Conectando-se ao Event Notifications na IU

Antes de ativar as notificações para Secrets Manager, certifique-se de que você tenha uma instância de serviço Event Notifications que esteja na mesma conta que a instância Secrets Manager. Em seguida, você pode usar a seção Settings > Event Notifications na interface do usuário Secrets Manager para conectar os serviços.

1. No console, clique no ícone Menu > Lista de recursos.

2. Na lista de serviços, selecione sua instância do Secrets Manager.

3. Na navegação do Secrets Manager, clique em Configurações.

4. Na seção Event Notifications, clique em Conectar.

5. No painel lateral, revise os detalhes da origem para a conexão. Opcionalmente, forneça uma descrição.

6. Selecione o grupo de recursos e a instância de serviço do Event Notifications que você deseja conectar.

   Se uma autorização do IAM entre o Secrets Manager e o Event Notifications não existir em sua conta, um diálogo será exibido. Siga os prompts para conceder acesso entre os serviços.

   1. Para conceder acesso entre o Secrets Manager e o Event Notifications, clique em Autorizar.
   2. No painel lateral, selecione o Event Notifications como o serviço de destino.
   3. Na lista de instâncias, selecione a instância de serviço do Event Notifications que você deseja autorizar.
   4. Selecione a função Gerente de origem de eventos.
   5. Clique em Revisar.
   6. Clique em Designar.

7. Para confirmar a conexão, clique em Conectar.

   Uma mensagem de êxito é exibida para indicar que o Secrets Manager agora está conectado ao Event Notifications. Se você precisar se desconectar mais tarde do Event Notifications, é possível usar o menu de opções > Desconectar para remover o Secrets Manager como um serviço de origem na instância do Event Notifications.

   Se você optar por desconectar o Event Notifications, não exclua a autorização do IAM entre o Secrets Manager e o Event Notifications. O Secrets Manager usa a autorização existente para cancelar o registro a partir do Event Notifications. Se uma instância do Event Notifications for excluída, quaisquer autorizações existentes entre o serviço e o Secrets Manager também serão excluídas pelo IAM.

Conectando-se ao Event Notifications com a API

Antes de ativar as notificações para Secrets Manager, certifique-se de que você tenha uma instância de serviço Event Notifications que esteja na mesma conta que a instância Secrets Manager. Em seguida, é possível conectar-se ao Event Notifications programaticamente chamando a API Secrets Manager.

O exemplo a seguir mostra uma consulta que pode ser usada para registrar seus detalhes de origem Secrets Manager com o Event Notifications. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

É possível localizar o valor event_notifications_instance_crn no console acessando a lista Recursos e clicando na linha da instância do Event Notifications.

curl -X POST
   --H "Authorization: Bearer {iam_token}" \
   --H "Accept: application/json" \
   --H "Content-Type: application/json" \
   --d'{
      "event_notifications_instance_crn": "crn:v1:bluemix:public:event-notifications:us-south:a/22018f3c34ff4ff193698d15ca316946:578ad1a4-2fd8-4e66-95d5-79a842ba91f8::",
      "event_notifications_source_description": "Optional description of this source in an Event Notifications instance.",
      "event_notifications_source_name": "My Secrets Manager"
   }' \
"https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/notifications/registration"

Uma solicitação bem-sucedida retorna o valor de CRN de sua instância de serviço do Event Notifications conectada. Para obter mais informações sobre os parâmetros de solicitação opcionais e necessários, consulte os Docs da API.

Conectando-se ao Event Notifications com o Terraform

O exemplo a seguir mostra uma configuração que pode ser usada para registrar os detalhes da fonte Secrets Manager com Event Notifications.

    resource "ibm_sm_en_registration" "en_registration" {
        instance_id = local.instance_id
        region = local.region
        name = "test-root-ca"
        event_notifications_instance_crn = var.en_instance_crn
        event_notifications_source_description = "My event notification source"
        event_notifications_source_name = "my_en_source"
    }

Enviando um evento de teste para o Event Notifications na IU

Depois de ativar as notificações para o Secrets Manager, teste sua conexão para assegurar que os eventos gerados pelo Secrets Manager estejam sendo encaminhados para o Event Notifications.

Para poder enviar eventos de teste do Secrets Manager, tópicos, destinos e assinaturas deverão ter sido criados em sua instância do Event Notifications. Assegure que o tipo de evento Evento de teste (com.ibm.cloud.secrets-manager.test_event) esteja incluído como uma condição em seu tópico do Event Notifications.

1. Na IU do Secrets Manager, clique em Configurações.

2. Na seção Event Notifications, clique em Enviar evento de teste.

   Uma mensagem de êxito é exibida para indicar que o evento de teste foi encaminhado com sucesso para o Event Notifications.

Enviando um evento de teste para o Event Notifications com a API

Depois de ativar as notificações para o Secrets Manager, teste sua conexão para assegurar que os eventos gerados pelo Secrets Manager estejam sendo encaminhados para o Event Notifications.

Para poder enviar um evento de teste do Secrets Manager, tópicos, destinos e assinaturas deverão ter sido criados em sua instância do Event Notifications. Assegure que o tipo de evento Evento de teste (com.ibm.cloud.secrets-manager.test_event) esteja incluído como uma condição em seu tópico do Event Notifications.

O exemplo a seguir mostra uma consulta que pode ser usada para enviar um evento de teste do Secrets Manager para o Event Notifications. Ao chamar a API, substitua as variáveis de ID e o token IAM pelos valores que são específicos para a sua instância do Secrets Manager.

curl -X GET
   --H "Authorization: Bearer {iam_token}" \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/notifications/registration/test"

Uma solicitação bem-sucedida retorna uma resposta HTTP 200 OK para indicar que um evento de teste foi encaminhado com sucesso para sua instância de serviço do Event Notifications conectada. Para obter mais informações, consulte os Docs da API.