Connexion à Event Notifications dans l'interface utilisateur

Avant d'activer les notifications pour Secrets Manager, assurez-vous que vous disposez d'une instance de service Event Notifications dans le même compte que votre instance Secrets Manager. Ensuite, vous pouvez utiliser la section Paramètres > Event Notifications dans l'interface utilisateur Secrets Manager pour connecter les services.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.

2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.

3. Dans la navigation Secrets Manager, cliquez sur Paramètres.

4. Dans la section Event Notifications, cliquez sur Connecter.

5. Dans le panneau latéral, consultez les détails source de la connexion. Si vous le souhaitez, entrez une description.

6. Sélectionnez le groupe de ressources et l'instance de service Event Notifications à connecter.

   Si une autorisation IAM entre Secrets Manager et Event Notifications n'existe pas dans votre compte, une boîte de dialogue s'affiche. Suivez les invites pour accorder l'accès entre les services.

   1. Pour accorder l'accès entre Secrets Manager et Event Notifications, cliquez sur Autoriser.
   2. Dans le panneau latéral, sélectionnez Event Notificationsen tant que service cible.
   3. Dans la liste des instances, sélectionnez l'instance de service Event Notifications à autoriser.
   4. Sélectionnez le rôle Gestionnaire de sources d’évènements .
   5. Cliquez sur Vérifier.
   6. Cliquez sur Affecter.

7. Pour confirmer la connexion, cliquez sur Connecter.

   Un message de réussite s'affiche pour indiquer que Secrets Manager est désormais connecté à Event Notifications. Si vous devez vous déconnecter plus tard de Event Notifications, vous pouvez utiliser le menu d'options > Déconnexion pour supprimer le Secrets Manager en tant que service source dans l'instance Event Notifications.

   Si vous choisissez de déconnecter Event Notifications, ne supprimez pas l'autorisation IAM entre Secrets Manager et Event Notifications. Secrets Manager utilise l'autorisation existante pour annuler l'enregistrement à partir de Event Notifications. Si une instance Event Notifications est supprimée, les autorisations qui existent entre le service et Secrets Manager sont également supprimées par IAM.

Connexion à Event Notifications avec l'API

Avant d'activer les notifications pour Secrets Manager, assurez-vous que vous disposez d'une instance de service Event Notifications dans le même compte que votre instance Secrets Manager. Vous pouvez ensuite vous connecter à Event Notifications à l'aide d'un programme en appelant l'API Secrets Manager.

L'exemple suivant présente une requête que vous pouvez utiliser pour enregistrer vos détails source Secrets Manager avec Event Notifications. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

Vous pouvez trouver la valeur event_notifications_instance_crn dans la console en accédant à la liste des ressources et en cliquant sur la ligne de l'instance 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"

Une demande réussie renvoie la valeur CRN de votre instance de service Event Notifications connectée. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, voir les Docs d'API.

Connexion à Event Notifications avec Terraform

L'exemple suivant montre une configuration que vous pouvez utiliser pour enregistrer les détails de votre source Secrets Manager avec 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"
    }

Envoi d'un événement de test à Event Notifications dans l'interface utilisateur

Lorsque vous avez activé les notifications pour Secrets Manager, testez votre connexion pour vous assurer que les événements générés par Secrets Manager sont transmis à Event Notifications.

Avant d'envoyer des événements de test Secrets Manager, vous devez avoir créé des rubriques, des destinations et des abonnements dans votre instance Event Notifications. Assurez-vous que le type d'événement Evénement de test (com.ibm.cloud.secrets-manager.test_event) est inclus comme condition dans votre rubrique Event Notifications.

1. Dans l'interface utilisateur Secrets Manager, cliquez sur Paramètres.

2. Dans la section Notifications d'évènements, cliquez sur Envoyer un évènement de test.

   Un message de réussite s'affiche pour indiquer que l'événement de test a été transmis à Event Notifications.

Envoi d'un événement de test à Event Notifications avec l'API

Lorsque vous avez activé les notifications pour Secrets Manager, testez votre connexion pour vous assurer que les événements générés par Secrets Manager sont transmis à Event Notifications.

Avant d'envoyer un événement de test Secrets Manager, vous devez avoir créé des rubriques, des destinations et des abonnements dans votre instance Event Notifications. Assurez-vous que le type d'événement Evénement de test (com.ibm.cloud.secrets-manager.test_event) est inclus comme condition dans votre rubrique Event Notifications.

L'exemple suivant présente une requête que vous pouvez utiliser pour envoyer un événement de test de Secrets Manager à Event Notifications. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

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

Une demande réussie renvoie une réponse HTTP 200 OK pour indiquer qu'un événement de test a été transmis avec succès à votre instance de service Event Notifications connectée. Pour plus d'informations, voir Docs d'API.