View a markdown version of this page

Zoom - Amazon Grundgestein AgentCore
Ausgehend

Zoom

Zoom kann als AgentCore Identity-Anmeldeinformationsanbieter für den ausgehenden Ressourcenzugriff konfiguriert werden. Auf diese Weise können Ihre Agenten Benutzer über den OAuth2-Dienst von Zoom authentifizieren und Zugriffstoken für Zoom-API-Ressourcen erhalten.

Ausgehend

Anmerkung

Sie können eine Zoom OAuth2-Anwendung nur entweder als Benutzerverbund oder als M2M-OAuth2-Client konfigurieren, aber nicht beides.

Anmerkung

AgentCore Identity gibt für jeden Anmeldeinformationsanbieter, den Sie erstellen, eine eindeutige OAuth2-Callback-URL aus. Die eindeutige Callback-URL ermöglicht die Sitzungsbindung, wodurch der Austausch von OAuth2-Autorisierungscodes vor anbieterübergreifender Wiedergabe und CSRF-style Angriffen geschützt wird, indem sichergestellt wird, dass eine Autorisierungsantwort nur gegen den spezifischen Anmeldeinformationsanbieter eingelöst werden kann, der sie initiiert hat. Da die URL für jeden Anbieter einzigartig ist, erfahren Sie sie erst nach Ihrem Anruf. CreateOauth2CredentialProvider Erstellen Sie zuerst Ihren Zoom OAuth2-Client und kehren Sie dann zur Zoom Developer Console zurück, um die Callback-URL zu registrieren, sobald AgentCore Identity sie ausgegeben hat.

Schritt 1: Erstellen Sie den Zoom OAuth2-Client

Gehen Sie wie folgt vor, um eine Zoom OAuth2-Anwendung einzurichten und die erforderlichen Client-Anmeldeinformationen für Identity zu erhalten. AgentCore Sie registrieren die Umleitungs-URI in Schritt 3, nachdem AgentCore Identity die eindeutige Rückruf-URL ausgegeben hat.

Um eine Zoom OAuth2-Anwendung zu konfigurieren

  1. Melden Sie sich im Zoom App Marketplace an.

  2. Wählen Sie Develop > Build App aus.

  3. Wählen Sie für eine Benutzerverbund-App die Option Allgemeine App und dann Erstellen aus.

    • Fügen Sie auf der Seite mit den App-Details einen Namen für Ihre Anwendung hinzu und wählen Sie aus, wie Ihre Anwendung verwaltet werden soll.

    • Lassen Sie im Abschnitt OAuth-Informationen die OAuth-Weiterleitungs-URL und die OAuth-Zulassungslisten vorerst leer — Sie fügen die eindeutige Rückruf-URL in Schritt 3 hinzu.

  4. Wählen Sie für eine M2M-App die Option Server-to-Server-OAuth-App und dann Create aus.

    • Fügen Sie einen Namen für Ihre Anwendung hinzu.

    • Wählen Sie auf der Seite mit den App-Details Bereiche aus und fügen Sie die erforderlichen Bereiche für Ihre Anwendung hinzu.

    • Öffnen Sie Informationen und geben Sie einen Firmennamen und Kontaktinformationen für Entwickler ein.

  5. Notieren Sie sich die Client-ID und das Client-Geheimnis, die für Ihre Anwendung generiert wurden. Sie benötigen diese Werte, um den Zoom-Anmeldeinformationsanbieter in AgentCore Identity zu konfigurieren.

Weitere Informationen finden Sie in der Integrationsdokumentation von Zoom.

Schritt 2: Erstellen Sie den AgentCore Identity-Anbieter für Anmeldeinformationen

Verwenden Sie Folgendes, um Zoom als Anbieter für ausgehende Ressourcen zu konfigurieren:

{
  "name": "Zoom",
  "credentialProviderVendor": "ZoomOauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret"
    }
  }
}

Die CreateOauth2CredentialProviderAntwort enthält ein callbackUrl Feld. Diese URL ist für diesen Anmeldeinformationsanbieter einzigartig und sieht wie folgt aus:https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Speichern Sie diesen Wert für den nächsten Schritt.

Schritt 3: Registrieren Sie die eindeutige Rückruf-URL bei Zoom

Kehren Sie zur Zoom-Entwicklerkonsole zurück und fügen Sie die eindeutige Callback-URL zur Weiterleitungs-URI-Liste Ihrer OAuth2-Anwendung hinzu.

  1. Melden Sie sich bei der Zoom Developer Console an und öffnen Sie die OAuth2-Anwendung, die Sie in Schritt 1 erstellt haben.

  2. Fügen Sie den von zurückgegebenen callbackUrl Wert CreateOauth2CredentialProvider zur Umleitungs-URI-Konfiguration der Anwendung hinzu.

  3. Speichern Sie Ihre Änderungen.