

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# OneNote Intégration avec Microsoft
<a name="microsoft-onenote-integration"></a>

Grâce au connecteur OneNote d'action Microsoft, vous pouvez gérer les blocs-notes, les sections et les pages de votre compte Microsoft 365 directement dans Amazon Quick via le langage naturel. Le connecteur utilise Microsoft Graph pour les OneNote opérations.

Amazon Quick prend en charge deux méthodes d'authentification pour Microsoft OneNote. Choisissez la méthode qui répond le mieux aux exigences de sécurité de votre entreprise.
+ Application **OAuth par défaut — Utilise une application** OAuth AWS gérée. Aucune information d'identification supplémentaire n'est requise. Les utilisateurs s'authentifient directement avec leur compte Microsoft 365.
+ Application **OAuth personnalisée : utilise une application** gérée par le client enregistrée sous l'identifiant Microsoft Entra. Cette option donne à votre organisation le contrôle total de la configuration OAuth.

Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultez[Méthodes d’authentification](quick-action-auth.md).

## Avant de commencer
<a name="microsoft-onenote-prerequisites"></a>

Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.
+ Un compte Microsoft 365 actif avec accès aux OneNote blocs-notes que vous souhaitez utiliser.
+ Pour **l'application OAuth personnalisée** : accès à l'identifiant Microsoft Entra (anciennement Azure Active Directory) pour enregistrer une application et configurer les autorisations Microsoft Graph pour. OneNote
+ Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultez[Configuration des intégrations dans la console](integration-console-setup-process.md).

## Configuration de l'identifiant Microsoft Entra
<a name="microsoft-onenote-source-setup"></a>

Si vous utilisez l'authentification **par défaut de l'application OAuth**, ignorez cette section et passez à. [Configuration du connecteur dans Amazon Quick](#microsoft-onenote-quicksuite-setup)

Pour l'authentification personnalisée des applications OAuth, enregistrez une application dans le [centre d'administration Microsoft Entra](https://entra.microsoft.com/) et configurez les autorisations Microsoft Graph pour OneNote (par exemple `Notes.Read``Notes.ReadWrite`, ou selon `Notes.Read.All` les besoins). Ajoutez l'URL de rappel Amazon Quick en `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` tant qu'URI de redirection. Remplacez {{{region}}} par votre AWS région (par exemple,`us-east-1`). Pour obtenir des instructions détaillées, consultez la section Notions de [base de l'authentification et de l'autorisation](https://learn.microsoft.com/en-us/graph/auth/auth-concepts) dans la documentation Microsoft Graph. Enregistrez l'ID de l'application (client) et une valeur secrète du client. Vous en avez besoin pour configurer Amazon Quick.

## Configuration du connecteur dans Amazon Quick
<a name="microsoft-onenote-quicksuite-setup"></a>

### Se connecter depuis l'onglet Disponible
<a name="microsoft-onenote-quick-connect"></a>

Si vous souhaitez utiliser l'authentification par défaut de l'application OAuth, vous pouvez vous connecter directement depuis l'onglet **Disponible** sans configuration supplémentaire.

1. Dans la console Amazon Quick, choisissez **Connectors**.

1. Dans l'onglet **Disponible**, recherchez **OneNote**et choisissez **Connect**.

1. Terminez le flux de connexion Microsoft et accordez les autorisations demandées.

Pour configurer un connecteur avec l'application OAuth personnalisée à la place, utilisez l'onglet **Créer pour votre équipe**, comme décrit ci-dessous.

### Créez à partir de l'onglet Créer pour votre équipe
<a name="microsoft-onenote-full-setup"></a>

1. Dans la console Amazon Quick, choisissez **Connectors**.

1. Choisissez l'onglet **Créer pour votre équipe**.

1. Trouvez et choisissez **OneNote**.

1. Entrez un **nom** pour votre connecteur. Choisissez éventuellement **\+ Ajouter une description** pour ajouter une description.

1. Pour **Type de connexion**, sélectionnez **Réseau public**.

1. Pour **la configuration OAuth**, choisissez l'une des méthodes d'authentification suivantes et configurez les champs obligatoires.

   1. Pour l'**application OAuth par défaut** :

      Aucune information d'identification supplémentaire n'est requise. Choisissez **Next (Suivant)** pour continuer.

   1. Pour l'**application OAuth personnalisée**, configurez les champs suivants :
      + **URL de base** (facultatif) — URL de base de Microsoft Graph. Exemple : `https://graph.microsoft.com/v1.0`
      + **ID client : ID** de l'application (client) indiqué lors de l'enregistrement de votre application Microsoft Entra ID.
      + **Client OAuth public** (facultatif) : sélectionnez cette option si votre application Microsoft Entra ID est configurée en tant que client public (aucun secret client).
      + **Secret client** : valeur du secret client issue de l'enregistrement de votre application Microsoft Entra ID.
      + **URL du jeton** : point de terminaison du jeton de la plateforme d'identité Microsoft. Exemple : `https://login.microsoftonline.com/common/oauth2/v2.0/token`
      + **URL d'autorisation** : point de terminaison d'autorisation de la plateforme d'identité Microsoft. Exemple : `https://login.microsoftonline.com/common/oauth2/v2.0/authorize`
      + **URL de redirection** : Pre-filled avec l'URL de rappel Amazon Quick.
**Note**  
Pour une authentification spécifique au locataire, remplacez `common` l'URL du jeton et l'URL d'autorisation par votre identifiant de locataire Microsoft Entra ID.

1. Choisissez **Suivant**.

1. Une fenêtre de connexion Microsoft s'ouvre. Vérifiez les autorisations demandées et choisissez **Accepter**.

1. Sur la page **Révision**, passez en revue les actions disponibles pour le connecteur. Choisissez **Suivant**.

1. Sur la page **Publier**, choisissez qui peut accéder au connecteur. Vous pouvez autoriser l'accès à tous les membres de votre organisation ou rechercher des équipes ou des groupes spécifiques.

1. Choisissez **Publier**.

## Actions disponibles
<a name="microsoft-onenote-actions"></a>

Une fois le connecteur configuré, les actions exposées par OneNote sont disponibles. Pour voir l'ensemble d'actions actuel pour votre connecteur, accédez à la vue **Actions disponibles** du connecteur dans la console Amazon Quick.

## Gestion et résolution des problèmes
<a name="microsoft-onenote-troubleshooting"></a>

Pour modifier, partager ou supprimer votre connecteur, consultez[Gestion des intégrations existantes](integration-workflows.md#managing-existing-integrations).

### Problèmes d’authentification
<a name="microsoft-onenote-troubleshooting-auth"></a>
+ **Sign-in échoue (application OAuth par défaut ou application OAuth personnalisée)** : vérifiez que votre compte Microsoft 365 est actif et que vous pouvez vous y connecter directement OneNote sur le Web. Pour l'application OAuth personnalisée, vérifiez que l'URI de redirection dans votre application Microsoft Entra ID correspond à l'URL de rappel Amazon Quick.
+ **Autorisations insuffisantes** — Vérifiez que les autorisations Microsoft Graph configurées sur votre application Microsoft Entra ID incluent OneNote les étendues requises pour les opérations que vous souhaitez utiliser, et que le consentement de l'administrateur a été accordé si nécessaire.
+ **Informations d'identification client non valides (application OAuth personnalisée)** : vérifiez que l'ID client et le secret du client correspondent aux valeurs indiquées dans votre enregistrement à l'application Microsoft Entra ID. Vérifiez que le secret du client n'a pas expiré.