View a markdown version of this page

Notion - Amazon Bedrock AgentCore
Sortant

Notion

Notion peut être configurée en tant que fournisseur d'identifiants d' AgentCore identité pour l'accès aux ressources sortantes. Cela permet à vos agents d'authentifier les utilisateurs via le service OAuth2 de Notion et d'obtenir des jetons d'accès aux ressources de l'API Notion.

Sortant

Note

AgentCore Identity émet une URL de rappel OAuth2 unique pour chaque fournisseur d'informations d'identification que vous créez. L'URL de rappel unique permet la liaison de session, ce qui protège l'échange de code d'autorisation OAuth2 contre les rediffusions et les CSRF-style attaques entre fournisseurs en garantissant qu'une réponse d'autorisation ne peut être échangée que contre le fournisseur d'informations d'identification spécifique qui l'a initiée. Comme l'URL est unique par fournisseur, vous ne le saurez qu'après avoir appeléCreateOauth2CredentialProvider. Créez d'abord votre client Notion OAuth2, puis revenez à la console de développement Notion pour enregistrer l'URL de rappel une fois qu' AgentCore Identity l'a émise.

Étape 1 : Création du client Notion OAuth2

Utilisez la procédure suivante pour configurer une application Notion OAuth2 et obtenir les informations d'identification client nécessaires pour AgentCore Identity. Vous enregistrerez l'URI de redirection à l'étape 3, une fois qu' AgentCore Identity aura émis l'URL de rappel unique.

Pour configurer une application Notion OAuth2

  1. Ouvrir https://www.notion.so/my-integrations.

  2. Choisissez + Nouvelle intégration.

  3. Choisissez Intégration publique.

  4. Donnez un nom à votre intégration.

  5. Sélectionnez Soumettre.

  6. Sur la page des détails de l'intégration, ouvrez la section Domaine et URI OAuth. Laissez la liste des URI de redirection vide pour le moment. Vous ajouterez l'URL de rappel unique à l'étape 3.

  7. Enregistrez l'ID du client OAuth et le secret du client OAuth, car vous aurez besoin de ces informations pour configurer le fournisseur de ressources Notion dans Identity. AgentCore

Pour plus de détails, consultez la documentation d'autorisation de Notion.

Étape 2 : créer le fournisseur AgentCore d'identifiants d'identité

Pour configurer Notion en tant que fournisseur de ressources sortantes, utilisez ce qui suit :

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

La CreateOauth2CredentialProviderréponse inclut un callbackUrl champ. Cette URL est propre à ce fournisseur d'informations d'identification et ressemble à :https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Enregistrez cette valeur pour l'étape suivante.

Étape 3 : Enregistrez l'URL de rappel unique avec Notion

Retournez à la console de développement Notion et ajoutez l'URL de rappel unique à la liste d'URI de redirection de votre application OAuth2.

  1. Connectez-vous à la console de développement Notion et ouvrez l'application OAuth2 que vous avez créée à l'étape 1.

  2. Ajoutez la callbackUrl valeur renvoyée par CreateOauth2CredentialProvider à la configuration de l'URI de redirection de l'application.

  3. Enregistrez vos modifications.