Come si configura un'autorizzazione da servizio a servizio ( S2S ) tra IBM Cloud Logs Routing e IBM Cloud Logs in un account IBM Cloud?

Utilizza IBM Cloud® Identity and Access Management (IAM) per creare un'autorizzazione che conceda a IBM Cloud Logs Routing l'accesso a IBM Cloud Logs, in modo che il servizio IBM Cloud Logs Routing possa inviare i log alla tua istanza di IBM Cloud Logs (destinazione).

L'istanza di IBM Cloud Logs che si intende configurare come destinazione deve trovarsi nello stesso account in cui si intende configurare IBM Cloud Logs Routing.

Prima di iniziare

Il servizio di destinazione si trova sempre nell'account in cui è stata creata l'autorizzazione.

L'autorizzazione definita per il servizio " IBM Cloud Logs Routing " richiede il ruolo " Administrator " per il target " IBM Cloud Logs ".

Se si dispone dell'autorizzazione IAM per creare criteri e autorizzazioni, è possibile concedere solo il livello di accesso di cui si dispone come utente del servizio di destinazione. Ad esempio, se si dispone dell'accesso come visualizzatore per il servizio di destinazione, è possibile assegnare solo il ruolo di visualizzatore per l'autorizzazione. Se si tenta di assegnare un'autorizzazione più elevata, come quella di amministratore, potrebbe sembrare che l'autorizzazione sia concessa, tuttavia verrà assegnata solo l'autorizzazione di livello più alto che si possiede per il servizio di destinazione, cioè viewer.

Quali sono i ruoli di accesso al servizio IAM (autorizzazioni) necessari per configurare un’autorizzazione da servizio a servizio ( S2S ) tra IBM® Cloud Logs Routing e IBM Cloud Logs in un account IBM Cloud?

È possibile selezionare uno dei seguenti ruoli che l'origine può utilizzare per interagire con la destinazione. È possibile concedere solo il livello di accesso di cui si dispone come utente della destinazione selezionata.

  • Sender: In qualità di mittente, puoi inviare i log alla tua istanza del servizio IBM Cloud Logs, ma non puoi eseguire query sui log né monitorarne l'andamento in tempo reale. Questo ruolo è destinato agli agenti e ai router che inviano i log.

Come posso creare un'autorizzazione da servizio a servizio ( S2S ) tra IBM® Cloud Logs Routing e IBM Cloud Logs nella console dell'interfaccia utente di IBM Cloud?

Completa i seguenti passi:

  1. Nella console IBM Cloud , fare clic su Gestisci > Accesso (IAM) e selezionare Autorizzazioni.

  2. Fai clic su Crea.

  3. Configurare l'account di origine. Selezionate Questo conto.

  4. Selezionare Logs Routing come servizio di origine. Quindi, impostare l'ambito dell'accesso su Tutte le risorse.

  5. Selezionare Cloud Logs come servizio di destinazione. Quindi, impostare l'ambito di accesso su " Tutte le risorse " o su una singola istanza configurando le risorse in base agli attributi selezionati > Istanza di servizio.

    Altri attributi non sono supportati per questo tipo di autorizzazione.

  6. Nella sezione Accesso al servizio, selezionare Mittente per assegnare l'accesso al servizio di origine che accede al servizio di destinazione.

  7. Fai clic su Autorizza.

Se si crea un'autorizzazione tra un servizio di un altro account e un servizio di destinazione del proprio account corrente, è necessario avere accesso solo alla risorsa di destinazione. Per il conto sorgente è sufficiente il numero di conto

Come posso creare un'autorizzazione da servizio a servizio ( S2S ) tra IBM® Cloud Logs Routing e IBM Cloud Logs utilizzando la CLI?

Eseguire il comando seguente per creare un'autorizzazione per il servizio IBM Cloud Logs.

ibmcloud iam authorization-policy-create logs-router logs Sender

È possibile eseguire lo scope di una specifica istanza di destinazione IBM Cloud Logs usando [--target-service-instance-name TARGET_SERVICE_INSTANCE_NAME | --target-service-instance-id TARGET_SERVICE_INSTANCE_ID]. Non fornire altre opzioni di ambito.

Per ulteriori informazioni su tutti i parametri disponibili per questo comando, vedere ibmcloud iam authorization-policy-create.

Come posso creare un'autorizzazione da servizio a servizio ( S2S ) tra IBM® Cloud Logs Routing e IBM Cloud Logs utilizzando Terraform?

Prima di creare un'autorizzazione con Terraform, accertarsi di aver completato quanto segue:

  • Installare la CLI di Terraform e configurare il plug-in IBM Cloud Provider per Terraform. Per ulteriori informazioni, vedere il tutorial Iniziare con Terraform su IBM Cloud. Il plug-in astrae le API IBM Cloud utilizzate per completare questo compito.
  • Crea un file di configurazione Terraform denominato “ main.tf ”. In questo file, si definiscono le risorse utilizzando il linguaggio di configurazione HashiCorp. Per ulteriori informazioni, consultare la documentazione di Terraform.

Per creare un'autorizzazione utilizzando Terraform, procedere come segue:

  1. Creare una politica di autorizzazione tra i servizi utilizzando l'argomento della risorsa ibm_iam_authorization_policy nel file main.tf.

    L'esempio seguente crea un'autorizzazione tra servizi:

    resource "ibm_iam_authorization_policy" "policy" {
      source_service_name = "logs-router"
      target_service_name = "logs"
      roles               = ["Sender"]
      description         = "Authorization Policy"
      transaction_id     = "terraformAuthorizationPolicy"
    }
    

    La risorsa ibm_iam_authorization_policy richiede il servizio di origine, il servizio di destinazione e il ruolo. Al servizio di origine viene concesso l'accesso al servizio di destinazione e il ruolo è il livello di autorizzazione che l'accesso consente. Opzionalmente, è possibile aggiungere una descrizione dell'autorizzazione e un ID di transazione.

  2. Dopo aver completato la creazione del file di configurazione, inizializzare la CLI di Terraform. Per ulteriori informazioni, vedere Inizializzazione delle directory di lavoro.

    terraform init
    
  3. Eseguire il provisioning delle risorse dal file main.tf. Per ulteriori informazioni, vedere Provisioning dell'infrastruttura con Terraform.

    1. Eseguire terraform plan per generare un piano di esecuzione Terraform per visualizzare in anteprima le azioni proposte.
       terraform plan
    
    1. Eseguire terraform apply per creare le risorse definite nel piano.
       terraform apply
    

Come posso creare un’autorizzazione da servizio a servizio ( S2S ) tra IBM® Cloud Logs Routing e IBM Cloud Logs utilizzando l’API?

Per creare un'autorizzazione tra i servizi, devi disporre dell'accesso al servizio di destinazione. Puoi concedere solo il livello di accesso di cui disponi come utente del servizio di destinazione. L'autorizzazione definita per il servizio IBM Cloud Logs Routing richiede che si disponga del ruolo " Administrator " per il servizio di destinazione IBM Cloud Logs.

Per autorizzare l'accesso di un servizio di origine a un servizio di destinazione, utilizzare l'API IAM Policy Management.

Gli attributi supportati per la creazione di un criterio di autorizzazione dipendono da ciò che ogni servizio supporta. Per ulteriori informazioni sugli attributi supportati per ciascun servizio, consultare la documentazione dei servizi in uso.

curl --request POST \
  --url https://iam.cloud.ibm.com/v1/policies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "authorization",
    "subjects": [
        {
            "attributes": [
                {
                    "name": "accountId",
                    "value": "<account-id>"
                },
                {
                    "name": "serviceName",
                    "value": "logs-router"
                }
            ]
        }
    ],
    "roles": [
        {
            "role_id": "crn:v1:bluemix:public:logs::::serviceRole:Sender"
        }
    ],
    "resources": [
        {
            "attributes": [
                {
                    "name": "serviceName",
                    "value": "logs"
                },
                {
                    "name": "serviceInstance",
                    "value": "$LOGS_SERVICE_INSTANCE_CRN",
                    "operator": "stringEquals"
                }
            ]
        }
    ]
}'
SubjectAttribute accountSubjectAttribute = new SubjectAttribute.Builder()
      .name("accountId")
      .value(exampleAccountId)
      .build();
SubjectAttribute serviceNameSubjectAttribute = new SubjectAttribute.Builder()
      .name("serviceName")
      .value("logs-router")
      .build();
PolicySubject policySubjects = new PolicySubject.Builder()
      .addAttributes(accountSubjectAttribute)
      .addAttributes(serviceNameSubjectAttribute)
      .build();
PolicyRole policyRoles = new PolicyRole.Builder()
      .roleId("crn:v1:bluemix:public:logs::::serviceRole:Sender")
      .build();
ResourceAttribute accountIdResourceAttribute = new ResourceAttribute.Builder()
      .name("accountId")
      .value(exampleAccountId)
      .operator("stringEquals")
      .build();
ResourceAttribute serviceNameResourceAttribute = new ResourceAttribute.Builder()
      .name("serviceName")
      .value("logs")
      .operator("stringEquals")
      .build();
ResourceAttribute serviceInstanceResourceAttribute = new ResourceAttribute.Builder()
      .name("serviceInstance")
      .value(exampleTargetInstanceId)
      .operator("stringEquals")
      .build();
ResourceAttribute resourceTypeResourceAttribute = new ResourceAttribute.Builder()
      .name("resourceType")
      .value(exampleResourceType)
      .operator("stringEquals")
      .build();
ResourceAttribute resourceResourceAttribute = new ResourceAttribute.Builder()
      .name("resource")
      .value(exampleResourceId)
      .operator("stringEquals")
      .build();
PolicyResource policyResources = new PolicyResource.Builder()
      .addAttributes(accountIdResourceAttribute)
      .addAttributes(serviceNameResourceAttribute)
      .build();
CreatePolicyOptions options = new CreatePolicyOptions.Builder()
      .type("authorization")
      .subjects(Arrays.asList(policySubjects))
      .roles(Arrays.asList(policyRoles))
      .resources(Arrays.asList(policyResources))
      .build();
Response<Policy> response = service.createPolicy(options).execute();
Policy policy = response.getResult();
System.out.println(policy);
const policySubjects = [
  {
    attributes: [
      {
        name: 'accountId',
        value: exampleAccounId,
      },
      {
        name: 'serviceName',
        value: "logs-router",
      }
    ],
  },
];
const policyRoles = [
  {
    role_id: 'crn:v1:bluemix:public:logs::::serviceRole:Sender',
  },
];
const accountIdResourceAttribute = {
  name: 'accountId',
  value: exampleAccountId,
  operator: 'stringEquals',
};
const serviceNameResourceAttribute = {
  name: 'serviceName',
  value: "logs",
  operator: 'stringEquals'
};
const policyResources = [
  {
    attributes: [
      accountIdResourceAttribute,
      serviceNameResourceAttribute
    ],
  },
];
const params = {
  type: 'authorization',
  subjects: policySubjects,
  roles: policyRoles,
  resources: policyResources,
};
iamPolicyManagementService.createPolicy(params)
  .then(res => {
    examplePolicyId = res.result.id;
    console.log(JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });
policy_subjects = PolicySubject(
    attributes=[SubjectAttribute(name='accountId', value=example_account_id),
                SubjectAttribute(name='serviceName', value="logs-router")
                ])
policy_roles = PolicyRole(
    role_id='crn:v1:bluemix:public:logs::::serviceRole:Sender')
account_id_resource_attribute = ResourceAttribute(
    name='accountId', value=example_account_id)
service_name_resource_attribute = ResourceAttribute(
    name='serviceName', value="logs")
policy_resources = PolicyResource(
    attributes=[account_id_resource_attribute,
                service_name_resource_attribute])
policy = iam_policy_management_service.create_policy(
    type='authorization',
    subjects=[policy_subjects],
    roles=[policy_roles],
    resources=[policy_resources]
).get_result()
print(json.dumps(policy, indent=2))
accountSubjectAttribute := &iampolicymanagementv1.SubjectAttribute{
    Name:  core.StringPtr("accountId"),
    Value: &exampleAccountID,
    Operator: core.StringPtr("stringEquals"),
}
serviceNameSubjectAttribute := &iampolicymanagementv1.SubjectAttribute{
    Name:  core.StringPtr("serviceName"),
    Value: "logs-router",
    Operator: core.StringPtr("stringEquals"),
}
policySubjects := &iampolicymanagementv1.PolicySubject{
    Attributes: []iampolicymanagementv1.SubjectAttribute{*accountSubjectAttribute,
        *serviceNameSubjectAttribute},
}
policyRoles := &iampolicymanagementv1.PolicyRole{
    RoleID: core.StringPtr("crn:v1:bluemix:public:logs::::serviceRole:Sender"),
}
accountIDResourceAttribute := &iampolicymanagementv1.ResourceAttribute{
    Name:     core.StringPtr("accountId"),
    Value:    core.StringPtr(exampleAccountID),
    Operator: core.StringPtr("stringEquals"),
}
serviceNameResourceAttribute := &iampolicymanagementv1.ResourceAttribute{
    Name:     core.StringPtr("serviceName"),
    Value:    core.StringPtr("logs"),
    Operator: core.StringPtr("stringEquals"),
}
policyResources := &iampolicymanagementv1.PolicyResource{
    Attributes: []iampolicymanagementv1.ResourceAttribute{
        *accountIDResourceAttribute, *serviceNameResourceAttribute},
}
options := iamPolicyManagementService.NewCreatePolicyOptions(
    "authorization",
    []iampolicymanagementv1.PolicySubject{*policySubjects},
    []iampolicymanagementv1.PolicyRole{*policyRoles},
    []iampolicymanagementv1.PolicyResource{*policyResources},
)
policy, response, err := iamPolicyManagementService.CreatePolicy(options)
if err != nil {
    panic(err)
}
b, _ := json.MarshalIndent(policy, "", "  ")
fmt.Println(string(b))