View a markdown version of this page

Nozione - Fondamento Amazon AgentCore
In uscita

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Nozione

Notion può essere configurato come fornitore di credenziali di AgentCore identità per l'accesso alle risorse in uscita. Ciò consente agli agenti di autenticare gli utenti tramite il servizio OAuth2 di Notion e ottenere token di accesso per le risorse API Notion.

In uscita

Nota

AgentCore Identity emette un URL di callback OAuth2 univoco per ogni provider di credenziali creato. L'URL di callback univoco abilita l'associazione di sessione, che protegge lo scambio di codice di autorizzazione OAuth2 dalla ripetizione e dagli CSRF-style attacchi tra provider, garantendo che una risposta di autorizzazione possa essere riscattata solo rispetto allo specifico provider di credenziali che l'ha avviata. Poiché l'URL è unico per ogni provider, lo conoscerai solo dopo aver chiamato. CreateOauth2CredentialProvider Crea prima il tuo client Notion OAuth2, quindi torna alla console per sviluppatori Notion per registrare l'URL di callback una volta AgentCore che Identity lo ha emesso.

Fase 1: Creare il client Notion OAuth2

Utilizzare la seguente procedura per configurare un'applicazione Notion OAuth2 e ottenere le credenziali client necessarie per Identity. AgentCore L'URI di reindirizzamento verrà registrato nel passaggio 3, dopo che AgentCore Identity avrà emesso l'URL di callback univoco.

Per configurare un'applicazione Notion OAuth2

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

  2. Scegli + Nuova integrazione.

  3. Scegli Integrazione pubblica.

  4. Fornisci un nome per la tua integrazione.

  5. Seleziona Invia.

  6. Nella pagina dei dettagli dell'integrazione, apri la sezione Dominio e URI OAuth. Lascia vuoto l'elenco degli URI di reindirizzamento per ora: aggiungerai l'URL di callback univoco nel passaggio 3.

  7. Registra l'ID del client OAuth e il segreto del client OAuth poiché avrai bisogno di queste informazioni per configurare il provider di risorse Notion in Identity. AgentCore

Per maggiori dettagli, consulta la documentazione di autorizzazione di Notion.

Fase 2: Creare il provider di credenziali di AgentCore identità

Per configurare Notion come fornitore di risorse in uscita, utilizzare quanto segue:

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

La CreateOauth2CredentialProvider risposta include un callbackUrl campo. Questo URL è unico per questo fornitore di credenziali e ha il seguente aspetto:https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Salva questo valore per il passaggio successivo.

Passaggio 3: registra l'URL di callback univoco con Notion

Torna alla console per sviluppatori Notion e aggiungi l'URL di callback univoco all'elenco degli URI di reindirizzamento dell'applicazione OAuth2.

  1. Accedi alla console per sviluppatori Notion e apri l'applicazione OAuth2 creata nel passaggio 1.

  2. Aggiungere il callbackUrl valore restituito da CreateOauth2CredentialProvider alla configurazione dell'URI di reindirizzamento dell'applicazione.

  3. Salvare le modifiche.