Verbindung zu Event Notifications in der Benutzerschnittstelle herstellen

Bevor Sie Benachrichtigungen für Secrets Manager aktivieren können, vergewissern Sie sich, dass Sie eine Event Notifications Service-Instanz haben, die sich im selben Konto befindet wie Ihre Secrets Manager Instanz. Dann können Sie den Abschnitt Einstellungen > Event Notifications in der Benutzeroberfläche Secrets Manager verwenden, um die Dienste zu verbinden.

1. Klicken Sie in der Konsole auf das Symbol Menü > Ressourcenliste.

2. Wählen Sie in der Liste der Services Ihre Instanz von Secrets Manager aus.

3. Klicken Sie in der Secrets Manager -Navigation auf Einstellungen.

4. Klicken Sie im Abschnitt Event Notifications auf Verbinden.

5. Überprüfen Sie im Seitenbereich die Quellendetails für die Verbindung. Geben Sie optional eine Beschreibung an.

6. Wählen Sie die Ressourcengruppe und die Event Notifications-Serviceinstanz aus, die Sie verbinden wollen.

   Wenn in Ihrem Konto keine IAM-Berechtigung zwischen Secrets Manager und Event Notifications vorhanden ist, wird ein Dialogfenster angezeigt. Befolgen Sie die Eingabeaufforderungen, um den Zugriff zwischen den Services zu erteilen.

   1. Um Zugriff zwischen Secrets Manager und Event Notificationszu erteilen, klicken Sie auf Autorisieren.
   2. Wählen Sie in der seitlichen Anzeige Event Notifications als Zielservice aus.
   3. Wählen Sie in der Liste der Instanzen die Event Notifications-Serviceinstanz aus, die Sie berechtigen möchten.
   4. Wählen Sie die Rolle Ereignisquellenmanager aus.
   5. Klicken Sie auf Überprüfung.
   6. Klicken Sie auf Zuweisen.

7. Klicken Sie auf Verbinden, um die Verbindung zu bestätigen.

   Es wird eine Nachricht über die erfolgreiche Ausführung angezeigt, die angibt, dass Secrets Manager jetzt mit Event Notifications verbunden ist. Wenn Sie die Verbindung zu Event Notifications später trennen müssen, können Sie das Optionsmenü > Verbindung trennen verwenden, um Secrets Manager als Quellenservice in der Event Notifications -Instanz zu löschen.

   Wenn Sie die Verbindung zu Event Notifications trennen, löschen Sie die IAM-Berechtigung zwischen Secrets Manager und Event Notifications nicht. Secrets Manager verwendet die vorhandene Berechtigung, um die Registrierung bei Event Notifications aufzuheben. Wenn eine Event Notifications-Instanz gelöscht wird, werden alle Berechtigungen, die zwischen dem Service und Secrets Manager bestehen, auch von IAM gelöscht.

Verbindung zu Event Notifications über die API herstellen

Bevor Sie Benachrichtigungen für Secrets Manager aktivieren können, vergewissern Sie sich, dass Sie eine Event Notifications Service-Instanz haben, die sich im selben Konto befindet wie Ihre Secrets Manager Instanz. Anschließend können Sie programmgesteuert eine Verbindung zu Event Notifications herstellen, indem Sie die API Secrets Manager aufrufen.

Das folgende Beispiel zeigt eine Abfrage, mit der Sie Ihre Secrets Manager-Quellendetails bei Event Notifications registrieren können. Wenn Sie die API aufrufen, müssen Sie die ID-Variablen und das IAM-Token durch die Werte ersetzen, die für Ihre Secrets Manager-Instanz spezifisch sind.

Sie finden den Wert für event_notifications_instance_crn in der Konsole, indem Sie zur Ressourcenliste wechseln und auf die Event Notifications -Instanzzeile klicken.

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"

Eine erfolgreiche Anforderung gibt den CRN-Wert Ihrer verbundenen Event Notifications-Serviceinstanz zurück. Weitere Informationen zu den erforderlichen und optionalen Anforderungsparametern finden Sie in den API-Dokumenten.

Verbindung zu Event Notifications mit Terraform herstellen

Das folgende Beispiel zeigt eine Konfiguration, die Sie verwenden können, um Ihre Secrets Manager Quellenangaben bei Event Notifications zu registrieren.

    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"
    }

Testereignis in der Benutzerschnittstelle an Event Notifications senden

Nachdem Sie Benachrichtigungen für Secrets Manager aktiviert haben, testen Sie Ihre Verbindung, um sicherzustellen, dass die von Secrets Manager generierten Ereignisse an Event Notifications weitergeleitet werden.

Bevor Sie Secrets Manager-Testereignisse senden können, müssen Sie Themen, Ziele und Subskriptionen in Ihrer Event Notifications-Instanz erstellt haben. Stellen Sie sicher, dass der Ereignistypen Testereignis (com.ibm.cloud.secrets-manager.test_event) als Bedingung in Ihrem Abschnitt Event Notifications enthalten ist.

1. Klicken Sie in der Secrets Manager -Benutzerschnittstelle auf Einstellungen.

2. Klicken Sie im Abschnitt Event Notifications auf Testereignis senden.

   Eine Nachricht über die erfolgreiche Ausführung wird angezeigt, um anzuzeigen, dass das Testereignis erfolgreich an Event Notifications weitergeleitet wurde.

Testereignis mit der API an Event Notifications senden

Nachdem Sie Benachrichtigungen für Secrets Manager aktiviert haben, testen Sie Ihre Verbindung, um sicherzustellen, dass die von Secrets Manager generierten Ereignisse an Event Notifications weitergeleitet werden.

Damit Sie ein Secrets Manager-Testereignis senden können, müssen Sie Themen, Ziele und Subskriptionen in Ihrer Event Notifications-Instanz erstellt haben. Stellen Sie sicher, dass der Ereignistypen Testereignis (com.ibm.cloud.secrets-manager.test_event) als Bedingung in Ihrem Abschnitt Event Notifications enthalten ist.

Das folgende Beispiel zeigt eine Abfrage, mit der Sie ein Testereignis vom Secrets Manager an Event Notifications senden können. Wenn Sie die API aufrufen, müssen Sie die ID-Variablen und das IAM-Token durch die Werte ersetzen, die für Ihre Secrets Manager-Instanz spezifisch sind.

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

Eine erfolgreiche Anforderung gibt die HTTP-Antwort 200 OK zurück, um anzuzeigen, dass ein Testereignis erfolgreich an Ihre verbundene Event Notifications-Serviceinstanz weitergeleitet wurde. Weitere Informationen finden Sie in den API-Dokumenten.