View a markdown version of this page

HubSpot - Amazon Grundgestein AgentCore
Ausgehend

HubSpot

HubSpot kann als AgentCore Identitätsanmeldeanbieter für ausgehenden Ressourcenzugriff konfiguriert werden. Auf diese Weise können Ihre Agenten Benutzer über HubSpot den OAuth2-Dienst authentifizieren und Zugriffstoken für API-Ressourcen abrufen. HubSpot

Anmerkung

HubSpot unterstützt den Ablauf der M2M/Client Anmeldeinformationen nicht.

Ausgehend

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 HubSpot OAuth2-Client und kehren Sie dann zur HubSpot Entwicklerkonsole zurück, um die Callback-URL zu registrieren, sobald AgentCore Identity sie ausgegeben hat.

Schritt 1: Erstellen Sie den OAuth2-Client HubSpot

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

Um eine HubSpot OAuth2-Anwendung zu konfigurieren

  1. Öffnen Sie die Entwicklerkonsole für. HubSpot

  2. Wählen Sie in der Hauptnavigationsleiste Apps aus.

  3. Wählen Sie Create app (App erstellen).

  4. Geben Sie einen Namen für Ihre Anwendung ein.

  5. Öffnen Sie die Registerkarte Auth. Lassen Sie das Feld Umleitungs-URL vorerst leer. In Schritt 3 fügen Sie die eindeutige Rückruf-URL hinzu.

  6. Konfigurieren Sie alle Bereiche, die für Ihre Anwendung erforderlich sind.

  7. Sobald Ihre App erstellt wurde, kehren Sie zur Registerkarte Auth für Ihre Anwendung zurück.

  8. Notieren Sie sich die Client-ID und das Client-Geheimnis. Sie benötigen diese, wenn Sie den HubSpot Ressourcenanbieter in AgentCore Identity erstellen.

Weitere Informationen finden Sie in HubSpotder OAuth-Schnellstartanleitung.

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

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

{
  "name": "Hubspot",
  "credentialProviderVendor": "HubspotOauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret"
    }
  }
}
Anmerkung

Beim Aufrufen GetResourceOAuth2Token müssen die Bereiche Folgendes beinhalten: oauth

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 mit HubSpot

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

  1. Melden Sie sich bei der HubSpot Entwicklerkonsole 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.