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.
# OneDrive Connecteur Microsoft V1.0
Microsoft OneDrive est un service de stockage basé sur le cloud que vous pouvez utiliser pour stocker, partager et héberger votre contenu. Vous pouvez l'utiliser Amazon Kendra pour indexer votre source OneDrive de données Microsoft.
**Note**
Support pour le OneDrive connecteur V1.0/ l' OneDrive API Microsoft devrait prendre fin en juin 2023. Nous vous recommandons d'utiliser le OneDrive connecteur TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra OneDrive données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v1-onedrive)
+ [Conditions préalables](#prerequisites-v1-onedrive)
+ [Instructions de connexion](#data-source-v1-procedure-onedrive)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtres d’inclusion et d’exclusion
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de OneDrive données, apportez ces modifications à vos AWS comptes OneDrive and.
**Dans votre Azure Active Directory (AD), assurez-vous d'avoir :**
+ Créé une application Azure Active Directory (AD).
+ Utilisé l’ID de l’application AD pour enregistrer une clé secrète pour l’application sur le site AD. La clé secrète doit contenir l'ID de l'application et une clé secrète.
+ Copié le domaine AD de l’organisation.
+ Les autorisations d'application suivantes ont été ajoutées à votre application AD sur l'option Microsoft Graph :
+ Lire des fichiers dans toutes les collections de sites (File.Read.All)
+ Lire le profil complet de tous les utilisateurs (User.Read.All)
+ Lire les données du répertoire (Directory.Read.All)
+ Lire tous les groupes (Group.Read.All)
+ Lire des éléments dans toutes les collections du site (Site.Read.All)
+ Copie de la liste des utilisateurs dont les documents doivent être indexés. Vous pouvez choisir de fournir une liste de noms d'utilisateur ou de fournir les noms d'utilisateur dans un fichier stocké dans un Amazon S3. Après avoir créé la source de données, vous pouvez :
+ Modifiez la liste des utilisateurs.
+ Passez d'une liste d'utilisateurs à une liste stockée dans un Amazon S3 bucket.
+ Modifiez l'emplacement du Amazon S3 compartiment d'une liste d'utilisateurs. Si vous modifiez l'emplacement du compartiment, vous devez également mettre à jour le IAM rôle de la source de données afin qu'elle ait accès au compartiment.
**Note**
Si vous stockez la liste des noms d'utilisateur dans un Amazon S3 bucket, la IAM politique de la source de données doit fournir l'accès au bucket et l'accès à la clé avec laquelle le bucket a été chiffré, le cas échéant.
+ Il est vérifié que chaque document est unique dans OneDrive et entre les autres sources de données que vous prévoyez d'utiliser pour le même index. Chaque source de données que vous souhaitez utiliser pour un index ne doit pas contenir le même document dans toutes les sources de données. IDs Les documents sont globaux par rapport à un index et doivent être uniques par index.
**Dans votre Compte AWS, assurez-vous d'avoir :**
+ [Création d'un Amazon Kendra index](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) et, si vous utilisez l'API, notez l'ID de l'index.
+ Vous avez [créé un IAM rôle](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) pour votre source de données et, si vous utilisez l'API, notez l'ARN du IAM rôle.
**Note**
Si vous modifiez votre type d'authentification et vos informations d'identification, vous devez mettre à jour votre IAM rôle pour accéder au bon identifiant AWS Secrets Manager secret.
+ Stockez vos informations d' OneDrive authentification dans un AWS Secrets Manager secret et, si vous utilisez l'API, notez l'ARN du secret.
**Note**
Nous vous recommandons d’actualiser ou de modifier régulièrement vos informations d’identification et votre secret. Pour votre propre sécurité, fournissez uniquement le niveau d’accès nécessaire. Nous vous **déconseillons** de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).
Si vous n'avez pas de IAM rôle ou de secret existant, vous pouvez utiliser la console pour créer un nouveau IAM rôle et un nouveau Secrets Manager secret lorsque vous connectez votre source de OneDrive données à Amazon Kendra. Si vous utilisez l'API, vous devez fournir l'ARN d'un IAM rôle et d'un Secrets Manager secret existants, ainsi qu'un identifiant d'index.
## Instructions de connexion
Pour vous connecter Amazon Kendra à votre source de OneDrive données, vous devez fournir les détails de vos OneDrive informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré OneDrive pour Amazon Kendra voir[Conditions préalables](#prerequisites-v1-onedrive).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à OneDrive**
1. Connectez-vous à la [Amazon Kendra console AWS Management Console et ouvrez-la](https://console.aws.amazon.com/kendra/).
1. Dans le volet de navigation de gauche, choisissez **Index**, puis choisissez l'index que vous souhaitez utiliser dans la liste des index.
**Note**
Vous pouvez choisir de configurer ou de modifier vos paramètres de **contrôle d'accès utilisateur** dans les paramètres de **l'index**.
1. Sur la page de **démarrage**, choisissez **Ajouter une source de données**.
1. Sur la page **Ajouter une source de données**, choisissez **OneDrive connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **OneDrive connecteur** avec la balise « V2.0 ».
1. Sur la page **Spécifier les détails de la source de données**, entrez les informations suivantes :
1. Dans **Nom et description**, pour Nom de la **source de données** : entrez le nom de votre source de données. Vous pouvez inclure des traits d'union, mais pas des espaces.
1. (Facultatif) **Description** : entrez une description facultative pour votre source de données.
1. Dans la **langue par défaut** : choisissez une langue pour filtrer vos documents pour l'index. Sauf indication contraire, la langue par défaut est l'anglais. La langue spécifiée dans les métadonnées du document remplace la langue sélectionnée.
1. Dans **Balises**, pour **Ajouter une nouvelle balise** : incluez des balises facultatives pour rechercher et filtrer vos ressources ou suivre vos AWS coûts.
1. Choisissez **Suivant**.
1. Sur la page **Définir l'accès et la sécurité**, entrez les informations suivantes :
1. **OneDrive ID du locataire** —Entrez l'ID du OneDrive locataire sans le protocole.
1. **Type d'authentification** : choisissez entre **nouvelle** et **existante**.
1.
1. Si vous choisissez **Existant**, sélectionnez un secret existant pour **Sélectionner un secret**.
1. Si vous choisissez **Nouveau**, entrez les informations suivantes dans la section **Nouveau AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - OneDrive - » est automatiquement ajouté à votre nom secret.
1. Pour **l'ID** de l'**application et le mot de passe de** l'application : entrez les valeurs des informations d'authentification de votre OneDrive compte, puis choisissez **Enregistrer** l'authentification.
1. **IAM rôle** —Choisissez un IAM rôle existant ou créez-en un nouveau IAM pour accéder aux informations d'identification de votre référentiel et indexer le contenu.
**Note**
IAM les rôles utilisés pour les index ne peuvent pas être utilisés pour les sources de données. Si vous ne savez pas si un rôle existant est utilisé pour un index ou une FAQ, choisissez **Créer un nouveau rôle** pour éviter les erreurs.
1. Choisissez **Suivant**.
1. Sur la page **Configurer les paramètres de synchronisation**, entrez les informations suivantes :
1. Choisissez entre **le fichier de liste** et la **liste de noms** en fonction de votre cas d'utilisation.
1. Si vous choisissez **Fichier de liste**, entrez les informations suivantes :
1. **Sélectionnez l'emplacement** —Entrez le chemin d'accès à votre Amazon S3 compartiment.
**Ajouter un fichier de liste d'utilisateurs à Amazon S3** —Sélectionnez cette option pour ajouter vos fichiers de liste d'utilisateurs à votre Amazon S3 compartiment.
**Mappages de groupes locaux d'utilisateurs** : sélectionnez cette option pour utiliser le mappage de groupes locaux pour filtrer votre contenu.
1. Si vous choisissez la **liste des noms**, entrez les informations suivantes :
1. **Nom d'utilisateur** : entrez jusqu'à 10 lecteurs utilisateur à indexer. Pour ajouter plus de 10 utilisateurs, créez un fichier contenant les noms.
**Ajouter un autre** : choisissez d'ajouter d'autres utilisateurs.
**Mappages de groupes locaux d'utilisateurs** : sélectionnez cette option pour utiliser le mappage de groupes locaux pour filtrer votre contenu.
1. Pour les **configurations supplémentaires** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains fichiers. Vous pouvez ajouter jusqu’à 100 modèles.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : choisissez la fréquence de synchronisation avec votre source de données. Amazon Kendra
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Pour les **champs de source de données par défaut et les** **mappages de champs suggérés supplémentaires**, sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés que vous souhaitez mapper à votre index.
1. Choisissez **Suivant**.
1. Sur la page **Réviser et créer**, vérifiez que les informations saisies sont correctes, puis sélectionnez **Ajouter une source de données**. Vous pouvez également choisir de modifier vos informations à partir de cette page. Votre source de données apparaîtra sur la page **Sources de données** une fois que la source de données aura été ajoutée avec succès.
------
#### [ API ]
**Pour vous connecter Amazon Kendra à OneDrive**
Vous devez spécifier les éléments suivants à l'aide de l'[OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_OneDriveConfiguration.html)API :
+ **ID du locataire** : spécifiez le domaine Azure Active Directory de l'organisation.
+ **OneDrive Utilisateurs** : spécifiez la liste des comptes utilisateurs dont les documents doivent être indexés.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification de votre OneDrive compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "OAuth client ID",
"password": "client secret"
}
```
+ **IAM role** —Spécifiez le `RoleArn` moment où vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et d'appeler le public requis APIs pour le OneDrive connecteur et Amazon Kendra. Pour plus d'informations, consultez la section [IAM Rôles des sources de OneDrive données](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Filtres d'inclusion et d'exclusion** : indiquez si vous souhaitez inclure ou exclure certains documents.
**Note**
La plupart des sources de données utilisent des modèles d’expressions régulières, qui sont des modèles d’inclusion ou d’exclusion appelés filtres. Si vous spécifiez un filtre d’inclusion, seul le contenu correspondant au filtre d’inclusion est indexé. Tout document qui ne correspond pas au filtre d'inclusion n'est pas indexé. Si vous spécifiez un filtre d'inclusion et d'exclusion, les documents correspondant au filtre d'exclusion ne sont pas indexés, même s'ils correspondent au filtre d'inclusion.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de OneDrive données à vos champs d' Amazon Kendra index. Pour plus d’informations, consultez [Mappage des champs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Note**
Le champ du corps du document ou l'équivalent du corps du document pour vos documents est requis pour Amazon Kendra effectuer une recherche dans vos documents. Vous devez associer le nom du champ du corps du document dans votre source de données au nom du champ d'index`_document_body`. Tous les autres champs sont facultatifs.
+ **Filtrage du contexte utilisateur et contrôle d'accès**Amazon Kendra : analyse la liste de contrôle d'accès (ACL) de vos documents, si vous disposez d'une ACL pour vos documents. Les informations ACL sont utilisées pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Pour plus d'informations, consultez la section [Filtrage du contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------