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, consultezMéthodes d’authentification.
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
avec au moins les autorisations de développeur d'applications. -
Pour les conditions d'abonnement, voirConfiguration des intégrations dans la console.
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
Enregistrez l'application
-
Ouvrez le centre d'administration Microsoft Entra
. -
Dans le menu de navigation de gauche, choisissez Entra ID, puis sélectionnez Inscriptions d'applications.
-
Choisissez Nouvel enregistrement.
-
Dans Nom, entrez un nom descriptif pour votre intégration.
-
Pour les types de comptes pris en charge, sélectionnez Comptes uniquement dans ce répertoire d'organisation.
-
Pour l'URI de redirection, sélectionnez Web et entrez
https://. Remplacez{region}.quicksight.aws.amazon.com/sn/oauthcallback{region}par la AWS région dans laquelle votre instance Amazon Quick est déployée. -
Choisissez S’inscrire.
-
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.
-
Lors de l'enregistrement de votre application, sélectionnez Certificats et secrets.
-
Choisissez Nouveau secret client.
-
Entrez une description et choisissez une période d'expiration.
-
Choisissez Ajouter.
-
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
-
À partir de l'enregistrement de votre application, choisissez les autorisations d'API.
-
Choisissez Ajouter une autorisation, puis Microsoft Graph.
-
Choisissez Autorisations déléguées et ajoutez les autorisations dans le tableau ci-dessous.
-
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
| 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_access |
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.
| 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.
-
Dans la console Amazon Quick, choisissez Integrations.
-
Choisissez Microsoft OneDrive et cliquez sur le bouton Ajouter (plus « + »).
-
Choisissez l'onglet Actions.
-
Choisissez Exécuter des actions dans Microsoft OneDrive.
-
Renseignez les détails de l'intégration :
-
Nom : nom descriptif de votre OneDrive intégration.
-
Description (facultatif) — Objectif de l'intégration.
-
-
Renseignez les paramètres de connexion :
URL de base —
https://graph.microsoft.com/v1.0ID 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/tokenURL d'authentification —
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorizeURL de redirection —
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback
-
Choisissez Créer et continuer.
-
Choisissez les utilisateurs avec lesquels partager l'intégration.
-
Choisissez Suivant.
Actions disponibles
Après avoir configuré l'intégration, les actions suivantes sont disponibles.
| 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, consultezGestion des intégrations existantes.
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.
