

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à.

# OneNote Integrazione con Microsoft
<a name="microsoft-onenote-integration"></a>

Con Microsoft OneNote Action Connector, puoi gestire taccuini, sezioni e pagine dal tuo account Microsoft 365 direttamente in Amazon Quick tramite linguaggio naturale. Il connettore utilizza Microsoft Graph per OneNote le operazioni.

Amazon Quick supporta due metodi di autenticazione per Microsoft OneNote. Scegli il metodo più adatto ai requisiti di sicurezza della tua organizzazione.
+ App **OAuth predefinita: utilizza un'applicazione** OAuth AWS gestita. Non sono necessarie credenziali aggiuntive. Gli utenti si autenticano direttamente con il proprio account Microsoft 365.
+ **App OAuth personalizzata**: utilizza un'applicazione gestita dal cliente registrata in Microsoft Entra ID. Questa opzione offre all'organizzazione il pieno controllo sulla configurazione OAuth.

Per ulteriori informazioni sui metodi di autenticazione supportati da Amazon Quick, consulta[Metodi di autenticazione](quick-action-auth.md).

## Prima di iniziare
<a name="microsoft-onenote-prerequisites"></a>

Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Un account Microsoft 365 attivo con accesso ai OneNote notebook che desideri utilizzare.
+ Per **l'app OAuth personalizzata**: accesso all'ID Microsoft Entra (precedentemente Azure Active Directory) per registrare un'applicazione e configurare le autorizzazioni di Microsoft Graph per. OneNote
+ Per i requisiti di abbonamento ad Amazon Quick, consulta[Configura le integrazioni nella console](integration-console-setup-process.md).

## Configurazione dell'ID Microsoft Entra
<a name="microsoft-onenote-source-setup"></a>

Se utilizzi l'autenticazione **predefinita dell'app OAuth**, salta questa sezione e procedi con. [Configurazione del connettore in Amazon Quick](#microsoft-onenote-quicksuite-setup)

Per l'autenticazione personalizzata dell'app OAuth, registra un'applicazione nell'interfaccia di [amministrazione di Microsoft Entra e configura](https://entra.microsoft.com/) le autorizzazioni Microsoft Graph per OneNote (ad esempio `Notes.Read``Notes.ReadWrite`, o `Notes.Read.All` in base alle esigenze). Aggiungi l'URL di callback Amazon Quick `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` come URI di reindirizzamento. {{{region}}}Sostituiscilo con la tua AWS regione (ad esempio,`us-east-1`). Per istruzioni dettagliate, vedi Nozioni di [base sull'autenticazione e l'autorizzazione nella](https://learn.microsoft.com/en-us/graph/auth/auth-concepts) documentazione di Microsoft Graph. Registra l'ID dell'applicazione (client) e un valore segreto del client: ne hai bisogno quando configuri Amazon Quick.

## Configurazione del connettore in Amazon Quick
<a name="microsoft-onenote-quicksuite-setup"></a>

### Connect dalla scheda Available
<a name="microsoft-onenote-quick-connect"></a>

Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda **Disponibile** senza configurazioni aggiuntive.

1. Nella console Amazon Quick, scegli **Connettori**.

1. Nella scheda **Disponibile**, trova **OneNote**e scegli **Connect**.

1. Completa il flusso di accesso a Microsoft e concedi le autorizzazioni richieste.

Per configurare invece un connettore con l'app OAuth personalizzata, usa la scheda **Crea per il tuo team** come descritto di seguito.

### Crea dalla scheda Crea per il tuo team
<a name="microsoft-onenote-full-setup"></a>

1. Nella console Amazon Quick, scegli **Connettori**.

1. Scegli la scheda **Crea per il tuo team**.

1. Trova e scegli **OneNote**.

1. Inserisci un **nome** per il connettore. Facoltativamente, scegli **\+ Aggiungi descrizione** per aggiungere una descrizione.

1. Per **Tipo di connessione**, scegli **Rete pubblica**.

1. Per la **configurazione OAuth**, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.

   1. Per l'app **OAuth predefinita:**

      Non sono necessarie credenziali aggiuntive. Seleziona **Successivo** per continuare.

   1. Per l'**app OAuth personalizzata**, configura i seguenti campi:
      + **URL di base** (facoltativo): l'URL di base di Microsoft Graph. Ad esempio: `https://graph.microsoft.com/v1.0`
      + **ID client**: l'ID dell'applicazione (client) ottenuto dalla registrazione dell'app Microsoft Entra ID.
      + **Client OAuth pubblico** (opzionale): seleziona questa opzione se l'app Microsoft Entra ID è configurata come client pubblico (nessun client segreto).
      + **Client secret**: il valore segreto del client derivante dalla registrazione dell'app Microsoft Entra ID.
      + **URL del token**: l'endpoint del token della piattaforma di identità Microsoft. Ad esempio: `https://login.microsoftonline.com/common/oauth2/v2.0/token`
      + **URL di autorizzazione**: l'endpoint di autorizzazione della piattaforma di identità Microsoft. Ad esempio: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize`
      + URL **di reindirizzamento: Pre-filled con l'URL** di callback di Amazon Quick.
**Nota**  
Per l'autenticazione specifica del tenant, sostituisci `common` l'URL del token e l'URL di autorizzazione con il tuo ID tenant ID Microsoft Entra.

1. Scegli **Next (Successivo)**.

1. Viene visualizzata una finestra di accesso Microsoft. **Controlla le autorizzazioni richieste e scegli Accetta.**

1. Nella pagina **Revisione**, esamina le azioni disponibili per il connettore. Scegli **Next (Successivo)**.

1. Nella pagina **Pubblica**, scegli chi può accedere al connettore. Puoi abilitare l'accesso per tutti i membri dell'organizzazione o cercare team o gruppi specifici.

1. Seleziona **Pubblica**.

## Operazioni disponibili
<a name="microsoft-onenote-actions"></a>

Dopo aver configurato il connettore, OneNote sono disponibili le azioni esposte da. Per visualizzare l'attuale set di azioni per il tuo connettore, vai alla visualizzazione **Azioni disponibili** del connettore nella console Amazon Quick.

## Gestione e risoluzione dei problemi
<a name="microsoft-onenote-troubleshooting"></a>

Per modificare, condividere o eliminare il connettore, consulta[Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations).

### Problemi di autenticazione
<a name="microsoft-onenote-troubleshooting-auth"></a>
+ **Sign-in fallisce (app OAuth predefinita o app OAuth personalizzata): verifica che l'**account Microsoft 365 sia attivo e che sia possibile accedere direttamente OneNote sul Web. Per l'app OAuth personalizzata, verifica che l'URI di reindirizzamento nell'app Microsoft Entra ID corrisponda all'URL di callback Amazon Quick.
+ **Autorizzazioni insufficienti**: verifica che le autorizzazioni Microsoft Graph configurate nell'app Microsoft Entra ID includano gli OneNote ambiti necessari per le operazioni che desideri utilizzare e che il consenso dell'amministratore sia stato concesso, se necessario.
+ **Credenziali client non valide (app OAuth personalizzata)**: verifica che l'ID client e il segreto del cliente corrispondano ai valori nella registrazione dell'app Microsoft Entra ID. Verifica che il segreto del client non sia scaduto.