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.
# Intégration de Microsoft OneDrive Action
Utilisez le connecteur OneDrive d'action Microsoft pour gérer les OneDrive fichiers, les dossiers et les classeurs Excel directement dans Amazon Quick via le langage naturel.
La configuration de cette intégration comporte deux étapes. Tout d'abord, vous enregistrez une application dans Microsoft Entra et vous configurez ses autorisations. Ensuite, vous créez l'intégration dans Amazon Quick et vous la connectez à votre application Entra. 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
Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.
+ Un compte Microsoft 365 avec OneDrive accès.
+ Accès au [centre d'administration Microsoft Entra](https://entra.microsoft.com/) avec au moins les autorisations de développeur d'applications.
+ Pour les conditions d'abonnement, voir[Configuration des intégrations dans la console](integration-console-setup-process.md).
## Configuration de Microsoft Entra
Avant de configurer Amazon Quick, créez un enregistrement d'application dans Microsoft Entra. Effectuez toutes les étapes suivantes dans Entra avant de passer à la console Amazon Quick.
Pour plus d'informations sur les enregistrements d'applications, voir [Enregistrer une application auprès de la plateforme d'identité Microsoft](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app) dans la documentation Microsoft.
### Enregistrez l'application
1. Ouvrez le [centre d'administration Microsoft Entra](https://entra.microsoft.com/).
1. Dans le menu de navigation de gauche, choisissez **Entra ID**, puis sélectionnez **Inscriptions d'applications**.
1. Choisissez **Nouvel enregistrement**.
1. Dans **Nom**, entrez un nom descriptif pour votre intégration.
1. Pour les **types de comptes pris en charge**, sélectionnez **Comptes uniquement dans ce répertoire d'organisation**.
1. Pour l'**URI de redirection**, sélectionnez **Web** et entrez`https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`. Remplacez *\$1region\$1* par la AWS région dans laquelle votre instance Amazon Quick est déployée.
1. Choisissez **S’inscrire**.
1. Sur la page d'aperçu, copiez l'ID de **l'application (client) et l'ID** du **répertoire (locataire)**. Vous avez besoin de ces valeurs pour la configuration d'Amazon Quick.
### Création d'un secret client
Amazon Quick a besoin d'un secret client pour s'authentifier auprès de Microsoft Entra. Ce secret sert de mot de passe pour l'enregistrement de l'application.
1. Lors de l'enregistrement de votre application, sélectionnez **Certificats et secrets**.
1. Choisissez **Nouveau secret client**.
1. Entrez une description et choisissez une période d'expiration.
1. Choisissez **Ajouter**.
1. Copiez immédiatement la **valeur**. Cette valeur n'est affichée qu'une seule fois.
**Important**
Copiez la **valeur** secrète, pas l'ID secret. La valeur est la chaîne la plus longue utilisée pour l'authentification.
### Configurer les autorisations d'API
Cette intégration utilise des autorisations déléguées, qui permettent à l'application d'agir au nom d'un utilisateur connecté. Pour plus d'informations, consultez la section [Présentation des autorisations Microsoft Graph](https://learn.microsoft.com/en-us/graph/permissions-overview) dans la documentation Microsoft.
1. À partir de l'enregistrement de votre application, choisissez **les autorisations d'API**.
1. Choisissez **Ajouter une autorisation**, puis **Microsoft Graph**.
1. Choisissez **Autorisations déléguées** et ajoutez les autorisations dans le tableau ci-dessous.
1. Choisissez **Accorder le consentement de l'administrateur pour [nom de votre locataire]** pour approuver les autorisations.
Ajoutez ce qui suit en tant qu'autorisations déléguées lors de l'enregistrement de votre application Entra. Pour la référence complète des autorisations, consultez la [référence des autorisations Microsoft Graph](https://learn.microsoft.com/en-us/graph/permissions-reference) dans la documentation Microsoft.
**OneDrive intégration des actions — autorisations déléguées**
| Autorisations | Description |
| --- | --- |
| Files.ReadWrite | Permet à l'application de lire, créer, mettre à jour et supprimer les fichiers de l'utilisateur connecté. |
| User.Read.All | Permet à l'application de lire l'ensemble complet des propriétés de profil de tous les utilisateurs de l'organisation au nom de l'utilisateur connecté. |
| offline\$1access | Permet à l'application d'actualiser les jetons d'accès sans obliger l'utilisateur à se reconnecter. Cela réduit la fréquence à laquelle les utilisateurs doivent se réauthentifier. |
### Enregistrez vos informations d'identification
Avant de quitter le centre d'administration Microsoft Entra, vérifiez que vous disposez des valeurs suivantes. Vous en avez besoin pour la configuration d'Amazon Quick.
**Informations d'identification requises auprès de Microsoft Entra**
| Value | Où le trouver |
| --- | --- |
| ID de l’application (client) | Page d'aperçu de l'enregistrement de l'application |
| ID du répertoire (locataire) | Page d'aperçu de l'enregistrement de l'application |
| Valeur secrète du client | Page des certificats et secrets |
## Configurer l'intégration dans Amazon Quick
Après avoir terminé la configuration d'Entra, créez l'intégration dans Amazon Quick.
1. Dans la console Amazon Quick, choisissez **Integrations.**
1. Choisissez **Microsoft OneDrive** et cliquez sur le bouton Ajouter (plus « \$1 »).
1. Choisissez l'onglet **Actions**.
1. Choisissez **Exécuter des actions dans Microsoft OneDrive**.
1. Renseignez les détails de l'intégration :
+ **Nom** : nom descriptif de votre OneDrive intégration.
+ **Description** (facultatif) — Objectif de l'intégration.
1. Renseignez les paramètres de connexion :
+ **URL de base** — `https://graph.microsoft.com/v1.0`
+ **ID client — Identifiant** de l'application (client) indiqué lors de l'enregistrement de votre application Entra.
+ **Secret client** — Valeur du secret client issue de l'enregistrement de votre application Entra.
+ **URL du jeton** — `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token`
+ **URL d'authentification —** `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize`
+ **URL de redirection** — `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Choisissez **Créer et continuer**.
1. Choisissez les utilisateurs avec lesquels partager l'intégration.
1. Choisissez **Suivant**.
## Actions disponibles
Après avoir configuré l'intégration, les actions suivantes sont disponibles.
**Actions OneDrive disponibles par Microsoft**
| Catégorie | Action | Description |
| --- | --- | --- |
| Disque dur et objets | Obtenez Drive | Récupérez les propriétés et les relations d'un lecteur. |
| Disque dur et objets | Elément de liste | Récupérez tous les objets contenus dans le lecteur. |
| Disque dur et objets | Obtenir un élément | Récupérez un objet contenu dans le lecteur. |
| Disque dur et objets | Create Folder | Créez un nouveau dossier sur le lecteur de l'utilisateur. |
| Disque dur et objets | Mettre à jour un élément | Mettez à jour les métadonnées d'un fichier ou d'un dossier. |
| Disque dur et objets | Supprimer un élément | Supprimer un fichier ou un dossier. Déplace l'article vers la corbeille. |
| Disque dur et objets | Liste des dossiers pour enfants | Renvoie une collection d'éléments dans les enfants d'un dossier. |
| Disque dur et objets | Copier l'article | Créez une copie d'un fichier ou d'un dossier vers un autre emplacement. |
| Disque dur et objets | Ajout d'autorisations | Envoyez une invitation au partage d'un fichier ou d'un dossier. |
| Disque dur et objets | Charger un fichier | Téléchargez un nouveau fichier ou mettez à jour un fichier existant. Supporte des fichiers jusqu'à 250 Mo. |
| classeurs Excel | List Sheets | Récupérez une liste d'objets de feuille de calcul. |
| classeurs Excel | Ajouter une feuille | Ajoutez une nouvelle feuille de calcul au classeur. |
| classeurs Excel | Lire la feuille | Récupérez les propriétés d'un objet de feuille de calcul. |
| classeurs Excel | Feuille de mise à jour | Mettez à jour les propriétés d'un objet de feuille de calcul. |
| classeurs Excel | Supprimer la feuille | Supprimez la feuille de travail du classeur. |
| classeurs Excel | Lire la cellule | Obtenez la valeur d'une seule cellule par numéro de ligne et de colonne. |
| classeurs Excel | Cellule d'écriture | Définissez la valeur d'une seule cellule par numéro de ligne et de colonne. |
| classeurs Excel | Plage de lecture | Obtenez les valeurs d'une plage. |
| classeurs Excel | Plage d'écriture | Mettez à jour les valeurs d'une plage. |
| classeurs Excel | Gamme claire | Efface les valeurs de plage, le format, le remplissage et la bordure. |
| classeurs Excel | Supprimer la plage | Supprimez les cellules associées à la plage. |
| classeurs Excel | Gamme Get Used | Obtenez la plus petite plage comprenant des cellules avec une valeur ou une mise en forme. |
## Gestion et résolution des problèmes
Pour modifier, partager ou supprimer votre intégration, consultez[Gestion des intégrations existantes](integration-workflows.md#managing-existing-integrations).
### Problèmes d’authentification
+ **Enregistrement d'application incorrect** — Vérifiez que l'enregistrement de l'application dans Microsoft Entra inclut les autorisations d'API requises et que le consentement de l'administrateur a été accordé.
+ **Secret client expiré** — Vérifiez si le secret client a expiré dans **Certificats et secrets** et générez-en un nouveau si nécessaire.
+ **URI de redirection incorrect** — Vérifiez que l'URI de redirection dans Microsoft Entra correspond`https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`.
### Messages d'erreur courants
+ **`Access denied. You do not have permission to perform this action`**— L'utilisateur authentifié ne dispose pas des autorisations requises. Contactez votre administrateur pour vérifier et accorder les autorisations appropriées.
+ **`AADSTS50020: User account from identity provider does not exist in tenant`**— Le compte utilisateur n'est pas configuré dans le client Microsoft Entra approprié. Vérifiez que le compte utilisateur existe chez le locataire qui correspond à l'ID du répertoire (tenant) indiqué lors de l'enregistrement de votre application.