. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Une liste d’objets qui mappent les attributs ou les noms de champs de vos fichiers Drupal. Pour plus d’informations, consultez [Mappage des champs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Les noms des champs de source de données Drupal doivent figurer dans vos métadonnées personnalisées Drupal. |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Une liste des modèles d’expression régulière pour inclure certains fichiers dans votre source de données Drupal. Les fichiers qui correspondent aux modèles sont inclus dans l’index. Les fichiers qui ne correspondent pas aux modèles sont exclus de l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Une liste des modèles d’expression régulière pour exclure certains fichiers de votre source de données Drupal. Les fichiers qui correspondent aux modèles sont exclus de l’index. Les fichiers qui ne correspondent pas aux modèles sont inclus dans l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| contentDefinitions[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Spécifiez les types de contenu à indexer et indiquez si vous souhaitez indexer les commentaires et les pièces jointes pour les types de contenu que vous avez sélectionnés. |
| type | Type de la source de données. Spécifiez DRUPAL comme type de source de données. |
| authType | Le type d’authentification que vous utilisez, BASIC-AUTH ou OAUTH2. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| enableIdentityCrawler | trueutiliser Amazon Kendra le moteur de recherche d'identité pour synchroniser les identity/principal informations relatives aux utilisateurs et aux groupes ayant accès à certains documents. Si Identity Crawler est désactivé, tous les documents peuvent être consultés publiquement. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'[https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes. |
| secretARN | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret qui contient les paires clé-valeur requises pour se connecter à votre Drupal. Le secret doit contenir une structure JSON avec les clés suivantes : **Si vous utilisez l’authentification basique :**{
"username": "user name",
"passwords": "password"
} **Si vous utilisez l'authentification OAuth 2.0 :**{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
} |
| version | La version de ce modèle qui est actuellement prise en charge. |
### Schéma JSON Drupal
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"hostUrl": {
"type": "string",
"pattern": "https:.*"
}
},
"required": [
"hostUrl"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"content": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"comment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"attachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties": {
"isCrawlArticle": {
"type": "boolean"
},
"isCrawlBasicPage": {
"type": "boolean"
},
"isCrawlBasicBlock": {
"type": "boolean"
},
"crawlCustomContentTypesList": {
"type": "array",
"items": {
"type": "string"
}
},
"crawlCustomBlockTypesList": {
"type": "array",
"items": {
"type": "string"
}
},
"filePath": {
"anyOf": [
{
"type": "string",
"pattern": "s3:.*"
},
{
"type": "string",
"pattern": ""
}
]
},
"inclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"articleTitleInclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"articleTitleExclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"pageTitleInclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"pageTitleExclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"customContentTitleInclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"customContentTitleExclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"basicBlockTitleInclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"basicBlockTitleExclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"customBlockTitleInclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"customBlockTitleExclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"contentDefinitions": {
"type": "array",
"items": {
"properties": {
"contentType": {
"type": "string"
},
"fieldDefinition": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"machineName": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"machineName",
"type"
]
}
]
},
"isCrawlComments": {
"type": "boolean"
},
"isCrawlFiles": {
"type": "boolean"
}
}
},
"required": [
"contentType",
"fieldDefinition",
"isCrawlComments",
"isCrawlFiles"
]
}
},
"required": []
},
"type": {
"type": "string",
"pattern": "DRUPAL"
},
"authType": {
"type": "string",
"enum": [
"BASIC-AUTH",
"OAUTH2"
]
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"enableIdentityCrawler": {
"type": "boolean"
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## GitHub schéma de modèle
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)objet. Vous indiquez l'URL de l' GitHub hôte, le nom de l'organisation et indiquez si vous utilisez le GitHub GitHub cloud ou sur site dans le cadre de la configuration de la connexion ou des détails du point de terminaison du référentiel. Spécifiez également le type de source de données`GITHUB`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [GitHub Schéma JSON](#github-json).
Le tableau suivant décrit les paramètres du schéma GitHub JSON.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de point de terminaison pour la source de données. |
| type | Spécifiez le type comme suit : SAAS ouON\$1PREMISE. |
| hostUrl | URL de l' GitHub hôte. Par exemple, si vous utilisez le GitHub SaaS/Enterprise Cloud :. https://api.github.com Ou, si vous utilisez un serveur GitHub local ou d'entreprise :. https://on-prem-host-url/api/v3/ |
| organizationName | Vous pouvez trouver le nom de votre organisation lorsque vous vous connectez à votre GitHub ordinateur de bureau et que vous accédez à Vos organisations dans le menu déroulant de votre photo de profil. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste d'objets qui mappent les attributs ou les noms de champs de votre GitHub contenu aux noms de 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). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données. |
| isCrawlAcl | truepour analyser les informations de la liste de contrôle d'accès (ACL) de vos documents, si vous possédez une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder et effectuer des recherches. 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#context-filter-user-incl-datasources). |
| fieldForUserId | Spécifiez le type d'ID utilisateur que vous souhaitez utiliser pour l'analyse des ACL. Spécifiez email si vous souhaitez utiliser l'adresse e-mail de l'utilisateur comme ID utilisateur ou username si vous souhaitez utiliser le nom d'utilisateur pour l'ID utilisateur. Si vous ne spécifiez aucune option, elle email est utilisée par défaut. |
| repositoryFilter | Liste des noms des référentiels et noms de branches spécifiques que vous souhaitez indexer. |
| Référentiel Crawl | truepour explorer les référentiels. |
| crawlRepositoryDocuments | truepour explorer les documents du référentiel. |
| Problème Crawlish | trueaux problèmes de crawl. |
| crawlIssueComment | truepour explorer les commentaires des problèmes. |
| crawlIssueCommentPièce jointe | truepour explorer les pièces jointes aux commentaires des problèmes. |
| crawlPullRequest | truepour explorer les pull requests. |
| crawlPullRequestCommentaire | truepour explorer les commentaires des pull requests. |
| crawlPullRequestCommentAttachment | truepour explorer les pièces jointes aux commentaires de la pull request. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières permettant d'inclure certains contenus dans votre source de GitHub données. Le contenu qui correspond aux modèles est inclus dans l’index. Le contenu qui ne correspond pas aux modèles est exclu de l’index. Si un contenu correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le contenu n’est pas inclus dans l’index. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières permettant d'exclure certains contenus de votre source de GitHub données. Le contenu qui correspond aux modèles est exclu de l’index. Le contenu qui ne correspond pas aux modèles est inclus dans l’index. Si un contenu correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le contenu n’est pas inclus dans l’index. |
| type | Type de la source de données. Spécifiez GITHUB comme type de source de données. |
| enableIdentityCrawler | trueutiliser Amazon Kendra le moteur de recherche d'identité pour synchroniser les identity/principal informations relatives aux utilisateurs et aux groupes ayant accès à certains documents. Si Identity Crawler est désactivé, tous les documents peuvent être consultés publiquement. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'[https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| secretArn | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret contenant les paires clé-valeur requises pour se connecter à votre. GitHub Le secret doit contenir une structure JSON avec les clés suivantes : {
"personalToken": "token"
} |
| version | La version de ce modèle actuellement prise en charge. |
### GitHub Schéma JSON
Le schéma GitHub JSON est le suivant :
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"hostUrl": {
"type": "string",
"pattern": "https://.*"
},
"organizationName": {
"type": "string"
}
},
"required": [
"type",
"hostUrl",
"organizationName"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"ghRepository": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"ghCommit": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"ghIssueDocument": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"ghIssueComment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"ghIssueAttachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"ghPRDocument": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"ghPRComment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"ghPRAttachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties": {
"isCrawlAcl": {
"type": "boolean"
},
"fieldForUserId": {
"type": "string"
},
"crawlRepository": {
"type": "boolean"
},
"crawlRepositoryDocuments": {
"type": "boolean"
},
"crawlIssue": {
"type": "boolean"
},
"crawlIssueComment": {
"type": "boolean"
},
"crawlIssueCommentAttachment": {
"type": "boolean"
},
"crawlPullRequest": {
"type": "boolean"
},
"crawlPullRequestComment": {
"type": "boolean"
},
"crawlPullRequestCommentAttachment": {
"type": "boolean"
},
"repositoryFilter": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"repositoryName": {
"type": "string"
},
"branchNameList": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
]
},
"inclusionFolderNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFolderNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": []
},
"type": {
"type": "string",
"pattern": "GITHUB"
},
"syncMode": {
"type": "string",
"enum": [
"FULL_CRAWL",
"FORCED_FULL_CRAWL",
"CHANGE_LOG"
]
},
"enableIdentityCrawler": {
"type": "boolean"
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"enableIdentityCrawler"
]
}
```
## Schéma du modèle Gmail
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Spécifiez le type de source de données`GMAIL`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma JSON Gmail](#gmail-json).
Le tableau suivant décrit les paramètres du schéma JSON Gmail.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de point de terminaison pour la source de données. Cette source de données ne spécifie pas de point de terminaison dansrepositoryEndpointMetadata. Les informations de connexion sont plutôt incluses dans un AWS Secrets Manager secret que vous fournissezsecretArn. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. Spécifiez le type de source de données et l’ARN secret. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste d'objets qui mappent les attributs ou les noms de champs de vos messages Gmail et de vos pièces jointes aux noms de 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). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières permettant d'inclure ou d'exclure des messages portant des noms d'objet spécifiques dans votre source de données Gmail. Les fichiers qui correspondent aux modèles sont inclus dans l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| beforeDateFilter | Spécifiez les messages et les pièces jointes à inclure avant une certaine date. |
| afterDateFilter | Spécifiez les messages et les pièces jointes à inclure après une certaine date. |
| isCrawlAttachment | Valeur booléenne permettant de choisir si vous souhaitez indexer les pièces jointes. Les messages sont automatiquement indexés. |
| type | Type de la source de données. Spécifiez GMAIL comme type de source de données. |
| shouldCrawlDraftMessages | Valeur booléenne permettant de choisir si vous souhaitez indexer les brouillons de messages. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) Comme il n'existe aucune API permettant de mettre à jour les messages Gmail définitivement supprimés, tout contenu nouveau, modifié ou supprimé est synchronisé : Ne supprimera pas de votre Amazon Kendra index les messages définitivement supprimés de Gmail Ne synchronisera pas les modifications dans les libellés des e-mails Gmail Pour synchroniser les modifications apportées à l'étiquette de votre source de données Gmail et les e-mails définitivement supprimés avec votre Amazon Kendra index, vous devez effectuer régulièrement des analyses complètes. |
| secretARN | Le nom de ressource Amazon (ARN) d'un secret de Secrets Manager qui contient les paires clé-valeur requises pour se connecter à votre compte Gmail. Le secret doit contenir une structure JSON avec les clés suivantes : {
"adminAccountEmailId": "service account email",
"clientEmailId": "user account email",
"privateKey": "private key"
} |
| version | La version du modèle actuellement prise en charge. |
### Schéma JSON Gmail
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
}
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"message": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"attachments": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING"]
},
"dataSourceFieldName": {
"type": "string"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
}
},
"required": []
},
"additionalProperties": {
"type": "object",
"properties": {
"inclusionLabelNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionLabelNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionAttachmentTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionAttachmentTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionAttachmentNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionAttachmentNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionSubjectFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionSubjectFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"isSubjectAnd": {
"type": "boolean"
},
"inclusionFromFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFromFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionToFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionToFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionCcFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionCcFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionBccFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionBccFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"beforeDateFilter": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
},
{
"type": "string",
"pattern": ""
}
]
},
"afterDateFilter": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
},
{
"type": "string",
"pattern": ""
}
]
},
"isCrawlAttachment": {
"type": "boolean"
},
"shouldCrawlDraftMessages": {
"type": "boolean"
}
},
"required": [
"isCrawlAttachment",
"shouldCrawlDraftMessages"
]
},
"type" : {
"type" : "string",
"pattern": "GMAIL"
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL"
]
},
"secretArn": {
"type": "string"
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
}
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"additionalProperties",
"syncMode",
"secretArn",
"type"
]
}
```
## Schéma du modèle Google Drive
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Spécifiez le type de source de données`GOOGLEDRIVE2`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma JSON Google Drive](#googledrive-json).
Le tableau suivant décrit les paramètres du schéma JSON de Google Drive.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration pour la source de données. |
| repositoryEndpointMetadata | Informations de point de terminaison pour la source de données. Cette source de données ne spécifie pas de point de terminaison. Vous choisissez votre type d’authentification : serviceAccount et OAuth2. Les informations de connexion sont incluses dans un AWS Secrets Manager secret que vous fournissezsecretArn. |
| authType | Choisissez entre serviceAccount et OAuth2 en fonction de votre cas d'utilisation. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste d'objets qui associent les attributs ou les noms de champs de votre Google Drive à des noms de 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). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Spécifiez une limite de taille MBs de Amazon Kendra fichier à analyser. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | truepour analyser les commentaires dans votre source de données Google Drive. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | truepour explorer MyDrive et partager des disques avec moi dans votre source de données Google Drive. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | truepour explorer les lecteurs partagés dans votre source de données Google Drive. |
| isCrawlAcl | truepour analyser les informations de la liste de contrôle d'accès (ACL) de vos documents, si vous possédez une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder et effectuer des recherches. 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#context-filter-user-incl-datasources). |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières permettant d'exclure certains fichiers de votre source de données Google Drive. Les fichiers qui correspondent aux modèles sont exclus de l’index. Les fichiers qui ne correspondent pas aux modèles sont inclus dans l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières permettant d'inclure certains fichiers dans votre source de données Google Drive. Les fichiers qui correspondent aux modèles sont inclus dans l’index. Les fichiers qui ne correspondent pas aux modèles sont exclus de l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| type | Type de la source de données. Spécifiez GOOOGLEDRIVEV2 comme type de source de données. |
| enableIdentityCrawler | trueutiliser Amazon Kendra le moteur de recherche d'identité pour synchroniser les identity/principal informations relatives aux utilisateurs et aux groupes ayant accès à certains documents. Si Identity Crawler est désactivé, tous les documents peuvent être consultés publiquement. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'[https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| secretARN | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret qui contient les paires clé-valeur requises pour se connecter à votre Google Drive. Le secret doit contenir une structure JSON avec les clés suivantes : ****Si vous utilisez l'authentification par compte de service Google :{
"clientEmail": "user account email",
"adminAccountEmail": "service account email",
"privateKey": "private key"
} ****Si vous utilisez l'authentification OAuth 2.0 : {
"clientID": "OAuth client ID",
"clientSecret": "client secret",
"refreshToken": "refresh token"
} |
| version | La version de ce modèle qui est actuellement prise en charge. |
### Schéma JSON Google Drive
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"authType": {
"type": "string",
"enum": [
"serviceAccount",
"OAuth2"
]
}
},
"required": [
"authType"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"file": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"STRING_LIST",
"LONG"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"comment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"STRING_LIST"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties": {
"maxFileSizeInMegaBytes": {
"type": "string"
},
"isCrawlComment": {
"type": "boolean"
},
"isCrawlMyDriveAndSharedWithMe": {
"type": "boolean"
},
"isCrawlSharedDrives": {
"type": "boolean"
},
"isCrawlAcl": {
"type": "boolean"
},
"excludeUserAccounts": {
"type": "array",
"items": {
"type": "string"
}
},
"excludeSharedDrives": {
"type": "array",
"items": {
"type": "string"
}
},
"excludeMimeTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"includeUserAccounts": {
"type": "array",
"items": {
"type": "string"
}
},
"includeSharedDrives": {
"type": "array",
"items": {
"type": "string"
}
},
"includeMimeTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"includeTargetAudienceGroup": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFilePathFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFilePathFilter": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"type": {
"type": "string",
"pattern": "GOOGLEDRIVEV2"
},
"enableIdentityCrawler": {
"type": "boolean"
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Schéma DB2 du modèle IBM
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Spécifiez le type de source de données`JDBC`, le type de base de données`db2`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma IBM DB2 JSON](#ibm-db2-json).
Le tableau suivant décrit les paramètres du schéma IBM DB2 JSON.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de configuration requises pour la connexion de votre source de données.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. Spécifiez le type de source de données et l’ARN secret. |
| document | Liste d'objets qui mappent les attributs ou les noms de champs du contenu de votre base de données aux noms de 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). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données. Utilisez ce champ pour inclure ou exclure du contenu spécifique dans la source de données de votre base de données. |
| primaryKey | Indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données. |
| titleColumn | Indiquez le nom de la colonne de titre du document dans votre table de base de données. |
| bodyColumn | Indiquez le nom de la colonne de titre du document dans votre table de base de données. |
| sqlQuery | Saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra analysera tout le contenu de la base de données correspondant à votre requête. |
| timestampColumn | Entrez le nom de la colonne contenant les horodatages. Amazon Kendra utilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié. |
| timestampFormat | Saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu. |
| timezone | Saisissez le nom de la colonne contenant les fuseaux horaires du contenu à indexer. |
| changeDetectingColumns | Entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendra réindexera le contenu en cas de modification de l'une de ces colonnes |
| allowedUsersColumns | Entrez le nom de la colonne contenant l'utilisateur devant IDs être autorisé à accéder au contenu. |
| allowedGroupsColumn | Entrez le nom de la colonne contenant l'utilisateur devant IDs être autorisé à accéder au contenu. |
| source URIColumn | Entrez le nom de la colonne contenant la source URLs à indexer. |
| isSslEnabled | Saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra analysera tout le contenu de la base de données correspondant à votre requête. |
| type | Type de la source de données. Spécifiez JDBC comme type de source de données. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| secretArn | L’Amazon Resource Name (ARN) d’un secret Secrets Manager qui contient le nom d’utilisateur et le mot de passe requis pour la connexion à votre base de données. Le secret doit contenir une structure JSON avec les clés suivantes : {
"user name": "database user name",
"password": "password"
} |
| version | La version du modèle actuellement prise en charge. |
### Schéma IBM DB2 JSON
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"dbType": {
"type": "string",
"enum": [
"mysql",
"db2",
"postgresql",
"oracle",
"sqlserver"
]
},
"dbHost": {
"type": "string"
},
"dbPort": {
"type": "string"
},
"dbInstance": {
"type": "string"
}
},
"required": [
"dbType",
"dbHost",
"dbPort",
"dbInstance"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"document": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string"
},
"dataSourceFieldName": {
"type": "string"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
},
"required": [
]
},
"additionalProperties": {
"type": "object",
"properties": {
"primaryKey": {
"type": "string"
},
"titleColumn": {
"type": "string"
},
"bodyColumn": {
"type": "string"
},
"sqlQuery": {
"type": "string",
"not": {
"pattern": ";+"
}
},
"timestampColumn": {
"type": "string"
},
"timestampFormat": {
"type": "string"
},
"timezone": {
"type": "string"
},
"changeDetectingColumns": {
"type": "array",
"items": {
"type": "string"
}
},
"allowedUsersColumn": {
"type": "string"
},
"allowedGroupsColumn": {
"type": "string"
},
"sourceURIColumn": {
"type": "string"
},
"isSslEnabled": {
"type": "boolean"
}
},
"required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"]
},
"type" : {
"type" : "string",
"pattern": "JDBC"
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string"
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Schéma du modèle Microsoft Exchange
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Vous fournissez l'ID du locataire dans le cadre de la configuration de la connexion ou des détails du point de terminaison du référentiel. Spécifiez également le type de source de données`MSEXCHANGE`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma Microsoft Exchange JSON](#msexchange-json).
Le tableau suivant décrit les paramètres du schéma Microsoft Exchange JSON.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de point de terminaison pour la source de données. |
| Identifiant du locataire | ID de locataire Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste d'objets qui mappent les attributs ou les noms de champs de votre source de données Microsoft Exchange à des 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). |
| additionalProperties | Options de configuration supplémentaires pour le contenu dans votre source de données |
| Modèles d'inclusion | Liste de modèles d'expressions régulières permettant d'inclure certains fichiers dans votre source de données Microsoft Exchange. Les fichiers qui correspondent aux modèles sont inclus dans l’index. Les fichiers qui ne correspondent pas aux modèles sont exclus de l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| Schémas d'exclusion | Liste de modèles d'expressions régulières permettant d'exclure certains fichiers de votre source de données Microsoft Exchange. Les fichiers qui correspondent aux modèles sont exclus de l’index. Les fichiers qui ne correspondent pas aux modèles sont inclus dans l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières permettant d'inclure certains utilisateurs et fichiers utilisateur dans votre source de données Microsoft Exchange. Les utilisateurs qui correspondent aux modèles sont inclus dans l'index. Les utilisateurs qui ne correspondent pas aux modèles sont exclus de l'index. Si un utilisateur correspond à la fois à un modèle d'inclusion et à un modèle d'exclusion, le modèle d'exclusion est prioritaire et l'utilisateur n'est pas inclus dans l'index. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières permettant d'exclure certains utilisateurs et fichiers utilisateur de votre source de données Microsoft Exchange. Les utilisateurs qui correspondent aux modèles sont exclus de l'index. Les utilisateurs qui ne correspondent pas aux modèles sont inclus dans l'index. Si un utilisateur correspond à la fois à un modèle d'exclusion et à un modèle d'inclusion, le modèle d'exclusion est prioritaire et l'utilisateur n'est pas inclus dans l'index. |
| Nom du compartiment S3 | Le nom de votre compartiment S3 si vous souhaitez l'utiliser. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | truepour analyser ces types de contenu et d'informations de contrôle d'accès dans votre source de données Microsoft Exchange. |
| startCalendarDateHeure | Vous pouvez configurer une date et une heure de début spécifiques pour le contenu de votre calendrier. |
| endCalendarDateHeure | Vous pouvez configurer une date et une heure de fin spécifiques pour le contenu du calendrier. |
| subject | Vous pouvez configurer une ligne d'objet spécifique pour le contenu de votre e-mail. |
| Courrier électronique de | Vous pouvez configurer un e-mail spécifique pour le contenu de votre « expéditeur » ou du courrier de l'expéditeur. |
| Envoyer un e-mail à | Vous pouvez configurer un e-mail spécifique pour le contenu de votre message « À » ou du message du destinataire. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| type | Type de la source de données. Spécifiez MSEXCHANGE comme type de source de données. |
| secretARN | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret qui contient les paires clé-valeur requises pour se connecter à votre Microsoft Exchange. Cela inclut votre ID client et votre secret client générés lorsque vous créez une OAuth application sur le portail Azure. |
| version | La version de ce modèle qui est actuellement prise en charge. |
### Schéma Microsoft Exchange JSON
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"tenantId": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"minLength": 36,
"maxLength": 36
}
},
"required": ["tenantId"]
}
}
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"email": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"attachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "DATE","LONG"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"calendar": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"contacts": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"notes": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
},
"required": ["email"
]
},
"additionalProperties": {
"type": "object",
"properties": {
"inclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionUsersList": {
"type": "array",
"items": {
"type": "string",
"format": "email"
}
},
"exclusionUsersList": {
"type": "array",
"items": {
"type": "string",
"format": "email"
}
},
"s3bucketName": {
"type": "string"
},
"inclusionUsersFileName": {
"type": "string"
},
"exclusionUsersFileName": {
"type": "string"
},
"inclusionDomainUsers": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionDomainUsers": {
"type": "array",
"items": {
"type": "string"
}
},
"crawlCalendar": {
"type": "boolean"
},
"crawlNotes": {
"type": "boolean"
},
"crawlContacts": {
"type": "boolean"
},
"crawlFolderAcl": {
"type": "boolean"
},
"startCalendarDateTime": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
},
{
"type": "string",
"pattern": ""
}
]
},
"endCalendarDateTime": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
},
{
"type": "string",
"pattern": ""
}
]
},
"subject": {
"type": "array",
"items": {
"type": "string"
}
},
"emailFrom": {
"type": "array",
"items": {
"type": "string",
"format": "email"
}
},
"emailTo": {
"type": "array",
"items": {
"type": "string",
"format": "email"
}
}
},
"required": [
]
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"type" : {
"type" : "string",
"pattern": "MSEXCHANGE"
},
"secretArn": {
"type": "string"
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Schéma OneDrive de modèle Microsoft
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Vous fournissez l'ID du locataire dans le cadre de la configuration de la connexion ou des détails du point de terminaison du référentiel. Spécifiez également le type de source de données et un secret pour vos informations d'authentification, ainsi que les autres configurations nécessaires. `ONEDRIVEV2` Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma Microsoft OneDrive JSON](#onedrive-json).
Le tableau suivant décrit les paramètres du schéma Microsoft OneDrive JSON.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de point de terminaison pour la source de données. |
| Identifiant du locataire | ID de locataire Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. |
| dans le fichier | Liste d'objets qui mappent les attributs ou les noms de champs de vos OneDrive fichiers Microsoft aux noms de 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). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Vous pouvez choisir d'indexer des fichiers, des OneNote sections, des OneNote pages spécifiques et de filtrer par nom d'utilisateur. |
| isUserNamesur S3 | true pour fournir une liste de noms d’utilisateur dans un fichier stocké dans un Amazon S3. |
| type | Type de la source de données. Spécifiez ONEDRIVEV2 comme type de source de données. |
| enableIdentityCrawler | trueutiliser Amazon Kendra le moteur de recherche d'identité pour synchroniser les identity/principal informations relatives aux utilisateurs et aux groupes ayant accès à certains documents. Si Identity Crawler est désactivé, tous les documents peuvent être consultés publiquement. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'[https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes. |
| type | Type de la source de données. Spécifiez ONEDRIVEV2 comme type de source de données. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| secretARN | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret qui contient les paires clé-valeur requises pour se connecter à votre Microsoft. OneDrive Le secret doit contenir une structure JSON avec les clés suivantes : {
"clientId": "client ID",
"clientSecret": "client secret"
} |
| version | La version de ce modèle qui est actuellement prise en charge. |
### Schéma Microsoft OneDrive JSON
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"tenantId": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"minLength": 36,
"maxLength": 36
}
},
"required": [
"tenantId"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"file": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties": {
"userNameFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"userFilterPath": {
"type": "string"
},
"isUserNameOnS3": {
"type": "boolean"
},
"inclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFilePathPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFilePathPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionOneNoteSectionNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionOneNoteSectionNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionOneNotePageNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionOneNotePageNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": []
},
"enableIdentityCrawler": {
"type": "boolean"
},
"type": {
"type": "string",
"pattern": "ONEDRIVEV2"
},
"syncMode": {
"type": "string",
"enum": [
"FULL_CRAWL",
"FORCED_FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Schéma SharePoint de modèle Microsoft
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)l'objet. Vous fournissez l'URL du SharePoint siteURLs, le domaine et également un ID de locataire si nécessaire dans le cadre de la configuration de la connexion ou des détails du point de terminaison du référentiel. Spécifiez également le type de source de données`SHAREPOINTV2`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous le spécifiez ensuite `TEMPLATE` comme **type** lorsque vous appelez [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [SharePoint Schéma JSON](#sharepoint-json).
Le tableau suivant décrit les paramètres du schéma Microsoft SharePoint JSON.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données |
| repositoryEndpointMetadata | Informations sur le point de terminaison pour la source de données |
| Identifiant du locataire | L'identifiant du locataire de votre SharePoint compte. |
| domaine | Le domaine de votre SharePoint compte. |
| URL du site | L'hébergeur URLs de votre SharePoint compte. |
| repositoryAdditionalProperties | Propriétés supplémentaires pour se connecter au point de terminaison repository/data source. |
| Nom du compartiment S3 | Nom du Amazon S3 compartiment qui stocke votre certificat X.509 autosigné Azure AD. |
| Nom du certificat S3 | Le nom du certificat X.509 autosigné Azure AD stocké dans votre Amazon S3 compartiment. |
| authType | Le type d'authentification que vous utilisez, que ce soit OAuth2 OAuth2CertificateOAuth2App,Basic,OAuth2\$1RefreshToken,NTLM, ouKerberos. |
| version | La SharePoint version que vous utilisez, que ce soit Server ouOnline. |
| onPremVersion | La version SharePoint du serveur que vous utilisez, que ce soit 2013 20162019, ouSubscriptionEdition. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste d'objets qui mappent les attributs ou les noms de champs de votre SharePoint contenu aux noms de 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). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières pour include/exclude certains contenus de votre source de SharePoint données. Les éléments de contenu qui correspondent aux modèles d'inclusion sont inclus dans l'index. Les éléments de contenu qui ne correspondent pas aux modèles d'inclusion sont exclus de l'index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | truepour explorer ces types de contenu. |
| CrawlacL | truepour analyser les informations de la liste de contrôle d'accès (ACL) de vos documents, si vous possédez une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder et effectuer des recherches. 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#context-filter-user-incl-datasources). |
| fieldForUserId | Spécifiez email si vous souhaitez utiliser l'adresse e-mail de l'utilisateur comme ID utilisateur ou userPrincipalName si vous souhaitez utiliser un nom d'utilisateur pour l'ID utilisateur. Si vous ne spécifiez aucune option, elle email est utilisée par défaut. |
| Configuration de l'ACL | Spécifiez soit ACLWithLDAPEmailFmtACLWithManualEmailFmt, soitACLWithUsernameFmtM. |
| Domaine de courrier électronique | Le domaine de l'e-mail. Par exemple, « amazon.com ». |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | truepour analyser les informations de mappage des groupes. |
| Hôte proxy | Le nom d'hôte du proxy Web que vous utilisez, sans le protocole http ://ou https ://. |
| Port proxy | Numéro de port utilisé par le protocole de transport d'URL de l'hôte. Il doit s'agir d'une valeur numérique comprise entre 0 et 65535. |
| type | Spécifiez SHAREPOINTV2 comme type de source de données |
| enableIdentityCrawler | trueutiliser Amazon Kendra le moteur de recherche d'identité pour synchroniser les identity/principal informations relatives aux utilisateurs et aux groupes ayant accès à certains documents. Si Identity Crawler est désactivé, tous les documents peuvent être consultés publiquement. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'[https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| secretARN | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret contenant les paires clé-valeur requises pour se connecter à votre. SharePoint Pour plus d'informations sur ces paires clé-valeur, consultez les [instructions de connexion pour SharePoint Online et SharePoint Server](https://docs.aws.amazon.com/kendra/latest/dg/data-source-v2-sharepoint.html#data-source-procedure-v2-sharepoint). |
| version | La version de ce modèle qui est actuellement prise en charge. |
## SharePoint Schéma JSON
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"tenantId": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"minLength": 36,
"maxLength": 36
},
"domain": {
"type": "string"
},
"siteUrls": {
"type": "array",
"items": {
"type": "string",
"pattern": "https://.*"
}
},
"repositoryAdditionalProperties": {
"type": "object",
"properties": {
"s3bucketName": {
"type": "string"
},
"s3certificateName": {
"type": "string"
},
"authType": {
"type": "string",
"enum": [
"OAuth2",
"OAuth2Certificate",
"OAuth2App",
"Basic",
"OAuth2_RefreshToken",
"NTLM",
"Kerberos"
]
},
"version": {
"type": "string",
"enum": [
"Server",
"Online"
]
},
"onPremVersion": {
"type": "string",
"enum": [
"",
"2013",
"2016",
"2019",
"SubscriptionEdition"
]
}
},
"required": [
"authType",
"version"
]
}
},
"required": [
"siteUrls",
"domain",
"repositoryAdditionalProperties"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"event": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"page": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"LONG"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"file": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"LONG"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"link": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"attachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"comment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties": {
"eventTitleFilterRegEx": {
"type": "array",
"items": {
"type": "string"
}
},
"pageTitleFilterRegEx": {
"type": "array",
"items": {
"type": "string"
}
},
"linkTitleFilterRegEx": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFilePath": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFilePath": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionOneNoteSectionNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionOneNoteSectionNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionOneNotePageNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionOneNotePageNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"crawlFiles": {
"type": "boolean"
},
"crawlPages": {
"type": "boolean"
},
"crawlEvents": {
"type": "boolean"
},
"crawlComments": {
"type": "boolean"
},
"crawlLinks": {
"type": "boolean"
},
"crawlAttachments": {
"type": "boolean"
},
"crawlListData": {
"type": "boolean"
},
"crawlAcl": {
"type": "boolean"
},
"fieldForUserId": {
"type": "string"
},
"aclConfiguration": {
"type": "string",
"enum": [
"ACLWithLDAPEmailFmt",
"ACLWithManualEmailFmt",
"ACLWithUsernameFmt"
]
},
"emailDomain": {
"type": "string"
},
"isCrawlLocalGroupMapping": {
"type": "boolean"
},
"isCrawlAdGroupMapping": {
"type": "boolean"
},
"proxyHost": {
"type": "string"
},
"proxyPort": {
"type": "string"
}
},
"required": [
]
},
"type": {
"type": "string",
"pattern": "SHAREPOINTV2"
},
"enableIdentityCrawler": {
"type": "boolean"
},
"syncMode": {
"type": "string",
"enum": [
"FULL_CRAWL",
"FORCED_FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"enableIdentityCrawler",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Schéma de modèle Microsoft SQL Server
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Spécifiez le type de source de données`JDBC`, le type de base de données`sqlserver`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma JSON de Microsoft SQL Server](#ms-sql-server-json).
Le tableau suivant décrit les paramètres du schéma JSON de Microsoft SQL Server.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de configuration requises pour la connexion de votre source de données.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. Spécifiez le type de source de données et l’ARN secret. |
| document | Liste d'objets qui mappent les attributs ou les noms de champs du contenu de votre base de données aux noms de 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). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données. Utilisez ce champ pour inclure ou exclure du contenu spécifique dans la source de données de votre base de données. |
| primaryKey | Indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données. |
| titleColumn | Indiquez le nom de la colonne de titre du document dans votre table de base de données. |
| bodyColumn | Indiquez le nom de la colonne de titre du document dans votre table de base de données. |
| sqlQuery | Saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra analysera tout le contenu de la base de données correspondant à votre requête. |
| timestampColumn | Entrez le nom de la colonne contenant les horodatages. Amazon Kendra utilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié. |
| timestampFormat | Saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu. |
| timezone | Saisissez le nom de la colonne contenant les fuseaux horaires du contenu à indexer. |
| changeDetectingColumns | Entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendra réindexera le contenu en cas de modification de l'une de ces colonnes |
| allowedUsersColumns | Entrez le nom de la colonne contenant l'utilisateur devant IDs être autorisé à accéder au contenu. |
| allowedGroupsColumn | Entrez le nom de la colonne contenant l'utilisateur devant IDs être autorisé à accéder au contenu. |
| source URIColumn | Entrez le nom de la colonne contenant la source URLs à indexer. |
| isSslEnabled | Saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra analysera tout le contenu de la base de données correspondant à votre requête. |
| type | Type de la source de données. Spécifiez JDBC comme type de source de données. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| secretArn | L’Amazon Resource Name (ARN) d’un secret Secrets Manager qui contient le nom d’utilisateur et le mot de passe requis pour la connexion à votre base de données. Le secret doit contenir une structure JSON avec les clés suivantes : {
"user name": "database user name",
"password": "password"
} |
| version | La version du modèle actuellement prise en charge. |
### Schéma JSON de Microsoft SQL Server
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"dbType": {
"type": "string",
"enum": [
"mysql",
"db2",
"postgresql",
"oracle",
"sqlserver"
]
},
"dbHost": {
"type": "string"
},
"dbPort": {
"type": "string"
},
"dbInstance": {
"type": "string"
}
},
"required": [
"dbType",
"dbHost",
"dbPort",
"dbInstance"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"document": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string"
},
"dataSourceFieldName": {
"type": "string"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
},
"required": [
]
},
"additionalProperties": {
"type": "object",
"properties": {
"primaryKey": {
"type": "string"
},
"titleColumn": {
"type": "string"
},
"bodyColumn": {
"type": "string"
},
"sqlQuery": {
"type": "string",
"not": {
"pattern": ";+"
}
},
"timestampColumn": {
"type": "string"
},
"timestampFormat": {
"type": "string"
},
"timezone": {
"type": "string"
},
"changeDetectingColumns": {
"type": "array",
"items": {
"type": "string"
}
},
"allowedUsersColumn": {
"type": "string"
},
"allowedGroupsColumn": {
"type": "string"
},
"sourceURIColumn": {
"type": "string"
},
"isSslEnabled": {
"type": "boolean"
}
},
"required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"]
},
"type" : {
"type" : "string",
"pattern": "JDBC"
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string"
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Schéma du modèle Microsoft Teams
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Vous fournissez l'ID du locataire dans le cadre de la configuration de la connexion ou des détails du point de terminaison du référentiel. Spécifiez également le type de source de données`MSTEAMS`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma Microsoft Teams JSON](#msteams-json).
Le tableau suivant décrit les paramètres du schéma Microsoft Teams JSON.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration pour un point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de point de terminaison pour la source de données. |
| Identifiant du locataire | ID de locataire Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste d'objets qui mappent les attributs ou les noms de champs de votre contenu Microsoft Teams aux noms de 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). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données. |
| Modèle de paiement | Spécifie le type de modèle de paiement à utiliser avec votre source de données Microsoft Teams. Les modèles de paiement du modèle A sont limités aux modèles de licence et de paiement qui nécessitent une conformité en matière de sécurité. Les modèles de paiement du modèle B conviennent aux modèles de licence et de paiement qui ne nécessitent pas de conformité en matière de sécurité. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières permettant d'inclure certains contenus dans votre source de données Microsoft Teams. Le contenu qui correspond aux modèles est inclus dans l’index. Le contenu qui ne correspond pas aux modèles est exclu de l’index. Si le contenu correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le contenu n’est pas inclus dans l’index. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières permettant d'exclure certains contenus de votre source de données Microsoft Teams. Le contenu qui correspond aux modèles est exclu de l’index. Le contenu qui ne correspond pas aux modèles est inclus dans l’index. Si le contenu correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le contenu n’est pas inclus dans l’index. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | truepour analyser ces types de contenu dans votre source de données Microsoft Teams. |
| startCalendarDateHeure | Vous pouvez configurer une date et une heure de début spécifiques pour le contenu de votre calendrier. |
| endCalendarDateHeure | Vous pouvez configurer une date et une heure de fin spécifiques pour le contenu du calendrier. |
| type | Type de la source de données. Spécifiez MSTEAMS comme type de source de données. |
| enableIdentityCrawler | trueutiliser Amazon Kendra le moteur de recherche d'identité pour synchroniser les identity/principal informations relatives aux utilisateurs et aux groupes ayant accès à certains documents. Si Identity Crawler est désactivé, tous les documents peuvent être consultés publiquement. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'[https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| secretArn | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret qui contient les paires clé-valeur requises pour se connecter à vos Microsoft Teams. Cela inclut votre ID client et le secret client générés lorsque vous créez une OAuth application sur le portail Azure. |
| version | La version de ce modèle qui est actuellement prise en charge. |
### Schéma Microsoft Teams JSON
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"tenantId": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"minLength": 36,
"maxLength": 36
}
},
"required": [
"tenantId"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"chatMessage": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"chatAttachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"LONG"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"channelPost": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"channelWiki": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"LONG"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"channelAttachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"LONG"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"meetingChat": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"meetingFile": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"LONG"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"meetingNote": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"calendarMeeting": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties": {
"paymentModel": {
"type": "string",
"enum": [
"A",
"B",
"Evaluation Mode"
]
},
"inclusionTeamNameFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionTeamNameFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionChannelNameFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionChannelNameFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionUserEmailFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionOneNoteSectionNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionOneNoteSectionNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionOneNotePageNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionOneNotePageNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"isCrawlChatMessage": {
"type": "boolean"
},
"isCrawlChatAttachment": {
"type": "boolean"
},
"isCrawlChannelPost": {
"type": "boolean"
},
"isCrawlChannelAttachment": {
"type": "boolean"
},
"isCrawlChannelWiki": {
"type": "boolean"
},
"isCrawlCalendarMeeting": {
"type": "boolean"
},
"isCrawlMeetingChat": {
"type": "boolean"
},
"isCrawlMeetingFile": {
"type": "boolean"
},
"isCrawlMeetingNote": {
"type": "boolean"
},
"startCalendarDateTime": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
},
{
"type": "string",
"pattern": ""
}
]
},
"endCalendarDateTime": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
},
{
"type": "string",
"pattern": ""
}
]
}
},
"required": []
},
"type": {
"type": "string",
"pattern": "MSTEAMS"
},
"enableIdentityCrawler": {
"type": "boolean"
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Schéma du modèle Microsoft Yammer
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)l'objet. Spécifiez le type de source de données`YAMMER`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous le spécifiez ensuite `TEMPLATE` comme **type** lorsque vous appelez [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur.
Le tableau suivant décrit les paramètres du schéma Microsoft Yammer JSON.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration pour la source de données. |
| repositoryEndpointMetadata | Informations de point de terminaison pour la source de données. Cette source de données ne spécifie pas de point de terminaison dansrepositoryEndpointMetadata. Les informations de connexion sont plutôt incluses dans un AWS Secrets Manager secret que vous fournissezsecretArn. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste d'objets qui associent les attributs ou les noms de champs du contenu Microsoft Yammer aux noms des champs d'index Amazon Kendra. Pour plus d’informations, consultez [Mappage des champs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données |
| Modèles d'inclusion | Liste de modèles d'expressions régulières permettant d'inclure certains fichiers dans votre source de données Microsoft Yammer. Les fichiers qui correspondent aux modèles sont inclus dans l’index. Les fichiers qui ne correspondent pas aux modèles sont exclus de l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| Schémas d'exclusion | Liste de modèles d'expressions régulières permettant d'exclure certains fichiers de votre source de données Microsoft Yammer. Les fichiers qui correspondent aux modèles sont exclus de l’index. Les fichiers qui ne correspondent pas aux modèles sont inclus dans l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| Depuis Date | Vous pouvez choisir de configurer un sinceDate paramètre afin que le connecteur Microsoft Yammer analyse le contenu en fonction d'un paramètre spécifique. sinceDate |
| communityNameFilter | Vous pouvez choisir d'indexer un contenu communautaire spécifique. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | truepour analyser les messages, les pièces jointes et les messages privés. |
| type | Spécifiez YAMMER comme type de source de données. |
| secretARN | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret qui contient les paires clé-valeur requises pour se connecter à votre Microsoft Yammer. Cela inclut votre nom d'utilisateur et votre mot de passe Microsoft Yammer, ainsi que l'ID client et le secret client générés lorsque vous créez une OAuth application sur le portail Azure. |
| useChangeLog | truepour utiliser le journal des modifications de Microsoft Yammer afin de déterminer quels documents doivent être mis à jour dans l'index. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| enableIdentityCrawler | trueutiliser Amazon Kendra le moteur de recherche d'identité pour synchroniser les identity/principal informations relatives aux utilisateurs et aux groupes ayant accès à certains documents. Si Identity Crawler est désactivé, tous les documents peuvent être consultés publiquement. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'[https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes. |
### Schéma Microsoft Yammer JSON
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
}
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"community": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"user": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"message": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"attachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties": {
"inclusionPatterns": {
"type": "array"
},
"exclusionPatterns": {
"type": "array"
},
"sinceDate": {
"type": "string",
"pattern": "^(19|2[0-9])[0-9]{2}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])((\\+|-)(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9]))?$"
},
"communityNameFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"isCrawlMessage": {
"type": "boolean"
},
"isCrawlAttachment": {
"type": "boolean"
},
"isCrawlPrivateMessage": {
"type": "boolean"
}
},
"required": [
"sinceDate"
]
},
"type": {
"type": "string",
"pattern": "YAMMER"
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
},
"useChangeLog": {
"type": "string",
"enum": [
"true",
"false"
]
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"enableIdentityCrawler": {
"type": "boolean"
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
}
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"additionalProperties",
"type",
"secretArn",
"syncMode"
]
}
```
## Schéma du modèle MySQL
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Spécifiez le type de source de données`JDBC`, le type de base de données`mysql`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma JSON MySQL](#mysql-json).
Le tableau suivant décrit les paramètres du schéma JSON MySQL.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de configuration requises pour la connexion de votre source de données.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. Spécifiez le type de source de données et l’ARN secret. |
| document | Liste d'objets qui mappent les attributs ou les noms de champs du contenu de votre base de données aux noms de 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). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données. Utilisez ce champ pour inclure ou exclure du contenu spécifique dans la source de données de votre base de données. |
| primaryKey | Indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données. |
| titleColumn | Indiquez le nom de la colonne de titre du document dans votre table de base de données. |
| bodyColumn | Indiquez le nom de la colonne de titre du document dans votre table de base de données. |
| sqlQuery | Saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra analysera tout le contenu de la base de données correspondant à votre requête. |
| timestampColumn | Entrez le nom de la colonne contenant les horodatages. Amazon Kendra utilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié. |
| timestampFormat | Saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu. |
| timezone | Saisissez le nom de la colonne contenant les fuseaux horaires du contenu à indexer. |
| changeDetectingColumns | Entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendra réindexera le contenu en cas de modification de l'une de ces colonnes |
| allowedUsersColumns | Entrez le nom de la colonne contenant l'utilisateur devant IDs être autorisé à accéder au contenu. |
| allowedGroupsColumn | Entrez le nom de la colonne contenant l'utilisateur devant IDs être autorisé à accéder au contenu. |
| source URIColumn | Entrez le nom de la colonne contenant la source URLs à indexer. |
| isSslEnabled | Saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra analysera tout le contenu de la base de données correspondant à votre requête. |
| type | Type de la source de données. Spécifiez JDBC comme type de source de données. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| secretArn | L’Amazon Resource Name (ARN) d’un secret Secrets Manager qui contient le nom d’utilisateur et le mot de passe requis pour la connexion à votre base de données. Le secret doit contenir une structure JSON avec les clés suivantes : {
"user name": "database user name",
"password": "password"
} |
| version | La version du modèle actuellement prise en charge. |
### Schéma JSON MySQL
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"dbType": {
"type": "string",
"enum": [
"mysql",
"db2",
"postgresql",
"oracle",
"sqlserver"
]
},
"dbHost": {
"type": "string"
},
"dbPort": {
"type": "string"
},
"dbInstance": {
"type": "string"
}
},
"required": [
"dbType",
"dbHost",
"dbPort",
"dbInstance"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"document": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string"
},
"dataSourceFieldName": {
"type": "string"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
},
"required": [
]
},
"additionalProperties": {
"type": "object",
"properties": {
"primaryKey": {
"type": "string"
},
"titleColumn": {
"type": "string"
},
"bodyColumn": {
"type": "string"
},
"sqlQuery": {
"type": "string",
"not": {
"pattern": ";+"
}
},
"timestampColumn": {
"type": "string"
},
"timestampFormat": {
"type": "string"
},
"timezone": {
"type": "string"
},
"changeDetectingColumns": {
"type": "array",
"items": {
"type": "string"
}
},
"allowedUsersColumn": {
"type": "string"
},
"allowedGroupsColumn": {
"type": "string"
},
"sourceURIColumn": {
"type": "string"
},
"isSslEnabled": {
"type": "boolean"
}
},
"required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"]
},
"type" : {
"type" : "string",
"pattern": "JDBC"
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string"
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Schéma du modèle de base de données Oracle
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Spécifiez le type de source de données`JDBC`, le type de base de données`oracle`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma JSON de base de données Oracle](#oracle-database-json).
Le tableau suivant décrit les paramètres du schéma JSON de la base de données Oracle.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de configuration requises pour la connexion de votre source de données.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. Spécifiez le type de source de données et l’ARN secret. |
| document | Liste d'objets qui mappent les attributs ou les noms de champs du contenu de votre base de données aux noms de 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). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données. Utilisez ce champ pour inclure ou exclure du contenu spécifique dans la source de données de votre base de données. |
| primaryKey | Indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données. |
| titleColumn | Indiquez le nom de la colonne de titre du document dans votre table de base de données. |
| bodyColumn | Indiquez le nom de la colonne de titre du document dans votre table de base de données. |
| sqlQuery | Saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra analysera tout le contenu de la base de données correspondant à votre requête. |
| timestampColumn | Entrez le nom de la colonne contenant les horodatages. Amazon Kendra utilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié. |
| timestampFormat | Saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu. |
| timezone | Saisissez le nom de la colonne contenant les fuseaux horaires du contenu à indexer. |
| changeDetectingColumns | Entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendra réindexera le contenu en cas de modification de l'une de ces colonnes |
| allowedUsersColumns | Entrez le nom de la colonne contenant l'utilisateur devant IDs être autorisé à accéder au contenu. |
| allowedGroupsColumn | Entrez le nom de la colonne contenant l'utilisateur devant IDs être autorisé à accéder au contenu. |
| source URIColumn | Entrez le nom de la colonne contenant la source URLs à indexer. |
| isSslEnabled | Saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra analysera tout le contenu de la base de données correspondant à votre requête. |
| type | Type de la source de données. Spécifiez JDBC comme type de source de données. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| secretArn | L’Amazon Resource Name (ARN) d’un secret Secrets Manager qui contient le nom d’utilisateur et le mot de passe requis pour la connexion à votre base de données. Le secret doit contenir une structure JSON avec les clés suivantes : {
"user name": "database user name",
"password": "password"
} |
| version | La version du modèle actuellement prise en charge. |
### Schéma JSON de base de données Oracle
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"dbType": {
"type": "string",
"enum": [
"mysql",
"db2",
"postgresql",
"oracle",
"sqlserver"
]
},
"dbHost": {
"type": "string"
},
"dbPort": {
"type": "string"
},
"dbInstance": {
"type": "string"
}
},
"required": [
"dbType",
"dbHost",
"dbPort",
"dbInstance"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"document": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string"
},
"dataSourceFieldName": {
"type": "string"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
},
"required": [
]
},
"additionalProperties": {
"type": "object",
"properties": {
"primaryKey": {
"type": "string"
},
"titleColumn": {
"type": "string"
},
"bodyColumn": {
"type": "string"
},
"sqlQuery": {
"type": "string",
"not": {
"pattern": ";+"
}
},
"timestampColumn": {
"type": "string"
},
"timestampFormat": {
"type": "string"
},
"timezone": {
"type": "string"
},
"changeDetectingColumns": {
"type": "array",
"items": {
"type": "string"
}
},
"allowedUsersColumn": {
"type": "string"
},
"allowedGroupsColumn": {
"type": "string"
},
"sourceURIColumn": {
"type": "string"
},
"isSslEnabled": {
"type": "boolean"
}
},
"required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"]
},
"type" : {
"type" : "string",
"pattern": "JDBC"
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string"
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Schéma du modèle PostgreSQL
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Spécifiez le type de source de données`JDBC`, le type de base de données`postgresql`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma JSON PostgreSQL](#postgresql-json).
Le tableau suivant décrit les paramètres du schéma JSON de PostgreSQL.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de configuration requises pour la connexion de votre source de données.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. Spécifiez le type de source de données et l’ARN secret. |
| document | Liste d'objets qui mappent les attributs ou les noms de champs du contenu de votre base de données aux noms de 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). |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données. Utilisez ce champ pour inclure ou exclure du contenu spécifique dans la source de données de votre base de données. |
| primaryKey | Indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données. |
| titleColumn | Indiquez le nom de la colonne de titre du document dans votre table de base de données. |
| bodyColumn | Indiquez le nom de la colonne de titre du document dans votre table de base de données. |
| sqlQuery | Saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra analysera tout le contenu de la base de données correspondant à votre requête. |
| timestampColumn | Entrez le nom de la colonne contenant les horodatages. Amazon Kendra utilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié. |
| timestampFormat | Saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu. |
| timezone | Saisissez le nom de la colonne contenant les fuseaux horaires du contenu à indexer. |
| changeDetectingColumns | Entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendra réindexera le contenu en cas de modification de l'une de ces colonnes |
| allowedUsersColumns | Entrez le nom de la colonne contenant l'utilisateur devant IDs être autorisé à accéder au contenu. |
| allowedGroupsColumn | Entrez le nom de la colonne contenant l'utilisateur devant IDs être autorisé à accéder au contenu. |
| source URIColumn | Entrez le nom de la colonne contenant la source URLs à indexer. |
| isSslEnabled | Saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra analysera tout le contenu de la base de données correspondant à votre requête. |
| type | Type de la source de données. Spécifiez JDBC comme type de source de données. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| secretArn | L’Amazon Resource Name (ARN) d’un secret Secrets Manager qui contient le nom d’utilisateur et le mot de passe requis pour la connexion à votre base de données. Le secret doit contenir une structure JSON avec les clés suivantes : {
"user name": "database user name",
"password": "password"
} |
| version | La version du modèle actuellement prise en charge. |
### Schéma JSON PostgreSQL
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"dbType": {
"type": "string",
"enum": [
"mysql",
"db2",
"postgresql",
"oracle",
"sqlserver"
]
},
"dbHost": {
"type": "string"
},
"dbPort": {
"type": "string"
},
"dbInstance": {
"type": "string"
}
},
"required": [
"dbType",
"dbHost",
"dbPort",
"dbInstance"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"document": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string"
},
"dataSourceFieldName": {
"type": "string"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
},
"required": [
]
},
"additionalProperties": {
"type": "object",
"properties": {
"primaryKey": {
"type": "string"
},
"titleColumn": {
"type": "string"
},
"bodyColumn": {
"type": "string"
},
"sqlQuery": {
"type": "string",
"not": {
"pattern": ";+"
}
},
"timestampColumn": {
"type": "string"
},
"timestampFormat": {
"type": "string"
},
"timezone": {
"type": "string"
},
"changeDetectingColumns": {
"type": "array",
"items": {
"type": "string"
}
},
"allowedUsersColumn": {
"type": "string"
},
"allowedGroupsColumn": {
"type": "string"
},
"sourceURIColumn": {
"type": "string"
},
"isSslEnabled": {
"type": "boolean"
}
},
"required": ["primaryKey", "titleColumn", "bodyColumn", "sqlQuery"]
},
"type" : {
"type" : "string",
"pattern": "JDBC"
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string"
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Schéma du modèle Salesforce
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Vous fournissez l'URL de l'hôte Salesforce dans le cadre de la configuration de la connexion ou des détails du point de terminaison du référentiel. Spécifiez également le type de source de données`SALESFORCEV2`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma JSON Salesforce](#salesforce-json).
Le tableau suivant décrit les paramètres du schéma JSON Salesforce.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de point de terminaison pour la source de données. |
| hostUrl | URL de l'instance Salesforce à indexer. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste d'objets qui mappent les attributs ou les noms de champs de vos entités Salesforce aux noms de 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). |
| secretARN | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret qui contient les paires clé-valeur requises pour se connecter à votre Salesforce. Le secret doit contenir une structure JSON avec les clés suivantes : {
"authenticationUrl": "OAUTH endpoint that Amazon Kendra connects to get an OAUTH token",
"consumerKey": "Application public key generated when you created your Salesforce application",
"consumerSecret": "Application private key generated when you created your Salesforce application",
"password": "Password associated with the user logging in to the Salesforce instance",
"securityToken": "Token associated with the user account logging in to the Salesforce instance",
"username": "User name of the user logging in to the Salesforce instance"
} |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Collection de chaînes qui indique les entités à filtrer. |
| Modèles d'inclusion [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières permettant d'inclure certains fichiers dans votre source de données Salesforce. Les fichiers qui correspondent aux modèles sont inclus dans l’index. Les fichiers qui ne correspondent pas aux modèles sont exclus de l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| Schémas d'exclusion [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières permettant d'exclure certains fichiers de votre source de données Salesforce. Les fichiers qui correspondent aux modèles sont exclus de l’index. Les fichiers qui ne correspondent pas aux modèles sont inclus dans l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | truepour explorer ces types de fichiers dans votre compte Salesforce. |
| type | Type de la source de données. Spécifiez SALESFORCEV2 comme type de source de données. |
| enableIdentityCrawler | trueutiliser Amazon Kendra le moteur de recherche d'identité pour synchroniser les identity/principal informations relatives aux utilisateurs et aux groupes ayant accès à certains documents. Si Identity Crawler est désactivé, tous les documents peuvent être consultés publiquement. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'[https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| version | La version de ce modèle qui est actuellement prise en charge. |
### Schéma JSON Salesforce
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties":
{
"connectionConfiguration": {
"type": "object",
"properties":
{
"repositoryEndpointMetadata":
{
"type": "object",
"properties":
{
"hostUrl":
{
"type": "string",
"pattern": "https:.*"
}
},
"required":
[
"hostUrl"
]
}
},
"required":
[
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties":
{
"account":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"contact":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"campaign":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"case":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"product":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"lead":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"contract":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"partner":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"profile":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"idea":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"pricebook":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"task":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"solution":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"attachment":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"user":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"document":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"knowledgeArticles":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"group":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"opportunity":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE",
"LONG"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"chatter":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
},
"customEntity":
{
"type": "object",
"properties":
{
"fieldMappings":
{
"type": "array",
"items":
[
{
"type": "object",
"properties":
{
"indexFieldName":
{
"type": "string"
},
"indexFieldType":
{
"type": "string",
"enum":
[
"STRING",
"STRING_LIST",
"DATE"
]
},
"dataSourceFieldName":
{
"type": "string"
},
"dateFieldFormat":
{
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required":
[
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required":
[
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties":
{
"accountFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"contactFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"caseFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"campaignFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"contractFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"groupFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"leadFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"productFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"opportunityFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"partnerFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"pricebookFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"ideaFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"profileFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"taskFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"solutionFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"userFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"chatterFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"documentFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"knowledgeArticleFilter":{
"type": "array",
"items":
{
"type": "string"
}
},
"customEntities":{
"type": "array",
"items":
{
"type": "string"
}
},
"isCrawlAccount": {
"type": "boolean"
},
"isCrawlContact": {
"type": "boolean"
},
"isCrawlCase": {
"type": "boolean"
},
"isCrawlCampaign": {
"type": "boolean"
},
"isCrawlProduct": {
"type": "boolean"
},
"isCrawlLead": {
"type": "boolean"
},
"isCrawlContract": {
"type": "boolean"
},
"isCrawlPartner": {
"type": "boolean"
},
"isCrawlProfile": {
"type": "boolean"
},
"isCrawlIdea": {
"type": "boolean"
},
"isCrawlPricebook": {
"type": "boolean"
},
"isCrawlDocument": {
"type": "boolean"
},
"crawlSharedDocument": {
"type": "boolean"
},
"isCrawlGroup": {
"type": "boolean"
},
"isCrawlOpportunity": {
"type": "boolean"
},
"isCrawlChatter": {
"type": "boolean"
},
"isCrawlUser": {
"type": "boolean"
},
"isCrawlSolution":{
"type": "boolean"
},
"isCrawlTask":{
"type": "boolean"
},
"isCrawlAccountAttachments": {
"type": "boolean"
},
"isCrawlContactAttachments": {
"type": "boolean"
},
"isCrawlCaseAttachments": {
"type": "boolean"
},
"isCrawlCampaignAttachments": {
"type": "boolean"
},
"isCrawlLeadAttachments": {
"type": "boolean"
},
"isCrawlContractAttachments": {
"type": "boolean"
},
"isCrawlGroupAttachments": {
"type": "boolean"
},
"isCrawlOpportunityAttachments": {
"type": "boolean"
},
"isCrawlChatterAttachments": {
"type": "boolean"
},
"isCrawlSolutionAttachments":{
"type": "boolean"
},
"isCrawlTaskAttachments":{
"type": "boolean"
},
"isCrawlCustomEntityAttachments":{
"type": "boolean"
},
"isCrawlKnowledgeArticles": {
"type": "object",
"properties":
{
"isCrawlDraft": {
"type": "boolean"
},
"isCrawlPublish": {
"type": "boolean"
},
"isCrawlArchived": {
"type": "boolean"
}
}
},
"inclusionDocumentFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionDocumentFileTypePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionDocumentFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionDocumentFileNamePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionAccountFileTypePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionAccountFileTypePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionAccountFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionAccountFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCampaignFileTypePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCampaignFileTypePatterns": {
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCampaignFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCampaignFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCaseFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCaseFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCaseFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCaseFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionContactFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionContactFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionContactFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionContactFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionContractFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionContractFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionContractFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionContractFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionLeadFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionLeadFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionLeadFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionLeadFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionOpportunityFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionOpportunityFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionOpportunityFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionOpportunityFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionSolutionFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionSolutionFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionSolutionFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionSolutionFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionTaskFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionTaskFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionTaskFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionTaskFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionGroupFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionGroupFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionGroupFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionGroupFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionChatterFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionChatterFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionChatterFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionChatterFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCustomEntityFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCustomEntityFileTypePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"inclusionCustomEntityFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
},
"exclusionCustomEntityFileNamePatterns":{
"type": "array",
"items":
{
"type": "string"
}
}
},
"required":
[]
},
"enableIdentityCrawler": {
"type": "boolean"
},
"type": {
"type": "string",
"pattern": "SALESFORCEV2"
},
"syncMode": {
"type": "string",
"enum": [
"FULL_CRAWL",
"FORCED_FULL_CRAWL",
"CHANGE_LOG"
]
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## ServiceNow schéma de modèle
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet. Vous fournissez l'URL de l' ServiceNow hôte, le type d'authentification et la version de l'instance dans le cadre de la configuration de la connexion ou des détails du point de terminaison du référentiel. Spécifiez également le type de source de données`SERVICENOWV2`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [ServiceNow Schéma JSON](#servicenow-json).
Le tableau suivant décrit les paramètres du schéma ServiceNow JSON.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de point de terminaison pour la source de données. |
| hostUrl | URL de l' ServiceNow hôte. Par exemple, your-domain.service-now.com. |
| authType | Le type d’authentification que vous utilisez, basicAuth ou OAuth2. |
| servicenowInstanceVersion | La ServiceNow version que vous utilisez. Vous pouvez choisir entre TokyoSandiego,Rome, etOthers. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste d'objets qui mappent les attributs ou les noms de champs de vos articles de ServiceNow connaissances, de vos pièces jointes, de votre catalogue de services et de vos incidents pour Amazon Kendra indexer les noms de champs. Pour plus d’informations, consultez [Mappage des champs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). Les noms des champs de source de ServiceNow données doivent figurer dans vos métadonnées ServiceNow personnalisées. |
| propriétés supplémentaires | Options de configuration supplémentaires pour votre contenu dans votre source de données. |
| maxFileSizeInMegaBytes | Spécifiez la limite de taille de fichier MBs qu'Amazon Kendra explorera. Amazon Kendra explorera uniquement les fichiers dans la limite de taille que vous avez définie. La taille de fichier par défaut est de 50 Mo. La taille de fichier maximale doit être supérieure à 0 Mo et inférieure ou égale à 50 Mo. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste de modèles d'expressions régulières à inclure et à and/or exclure certains fichiers de votre source de ServiceNow données. Les fichiers qui correspondent aux modèles sont inclus dans l’index. Les fichiers qui ne correspondent pas aux modèles sont exclus de l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | truepour parcourir les articles de ServiceNow connaissances, les catalogues de services, les incidents et les pièces jointes. |
| type | Type de la source de données. Spécifiez SERVICENOWV2 comme type de source de données. |
| enableIdentityCrawler | trueutiliser Amazon Kendra le moteur de recherche d'identité pour synchroniser les identity/principal informations relatives aux utilisateurs et aux groupes ayant accès à certains documents. Si Identity Crawler est désactivé, tous les documents peuvent être consultés publiquement. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'[https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| secretARN | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret contenant les paires clé-valeur requises pour se connecter à votre. ServiceNow Le secret doit contenir une structure JSON avec les clés suivantes : {
"username": "user name",
"password": "password"
} Si vous utilisez OAuth2 l'authentification, votre secret doit contenir une structure JSON avec les clés suivantes : {
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
} |
| version | La version du modèle actuellement prise en charge. |
### ServiceNow Schéma JSON
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"hostUrl": {
"type": "string",
"pattern": "^(?!(^(https?|ftp|file):\/\/))[a-z0-9-]+(.service-now.com|.servicenowservices.com)$",
"minLength": 1,
"maxLength": 2048
},
"authType": {
"type": "string",
"enum": [
"basicAuth",
"OAuth2"
]
},
"servicenowInstanceVersion": {
"type": "string",
"enum": [
"Tokyo",
"Sandiego",
"Rome",
"Others"
]
}
},
"required": [
"hostUrl",
"authType",
"servicenowInstanceVersion"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"knowledgeArticle": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"STRING_LIST"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"attachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"LONG",
"DATE",
"STRING_LIST"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"serviceCatalog": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"STRING_LIST"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
},
"incident": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": [
"STRING",
"DATE",
"STRING_LIST"
]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
}
},
"additionalProperties": {
"type": "object",
"properties": {
"maxFileSizeInMegaBytes": {
"type": "string"
},
"isCrawlKnowledgeArticle": {
"type": "boolean"
},
"isCrawlKnowledgeArticleAttachment": {
"type": "boolean"
},
"includePublicArticlesOnly": {
"type": "boolean"
},
"knowledgeArticleFilter": {
"type": "string"
},
"incidentQueryFilter": {
"type": "string"
},
"serviceCatalogQueryFilter": {
"type": "string"
},
"isCrawlServiceCatalog": {
"type": "boolean"
},
"isCrawlServiceCatalogAttachment": {
"type": "boolean"
},
"isCrawlActiveServiceCatalog": {
"type": "boolean"
},
"isCrawlInactiveServiceCatalog": {
"type": "boolean"
},
"isCrawlIncident": {
"type": "boolean"
},
"isCrawlIncidentAttachment": {
"type": "boolean"
},
"isCrawlActiveIncident": {
"type": "boolean"
},
"isCrawlInactiveIncident": {
"type": "boolean"
},
"applyACLForKnowledgeArticle": {
"type": "boolean"
},
"applyACLForServiceCatalog": {
"type": "boolean"
},
"applyACLForIncident": {
"type": "boolean"
},
"incidentStateType": {
"type": "array",
"items": {
"type": "string",
"enum": [
"Open",
"Open - Unassigned",
"Resolved",
"All"
]
}
},
"knowledgeArticleTitleRegExp": {
"type": "string"
},
"serviceCatalogTitleRegExp": {
"type": "string"
},
"incidentTitleRegExp": {
"type": "string"
},
"inclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileTypePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"exclusionFileNamePatterns": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": []
},
"type": {
"type": "string",
"pattern": "SERVICENOWV2"
},
"enableIdentityCrawler": {
"type": "boolean"
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL"
]
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type"
]
}
```
## Schéma du modèle Slack
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)l'objet. Vous fournissez l'URL de l'hôte dans le cadre de la configuration de la connexion ou des détails du point de terminaison du référentiel. Spécifiez également le type de source de données`SLACK`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma JSON Slack](#slack-json).
Le tableau suivant décrit les paramètres du schéma JSON de Slack.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de point de terminaison pour la source de données. |
| teamId | L'identifiant d'équipe Slack que vous avez copié depuis l'URL de votre page principale de Slack. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. |
| Tous | Liste d'objets qui mappent les attributs ou les noms de champs de votre Slack contenu aux noms de champs d' Amazon Kendra index. |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données. |
| Modèles d'inclusion | Vous pouvez utiliser des modèles d’expressions régulières pour inclure du contenu spécifique dans votre source de données Slack. Le contenu qui correspond aux modèles est inclus dans l’index. Le contenu qui ne correspond pas aux modèles est exclu de l’index. Si un contenu correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le contenu n’est pas inclus dans l’index. |
| Schémas d'exclusion | Vous pouvez utiliser des modèles d’expressions régulières pour exclure du contenu spécifique dans votre source de données Slack. Le contenu qui correspond aux modèles est exclu de l’index. Le contenu qui ne correspond pas aux modèles est inclus dans l'index. Si un contenu correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le contenu n’est pas inclus dans l’index. |
| crawlBotMessages | truepour explorer les messages du bot. |
| Exclure Archivé | truepour exclure l'exploration des messages archivés. |
| Type de conversation | Le type de conversation que vous souhaitez indexer si PUBLIC\$1CHANNELPRIVATE\$1CHANNEL, GROUP\$1MESSAGE etDIRECT\$1MESSAGE. |
| Filtre de canal | Le type de canal que vous souhaitez indexer, private\$1channel ou public\$1channel. |
| Depuis Date | Vous pouvez choisir de configurer un paramètre sinceDate afin que le connecteur Slack indexe le contenu en fonction d’un paramètre sinceDate spécifique. |
| Regardez en arrière | Vous pouvez choisir de configurer un lookBack paramètre afin que le Slack connecteur analyse le contenu mis à jour ou supprimé jusqu'à un certain nombre d'heures avant la dernière synchronisation du connecteur. |
| syncMode | Spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Vous pouvez choisir entre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) |
| type | Type de la source de données. Spécifiez SLACK comme type de source de données. |
| enableIdentityCrawler | trueutiliser Amazon Kendra le moteur de recherche d'identité pour synchroniser les identity/principal informations relatives aux utilisateurs et aux groupes ayant accès à certains documents. Si Identity Crawler est désactivé, tous les documents peuvent être consultés publiquement. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'[https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html](https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes. |
| secretArn | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret contenant les paires clé-valeur requises pour se connecter à votre. Slack Le secret doit contenir une structure JSON avec les clés suivantes : {
"slackToken": "token"
} |
| version | La version de ce modèle actuellement prise en charge. |
### Schéma JSON Slack
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"teamId": {
"type": "string"
}
},
"required": ["teamId"]
}
}
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"All": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "DATE","LONG"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "yyyy-MM-dd'T'HH:mm:ss'Z'"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
},
"required": [
"fieldMappings"
]
}
},
"required": [
]
},
"additionalProperties": {
"type": "object",
"properties": {
"exclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusionPatterns": {
"type": "array",
"items": {
"type": "string"
}
},
"crawlBotMessages": {
"type": "boolean"
},
"excludeArchived": {
"type": "boolean"
},
"conversationType": {
"type": "array",
"items": {
"type": "string",
"enum": [
"PUBLIC_CHANNEL",
"PRIVATE_CHANNEL",
"GROUP_MESSAGE",
"DIRECT_MESSAGE"
]
}
},
"channelFilter": {
"type": "object",
"properties": {
"private_channel": {
"type": "array",
"items": {
"type": "string"
}
},
"public_channel": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"channelIdFilter": {
"type": "array",
"items": {
"type": "string"
}
},
"sinceDate": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
},
{
"type": "string",
"pattern": ""
}
]
},
"lookBack": {
"type": "string",
"pattern": "^[0-9]*$"
}
},
"required": [
]
},
"syncMode": {
"type": "string",
"enum": [
"FORCED_FULL_CRAWL",
"FULL_CRAWL",
"CHANGE_LOG"
]
},
"type" : {
"type" : "string",
"pattern": "SLACK"
},
"enableIdentityCrawler": {
"type": "boolean"
},
"secretArn": {
"type": "string"
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"syncMode",
"additionalProperties",
"secretArn",
"type",
"enableIdentityCrawler"
]
}
```
## Schéma du modèle Zendesk
Vous incluez un JSON qui contient le schéma de la source de données dans le cadre de [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)l'objet. Vous fournissez l'URL de l'hôte dans le cadre de la configuration de la connexion ou des détails du point de terminaison du référentiel. Spécifiez également le type de source de données`ZENDESK`, un secret pour vos informations d'authentification et les autres configurations nécessaires. Vous spécifiez ensuite `TEMPLATE` le `Type` moment de l'appel [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html).
Vous pouvez utiliser le modèle fourni dans ce guide du développeur. Consultez [Schéma JSON Zendesk](#zendesk-json).
Le tableau suivant décrit les paramètres du schéma Zendesk JSON.
| Configuration | Description |
| --- | --- |
| connectionConfiguration | Informations de configuration du point de terminaison pour la source de données. |
| repositoryEndpointMetadata | Informations de point de terminaison pour la source de données. |
| URL de l'hôte | URL de l'hôte Zendesk. Par exemple, https://yoursubdomain.zendesk.com. |
| repositoryConfigurations | Informations de configuration pour le contenu de la source de données. Par exemple, configurer des types spécifiques de contenu et des mappages de champs. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Liste d'objets qui associent les attributs ou les noms de champs des tickets Zendesk aux noms des champs d'index Amazon Kendra. Pour plus d’informations, consultez [Mappage des champs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). |
| secretARN | Le nom de ressource Amazon (ARN) d'un AWS Secrets Manager secret qui contient les paires clé-valeur requises pour se connecter à votre Zendesk. Le secret doit contenir une structure JSON avec les clés suivantes : URL hôte, ID client, secret client, nom d'utilisateur et mot de passe. |
| additionalProperties | Options de configuration supplémentaires pour votre contenu dans votre source de données |
| organizationNameFilter | Vous pouvez choisir d'indexer les tickets qui existent au sein d'une organisation spécifique. |
| Depuis Date | Vous pouvez choisir de configurer un sinceDate paramètre afin que le connecteur Zendesk analyse le contenu en fonction d'un paramètre spécifique. sinceDate |
| Modèles d'inclusion | Une liste de modèles d'expressions régulières pour inclure certains fichiers dans votre source de données Zendesk. Les fichiers qui correspondent aux modèles sont inclus dans l’index. Les fichiers qui ne correspondent pas aux modèles sont exclus de l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| Schémas d'exclusion | Une liste de modèles d'expressions régulières pour exclure certains fichiers de votre source de données Zendesk. Les fichiers qui correspondent aux modèles sont exclus de l’index. Les fichiers qui ne correspondent pas aux modèles sont inclus dans l’index. Si un fichier correspond à la fois à un modèle d’inclusion et d’exclusion, le modèle d’exclusion a la priorité et le fichier n’est pas inclus dans l’index. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/ds-schemas.html) | Entrez « true » pour explorer ces types de contenu. |
| type | Spécifiez ZENDESK comme type de source de données. |
| useChangeLog | Entrez « true » pour utiliser le journal des modifications de Zendesk afin de déterminer quels documents doivent être mis à jour dans l'index. Selon la taille du journal des modifications, il peut être plus rapide de numériser les documents dans Zendesk. Si vous synchronisez votre source de données Zendesk avec votre index pour la première fois, tous les documents sont numérisés. |
### Schéma JSON Zendesk
```
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"connectionConfiguration": {
"type": "object",
"properties": {
"repositoryEndpointMetadata": {
"type": "object",
"properties": {
"hostUrl": {
"type": "string",
"pattern": "https:.*"
}
},
"required": [
"hostUrl"
]
}
},
"required": [
"repositoryEndpointMetadata"
]
},
"repositoryConfigurations": {
"type": "object",
"properties": {
"ticket": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"ticketComment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"ticketCommentAttachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"article": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"communityPostComment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"articleComment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"articleAttachment": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
},
"communityTopic": {
"type": "object",
"properties": {
"fieldMappings": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"indexFieldName": {
"type": "string"
},
"indexFieldType": {
"type": "string",
"enum": ["STRING", "STRING_LIST", "LONG", "DATE"]
},
"dataSourceFieldName": {
"type": "string"
},
"dateFieldFormat": {
"type": "string",
"pattern": "dd-MM-yyyy HH:mm:ss"
}
},
"required": [
"indexFieldName",
"indexFieldType",
"dataSourceFieldName"
]
}
]
}
}
},
"required": [
"fieldMappings"
]
}
}
},
"secretArn": {
"type": "string",
"minLength": 20,
"maxLength": 2048
},
"additionalProperties": {
"type": "object",
"properties": {
"organizationNameFilter": {
"type": "array"
},
"sinceDate": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}$"
},
"inclusionPatterns": {
"type": "array"
},
"exclusionPatterns": {
"type": "array"
},
"isCrawTicket": {
"type": "string"
},
"isCrawTicketComment": {
"type": "string"
},
"isCrawTicketCommentAttachment": {
"type": "string"
},
"isCrawlArticle": {
"type": "string"
},
"isCrawlArticleAttachment": {
"type": "string"
},
"isCrawlArticleComment": {
"type": "string"
},
"isCrawlCommunityTopic": {
"type": "string"
},
"isCrawlCommunityPost": {
"type": "string"
},
"isCrawlCommunityPostComment": {
"type": "string"
}
}
},
"type": {
"type": "string",
"pattern": "ZENDESK"
},
"useChangeLog": {
"type": "string",
"enum": ["true", "false"]
}
},
"version": {
"type": "string",
"anyOf": [
{
"pattern": "1.0.0"
}
]
},
"additionalProperties": false,
"required": [
"connectionConfiguration",
"repositoryConfigurations",
"additionalProperties",
"useChangeLog",
"secretArn",
"type"
]
}
```
# Adobe Experience Manager
**Note**
Le connecteur Adobe Experience Manager reste entièrement pris en charge pour les clients existants jusqu'au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Adobe Experience Managerest un système de gestion de contenu utilisé pour créer du contenu de sites Web ou d'applications mobiles. Vous pouvez l'utiliser Amazon Kendra pour vous connecter à vos pages Adobe Experience Manager et à vos actifs de contenu et les indexer.
Amazon Kendraprend en charge Adobe Experience Manager (AEM) en tant qu'instance d'auteur du service Adobe Experience Manager cloud et en tant qu'instance de création et de publication sur site.
Vous pouvez vous connecter Amazon Kendra à votre source de Adobe Experience Manager données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) ou de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Adobe Experience Manager, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-aem)
+ [Conditions préalables](#prerequisites-aem)
+ [Instructions de connexion](#data-source-procedure-aem)
## Fonctionnalités prises en charge
Adobe Experience Managerle connecteur de source de données prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ OAuth Authentification 2.0 et de base
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de Adobe Experience Manager données, apportez ces modifications à vos AWS comptes Adobe Experience Manager and.
**Dans Adobe Experience Manager, assurez-vous d’avoir :**
+ Accès à un compte doté de privilèges administratifs ou à un utilisateur administrateur.
+ Copié l’URL de votre hôte Adobe Experience Manager.
**Note**
(Sur place/sur serveur) Amazon Kendra vérifie si les informations de point de terminaison incluses sont les mêmes AWS Secrets Manager que celles spécifiées dans les détails de configuration de votre source de données. Cela permet de se protéger contre le [problème de confusion des adjoints](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), qui est un problème de sécurité lorsqu'un utilisateur n'est pas autorisé à effectuer une action mais l'utilise Amazon Kendra comme proxy pour accéder au secret configuré et exécuter l'action. Si vous modifiez ultérieurement les informations de votre point de terminaison, vous devez créer un nouveau secret pour synchroniser ces informations.
+ Vous avez noté vos informations d'authentification de base, à savoir le nom d'utilisateur et le mot de passe de l'administrateur.
**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).
+ **Facultatif** : informations d'identification OAuth 2.0 configurées dans Adobe Experience Manager (AEM) en tant que service cloud ou AEM sur site. Si vous utilisez AEM On-Premise, les informations d'identification incluent l'ID client, le secret client et la clé privée. Si vous utilisez AEM en tant que service cloud, les informations d'identification incluent l'identifiant du client, le secret du client, la clé privée, l'identifiant de l'organisation, l'identifiant du compte technique et l'hôte Adobe Identity Management System (IMS). Pour plus d'informations sur la façon de générer ces informations d'identification pour AEM as a Cloud Service, consultez [Adobe Experience Managerla documentation](https://experienceleague.adobe.com/docs/experience-manager-learn/getting-started-with-aem-headless/authentication/service-credentials.html). Pour AEM On-Premise, l'implémentation du serveur Adobe Granite OAuth 2.0 (com.adobe.granite.oauth.server) prend en charge les fonctionnalités du serveur OAuth 2.0 dans AEM.
+ Il est vérifié que chaque document est unique dans Adobe Experience Manager et dans 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 votreCompte 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'authentification Adobe Experience Manager 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 données Adobe Experience Manager à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 Adobe Experience Manager données, vous devez fournir les informations nécessaires sur votre source de Adobe Experience Manager données afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Adobe Experience Manager pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-aem).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Adobe Experience Manager**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Adobe Experience Manager**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Adobe Experience Manager** 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. **Source** : choisissez **AEM sur site ou AEM en** **tant que** service cloud.
Entrez l'URL de votre Adobe Experience Manager hôte. Par exemple, si vous utilisez AEM On-Premise, vous incluez le nom d’hôte et le port : *https://hostname:port*. Ou, si vous utilisez AEM as a Cloud Service, vous pouvez utiliser l’URL de l’auteur : *https://author-xxxxxx-xxxxxxx.adobeaemcloud.com*.
1. **Emplacement du certificat SSL** : entrez le chemin d'accès au certificat SSL stocké dans un Amazon S3 compartiment. Vous l'utilisez pour vous connecter à AEM On-Premise avec une connexion SSL sécurisée.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **Authentification** —Choisissez **l'authentification de base ou l'****authentification OAuth 2.0**. Choisissez ensuite un AWS Secrets Manager secret existant ou créez-en un nouveau pour stocker vos Adobe Experience Manager informations d'identification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
Si vous avez choisi **l'authentification de base**, entrez le nom du secret, le nom d'utilisateur et le mot de passe du Adobe Experience Manager site. L'utilisateur doit disposer d'une autorisation d'administrateur ou être un utilisateur administrateur.
Si vous avez choisi **l'authentification OAuth 2.0** et que vous utilisez AEM On-Premise, entrez un nom pour le secret, l'ID client, le secret client et la clé privée. Si vous utilisez AEM en tant que service cloud, entrez un nom pour le secret, l'identifiant client, le secret client, la clé privée, l'identifiant de l'organisation, l'identifiant du compte technique et l'hôte Adobe Identity Management System (IMS).
Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. **Étendue de synchronisation** : définissez des limites pour l'exploration de certains types de contenu, composants de page et chemins racines, et filtrez le contenu à l'aide de modèles d'expression regex.
1. **Types de contenu** : choisissez d'explorer uniquement les pages ou les ressources, ou les deux.
1. (Facultatif) **Configuration supplémentaire** : configurez les paramètres suivants :
+ **Composants de page** : noms spécifiques des composants de page. Le composant de page est un composant de page extensible conçu pour fonctionner avec l'éditeur de Adobe Experience Manager modèles et permet d'assembler les composants de page header/footer et de structure avec l'éditeur de modèles.
+ **Variations de fragments de contenu** : noms spécifiques des variations de fragments de contenu. Les fragments de contenu vous permettent de concevoir, créer, organiser et publier du contenu indépendant de la page dans Adobe Experience Manager. Ils vous permettent de préparer du contenu prêt à être utilisé sur locations/over plusieurs canaux.
+ **Chemins racines** : chemins racines vers un contenu spécifique.
+ Modèles **Regex : modèles** d'expressions régulières permettant d'inclure ou d'exclure certaines pages et ressources.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. **ID de fuseau horaire** : si vous utilisez AEM On-Premise et que le fuseau horaire de votre serveur est différent de celui du connecteur ou de l'index Amazon Kendra AEM, vous pouvez spécifier le fuseau horaire du serveur afin de l'aligner sur le connecteur ou l'index AEM. Le fuseau horaire par défaut pour AEM On-Premise est le fuseau horaire du connecteur ou de l'Amazon Kendraindex AEM. Le fuseau horaire par défaut pour AEM en tant que service cloud est l'heure moyenne de Greenwich.
1. **Calendrier d'exécution de synchronisation**, pour la **fréquence** : choisissez la fréquence à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. 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. Pour ajouter des champs de source de données personnalisés, créez un nom de champ d'index à mapper et le type de données du champ.
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 à Adobe Experience Manager**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-aem-schema) à l'aide de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `AEM` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ URL de **l'hôte AEM : spécifiez l'URL** de l'Adobe Experience Managerhôte. Par exemple, si vous utilisez AEM On-Premise, vous incluez le nom d’hôte et le port : *https://hostname:port*. Ou, si vous utilisez AEM as a Cloud Service, vous pouvez utiliser l’URL de l’auteur : *https://author-xxxxxx-xxxxxxx.adobeaemcloud.com*.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Type d'authentification** : spécifiez le type d'authentification que vous souhaitez utiliser, `Basic` soit`OAuth2`.
+ **Type AEM** —Spécifiez le type Adobe Experience Manager que vous utilisez, soit`CLOUD`. `ON_PREMISE`
+ **Nom de ressource Amazon secret (ARN)** : si vous souhaitez utiliser l'authentification de base pour AEM sur site ou dans le cloud, vous devez fournir un secret qui stocke vos informations d'authentification, à savoir votre nom d'utilisateur et votre mot de passe. Vous fournissez le Amazon Resource Name (ARN) d'un AWS Secrets Manager secret. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"aemUrl": "Adobe Experience Manager On-Premise host URL",
"username": "user name with admin permissions",
"password": "password with admin permissions"
}
```
Si vous souhaitez utiliser l'authentification OAuth 2.0 pour AEM On-Premise, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"aemUrl": "Adobe Experience Manager host URL",
"clientId": "client ID",
"clientSecret": "client secret",
"privateKey": "private key"
}
```
Si vous souhaitez utiliser l'authentification OAuth 2.0 pour AEM en tant que service cloud, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"clientId": "client ID",
"clientSecret": "client secret",
"privateKey": "private key",
"orgId": "organization ID",
"technicalAccountId": "technical account ID",
"imsHost": "Adobe Identity Management System (IMS) host"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur Adobe Experience Manager etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de données Adobe Experience Manager](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **ID de fuseau horaire** : si vous utilisez AEM On-Premise et que le fuseau horaire de votre serveur est différent de celui du connecteur ou de l'index Amazon Kendra AEM, vous pouvez spécifier le fuseau horaire du serveur afin de l'aligner sur le connecteur ou l'index AEM.
Le fuseau horaire par défaut pour AEM On-Premise est le fuseau horaire du connecteur ou de l'Amazon Kendraindex AEM. Le fuseau horaire par défaut pour AEM en tant que service cloud est l'heure moyenne de Greenwich.
Pour plus d'informations sur les fuseaux horaires pris en charge IDs, consultez le [schéma Adobe Experience Manager JSON](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#aem-json).
+ **Filtres d'inclusion et d'exclusion** : indiquez si vous souhaitez inclure ou exclure certaines pages et ressources.
**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.
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Adobe Experience Manager à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du Adobe Experience Manager modèle](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-aem-schema).
------
# Alfresco
**Note**
Le connecteur Alfresco reste entièrement compatible pour les clients existants jusqu'au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Alfrescoest un service de gestion de contenu qui aide les clients à stocker et à gérer leur contenu. Vous pouvez l'utiliser Amazon Kendra pour indexer votre bibliothèque de Alfresco documents, votre wiki et votre blog.
Amazon Kendraprend en charge les services Alfresco sur site et Alfresco dans le cloud (plateforme en tant que service).
Vous pouvez vous connecter Amazon Kendra à votre source de Alfresco données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) ou de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Alfresco, consultez. [Dépannage des sources de données](troubleshooting-data-sources.md)
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-alfresco)
+ [Conditions préalables](#prerequisites-alfresco)
+ [Instructions de connexion](#data-source-procedure-alfresco)
+ [En savoir plus](#alfresco-learn-more)
## Fonctionnalités prises en charge
Amazon KendraAlfrescole connecteur de source de données prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ OAuth Authentification 2.0 et de base
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir l'utiliser Amazon Kendra pour indexer votre source de données Alfresco, apportez ces modifications dans votre Alfresco fichier et. Comptes AWS
**Dans Alfresco, assurez-vous d’avoir :**
+ Vous avez copié l’URL de votre référentiel Alfresco et l’URL de votre application Web. Si vous souhaitez uniquement indexer un site Alfresco spécifique, copiez également l’ID du site.
+ Notez vos informations Alfresco d'authentification, qui incluent un nom d'utilisateur et un mot de passe avec au moins des autorisations de lecture. Si vous souhaitez utiliser l'authentification OAuth 2.0, vous devez ajouter l'utilisateur au groupe Alfresco des administrateurs.
**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).
+ **Facultatif** : informations d'identification OAuth 2.0 configurées dansAlfresco. Les informations d’identification incluent l’ID client, le secret client et l’URL du jeton. Pour plus d'informations sur la configuration des clients sur Alfresco site, consultez la documentation [Alfresco](https://docs.alfresco.com/identity-service/latest/tutorial/sso/saml/). Si vous utilisez Alfresco le Cloud (PaaS), vous devez contacter le [support Hyland](https://community.hyland.com/) pour l'authentification Alfresco OAuth 2.0.
+ Il est vérifié que chaque document est unique dans Alfresco et dans 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 votreCompte 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 identifiants d'authentification Alfresco 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 données Alfresco à. 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 données Alfresco, vous devez fournir les informations nécessaires à votre source de données Alfresco afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Alfresco pourAmazon Kendra, consultez. [Conditions préalables](#prerequisites-alfresco)
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Alfresco**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Alfresco**, puis sélectionnez **Ajouter** un connecteur. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Alfresco** avec le tag « 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. **Alfrescotype** —Choisissez si vous utilisez Alfresco sur place/serveur ou dans le Alfresco cloud (plate-forme en tant que service).
1. URL du dépôt **Alfresco : entrez l'URL de votre référentiel** Alfresco. Par exemple, si vous utilisez Alfresco Cloud (PaaS), l’URL du référentiel peut être *https://company.alfrescocloud.com*. Ou, si vous utilisez Alfresco On-Premises, l’URL du référentiel peut être *https://company-alfresco-instance.company-domain.suffix:port*.
1. **Application utilisateur Alfresco. URL** —Entrez l'URL de votre interface Alfresco utilisateur. Vous pouvez obtenir l’URL du référentiel auprès de votre administrateur Alfresco. Par exemple, l’URL de l’interface utilisateur peut être *https://example.com*.
1. **Emplacement du certificat SSL** : entrez le chemin d'accès au certificat SSL stocké dans un Amazon S3 compartiment. Vous l'utilisez pour vous connecter à Alfresco On-Premises avec une connexion SSL sécurisée.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **Authentification** —Choisissez **l'authentification de base ou l'****authentification OAuth 2.0**. Choisissez ensuite un secret Secrets Manager existant ou créez-en un pour stocker vos informations d’identification Alfresco. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
Si vous avez choisi **l'authentification de base**, entrez le nom du secret, le nom Alfresco d'utilisateur et le mot de passe.
Si vous avez choisi **l'authentification OAuth 2.0**, entrez un nom pour le secret, l'ID client, le secret client et l'URL du jeton.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. **Étendue de synchronisation** : définissez des limites pour l'exploration de certains contenus et filtrez le contenu à l'aide de modèles d'expression regex.
1.
1. **Contenu** : choisissez d'explorer le contenu marqué d'un « Aspects »Alfresco, le contenu d'un Alfresco site spécifique ou le contenu de tous vos Alfresco sites.
1. (Facultatif) **Configuration supplémentaire** : définissez les paramètres suivants :
+ **Inclure les commentaires** : choisissez d'inclure les commentaires dans la bibliothèque de Alfresco documents et le blog.
+ Modèles **Regex : modèles** d'expressions régulières permettant d'inclure ou d'exclure certains fichiers.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. 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. Pour ajouter des champs de source de données personnalisés, créez un nom de champ d'index à mapper et le type de données du champ.
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 à Alfresco**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-alfresco-schema) à l'aide de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `ALFRESCO` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **AlfrescoID du site** —Spécifiez l'ID du site Alfresco.
+ **AlfrescoURL du référentiel** : spécifiez l'URL du Alfresco référentiel. Vous pouvez obtenir l’URL du référentiel auprès de votre administrateur Alfresco. Par exemple, si vous utilisez Alfresco Cloud (PaaS), l’URL du référentiel peut être *https://company.alfrescocloud.com*. Ou, si vous utilisez Alfresco On-Premises, l’URL du référentiel peut être *https://company-alfresco-instance.company-domain.suffix:port*.
+ **AlfrescoURL de l'application Web** —Spécifiez l'URL de Alfresco l'interface utilisateur. Vous pouvez obtenir l’URL du référentiel auprès de votre administrateur Alfresco. Par exemple, l’URL de l’interface utilisateur peut être *https://example.com*.
+ **Type d'authentification** : spécifiez le type d'authentification que vous souhaitez utiliser, que ce soit `OAuth2` ou`Basic`.
+ **Alfrescotype** —Spécifiez le type que Alfresco vous utilisez, que ce soit `PAAS` (Cloud/Plateforme en tant que service) ou `ON_PREM` (sur site).
+ **Nom de ressource Amazon secret (ARN)** : si vous souhaitez utiliser l'authentification de base, vous devez fournir un secret qui stocke vos informations d'authentification, à savoir votre nom d'utilisateur et votre mot de passe. Vous fournissez le Amazon Resource Name (ARN) d'un AWS Secrets Manager secret. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password"
}
```
Si vous souhaitez utiliser l'authentification OAuth 2.0, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"clientId": "client ID",
"clientSecret": "client secret",
"tokenUrl": "token URL"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur Alfresco et. Amazon Kendra Pour plus d'informations, consultez la section [IAMRôles des sources de données Alfresco](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Type de contenu** : le type de contenu que vous souhaitez explorer, qu'il s'agisse du contenu marqué d'un « Aspects » dans le champ « Aspects »Alfresco, du contenu d'un Alfresco site spécifique ou du contenu de tous vos Alfresco sites. Vous pouvez également répertorier du contenu « Aspects » spécifique.
+ **Filtres d'inclusion et d'exclusion** : spécifiez si vous souhaitez inclure ou exclure certains fichiers.
**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.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Alfresco à vos champs d'index. Amazon Kendra 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du Alfresco modèle](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-alfresco-schema).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Alfresco, consultez :
+ [Recherchez du Alfresco contenu de manière intelligente à l'aide de Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/intelligently-search-alfresco-content-using-amazon-kendra/)
# Aurora(MySQL)
**Note**
Le connecteur Aurora(MySQL) reste entièrement pris en charge pour les clients existants jusqu’au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Auroraest un système de gestion de base de données relationnelle (RDBMS) conçu pour le cloud. Si vous êtes un Aurora utilisateur, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de Aurora(MySQL) données. Le connecteur de source de Amazon Kendra Aurora(MySQL) données prend en charge Aurora MySQL 3 et MySQL 8.0 Aurora sans serveur.
Vous pouvez vous connecter Amazon Kendra à votre source de Aurora(MySQL) données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra Aurora(MySQL) données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-aurora-mysql)
+ [Conditions préalables](#prerequisites-aurora-mysql)
+ [Instructions de connexion](#data-source-procedure-aurora-mysql)
+ [Remarques](#aurora-mysql-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de Aurora(MySQL) données, apportez ces modifications à vos AWS comptes Aurora(MySQL) and.
**Dans Aurora(MySQL), assurez-vous d’avoir :**
+ Notez le nom d'utilisateur et le mot de passe de votre base de données.
**Important**
Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Vous avez copié l'URL, le port et l'instance de votre hôte de base de données. Vous trouverez ces informations sur la Amazon RDS console.
+ Il est vérifié que chaque document est unique dans Aurora(MySQL) 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 votreCompte 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'Aurora(MySQL)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 Aurora(MySQL) 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 Aurora(MySQL) données, vous devez fournir les détails de vos Aurora(MySQL) informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Aurora(MySQL) pour Amazon Kendra voir[Conditions préalables](#prerequisites-aurora-mysql).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Aurora(MySQL)**
1. Connectez-vous à la [Amazon Kendraconsole 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 **Aurora(MySQL)connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **Aurora(MySQL)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 tirets, 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. Dans **Source**, saisissez les informations suivantes :
1. **Hôte** : saisissez l’URL de l’hôte de la base de données, par exemple : `http://instance URL.region.rds.amazonaws.com`.
1. **Port** : saisissez le port de la base de données, par exemple, `5432`.
1. **Instance** — Entrez l'instance de base de données.
1. Dans **Authentification**, entrez les informations suivantes :
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations Aurora(MySQL) d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - Aurora(MySQL) - » est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le mot de **passe de** la base** de données, entrez les valeurs d'identification d'authentification que vous avez copiées depuis votre base de données.
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
+ **Requête SQL** : saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. Les requêtes SQL doivent être inférieures à 32 Ko Les requêtes SQL doivent être inférieures à 32 Ko et ne pas contenir de points-virgules (;). Amazon Kendraanalysera tout le contenu de la base de données correspondant à votre requête.
+ **Colonne de clé primaire** : indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données.
+ **Colonne de titre** : indiquez le nom de la colonne de titre du document dans votre table de base de données.
+ **Colonne du corps** : indiquez le nom de la colonne du corps du document dans votre table de base de données.
1. Dans **Configuration supplémentaire *(facultatif)***, choisissez l'une des options suivantes pour synchroniser un contenu spécifique au lieu de synchroniser tous les fichiers :
+ **Colonnes détectant les modifications** : entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendraréindexera le contenu en cas de modification de l'une de ces colonnes.
+ ** IDsColonne des utilisateurs** : entrez le nom de la colonne contenant l'utilisateur devant être autorisé IDs à accéder au contenu.
+ **Colonne des groupes** : saisissez le nom de la colonne contenant les groupes autorisés à accéder au contenu.
+ ** URLsColonne source** —Entrez le nom de la colonne contenant la source URLs à indexer.
+ **Colonne horodatage** : entrez le nom de la colonne contenant les horodatages. Amazon Kendrautilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié.
+ **Colonne des fuseaux horaires** : saisissez le nom de la colonne contenant les fuseaux horaires du contenu à explorer.
+ **Format d’horodatage** : saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : à quelle fréquence Amazon Kendra sera synchronisée avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés (**Document IDs****, Titres** des documents et **Source URLs**) que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à Aurora(MySQL)**
Vous devez spécifier les éléments suivants à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API :
+ **Source de données** —Spécifiez le type de source de données tel que `JDBC` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type de base de données** —Vous devez spécifier le type de base de données sous `mySql` la forme.
+ **Requête SQL** : spécifiez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre Aurora(MySQL) compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"user name": "database user name",
"password": "password"
}
```
**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).
+ **IAMrole** —Spécifiez à quel `RoleArn` moment 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 Aurora(MySQL) connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de Aurora(MySQL) 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure un contenu spécifique en utilisant l'utilisateur IDs, les groupes, la source URLs, les horodatages et les fuseaux horaires.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de Aurora(MySQL) données à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez[Aurora Schéma de modèle (MySQL)](ds-schemas.md#ds-aurora-mysql-schema).
------
## Remarques
+ Les lignes de base de données supprimées ne seront pas suivies lors de la Amazon Kendra vérification du contenu mis à jour.
+ La taille des noms et des valeurs des champs d’une ligne de votre base de données ne peut pas dépasser 400 Ko.
+ Si la source de données de votre base de données contient une grande quantité de données et que vous ne souhaitez pas Amazon Kendra indexer tout le contenu de votre base de données après la première synchronisation, vous pouvez choisir de ne synchroniser que les documents nouveaux, modifiés ou supprimés.
+ Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Il est recommandé d'éviter d'ajouter des tableaux contenant des données sensibles ou des informations personnelles identifiables (PII).
# Aurora(PostgreSQL)
**Note**
Le connecteur Aurora(PostgreSQL) reste entièrement pris en charge pour les clients existants jusqu’au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Auroraest un système de gestion de base de données relationnelle (RDBMS) conçu pour le cloud. Si vous êtes un Aurora utilisateur, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de Aurora(PostgreSQL) données. Le connecteur de source de Amazon Kendra Aurora(PostgreSQL) données prend en charge Aurora PostgreSQL 1.
Vous pouvez vous connecter Amazon Kendra à votre source de Aurora(PostgreSQL) données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra Aurora(PostgreSQL) données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-aurora-postgresql)
+ [Conditions préalables](#prerequisites-aurora-postgresql)
+ [Instructions de connexion](#data-source-procedure-aurora-postgresql)
+ [Remarques](#aurora-postgresql-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de Aurora(PostgreSQL) données, apportez ces modifications à vos AWS comptes Aurora(PostgreSQL) and.
**Dans Aurora(PostgreSQL), assurez-vous d’avoir :**
+ Notez le nom d'utilisateur et le mot de passe de votre base de données.
**Important**
Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Vous avez copié l'URL, le port et l'instance de votre hôte de base de données.
+ Il est vérifié que chaque document est unique dans Aurora(PostgreSQL) 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 votreCompte 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'Aurora(PostgreSQL)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 Aurora(PostgreSQL) 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 Aurora(PostgreSQL) données, vous devez fournir les détails de vos Aurora(PostgreSQL) informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Aurora(PostgreSQL) pour Amazon Kendra voir[Conditions préalables](#prerequisites-aurora-postgresql).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Aurora(PostgreSQL)**
1. Connectez-vous à la [Amazon Kendraconsole 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 **Aurora(PostgreSQL)connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **Aurora(PostgreSQL)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 tirets, 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. Dans **Source**, saisissez les informations suivantes :
1. **Hôte** : saisissez l’URL de l’hôte de la base de données, par exemple : `http://instance URL.region.rds.amazonaws.com`.
1. **Port** : saisissez le port de la base de données, par exemple, `5432`.
1. **Instance** : saisissez l’instance de la base de données, par exemple, `postgres`.
1. **Activer l'emplacement du certificat SSL** : choisissez d'entrer le Amazon S3 chemin d'accès à votre fichier de certificat SSL.
1. Dans **Authentification**, entrez les informations suivantes :
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations Aurora(PostgreSQL) d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - Aurora(PostgreSQL) - » est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le mot de **passe de** la base** de données, entrez les valeurs d'identification d'authentification que vous avez copiées depuis votre base de données.
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
+ **Requête SQL** : saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. Les requêtes SQL doivent être inférieures à 32 Ko Les requêtes SQL doivent être inférieures à 32 Ko et ne pas contenir de points-virgules (;). Amazon Kendraanalysera tout le contenu de la base de données correspondant à votre requête.
+ **Colonne de clé primaire** : indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données.
+ **Colonne de titre** : indiquez le nom de la colonne de titre du document dans votre table de base de données.
+ **Colonne du corps** : indiquez le nom de la colonne du corps du document dans votre table de base de données.
1. Dans **Configuration supplémentaire — *facultatif***, choisissez l'une des options suivantes pour synchroniser un contenu spécifique au lieu de synchroniser tous les fichiers :
+ **Colonnes détectant les modifications** : entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendraréindexera le contenu en cas de modification de l'une de ces colonnes.
+ ** IDsColonne des utilisateurs** : entrez le nom de la colonne contenant l'utilisateur devant être autorisé IDs à accéder au contenu.
+ **Colonne des groupes** : saisissez le nom de la colonne contenant les groupes autorisés à accéder au contenu.
+ ** URLsColonne source** —Entrez le nom de la colonne contenant la source URLs à indexer.
+ **Colonne horodatage** : entrez le nom de la colonne contenant les horodatages. Amazon Kendrautilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié.
+ **Colonne des fuseaux horaires** : saisissez le nom de la colonne contenant les fuseaux horaires du contenu à explorer.
+ **Format d’horodatage** : saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : à quelle fréquence Amazon Kendra sera synchronisée avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés (**Document IDs****, Titres** des documents et **Source URLs**) que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à Aurora(PostgreSQL)**
Vous devez spécifier les éléments suivants à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API :
+ **Source de données** —Spécifiez le type de source de données tel que `JDBC` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type de base de données** —Vous devez spécifier le type de base de données sous `postgresql` la forme.
+ **Requête SQL** : spécifiez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre Aurora(PostgreSQL) compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"user name": "database user name",
"password": "password"
}
```
**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).
+ **IAMrole** —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 Aurora(PostgreSQL) connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de Aurora(PostgreSQL) 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure un contenu spécifique en utilisant l'utilisateur IDs, les groupes, la source URLs, les horodatages et les fuseaux horaires.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de Aurora(PostgreSQL) données à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez[Aurora Schéma de modèle (PostgreSQL)](ds-schemas.md#ds-aurora-postgresql-schema).
------
## Remarques
+ Les lignes de base de données supprimées ne seront pas suivies lors de la Amazon Kendra vérification du contenu mis à jour.
+ La taille des noms et des valeurs des champs d’une ligne de votre base de données ne peut pas dépasser 400 Ko.
+ Si la source de données de votre base de données contient une grande quantité de données et que vous ne souhaitez pas Amazon Kendra indexer tout le contenu de votre base de données après la première synchronisation, vous pouvez choisir de ne synchroniser que les documents nouveaux, modifiés ou supprimés.
+ Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Il est recommandé d'éviter d'ajouter des tableaux contenant des données sensibles ou des informations personnelles identifiables (PII).
# Amazon FSx(Fenêtres)
Amazon FSx(Windows) est un système de serveur de fichiers entièrement géré basé sur le cloud qui offre des fonctionnalités de stockage partagé. Si vous êtes un utilisateur Amazon FSx (Windows), vous pouvez l'utiliser Amazon Kendra pour indexer votre source de données Amazon FSx (Windows).
**Note**
Amazon Kendraprend désormais en charge un connecteur mis à niveau Amazon FSx (Windows).
La console a été automatiquement mise à niveau pour vous. Tous les nouveaux connecteurs que vous créez sur la console utiliseront l'architecture mise à niveau. Si vous utilisez l'API, vous devez désormais utiliser l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet au lieu de l'`FSxConfiguration`objet pour configurer votre connecteur.
Les connecteurs configurés à l'aide de l'ancienne console et de l'ancienne architecture d'API continueront de fonctionner tels qu'ils ont été configurés. Toutefois, vous ne pourrez ni les modifier ni les mettre à jour. Si vous souhaitez modifier ou mettre à jour la configuration de votre connecteur, vous devez créer un nouveau connecteur.
Nous vous recommandons de migrer le flux de travail de votre connecteur vers la version mise à niveau. Support pour les connecteurs configurés à l'aide de l'ancienne architecture devrait prendre fin en juin 2024.
Vous pouvez vous connecter Amazon Kendra à votre source de données Amazon FSx (Windows) à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) ou de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Amazon FSx (Windows), consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-fsx)
+ [Conditions préalables](#prerequisites-fsx)
+ [Instructions de connexion](#data-source-procedure-fsx)
+ [En savoir plus](#fsx-learn-more)
## Fonctionnalités prises en charge
Amazon KendraAmazon FSxLe connecteur de source de données (Windows) prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Exploration de l'identité des utilisateurs
+ Filtres d'inclusion et d'exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Amazon FSx (Windows), vérifiez les détails de votre Amazon FSx (Windows) etComptes AWS.
**Pour Amazon FSx (Windows), assurez-vous d'avoir** :
+ Configurez Amazon FSx (Windows) avec des autorisations de lecture et de montage.
+ Vous avez noté l'identifiant de votre système de fichiers. Vous trouverez l'ID de votre système de fichiers sur le tableau de bord des systèmes de fichiers de la console Amazon FSx (Windows).
+ Configuré un cloud privé virtuel en utilisant l'Amazon VPCemplacement de votre système de fichiers Amazon FSx (Windows).
+ Vous avez noté vos informations d'authentification Amazon FSx (Windows) pour un compte Active Directory utilisateur. Cela inclut votre nom d'utilisateur Active Directory avec votre nom de domaine DNS (par exemple, *user@corp.example.com*) et votre mot de passe.
**Note**
Utilisez uniquement les informations d'identification nécessaires au fonctionnement du connecteur. N'utilisez pas d'informations d'identification privilégiées telles que celles d'administrateur de domaine.
**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).
+ Il est vérifié que chaque document est unique dans Amazon FSx (Windows) et dans 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 votreCompte 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'authentification Amazon FSx (Windows) 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 données Amazon FSx (Windows) à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 données Amazon FSx (Windows), vous devez fournir les informations nécessaires sur votre source de données Amazon FSx (Windows) afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Amazon FSx (Windows) pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-fsx).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à votre système de fichiers Amazon FSx (Windows)**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Amazon FSx (Windows)**, puis choisissez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Amazon FSx (Windows)** 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. **Amazon FSxID de système de fichiers (Windows)** —Sélectionnez dans le menu déroulant votre identifiant de système de fichiers existant, extrait depuis Amazon FSx (Windows). Vous pouvez également créer un [système de fichiers Amazon FSx (Windows)](https://console.aws.amazon.com/fsx/). Vous trouverez l'ID de votre système de fichiers sur le tableau de bord des systèmes de fichiers de la console Amazon FSx (Windows).
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **Authentification** : choisissez un AWS Secrets Manager secret existant ou créez-en un nouveau pour stocker les informations d'identification de votre système de fichiers. Si vous choisissez de créer un secret, une fenêtre de secret AWS Secrets Manager s’ouvre.
Fournissez un secret qui stocke vos informations d'authentification, à savoir votre nom d'utilisateur et votre mot de passe. Le nom d'utilisateur doit inclure votre nom de domaine DNS. Par exemple : *user@corp.example.com*.
Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous devez sélectionner l'Amazon VPCemplacement de votre Amazon FSx (Windows). Vous incluez le sous-réseau VPC et les groupes de sécurité. Voir [Configuration d'un Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
1. **IAMrô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**
IAMles 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. **Étendue de synchronisation, modèles Regex** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains fichiers.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. **Calendrier d'exécution de synchronisation** : pour **Fréquence**, choisissez la fréquence à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs par défaut Amazon Kendra générés de vos fichiers que vous souhaitez mapper à votre index. Pour ajouter des champs de source de données personnalisés, créez un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à votre système de fichiers Amazon FSx (Windows)**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-schema) à l'aide de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `FSX` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **ID du système de fichiers** : identifiant du système de fichiers Amazon FSx (Windows). Vous trouverez l'ID de votre système de fichiers sur le tableau de bord des systèmes de fichiers de la console Amazon FSx (Windows).
+ **Type de système de fichiers** —Spécifiez le type de système de fichiers en tant que`WINDOWS`.
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
**Note**
Vous devez sélectionner l'Amazon VPCemplacement de votre Amazon FSx (Windows). Vous incluez le sous-réseau VPC et les groupes de sécurité.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **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 compte Amazon FSx (Windows). Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user@corp.example.com",
"password": "password"
}
```
+ **IAMrole** —Spécifiez `CreateDataSource` à quel `RoleArn` moment vous appelez pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et d'appeler le public requis APIs pour le connecteur Amazon FSx (Windows) etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles pour les sources de données Amazon FSx (Windows)](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** : spécifiez si vous souhaitez inclure ou exclure certains fichiers.
**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.
+ **Liste de contrôle d'accès (ACL)** : indiquez si vous souhaitez analyser les informations ACL de vos documents, si vous disposez d'une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
**Note**
Pour tester le filtrage du contexte utilisateur sur un utilisateur, vous devez inclure le nom de domaine DNS dans le nom d'utilisateur lorsque vous émettez la requête. Vous devez disposer des autorisations administratives du domaine Active Directory. Vous pouvez également tester le filtrage du contexte utilisateur sur le nom d'un groupe.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Amazon FSx (Windows) à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma de modèle Amazon FSx (Windows)](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-windows-schema).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Amazon FSx (Windows), consultez :
+ [Recherchez en toute sécurité des données non structurées sur les systèmes de fichiers Windows à l'aide du Amazon Kendra connecteur pour Amazon FSx (Windows) pour Windows File Server](https://aws.amazon.com/blogs/machine-learning/securely-search-unstructured-data-on-windows-file-systems-with-amazon-kendra-connector-for-amazon-fsx-for-windows-file-server/).
# Amazon FSx(NetApp ONTAP)
Amazon FSx(NetApp ONTAP) est un système de serveur de fichiers entièrement géré basé sur le cloud qui offre des fonctionnalités de stockage partagé. Si vous êtes un utilisateur Amazon FSx (NetApp ONTAP), vous pouvez l'utiliser Amazon Kendra pour indexer votre source de données Amazon FSx (NetApp ONTAP).
Vous pouvez vous connecter Amazon Kendra à votre source de données Amazon FSx (NetApp ONTAP) à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) ou de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Amazon FSx (NetApp ONTAP), consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-fsx-ontap)
+ [Conditions préalables](#prerequisites-fsx-ontap)
+ [Instructions de connexion](#data-source-procedure-fsx-ontap)
## Fonctionnalités prises en charge
Amazon KendraAmazon FSxLe connecteur de source de données (NetApp ONTAP) prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d'inclusion et d'exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Amazon FSx (NetApp ONTAP), vérifiez les détails de votre source de données Amazon FSx (NetApp ONTAP) et. Comptes AWS
**Pour Amazon FSx (NetApp ONTAP), assurez-vous d'avoir** :
+ Configuration Amazon FSx (NetApp ONTAP) avec autorisations de lecture et de montage.
+ Vous avez noté l'identifiant de votre système de fichiers. Vous trouverez l'ID de votre système de fichiers sur le tableau de bord des systèmes de fichiers de la console Amazon FSx (NetApp ONTAP).
+ Notez l'ID de la machine virtuelle de stockage (SVM) utilisé avec votre système de fichiers. Vous pouvez trouver votre identifiant de SVM en accédant au tableau de bord des systèmes de fichiers de la console Amazon FSx (NetApp ONTAP), en sélectionnant l'identifiant de votre système de fichiers, puis en sélectionnant Machines **virtuelles de stockage**.
+ Configuré un cloud privé virtuel en utilisant l'Amazon VPCemplacement de votre système de fichiers Amazon FSx (NetApp ONTAP).
+ Vous avez noté vos informations d'authentification Amazon FSx (NetApp ONTAP) pour un compte Active Directory utilisateur. Cela inclut votre nom d'utilisateur Active Directory avec votre nom de domaine DNS (par exemple, *user@corp.example.com*) et votre mot de passe. Si vous utilisez le protocole NFS (Network File System) pour votre système de fichiers Amazon FSx (NetApp ONTAP), les informations d'authentification incluent un identifiant gauche, un identifiant droit et une clé pré-partagée.
**Note**
Utilisez uniquement les informations d'identification nécessaires au fonctionnement du connecteur. N'utilisez pas d'informations d'identification privilégiées telles que celles d'administrateur de domaine.
**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).
+ Il est vérifié que chaque document est unique dans Amazon FSx (NetApp ONTAP) et dans 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 votreCompte 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'authentification Amazon FSx (NetApp ONTAP) 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 données Amazon FSx (NetApp ONTAP) à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 données Amazon FSx (NetApp ONTAP), vous devez fournir les informations nécessaires sur votre source de données Amazon FSx (NetApp ONTAP) afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Amazon FSx (NetApp ONTAP) pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-fsx-ontap).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à votre système de fichiers Amazon FSx (NetApp ONTAP)**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Amazon FSx (NetApp ONTAP)**, puis choisissez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Amazon FSx (NetApp ONTAP)** 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. **Source** —Fournissez les informations relatives à votre système de fichiers.
+ **Protocole du système de fichiers** : choisissez le protocole de votre système de fichiers Amazon FSx (NetApp ONTAP). Vous pouvez choisir le protocole CIFS (Common Internet File System) ou le protocole NFS (Network File System) pour Linux.
+ **Amazon FSxID du système de fichiers (NetApp ONTAP)** —Sélectionnez dans le menu déroulant votre identifiant de système de fichiers existant, extrait de (ONTAP). Amazon FSx NetApp Vous pouvez également créer un [système de fichiers Amazon FSx (NetApp ONTAP)](https://console.aws.amazon.com/fsx/). Vous trouverez l'ID de votre système de fichiers sur le tableau de bord des systèmes de fichiers de la console Amazon FSx (NetApp ONTAP).
+ **ID de la SVM** (Amazon FSx(NetApp ONTAP) NetApp ONTAP uniquement) : indiquez l'identifiant de la machine virtuelle de stockage (SVM) de votre Amazon FSx (ONTAP). NetApp NetApp ONTAP Vous pouvez trouver votre identifiant de SVM en accédant au tableau de bord des systèmes de fichiers de la console Amazon FSx (NetApp ONTAP), en sélectionnant l'identifiant de votre système de fichiers et en sélectionnant Machines **virtuelles de stockage**.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **Authentification** : choisissez un AWS Secrets Manager secret existant ou créez-en un nouveau pour stocker les informations d'identification de votre système de fichiers. Si vous choisissez de créer un secret, une fenêtre de secret AWS Secrets Manager s’ouvre.
Fournissez un secret qui stocke vos informations d'authentification, à savoir votre nom d'utilisateur et votre mot de passe. Le nom d'utilisateur doit inclure votre nom de domaine DNS. Par exemple : *user@corp.example.com*.
Si vous utilisez le protocole NFS pour votre système de fichiers Amazon FSx (NetApp ONTAP), fournissez un secret qui stocke vos informations d'authentification (ID gauche, ID droit et clé pré-partagée).
Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous devez sélectionner l'Amazon VPCendroit où réside votre Amazon FSx (ONTAP). NetApp Vous incluez le sous-réseau VPC et les groupes de sécurité. Voir [Configuration d'un Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
1. **IAMrô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**
IAMles 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. **Étendue de synchronisation, modèles Regex** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains fichiers.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. **Calendrier d'exécution de synchronisation** : pour **Fréquence**, choisissez la fréquence à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs par défaut Amazon Kendra générés de vos fichiers que vous souhaitez mapper à votre index. Pour ajouter des champs de source de données personnalisés, créez un nom de champ d'index à mapper et le type de données du champ.
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 à votre système de fichiers Amazon FSx (NetApp ONTAP)**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-ontap-schema) à l'aide de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `FSXONTAP` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **ID du système de fichiers** : identifiant du système de fichiers Amazon FSx (NetApp ONTAP). Vous trouverez l'ID de votre système de fichiers sur le tableau de bord des systèmes de fichiers de la console Amazon FSx (NetApp ONTAP).
+ **ID de la SVM : identifiant** de la machine virtuelle de stockage (SVM) utilisé avec votre système de fichiers. Vous pouvez trouver votre identifiant de SVM en accédant au tableau de bord des systèmes de fichiers de la console Amazon FSx (NetApp ONTAP), en sélectionnant l'identifiant de votre système de fichiers, puis en sélectionnant Machines **virtuelles de stockage**.
+ **Type de protocole** : indiquez si vous utilisez le protocole CIFS (Common Internet File System) ou le protocole NFS (Network File System) pour Linux.
+ **Type de système de fichiers** : spécifiez le type de système de fichiers comme l'un ou l'autre`FSXONTAP`.
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
**Note**
Vous devez sélectionner le Amazon VPC lieu de résidence de votre Amazon FSx (NetApp ONTAP). Vous incluez le sous-réseau VPC et les groupes de sécurité.
+ **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 compte Amazon FSx (NetApp ONTAP). Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user@corp.example.com",
"password": "password"
}
```
Si vous utilisez le protocole NFS pour votre système de fichiers Amazon FSx (NetApp ONTAP), le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"leftId": "left ID",
"rightId": "right ID",
"preSharedKey": "pre-shared key"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment 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 connecteur Amazon FSx (NetApp ONTAP) et. Amazon Kendra Pour plus d'informations, consultez la section [IAMRôles pour les sources de données Amazon FSx (NetApp ONTAP)](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Filtres d'inclusion et d'exclusion** : spécifiez si vous souhaitez inclure ou exclure certains fichiers.
**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.
+ **Liste de contrôle d'accès (ACL)** : indiquez si vous souhaitez analyser les informations ACL de vos documents, si vous disposez d'une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
**Note**
Pour tester le filtrage du contexte utilisateur sur un utilisateur, vous devez inclure le nom de domaine DNS dans le nom d'utilisateur lorsque vous émettez la requête. Vous devez disposer des autorisations administratives du domaine Active Directory. Vous pouvez également tester le filtrage du contexte utilisateur sur le nom d'un groupe.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Amazon FSx (NetApp ONTAP) à vos Amazon Kendra champs d'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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du modèle Amazon FSx (NetApp ONTAP)](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-fsx-ontap-schema).
------
# Amazon RDS/Aurora
Vous pouvez indexer des documents stockés dans une base de données à l'aide d'une source de données de base de données. Après avoir fourni les informations de connexion pour la base de données, Amazon Kendra connecte et indexe les documents.
Amazon Kendraprend en charge les bases de données suivantes :
+ Amazon Aurora MySQL
+ Amazon Aurora PostgreSQL
+ Amazon RDSpour MySQL
+ Amazon RDSpour PostgreSQL
**Note**
Les bases de données Aurora sans serveur ne sont pas prises en charge.
**Important**
La dépréciation de ce RDS/Aurora connecteur Amazon est prévue pour fin 2023.
Amazon Kendraprend désormais en charge les nouveaux connecteurs de source de données de base de données. Pour une meilleure expérience, nous vous recommandons de choisir l'un des nouveaux connecteurs suivants pour votre cas d'utilisation :
[Aurora(MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-mysql.html)
[Aurora(PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-postgresql.html)
[Amazon RDS(MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-mysql.html)
[Amazon RDS(Microsoft SQL Server)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-ms-sql-server.html)
[Amazon RDS(Oracle)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-oracle.html)
[Amazon RDS(PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-postgresql.html)
[IBM DB2](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ibm-db2.html)
[Microsoft SQL Server](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ms-sql-server.html)
[MySQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html)
[Base de données Oracle](https://docs.aws.amazon.com/kendra/latest/dg/data-source-oracle-database.html)
[PostgreSQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-postgresql.html)
Vous pouvez vous connecter Amazon Kendra à la source de données de votre base de données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[DatabaseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DatabaseConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données de Amazon Kendra base de données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-database)
+ [Conditions préalables](#prerequisites-database)
+ [Instructions de connexion](#data-source-procedure-database)
## Fonctionnalités prises en charge
Amazon Kendrale connecteur de source de données de base de données prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer la source de données de votre base de données, apportez ces modifications à votre base de données et à vos AWS comptes.
**Dans votre base de données, assurez-vous d'avoir :**
+ Notez vos informations d'authentification de base, à savoir le nom d'utilisateur et le mot de passe de votre base de données.
+ Vous avez copié le nom d'hôte, le numéro de port, l'adresse de l'hôte, le nom de la base de données et le nom de la table de données contenant les données du document. Pour PostgreSQL, la table de données doit être une table publique ou un schéma public.
**Note**
L'hôte et le port indiquent Amazon Kendra où se trouve le serveur de base de données sur Internet. Le nom de la base de données et le nom de la table indiquent Amazon Kendra où se trouvent les données du document sur le serveur de base de données.
+ Les noms des colonnes de la table de données contenant les données du document ont été copiés. Vous devez inclure l'ID du document, le corps du document, les colonnes pour détecter si un document a changé (par exemple, dernière colonne mise à jour) et les colonnes facultatives de la table de données qui correspondent à des champs d'index personnalisés. Vous pouvez également associer n'importe quel [nom de champ Amazon Kendra réservé](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html#index-reserved-fields) à une colonne de table.
+ Vous avez copié les informations relatives au type de moteur de base de données, par exemple si vous l'utilisez Amazon RDS pour MySQL ou un autre type.
+ Il est vérifié que chaque document est unique dans la base de données et dans 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 votreCompte 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 les informations d'authentification de votre base de données 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 données de base de 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 données de base de données, vous devez fournir les informations nécessaires sur votre source de données de base de données afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré la base de données pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-database).
------
#### [ Console ]
**Pour se connecter Amazon Kendra à une base de données**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur de base** de données, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur de base de données** 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. **Point de terminaison** : nom d'hôte DNS, IPv4 adresse ou IPv6 adresse.
1. **Port** : numéro de port.
1. **Base de données** : nom de la base de données.
1. **Nom de la table —Nom** de la table.
1. Pour **Type d'authentification**, choisissez entre **Existant** et **Nouveau** pour stocker les informations d'authentification de votre base de données. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -database-» est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur** et le **mot de passe** : entrez les valeurs d'authentification de votre compte de base de données.
1. Choisissez **Enregistrer l'authentification**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
**Note**
Vous devez utiliser un sous-réseau privé. Si votre instance RDS se trouve dans un sous-réseau public de votre VPC, vous pouvez créer un sous-réseau privé doté d'un accès sortant à une passerelle NAT dans le sous-réseau public. Les sous-réseaux fournis dans la configuration VPC doivent se trouver dans l'ouest des États-Unis (Oregon), dans l'est des États-Unis (Virginie du Nord) ou dans l'UE (Irlande).
1. **IAMrô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**
IAMles 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 **Aurora MySQL**, **MySQL**, **Aurora PostgreSQL** et **PostgreSQL en fonction de votre cas d'utilisation**.
1. **Placer les identificateurs SQL entre guillemets** : sélectionnez cette option pour placer les identificateurs SQL entre guillemets doubles. Par exemple, « ColumnName ».
1. **Colonne ACL** et **colonnes de détection des modifications** : configurez les colonnes Amazon Kendra utilisées pour la détection des modifications (par exemple, dernière colonne mise à jour) et votre liste de contrôle d'accès.
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. **Amazon Kendramappages de champs par défaut** : 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. Vous devez ajouter les valeurs des **colonnes de base** de données pour `document_id` et `document_body`
1. **Mappages de champs personnalisés** : pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 se connecter Amazon Kendra à une base de données**
Vous devez spécifier l'[DatabaseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DatabaseConfiguration.html)API suivante :
+ **ColumnConfiguration**—Informations sur l'endroit où l'index doit obtenir les informations du document à partir de la base de données. Pour en savoir plus, consultez [ColumnConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ColumnConfiguration.html). Vous devez spécifier les champs `DocumentDataColumnName` (corps du document ou texte principal) et `DocumentIdColumnName` `ChangeDetectingColumn` (par exemple, dernière colonne mise à jour). La colonne mappée au `DocumentIdColumnName` champ doit être une colonne entière. L'exemple suivant montre une configuration de colonne simple pour une source de données de base de données :
```
"ColumnConfiguration": {
"ChangeDetectingColumns": [
"LastUpdateDate",
"LastUpdateTime"
],
"DocumentDataColumnName": "TextColumn",
"DocumentIdColumnName": "IdentifierColumn",
"DocoumentTitleColumnName": "TitleColumn",
"FieldMappings": [
{
"DataSourceFieldName": "AbstractColumn",
"IndexFieldName": "Abstract"
}
]
}
```
+ **ConnectionConfiguration**: informations de configuration requises pour se connecter à une base de données. Pour en savoir plus, consultez [ConnectionConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConnectionConfiguration.html).
+ **DatabaseEngineType**: type de moteur de base de données qui exécute la base de données. Le `DatabaseHost` champ pour `ConnectionConfiguration` doit être le point de terminaison de l'instance Amazon Relational Database Service (Amazon RDS) de la base de données. N'utilisez pas le point de terminaison du cluster.
+ **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 compte de base de données. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password"
}
```
L'exemple suivant montre une configuration de base de données, y compris l'ARN secret.
```
"DatabaseConfiguration": {
"ConnectionConfiguration": {
"DatabaseHost": "host.subdomain.domain.tld",
"DatabaseName": "DocumentDatabase",
"DatabasePort": 3306,
"SecretArn": "arn:aws:secretmanager:region:account ID:secret/secret name",
"TableName": "DocumentTable"
}
}
```
**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).
+ **IAMrole** —Spécifiez à `RoleArn` quel moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur de base de données etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de données de base](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) de données.
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC)** —Spécifiez dans le `VpcConfiguration` cadre de la configuration de la source de données. Consultez [la section Configuration Amazon Kendra pour utiliser un VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
**Note**
Vous ne devez utiliser qu'un sous-réseau privé. Si votre instance RDS se trouve dans un sous-réseau public de votre VPC, vous pouvez créer un sous-réseau privé doté d'un accès sortant à une passerelle NAT dans le sous-réseau public. Les sous-réseaux fournis dans la configuration VPC doivent se trouver dans l'ouest des États-Unis (Oregon), dans l'est des États-Unis (Virginie du Nord) ou dans l'UE (Irlande).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données de base de données à vos champs d'Amazon Kendraindex. 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).
------
# Amazon RDS(Microsoft SQL Server)
**Note**
Amazon RDSLe connecteur (Microsoft SQL Server) reste entièrement pris en charge pour les clients existants jusqu'au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
SQL Server est un système de gestion de base de données développé par Microsoft. Amazon RDSfor SQL Server facilite la configuration, l'exploitation et le dimensionnement des déploiements de SQL Server dans le cloud. Si vous êtes un utilisateur Amazon RDS (Microsoft SQL Server), vous pouvez l'utiliser Amazon Kendra pour indexer votre source de données Amazon RDS (Microsoft SQL Server). Le connecteur de source de données Amazon Kendra JDBC prend en charge Microsoft SQL Server 2019.
Vous pouvez vous connecter Amazon Kendra à votre source de données Amazon RDS (Microsoft SQL Server) à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Amazon RDS (Microsoft SQL Server), consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-rds-ms-sql-server)
+ [Conditions préalables](#prerequisites-rds-ms-sql-server)
+ [Instructions de connexion](#data-source-procedure-rds-ms-sql-server)
+ [Remarques](#rds-ms-sql-server-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Amazon RDS (Microsoft SQL Server), apportez ces modifications à votre Amazon RDS (Microsoft SQL Server) et à vos AWS comptes.
**Dans Amazon RDS (Microsoft SQL Server), assurez-vous que vous disposez des éléments suivants :**
+ Notez le nom d'utilisateur et le mot de passe de votre base de données.
**Important**
Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Vous avez copié l'URL, le port et l'instance de votre hôte de base de données.
+ Il est vérifié que chaque document est unique dans Amazon RDS (Microsoft SQL Server) et dans 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 votreCompte 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'authentification Amazon RDS (Microsoft SQL Server) 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 données Amazon RDS (Microsoft SQL Server) à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 données Amazon RDS (Microsoft SQL Server), vous devez fournir les détails de vos informations d'identification Amazon RDS (Microsoft SQL Server) afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Amazon RDS (Microsoft SQL Server) pour Amazon Kendra voir[Conditions préalables](#prerequisites-rds-ms-sql-server).
------
#### [ Console ]
**Pour se connecter Amazon Kendra à Amazon RDS (Microsoft SQL Server)**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Amazon RDS (Microsoft SQL Server)**, puis choisissez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Amazon RDS (Microsoft SQL Server)** 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. Dans **Source**, saisissez les informations suivantes :
1. **Hôte** : entrez le nom d'hôte de la base de données.
1. **Port** — Entrez le port de base de données.
1. **Instance** — Entrez l'instance de base de données.
1. **Activer l'emplacement du certificat SSL** : choisissez d'entrer le Amazon S3 chemin d'accès à votre fichier de certificat SSL.
1. Dans **Authentification**, entrez les informations suivantes :
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Amazon RDS (Microsoft SQL Server). Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - Amazon RDS (Microsoft SQL Server) -» est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le mot de **passe de** la base** de données, entrez les valeurs d'identification d'authentification que vous avez copiées depuis votre base de données.
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
+ **Requête SQL** : saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
**Note**
Si le nom d'une table contient des caractères spéciaux (non alphanumériques), vous devez utiliser des crochets autour du nom de la table. Par exemple, *select \$1 from [my-database-table]*
+ **Colonne de clé primaire** : indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données.
+ **Colonne de titre** : indiquez le nom de la colonne de titre du document dans votre table de base de données.
+ **Colonne du corps** : indiquez le nom de la colonne du corps du document dans votre table de base de données.
1. Dans **Configuration supplémentaire *(facultatif)***, choisissez l'une des options suivantes pour synchroniser un contenu spécifique au lieu de synchroniser tous les fichiers :
+ **Colonnes détectant les modifications** : entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendraréindexera le contenu en cas de modification de l'une de ces colonnes.
+ ** IDsColonne utilisateur** : entrez le nom de la colonne contenant l'utilisateur devant être autorisé IDs à accéder au contenu.
+ **Colonne des groupes** : saisissez le nom de la colonne contenant les groupes autorisés à accéder au contenu.
+ ** URLsColonne source** —Entrez le nom de la colonne contenant la source URLs à indexer.
+ **Colonne horodatage** : entrez le nom de la colonne contenant les horodatages. Amazon Kendrautilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié.
+ **Colonne des fuseaux horaires** : saisissez le nom de la colonne contenant les fuseaux horaires du contenu à explorer.
+ **Format d’horodatage** : saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : à quelle fréquence Amazon Kendra sera synchronisée avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés (**Document IDs****, Titres** des documents et **Source URLs**) que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 se connecter Amazon Kendra à Amazon RDS (Microsoft SQL Server)**
Vous devez spécifier les éléments suivants à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API :
+ **Source de données** —Spécifiez le type de source de données tel que `JDBC` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type de base de données** —Vous devez spécifier le type de base de données sous `sqlserver` la forme.
+ **Requête SQL** : spécifiez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
**Note**
Si le nom d'une table contient des caractères spéciaux (non alphanumériques), vous devez utiliser des crochets autour du nom de la table. Par exemple, *select \$1 from [my-database-table]*
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre compte Amazon RDS (Microsoft SQL Server). Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"user name": "database user name",
"password": "password"
}
```
**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).
+ **IAMrole** —Spécifiez `CreateDataSource` à quel `RoleArn` moment vous appelez pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur Amazon RDS (Microsoft SQL Server) etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles pour les sources de données Amazon RDS (Microsoft SQL Server)](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure un contenu spécifique en utilisant l'utilisateur IDs, les groupes, la source URLs, les horodatages et les fuseaux horaires.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données (Amazon RDSMicrosoft SQL Server) à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez[Amazon RDS Schéma de modèle (Microsoft SQL Server)](ds-schemas.md#ds-rds-ms-sql-server-schema).
------
## Remarques
+ Les lignes de base de données supprimées ne seront pas suivies lors de la Amazon Kendra vérification du contenu mis à jour.
+ La taille des noms et des valeurs des champs d’une ligne de votre base de données ne peut pas dépasser 400 Ko.
+ Si la source de données de votre base de données contient une grande quantité de données et que vous ne souhaitez pas Amazon Kendra indexer tout le contenu de votre base de données après la première synchronisation, vous pouvez choisir de ne synchroniser que les documents nouveaux, modifiés ou supprimés.
+ Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Il est recommandé d'éviter d'ajouter des tableaux contenant des données sensibles ou des informations personnelles identifiables (PII).
# Amazon RDS(MySQL)
**Note**
Le connecteur Amazon RDS(MySQL) reste entièrement pris en charge pour les clients existants jusqu’au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Amazon RDS(Amazon Relational Database Service) est un service Web qui facilite la configuration, l'exploitation et le dimensionnement d'une base de données relationnelle dans AWS le cloud. Si vous êtes un Amazon RDS utilisateur, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de Amazon RDS(MySQL) données. Le connecteur Amazon Kendra de source de données prend en charge les versions Amazon RDS MySql 5.6, 5.7 et 8.0.
Vous pouvez vous connecter Amazon Kendra à votre source de Amazon RDS(MySQL) données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra Amazon RDS(MySQL) données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-rds-mysql)
+ [Conditions préalables](#prerequisites-rds-mysql)
+ [Instructions de connexion](#data-source-procedure-rds-mysql)
+ [Remarques](#rds-mysql-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de Amazon RDS(MySQL) données, apportez ces modifications à vos AWS comptes Amazon RDS(MySQL) and.
**Dans Amazon RDS(MySQL), assurez-vous d’avoir :**
+ Notez le nom d'utilisateur et le mot de passe de votre base de données.
**Important**
Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Vous avez copié l'URL, le port et l'instance de votre hôte de base de données. Vous trouverez ces informations sur la Amazon RDS console.
+ Il est vérifié que chaque document est unique dans Amazon RDS(MySQL) 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 votreCompte 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'Amazon RDS(MySQL)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 Amazon RDS(MySQL) 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 Amazon RDS(MySQL) données, vous devez fournir les détails de vos Amazon RDS(MySQL) informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Amazon RDS(MySQL) pour Amazon Kendra voir[Conditions préalables](#prerequisites-rds-mysql).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Amazon RDS(MySQL)**
1. Connectez-vous à la [Amazon Kendraconsole 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 **Amazon RDS(MySQL)connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **Amazon RDS(MySQL)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 tirets, 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. Dans **Source**, saisissez les informations suivantes :
1. **Hôte** : saisissez l’URL de l’hôte de la base de données, par exemple : `http://instance URL.region.rds.amazonaws.com`.
1. **Port** : saisissez le port de la base de données, par exemple, `5432`.
1. **Instance** : saisissez l’instance de la base de données, par exemple, `postgres`.
1. **Activer l'emplacement du certificat SSL** : choisissez d'entrer le Amazon S3 chemin d'accès à votre fichier de certificat SSL.
1. Dans **Authentification**, entrez les informations suivantes :
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations Amazon RDS(MySQL) d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - Amazon RDS(MySQL) - » est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le mot de **passe de** la base** de données, entrez les valeurs d'identification d'authentification que vous avez copiées depuis votre base de données.
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
+ **Requête SQL** : saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. Les requêtes SQL doivent être inférieures à 32 Ko Les requêtes SQL doivent être inférieures à 32 Ko et ne pas contenir de points-virgules (;). Amazon Kendraanalysera tout le contenu de la base de données correspondant à votre requête.
+ **Colonne de clé primaire** : indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données.
+ **Colonne de titre** : indiquez le nom de la colonne de titre du document dans votre table de base de données.
+ **Colonne du corps** : indiquez le nom de la colonne du corps du document dans votre table de base de données.
1. Dans **Configuration supplémentaire *(facultatif)***, choisissez l'une des options suivantes pour synchroniser un contenu spécifique au lieu de synchroniser tous les fichiers :
+ **Colonnes détectant les modifications** : entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendraréindexera le contenu en cas de modification de l'une de ces colonnes.
+ ** IDsColonne des utilisateurs** : entrez le nom de la colonne contenant l'utilisateur devant être autorisé IDs à accéder au contenu.
+ **Colonne des groupes** : saisissez le nom de la colonne contenant les groupes autorisés à accéder au contenu.
+ ** URLsColonne source** —Entrez le nom de la colonne contenant la source URLs à indexer.
+ **Colonne horodatage** : entrez le nom de la colonne contenant les horodatages. Amazon Kendrautilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié.
+ **Colonne des fuseaux horaires** : saisissez le nom de la colonne contenant les fuseaux horaires du contenu à explorer.
+ **Format d’horodatage** : saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : à quelle fréquence Amazon Kendra sera synchronisée avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés (**Document IDs****, Titres** des documents et **Source URLs**) que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à Amazon RDS(MySQL)**
Vous devez spécifier les éléments suivants à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API :
+ **Source de données** —Spécifiez le type de source de données tel que `JDBC` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type de base de données** —Vous devez spécifier le type de base de données sous `mySql` la forme.
+ **Requête SQL** : spécifiez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre Amazon RDS(MySQL) compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"user name": "database user name",
"password": "password"
}
```
**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).
+ **IAMrole** —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 Amazon RDS(MySQL) connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de Amazon RDS(MySQL) 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure un contenu spécifique en utilisant l'utilisateur IDs, les groupes, la source URLs, les horodatages et les fuseaux horaires.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de Amazon RDS(MySQL) données à vos champs d'Amazon Kendraindex. 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).
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez[Amazon RDS Schéma de modèle (MySQL)](ds-schemas.md#ds-rds-mysql-schema).
------
## Remarques
+ Les lignes de base de données supprimées ne seront pas suivies lors de la Amazon Kendra vérification du contenu mis à jour.
+ La taille des noms et des valeurs des champs d’une ligne de votre base de données ne peut pas dépasser 400 Ko.
+ Si la source de données de votre base de données contient une grande quantité de données et que vous ne souhaitez pas Amazon Kendra indexer tout le contenu de votre base de données après la première synchronisation, vous pouvez choisir de ne synchroniser que les documents nouveaux, modifiés ou supprimés.
+ Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Il est recommandé d'éviter d'ajouter des tableaux contenant des données sensibles ou des informations personnelles identifiables (PII).
# Amazon RDS(Oracle)
**Note**
Le connecteur Amazon RDS(Oracle) reste entièrement pris en charge pour les clients existants jusqu’au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Amazon RDS(Amazon Relational Database Service) est un service Web qui facilite la configuration, l'exploitation et le dimensionnement d'une base de données relationnelle dans AWS le cloud. Si vous êtes un Amazon RDS(Oracle) utilisateur, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de Amazon RDS(Oracle) données. Le connecteur de source de Amazon Kendra Amazon RDS(Oracle) données prend en charge Amazon RDS Oracle Database 21c, Oracle Database 19c, Oracle Database 12c.
Vous pouvez vous connecter Amazon Kendra à votre source de Amazon RDS(Oracle) données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra Amazon RDS(Oracle) données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-rds-oracle)
+ [Conditions préalables](#prerequisites-rds-oracle)
+ [Instructions de connexion](#data-source-procedure-rds-oracle)
+ [Remarques](#rds-oracle-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de Amazon RDS(Oracle) données, apportez ces modifications à vos AWS comptes Amazon RDS(Oracle) and.
**Dans Amazon RDS(Oracle), assurez-vous d’avoir :**
+ Notez le nom d'utilisateur et le mot de passe de votre base de données.
**Important**
Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Vous avez copié l'URL, le port et l'instance de votre hôte de base de données.
+ Il est vérifié que chaque document est unique dans Amazon RDS(Oracle) 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 votreCompte 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'Amazon RDS(Oracle)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 Amazon RDS(Oracle) 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 Amazon RDS(Oracle) données, vous devez fournir les détails de vos Amazon RDS(Oracle) informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Amazon RDS(Oracle) pour Amazon Kendra voir[Conditions préalables](#prerequisites-rds-oracle).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Amazon RDS(Oracle)**
1. Connectez-vous à la [Amazon Kendraconsole 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 **Amazon RDS(Oracle)connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **Amazon RDS(Oracle)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 tirets, 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. Dans **Source**, saisissez les informations suivantes :
1. **Hôte** : entrez le nom d'hôte de la base de données.
1. **Port** — Entrez le port de base de données.
1. **Instance** — Entrez l'instance de base de données.
1. **Activer l'emplacement du certificat SSL** : choisissez d'entrer le Amazon S3 chemin d'accès à votre fichier de certificat SSL.
1. Dans **Authentification**, entrez les informations suivantes :
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations Amazon RDS(Oracle) d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - Amazon RDS(Oracle) - » est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le mot de **passe de** la base** de données, entrez les valeurs d'identification d'authentification que vous avez copiées depuis votre base de données.
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
+ **Requête SQL** : saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Colonne de clé primaire** : indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données.
+ **Colonne de titre** : indiquez le nom de la colonne de titre du document dans votre table de base de données.
+ **Colonne du corps** : indiquez le nom de la colonne du corps du document dans votre table de base de données.
1. Dans **Configuration supplémentaire — *facultatif***, choisissez l'une des options suivantes pour synchroniser un contenu spécifique au lieu de synchroniser tous les fichiers :
+ **Colonnes détectant les modifications** : entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendraréindexera le contenu en cas de modification de l'une de ces colonnes.
+ ** IDsColonne des utilisateurs** : entrez le nom de la colonne contenant l'utilisateur devant être autorisé IDs à accéder au contenu.
+ **Colonne des groupes** : saisissez le nom de la colonne contenant les groupes autorisés à accéder au contenu.
+ ** URLsColonne source** —Entrez le nom de la colonne contenant la source URLs à indexer.
+ **Colonne horodatage** : entrez le nom de la colonne contenant les horodatages. Amazon Kendrautilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié.
+ **Colonne des fuseaux horaires** : saisissez le nom de la colonne contenant les fuseaux horaires du contenu à explorer.
+ **Format d’horodatage** : saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : à quelle fréquence Amazon Kendra sera synchronisée avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés (**Document IDs****, Titres** des documents et **Source URLs**) que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à Amazon RDS(Oracle)**
Vous devez spécifier les éléments suivants à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API :
+ **Source de données** —Spécifiez le type de source de données tel que `JDBC` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type de base de données** —Vous devez spécifier le type de base de données sous `oracle` la forme.
+ **Requête SQL** : spécifiez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre Amazon RDS(Oracle) compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"user name": "database user name",
"password": "password"
}
```
**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).
+ **IAMrole** —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 Amazon RDS(Oracle) connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de Amazon RDS(Oracle) 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure un contenu spécifique en utilisant l'utilisateur IDs, les groupes, la source URLs, les horodatages et les fuseaux horaires.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de Amazon RDS(Oracle) données à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez[Amazon RDS schéma de modèle (Oracle)](ds-schemas.md#ds-rds-oracle-schema).
------
## Remarques
+ Les lignes de base de données supprimées ne seront pas suivies lors de la Amazon Kendra vérification du contenu mis à jour.
+ La taille des noms et des valeurs des champs d’une ligne de votre base de données ne peut pas dépasser 400 Ko.
+ Si la source de données de votre base de données contient une grande quantité de données et que vous ne souhaitez pas Amazon Kendra indexer tout le contenu de votre base de données après la première synchronisation, vous pouvez choisir de ne synchroniser que les documents nouveaux, modifiés ou supprimés.
+ Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Il est recommandé d'éviter d'ajouter des tableaux contenant des données sensibles ou des informations personnelles identifiables (PII).
# Amazon RDS(PostgreSQL)
**Note**
Le connecteur Amazon RDS(PostgreSQL) reste entièrement pris en charge pour les clients existants jusqu’au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Amazon RDSest un service Web qui facilite la configuration, l'exploitation et le dimensionnement d'une base de données relationnelle dans le AWS cloud. Si vous êtes un Amazon RDS utilisateur, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de Amazon RDS(PostgreSQL) données. Le connecteur de source de Amazon Kendra Amazon RDS(PostgreSQL) données prend en charge PostgreSQL 9.6.
Vous pouvez vous connecter Amazon Kendra à votre source de Amazon RDS(PostgreSQL) données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra Amazon RDS(PostgreSQL) données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-rds-postgresql)
+ [Conditions préalables](#prerequisites-rds-postgresql)
+ [Instructions de connexion](#data-source-procedure-rds-postgresql)
+ [Remarques](#rds-postgresql-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de Amazon RDS(PostgreSQL) données, apportez ces modifications à vos AWS comptes Amazon RDS(PostgreSQL) and.
**Dans Amazon RDS(PostgreSQL), assurez-vous d’avoir :**
+ Notez le nom d'utilisateur et le mot de passe de votre base de données.
**Important**
Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Vous avez copié l'URL, le port et l'instance de votre hôte de base de données. Vous pouvez trouver ces informations sur la Amazon RDS console.
+ Il est vérifié que chaque document est unique dans Amazon RDS(PostgreSQL) 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 votreCompte 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'Amazon RDS(PostgreSQL)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 Amazon RDS(PostgreSQL) 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 Amazon RDS(PostgreSQL) données, vous devez fournir les détails de vos Amazon RDS(PostgreSQL) informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Amazon RDS(PostgreSQL) pour Amazon Kendra voir[Conditions préalables](#prerequisites-rds-postgresql).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Amazon RDS(PostgreSQL)**
1. Connectez-vous à la [Amazon Kendraconsole 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 **Amazon RDS(PostgreSQL)connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **Amazon RDS(PostgreSQL)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. Dans **Source**, saisissez les informations suivantes :
1. **Hôte** : saisissez l’URL de l’hôte de la base de données, par exemple : `http://instance URL.region.rds.amazonaws.com`.
1. **Port** : saisissez le port de la base de données, par exemple, `5432`.
1. **Instance** : saisissez l’instance de la base de données, par exemple, `postgres`.
1. **Activer l'emplacement du certificat SSL** : choisissez d'entrer le Amazon S3 chemin d'accès à votre fichier de certificat SSL.
1. Dans **Authentification**, entrez les informations suivantes :
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations Amazon RDS(PostgreSQL) d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - Amazon RDS(PostgreSQL) - » est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le mot de **passe de** la base** de données, entrez les valeurs d'identification d'authentification que vous avez copiées depuis votre base de données.
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
+ **Requête SQL** : saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. Les requêtes SQL doivent être inférieures à 32 Ko Les requêtes SQL doivent être inférieures à 32 Ko et ne pas contenir de points-virgules (;). Amazon Kendraanalysera tout le contenu de la base de données correspondant à votre requête.
+ **Colonne de clé primaire** : indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données.
+ **Colonne de titre** : indiquez le nom de la colonne de titre du document dans votre table de base de données.
+ **Colonne du corps** : indiquez le nom de la colonne du corps du document dans votre table de base de données.
1. Dans **Configuration supplémentaire *(facultatif)***, choisissez l'une des options suivantes pour synchroniser un contenu spécifique au lieu de synchroniser tous les fichiers :
+ **Colonnes détectant les modifications** : entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendraréindexera le contenu en cas de modification de l'une de ces colonnes.
+ ** IDsColonne des utilisateurs** : entrez le nom de la colonne contenant l'utilisateur devant être autorisé IDs à accéder au contenu.
+ **Colonne des groupes** : saisissez le nom de la colonne contenant les groupes autorisés à accéder au contenu.
+ ** URLsColonne source** —Entrez le nom de la colonne contenant la source URLs à indexer.
+ **Colonne horodatage** : entrez le nom de la colonne contenant les horodatages. Amazon Kendrautilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié.
+ **Colonne des fuseaux horaires** : saisissez le nom de la colonne contenant les fuseaux horaires du contenu à explorer.
+ **Format d’horodatage** : saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : à quelle fréquence Amazon Kendra sera synchronisée avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés (**Document IDs****, Titres** des documents et **Source URLs**) que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 à Amazon RDS(PostgreSQL)**
Vous devez spécifier les éléments suivants à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API :
+ **Source de données** —Spécifiez le type de source de données tel que `JDBC` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type de base de données** —Vous devez spécifier le type de base de données sous `postgresql` la forme.
+ **Requête SQL** : spécifiez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre Amazon RDS(PostgreSQL) compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"user name": "database user name",
"password": "password"
}
```
**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).
+ **IAMrole** —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 Amazon RDS(PostgreSQL) connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de Amazon RDS(PostgreSQL) 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure un contenu spécifique en utilisant l'utilisateur IDs, les groupes, la source URLs, les horodatages et les fuseaux horaires.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de Amazon RDS(PostgreSQL) données à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez[Amazon RDS Schéma de modèle (PostgreSQL)](ds-schemas.md#ds-rds-postgresql-schema).
------
## Remarques
+ Les lignes de base de données supprimées ne seront pas suivies lors de la Amazon Kendra vérification du contenu mis à jour.
+ La taille des noms et des valeurs des champs d’une ligne de votre base de données ne peut pas dépasser 400 Ko.
+ Si la source de données de votre base de données contient une grande quantité de données et que vous ne souhaitez pas Amazon Kendra indexer tout le contenu de votre base de données après la première synchronisation, vous pouvez choisir de ne synchroniser que les documents nouveaux, modifiés ou supprimés.
+ Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Il est recommandé d'éviter d'ajouter des tableaux contenant des données sensibles ou des informations personnelles identifiables (PII).
# Amazon S3
Amazon S3 est un service de stockage d'objets qui stocke les données sous forme d'objets dans des compartiments. Vous pouvez l'utiliser Amazon Kendra pour indexer le référentiel de documents de votre Amazon S3 bucket.
**Avertissement**
Amazon Kendra n'utilise pas de politique de compartiment qui autorise un Amazon Kendra mandant à interagir avec un compartiment S3. Au lieu de cela, il utilise IAM des rôles. Assurez-vous qu'il Amazon Kendra n'est pas inclus en tant que membre de confiance dans votre politique de compartiment afin d'éviter tout problème de sécurité des données lié à l'octroi accidentel d'autorisations à des principaux arbitraires. Vous pouvez toutefois ajouter une politique de compartiment pour utiliser un Amazon S3 compartiment sur différents comptes. Pour plus d'informations, consultez la section [Politiques à Amazon S3 utiliser entre les comptes](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds-s3-cross-accounts) (dans l'onglet IAM Rôles S3, sous **IAM Rôles pour les sources de données**). Pour plus d'informations sur IAM les rôles pour les sources de données S3, consultez la section [IAM rôles](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds-s3).
**Note**
Amazon Kendra prend désormais en charge un Amazon S3 connecteur amélioré.
La console a été automatiquement mise à niveau pour vous. Tous les nouveaux connecteurs que vous créez dans la console utiliseront l'architecture mise à niveau. Si vous utilisez l'API, vous devez désormais utiliser l'[https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet au lieu de l'`S3DataSourceConfiguration`objet pour configurer votre connecteur.
Les connecteurs configurés à l'aide de l'ancienne console et de l'ancienne architecture d'API continueront de fonctionner tels qu'ils ont été configurés. Toutefois, vous ne pourrez ni les modifier ni les mettre à jour. Si vous souhaitez modifier ou mettre à jour la configuration de votre connecteur, vous devez créer un nouveau connecteur.
Nous vous recommandons de migrer le flux de travail de votre connecteur vers la version mise à niveau. Support pour les connecteurs configurés à l'aide de l'ancienne architecture devrait prendre fin en juin 2024.
Vous pouvez vous connecter à votre source de Amazon S3 données à l'aide de la [Amazon Kendra console](https://console.aws.amazon.com/kendra/) ou de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API.
**Note**
Pour générer un rapport d'état de synchronisation pour votre source de Amazon S3 données, consultez la section [Résolution des problèmes liés aux sources de données](https://docs.aws.amazon.com/kendra/latest/dg/troubleshooting-data-sources.html#troubleshooting-data-sources-sync-status-manifest).
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra S3, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-s3)
+ [Conditions préalables](#prerequisites-s3)
+ [Instructions de connexion](#data-source-procedure-s3)
+ [Création d'une source Amazon S3 de données](create-ds-s3.md)
+ [Amazon S3 métadonnées du document](s3-metadata.md)
+ [Contrôle d'accès pour les sources Amazon S3 de données](s3-acl.md)
+ [Utilisation Amazon VPC avec une source Amazon S3 de données](s3-vpc-example-1.md)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir l'utiliser Amazon Kendra pour indexer votre source de données S3, apportez ces modifications à votre S3 et à vos AWS comptes.
**Dans S3, assurez-vous d'avoir :**
+ Vous avez copié le nom de votre Amazon S3 compartiment.
**Note**
Votre compartiment doit se trouver dans la même région que votre Amazon Kendra index et celui-ci doit être autorisé à accéder au compartiment contenant vos documents.
+ Il est vérifié que chaque document est unique dans S3 et dans 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 AWS compte, 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.
Si vous n'avez pas de IAM rôle existant, vous pouvez utiliser la console pour créer un nouveau IAM rôle lorsque vous connectez votre source de données S3 à Amazon Kendra. Si vous utilisez l'API, vous devez fournir l'ARN d'un IAM rôle existant et un identifiant d'index.
## Instructions de connexion
Pour vous connecter Amazon Kendra à votre source de données S3, vous devez fournir les informations nécessaires sur votre source de données S3 afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré S3 pour Amazon Kendra, consultez[Conditions préalables](#prerequisites-s3).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Amazon S3 **
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 le **connecteur S3**, puis choisissez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur S3** 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 facultatives suivantes :
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. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. Choisissez **Suivant**.
1. Sur la page **Configurer les paramètres de synchronisation**, entrez les informations suivantes :
1. Pour l'**emplacement de la source de données** : spécifiez le chemin d'accès au Amazon S3 compartiment dans lequel vos données sont stockées. Sélectionnez **Parcourir S3** pour choisir votre compartiment S3.
1. Pour la **taille de fichier maximale** : spécifiez une limite en Mo pour analyser uniquement les fichiers inférieurs à cette limite. La taille de fichier maximale Amazon Kendra autorisée est de 50 Mo.
1. Pour les **fichiers de métadonnées (facultatif), préfixez l'emplacement du dossier** : spécifiez le chemin d'accès au dossier dans lequel vos métadonnées fields/attributes et celles des autres documents sont stockées. Sélectionnez **Parcourir S3** pour localiser votre dossier de métadonnées.
1. Pour l'**emplacement du fichier de configuration de la liste de contrôle d'accès** (facultatif) : spécifiez le chemin d'accès au fichier contenant une structure JSON de vos utilisateurs et de leur accès aux documents. Sélectionnez **Parcourir S3** pour localiser votre fichier de liste ACL.
1. (Facultatif) **Sélectionnez la clé de déchiffrement** : sélectionnez cette option pour utiliser une clé de déchiffrement. Vous pouvez choisir d'utiliser une AWS KMS clé existante.
1. Pour une **configuration supplémentaire** (facultative) : ajoutez des modèles pour inclure ou exclure certains fichiers. Tous les chemins sont relatifs au compartiment S3 de l'emplacement de la source de données.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations facultatives suivantes :
1. **Mappages de champs par défaut** : 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. **Ajouter un champ** : choisissez d'ajouter des champs de source de données personnalisés pour créer un nom de champ d'index à mapper et le type de données du champ.
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 à Amazon S3**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `S3` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **BucketName**: le nom du compartiment contenant les documents.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **IAM role** —Spécifiez à quel `RoleArn` moment 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 connecteur S3 et Amazon Kendra. Pour plus d'informations, consultez la section [IAM Rôles des sources de données S3](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : spécifiez s'il faut inclure ou exclure certains noms de fichiers, types de fichiers et chemins de fichiers. Vous utilisez des modèles globulaires (modèles qui peuvent transformer un motif générique en une liste de noms de chemins correspondant au modèle donné). Pour des exemples, consultez la section [Utilisation des filtres d'exclusion et d'inclusion](https://docs.aws.amazon.com/cli/latest/reference/s3/#use-of-exclude-and-include-filters) dans la référence des commandes de la AWS CLI.
+ **Configuration des métadonnées et du contrôle d'accès aux** documents : ajoutez des métadonnées de document et des fichiers de contrôle d'accès contenant des informations telles que l'URI source, l'auteur du document ou les attributs/champs personnalisés du document, ainsi que vos utilisateurs et les documents auxquels ils peuvent accéder. Chaque fichier de métadonnées contient des métadonnées relatives à un seul document.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données S3 à 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du S3 modèle](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-s3-schema).
------
### En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données S3, consultez :
+ [Recherchez des réponses avec précision à l'aide du connecteur Amazon Kendra S3 avec support VPC](https://aws.amazon.com/blogs/machine-learning/search-for-answers-accurately-using-amazon-kendra-s3-connector-with-vpc-support/)
# Création d'une source Amazon S3 de données
Les exemples suivants illustrent la création d'une source de Amazon S3 données. Les exemples supposent que vous avez déjà créé un index et un IAM rôle autorisés à lire les données de l'index. Pour plus d'informations sur le IAM rôle, consultez la section [Rôles IAM d'accès](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Pour plus d'informations sur la création d'un index, consultez la section [Création d'un index](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html).
------
#### [ CLI ]
```
aws kendra create-data-source \
--index-id index ID \
--name example-data-source \
--type S3 \
--configuration '{"S3Configuration":{"BucketName":"bucket name"}}'
--role-arn 'arn:aws:iam::account id:role:/role name
```
------
#### [ Python ]
L'extrait de code Python suivant crée une source de Amazon S3 données. Pour un exemple complet, voir[Démarrer (AWS SDK pour Python (Boto3))](gs-python.md).
```
print("Create an Amazon S3 data source.")
# Provide a name for the data source
name = "getting-started-data-source"
# Provide an optional description for the data source
description = "Getting started data source."
# Provide the IAM role ARN required for data sources
role_arn = "arn:aws:iam::${accountID}:role/${roleName}"
# Provide the data soource connection information
s3_bucket_name = "S3-bucket-name"
type = "S3"
# Configure the data source
configuration = {"S3DataSourceConfiguration":
{
"BucketName": s3_bucket_name
}
}
data_source_response = kendra.create_data_source(
Configuration = configuration,
Name = name,
Description = description,
RoleArn = role_arn,
Type = type,
IndexId = index_id
)
```
------
La création de votre source de données peut prendre un certain temps. Vous pouvez suivre la progression à l'aide de l'[DescribeDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DescribeDataSource.html)API. Lorsque le statut de la source de données est `ACTIVE` défini, la source de données est prête à être utilisée.
Les exemples suivants montrent comment obtenir le statut d'une source de données.
------
#### [ CLI ]
```
aws kendra describe-data-source \
--index-id index ID \
--id data source ID
```
------
#### [ Python ]
L'extrait de code Python suivant permet d'obtenir des informations sur une source de données S3. Pour un exemple complet, voir[Démarrer (AWS SDK pour Python (Boto3))](gs-python.md).
```
print("Wait for Amazon Kendra to create the data source.")
while True:
data_source_description = kendra.describe_data_source(
Id = "data-source-id",
IndexId = "index-id"
)
status = data_source_description["Status"]
print(" Creating data source. Status: "+status)
time.sleep(60)
if status != "CREATING":
break
```
------
Cette source de données n'a pas de calendrier, elle ne s'exécute donc pas automatiquement. Pour indexer la source de données, vous appelez [StartDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StartDataSourceSyncJob.html)pour synchroniser l'index avec la source de données.
Les exemples suivants illustrent la synchronisation d'une source de données.
------
#### [ CLI ]
```
aws kendra start-data-source-sync-job \
--index-id index ID \
--id data source ID
```
------
#### [ Python ]
L'extrait de code Python suivant synchronise une Amazon S3 source de données. Pour un exemple complet, voir[Démarrer (AWS SDK pour Python (Boto3))](gs-python.md).
```
print("Synchronize the data source.")
sync_response = kendra.start_data_source_sync_job(
Id = "data-source-id",
IndexId = "index-id"
)
```
------
# Amazon S3 métadonnées du document
Vous pouvez ajouter des métadonnées, des informations supplémentaires sur un document, aux documents d'un Amazon S3 compartiment à l'aide d'un fichier de métadonnées. Chaque fichier de métadonnées est associé à un document indexé.
Vos fichiers de métadonnées doivent être stockés dans le même compartiment que vos fichiers indexés. Vous pouvez spécifier un emplacement dans le compartiment pour vos fichiers de métadonnées à l'aide de la console ou du `S3Prefix` champ du `DocumentsMetadataConfiguration` paramètre lorsque vous créez une source de Amazon S3 données. Si vous ne spécifiez aucun préfixe Amazon S3 , vos fichiers de métadonnées doivent être stockés au même endroit que vos documents indexés.
Si vous spécifiez un Amazon S3 préfixe pour vos fichiers de métadonnées, ceux-ci se trouvent dans une structure de répertoire parallèle à celle de vos documents indexés. Amazon Kendra recherche uniquement dans le répertoire spécifié pour vos métadonnées. Si les métadonnées ne sont pas lues, vérifiez que l’emplacement du répertoire correspond à celui de vos métadonnées.
Les exemples suivants illustrent la manière dont l’emplacement du document indexé est mappé à l’emplacement du fichier de métadonnées. Notez que la Amazon S3 clé du document est ajoutée au Amazon S3 préfixe des métadonnées, puis suffixée `.metadata.json` pour former le chemin du fichier de métadonnées. Amazon S3 La Amazon S3 clé combinée, avec le Amazon S3 préfixe et le `.metadata.json` suffixe des métadonnées, ne doit pas comporter plus de 1024 caractères au total. Il est recommandé de ne pas dépasser 1 000 caractères pour tenir compte des caractères supplémentaires lorsque vous combinez votre clé avec le préfixe et le suffixe. Amazon S3
```
Bucket name:
s3://bucketName
Document path:
documents
Metadata path:
none
File mapping
s3://bucketName/documents/file.txt ->
s3://bucketName/documents/file.txt.metadata.json
```
```
Bucket name:
s3://bucketName
Document path:
documents/legal
Metadata path:
metadata
File mapping
s3://bucketName/documents/legal/file.txt ->
s3://bucketName/metadata/documents/legal/file.txt.metadata.json
```
Les métadonnées de votre document sont définies dans un fichier JSON. Le fichier doit être un fichier texte UTF-8 sans marqueur BOM. Le nom du fichier JSON doit être `..metadata.json`. Dans cet exemple, « document » est le nom du document auquel s'appliquent les métadonnées et « extension » est l'extension de fichier du document. L’ID de document doit être unique dans `..metadata.json`.
Le contenu du fichier JSON suit ce modèle. Tous attributes/fields sont facultatifs, il n'est donc pas nécessaire d'inclure tous les attributs. Vous devez fournir une valeur pour chaque attribut que vous souhaitez inclure ; la valeur ne peut pas être vide. Si vous ne spécifiez pas le`_source_uri`, les liens renvoyés par Amazon Kendra les résultats de recherche pointent vers le Amazon S3 compartiment contenant le document. `DocumentId`est mappé au champ `s3_document_id` et représente le chemin absolu vers le document dans S3.
```
{
"DocumentId": "S3 document ID, the S3 path to doc",
"Attributes": {
"_category": "document category",
"_created_at": "ISO 8601 encoded string",
"_last_updated_at": "ISO 8601 encoded string",
"_source_uri": "document URI",
"_version": "file version",
"_view_count": number of times document has been viewed,
"custom attribute key": "custom attribute value",
additional custom attributes
},
"AccessControlList": [
{
"Name": "user name",
"Type": "GROUP | USER",
"Access": "ALLOW | DENY"
}
],
"Title": "document title",
"ContentType": "For example HTML | PDF. For supported content types, see [Types of documents](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html)."
}
```
Les champs de métadonnées `_created_at` et `_last_updated_at` sont des dates codées ISO 8601. Par exemple, 2012-03-25T12:30:10\$101:00 est le format de date et d’heure ISO 8601 pour le 25 mars 2012 à 12 h 30 (plus 10 secondes) dans le fuseau horaire de l’heure d’Europe centrale.
Vous pouvez ajouter des informations supplémentaires au `Attributes` champ concernant un document que vous utilisez pour filtrer les requêtes ou pour regrouper les réponses aux requêtes. Pour de plus amples informations, veuillez consulter [Création de champs de document personnalisés](custom-attributes.md).
Vous pouvez utiliser le champ `AccessControlList` pour filtrer la réponse d’une requête. De cette manière, seuls certains utilisateurs et groupes ont accès aux documents. Pour de plus amples informations, veuillez consulter [Filtrage sur le contexte utilisateur](user-context-filter.md).
# Contrôle d'accès pour les sources Amazon S3 de données
Vous pouvez contrôler l'accès aux documents d'une source de Amazon S3 données à l'aide d'un fichier de configuration. Vous spécifiez le fichier dans la console ou en tant que `AccessControlListConfiguration` paramètre lorsque vous appelez l'[UpdateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateDataSource.html)API [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)or.
Le fichier de configuration contient une structure JSON qui identifie un préfixe S3 et répertorie les paramètres d'accès pour le préfixe. Le préfixe peut être un chemin ou un fichier individuel. Si le préfixe est un chemin, les paramètres d’accès s’appliquent à tous les fichiers de ce chemin. Le fichier de configuration JSON contient un nombre maximum de préfixes S3 et une taille de fichier maximale par défaut. Pour de plus amples informations, consultez [Quotas pour Amazon Kendra](quotas.md).
Vous pouvez spécifier à la fois les utilisateurs et les groupes dans les paramètres d'accès. Lorsque vous interrogez l'index, vous spécifiez les informations relatives aux utilisateurs et aux groupes. Pour de plus amples informations, veuillez consulter [Filtrage par attribut utilisateur](user-context-filter.md#context-filter-attribute).
La structure JSON du fichier de configuration doit être au format suivant :
```
[
{
"keyPrefix": "s3://BUCKETNAME/prefix1/",
"aclEntries": [
{
"Name": "user1",
"Type": "USER",
"Access": "ALLOW"
},
{
"Name": "group1",
"Type": "GROUP",
"Access": "DENY"
}
]
},
{
"keyPrefix": "s3://prefix2",
"aclEntries": [
{
"Name": "user2",
"Type": "USER",
"Access": "ALLOW"
},
{
"Name": "user1",
"Type": "USER",
"Access": "DENY"
},
{
"Name": "group1",
"Type": "GROUP",
"Access": "DENY"
}
]
}
]
```
# Utilisation Amazon VPC avec une source Amazon S3 de données
Cette rubrique fournit un step-by-step exemple qui montre comment se connecter à un compartiment Amazon S3 à l'aide d'un connecteur Amazon S3 via Amazon VPC. L'exemple suppose que vous commencez avec un compartiment S3 existant. Nous vous recommandons de ne télécharger que quelques documents dans votre compartiment S3 pour tester l'exemple.
Vous pouvez vous connecter Amazon Kendra à votre Amazon S3 bucket via Amazon VPC. Pour ce faire, vous devez spécifier le Amazon VPC sous-réseau et les groupes de Amazon VPC sécurité lors de la création de votre connecteur de source de Amazon S3 données.
**Important**
Pour qu'un Amazon Kendra Amazon S3 connecteur puisse accéder à votre Amazon S3 bucket, assurez-vous d'avoir attribué un Amazon S3 point de terminaison à votre cloud privé virtuel (VPC).
Amazon Kendra Pour synchroniser des documents depuis votre Amazon S3 compartiment Amazon VPC, vous devez suivre les étapes suivantes :
+ Configurez un Amazon S3 point de terminaison pour Amazon VPC. Pour plus d'informations sur la configuration d'un Amazon S3 point de terminaison, consultez la section [Points de terminaison de passerelle pour Amazon S3](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-s3.html) le *AWS PrivateLink Guide*.
+ (Facultatif) Vérifiez vos politiques de Amazon S3 bucket pour vous assurer que le Amazon S3 bucket est accessible depuis le cloud privé virtuel (VPC) auquel vous l'avez assigné. Amazon Kendra Pour plus d'informations, consultez la section [Contrôle de l'accès depuis les points de terminaison VPC avec des politiques de compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies-vpc-endpoint.html) dans le guide de l'utilisateur *Amazon* S3
**Topics**
+ [Étape 1 : Configuration d'un Amazon VPC](#s3-configure-vpc)
+ [(Facultatif) Étape 2 : Configuration de la politique de Amazon S3 compartiment](#s3-configure-bucket-policy)
+ [Étape 3 : Création d'un connecteur de source Amazon S3 de données de test](#s3-connect-vpc)
## Étape 1 : Configuration d'un Amazon VPC
Créez un réseau VPC comprenant un sous-réseau privé avec un point de terminaison de Amazon S3 passerelle et un groupe de sécurité Amazon Kendra à utiliser ultérieurement.
**Pour configurer un VPC avec un sous-réseau privé, un point de terminaison S3 et un groupe de sécurité**
1. Connectez-vous à la Amazon VPC console AWS Management Console et ouvrez-la à l'adresse[https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).
1. **Créez un VPC avec un sous-réseau privé et un point de terminaison S3 pour Amazon Kendra utiliser :**
Dans le volet de navigation, choisissez **Your VPCs**, puis **Create VPC**.
1. Sous **Ressources à créer**, choisissez **VPC et plus encore**.
1. Dans le **champ Name tag**, activez **Générer automatiquement**, puis entrez**kendra-s3-example**.
1. Pour le **blocIPv4 / IPv6 CIDR**, conservez les valeurs par défaut.
1. Pour **Nombre de zones de disponibilité (AZs)**, choisissez **le numéro 1**.
1. Sélectionnez **Personnaliser AZs**, puis sélectionnez une zone de disponibilité dans la liste des **premières zones de disponibilité**.
Amazon Kendra ne prend en charge qu'un ensemble spécifique de zones de disponibilité.
1. Pour **Nombre de sous-réseaux publics**, choisissez le **numéro 0**.
1. Pour **Nombre de sous-réseaux privés**, choisissez le **numéro 1**.
1. Pour **NAT gateways** (Passerelles NAT), choisissez **None** (Aucun).
1. **Pour les **points de terminaison VPC, choisissez Gateway**.Amazon S3 ** .
1. Conservez les paramètres par défaut pour les autres valeurs.
1. Sélectionnez **Créer VPC**.
Attendez que le flux de travail de **création d'un VPC** soit terminé. Choisissez ensuite **View VPC pour vérifier le VPC** que vous venez de **créer.**
Vous venez de créer un réseau VPC avec un sous-réseau privé, qui n'a pas accès à l'Internet public.
1. **Copiez l'ID de point de terminaison VPC de votre point de terminaison Amazon S3 :**
1. Dans le volet de navigation, choisissez **Points de terminaison**.
1. Dans la liste des **points de terminaison**, recherchez le point de terminaison Amazon S3 `kendra-s3-example-vpce-s3` que vous venez de créer avec votre VPC.
1. Notez l'ID du point de **terminaison du VPC**.
Vous venez de créer un point de terminaison de passerelle Amazon S3 pour accéder à votre compartiment Amazon S3 via un sous-réseau.
1. **Créez un **groupe de sécurité** Amazon Kendra pour utiliser :**
1. Dans le volet de navigation, choisissez **Security Groups**, puis sélectionnez **Create security group**.
1. Sous **Security group name (Nom du groupe de sécurité)**, saisissez **s3-data-source-security-group**.
1. Choisissez votre VPC dans la **Amazon VPC**liste.
1. Conservez **les règles entrantes** et **sortantes par** défaut.
1. Sélectionnez **Create security group** (Créer un groupe de sécurité).
Vous venez de créer un groupe de sécurité VPC.
Vous attribuez le sous-réseau et le groupe de sécurité que vous avez créés à votre connecteur de source de données Amazon Kendra Amazon S3 pendant le processus de configuration du connecteur.
## (Facultatif) Étape 2 : Configuration de la politique de Amazon S3 compartiment
Dans cette étape facultative, découvrez comment configurer une politique de compartiment Amazon S3 afin que votre compartiment Amazon S3 ne soit accessible que depuis le VPC auquel vous l'attribuez. Amazon Kendra
Amazon Kendra utilise des rôles IAM pour accéder à votre compartiment Amazon S3 et ne nécessite pas que vous configuriez une politique de compartiment Amazon S3. Cependant, il peut être utile de créer une politique de compartiment si vous souhaitez configurer un Amazon S3 connecteur à l'aide d'un compartiment Amazon S3 dont les politiques existantes limitent l'accès depuis l'Internet public.
**Pour configurer votre politique de Amazon S3 compartiment**
1. Ouvrez la console Amazon S3 à l'adresse[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation, sélectionnez **Buckets**.
1. Choisissez le nom du compartiment Amazon S3 avec lequel vous souhaitez effectuer la synchronisation Amazon Kendra.
1. Choisissez l'onglet **Autorisations**, faites défiler la page jusqu'à **Bucket policy**, puis cliquez sur **Modifier**.
1. Ajoutez ou modifiez votre politique de compartiment pour autoriser l'accès uniquement depuis le point de terminaison VPC que vous avez créé.
Voici un exemple de stratégie de compartiment. Remplacez *`bucket-name`* et *`vpce-id`* par le nom de votre compartiment Amazon S3 et l'ID de point de terminaison Amazon S3 que vous avez indiqués précédemment.
1. Cliquez sur **Enregistrer les modifications**.
Votre compartiment S3 n'est désormais accessible qu'à partir du VPC spécifique que vous avez créé.
## Étape 3 : Création d'un connecteur de source Amazon S3 de données de test
Pour tester votre Amazon VPC configuration, créez un Amazon S3 connecteur. Configurez-le ensuite avec le VPC que vous avez créé en suivant les étapes décrites dans. [Amazon S3](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html)
Pour les valeurs Amazon VPC de configuration, choisissez les valeurs que vous avez créées dans cet exemple :
+ **Amazon VPC(VPC**) — `kendra-s3-example-vpc`
+ **Sous-réseaux —** `kendra-s3-example-subnet-private1-[availability zone]`
+ **Groupes de sécurité** — `s3-data-source-security-group`
Attendez que la création de votre connecteur soit terminée. Une fois le Amazon S3 connecteur créé, choisissez **Sync now** pour lancer une synchronisation.
La synchronisation peut prendre de quelques minutes à plusieurs heures, selon le nombre de documents contenus dans votre Amazon S3 compartiment. Pour tester cet exemple, nous vous recommandons de ne télécharger que quelques documents dans votre compartiment S3. Si votre configuration est correcte, vous devriez éventuellement voir le **statut de synchronisation** **terminé**.
Si vous rencontrez des erreurs, consultez la section [Résolution des problèmes de Amazon VPC connexion](https://docs.aws.amazon.com/kendra/latest/dg/vpc-connector-troubleshoot.html).
# Amazon Kendra robot d'exploration Web
Vous pouvez utiliser Amazon Kendra Web Crawler pour explorer et indexer des pages Web.
Vous ne pouvez explorer que les sites Web destinés au public ou les sites Web internes de l'entreprise qui utilisent le protocole de communication sécurisé Hypertext Transfer Protocol Secure (HTTPS). Si vous recevez un message d’erreur lors de l’indexation d’un site web, cela signifie peut-être que l’indexation du site web est bloquée. Pour indexer des sites Web internes, vous pouvez configurer un proxy Web. Le proxy Web doit être accessible au public. Vous pouvez également utiliser l’authentification pour accéder à des sites Web et les indexer.
*Lorsque vous sélectionnez des sites web à indexer, vous devez respecter les [Politiques d'Amazon en matière d'utilisation acceptable](https://aws.amazon.com/aup/) et toutes les autres conditions d'Amazon. N'oubliez pas que vous ne devez utiliser Amazon Kendra Web Crawler que pour indexer vos propres pages Web ou les pages Web que vous êtes autorisé à indexer. Pour savoir comment empêcher Amazon Kendra Web Crawler d'indexer vos sites Web, consultez. [Configuration du `robots.txt` fichier pour Amazon Kendra Web Crawler](stop-web-crawler.md)*
**Note**
L'utilisation abusive de Amazon Kendra Web Crawler pour explorer agressivement des sites Web ou des pages Web qui ne vous appartiennent pas n'est **pas** considérée comme une utilisation acceptable.
Amazon Kendra possède deux versions du web crawler connecteur. Les fonctionnalités prises en charge par chaque version incluent :
**Amazon Kendra Connecteur Web Crawler v1.0/API [https://docs.aws.amazon.com/kendra/latest/dg/API_WebCrawlerConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_WebCrawlerConfiguration.html)**
+ Proxy Web
+ Filtres d’inclusion et d’exclusion
**Amazon Kendra Connecteur Web Crawler v2.0/API [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)**
+ Mappages de champs
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Proxy Web
+ Authentification de base, NTLM/Kerberos, SAML et par formulaire pour vos sites Web
+ Cloud privé virtuel (VPC)
**Important**
La création de connecteurs Web Crawler v2.0 n'est pas prise en charge par. CloudFormation Utilisez le connecteur Web Crawler v1.0 si vous avez besoin d' CloudFormation assistance.
Pour résoudre les problèmes liés au connecteur de source de données de votre robot d'exploration Amazon Kendra Web, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Amazon Kendra Connecteur Web Crawler v1.0](data-source-v1-web-crawler.md)
+ [Amazon Kendra Connecteur Web Crawler v2.0](data-source-v2-web-crawler.md)
+ [Configuration du `robots.txt` fichier pour Amazon Kendra Web Crawler](stop-web-crawler.md)
# Amazon Kendra Connecteur Web Crawler v1.0
Vous pouvez utiliser Amazon Kendra Web Crawler pour explorer et indexer des pages Web.
Vous ne pouvez explorer que les sites Web destinés au public et les sites Web qui utilisent le protocole de communication sécurisé Hypertext Transfer Protocol Secure (HTTPS). Si vous recevez un message d’erreur lors de l’indexation d’un site web, cela signifie peut-être que l’indexation du site web est bloquée. Pour indexer des sites Web internes, vous pouvez configurer un proxy Web. Le proxy Web doit être accessible au public.
*Lorsque vous sélectionnez des sites web à indexer, vous devez respecter les [Politiques d'Amazon en matière d'utilisation acceptable](https://aws.amazon.com/aup/) et toutes les autres conditions d'Amazon. N'oubliez pas que vous ne devez utiliser Amazon Kendra Web Crawler que pour indexer vos propres pages Web ou les pages Web que vous êtes autorisé à indexer. Pour savoir comment empêcher Amazon Kendra Web Crawler d'indexer vos sites Web, consultez. [Configuration du `robots.txt` fichier pour Amazon Kendra Web Crawler](stop-web-crawler.md)*
**Note**
L'utilisation abusive de Amazon Kendra Web Crawler pour explorer agressivement des sites Web ou des pages Web qui ne vous appartiennent pas n'est **pas** considérée comme une utilisation acceptable.
Pour résoudre les problèmes liés au connecteur de source de données de votre robot d'exploration Amazon Kendra Web, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v1-web-crawler)
+ [Conditions préalables](#prerequisites-v1-web-crawler)
+ [Instructions de connexion](#data-source-v1-procedure-web-crawler)
+ [En savoir plus](#web-crawler-learn-more)
## Fonctionnalités prises en charge
+ Proxy Web
+ Filtres d’inclusion et d’exclusion
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer vos sites Web, vérifiez les détails de vos sites Web et de vos AWS comptes.
**Pour vos sites Web, assurez-vous d'avoir :**
+ Vous avez copié la source ou le plan URLs du site Web que vous souhaitez indexer.
+ **Pour les sites Web qui nécessitent une authentification de base** : notez le nom d'utilisateur et le mot de passe, puis copiez le nom d'hôte du site Web et le numéro de port.
+ **Facultatif :** vous avez copié le nom d'hôte du site Web et le numéro de port si vous souhaitez utiliser un proxy Web pour vous connecter aux sites Web internes que vous souhaitez explorer. Le proxy Web doit être accessible au public. Amazon Kendra prend en charge la connexion à des serveurs proxy Web basés sur une authentification de base ou vous pouvez vous connecter sans authentification.
+ Coché : chaque document de page Web que vous souhaitez indexer est unique et que vous comptez utiliser pour le même index parmi les autres sources de données. 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 AWS compte, 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.
+ Pour les sites Web qui nécessitent une authentification, ou s'ils utilisent un proxy Web avec authentification, stockez vos informations d'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 web crawler 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 web crawler données, vous devez fournir les informations nécessaires sur votre source de web crawler données afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré web crawler pour Amazon Kendra voir[Conditions préalables](#prerequisites-v1-web-crawler).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à web crawler**
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 **le connecteur Web Crawler**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Web Crawler** 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. Pour **Source**, choisissez entre les plans de **site **Source URLs** et Source en fonction de** votre cas d'utilisation et entrez les valeurs pour chacun d'eux.
Vous pouvez ajouter jusqu'à 10 sources URLs et trois plans de site.
**Note**
Si vous souhaitez explorer un plan du site, vérifiez que l'URL de base ou racine est identique à celle URLs répertoriée sur votre page de plan du site. Par exemple, si l'URL de votre plan du site est *https://example.com/sitemap-page.html*, celle URLs répertoriée sur cette page de plan du site doit également utiliser l'URL de base « https://example.com/ ».
1. (Facultatif) Pour **le proxy Web**, entrez les informations suivantes :
1. **Nom d'hôte** : nom d'hôte pour lequel un proxy Web est requis.
1. **Numéro de port** : port utilisé par le protocole de transport d'URL de l'hôte. Le numéro de port doit être une valeur numérique comprise entre 0 et 65 535.
1. Pour les **informations d'identification du proxy Web** : si votre connexion au proxy Web nécessite une authentification, choisissez un secret existant ou créez-en un nouveau pour stocker vos informations d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra-WebCrawler- » est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le** **mot de passe** : entrez ces informations d'authentification de base pour vos sites Web.
1. Choisissez **Enregistrer**.
1. (Facultatif) **Hôtes avec authentification** : sélectionnez cette option pour ajouter des hôtes supplémentaires avec 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. **Plage d'exploration** : choisissez le type de pages Web que vous souhaitez explorer.
1. **Profondeur du crawl** —Sélectionnez le nombre de niveaux à partir de l'URL de départ qui Amazon Kendra doivent être explorés.
1. **Paramètres d'exploration avancés** et **Configuration supplémentaire** saisissez les informations suivantes :
1. Taille de **fichier maximale : taille** maximale de page Web ou de pièce jointe à analyser. Minimum 0,000001 Mo (1 octet). 50 Mo maximum.
1. **Nombre maximum de liens par page** : nombre maximal de liens explorés par page. Les liens sont explorés par ordre d’apparition. Minimum 1link/page. Maximum 1000 links/page.
1. **Limitation maximale :** nombre maximal d'objets analysés par nom URLs d'hôte et par minute. Minimum 1 URLs/host name/minute. Maximum 300 URLs/host name/minute.
1. **Modèles Regex** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains. URLs 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 **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 à web crawler**
Vous devez spécifier les éléments suivants à l'aide de l'[WebCrawlerConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_WebCrawlerConfiguration.html)API :
+ **URLs**—Spécifiez le point de départ ou le point URLs de départ des sites Web ou le plan URLs du site Web que vous souhaitez explorer à l'aide [https://docs.aws.amazon.com/kendra/latest/dg/API_SeedUrlConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_SeedUrlConfiguration.html)de et. [https://docs.aws.amazon.com/kendra/latest/dg/API_SiteMapsConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_SiteMapsConfiguration.html)
**Note**
Si vous souhaitez explorer un plan du site, vérifiez que l'URL de base ou racine est identique à celle URLs répertoriée sur votre page de plan du site. Par exemple, si l'URL de votre plan du site est *https://example.com/sitemap-page.html*, celle URLs répertoriée sur cette page de plan du site doit également utiliser l'URL de base « https://example.com/ ».
+ **Nom de ressource Amazon secret (ARN)** : si un site Web nécessite une authentification de base, vous fournissez le nom d'hôte, le numéro de port et un secret qui stocke vos informations d'authentification de base, à savoir votre nom d'utilisateur et votre mot de passe. Vous fournissez l'ARN secret à l'aide de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_AuthenticationConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_AuthenticationConfiguration.html)API. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password"
}
```
Vous pouvez également fournir les informations d'identification du proxy Web à l'aide d'un AWS Secrets Manager secret. Vous utilisez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_ProxyConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_ProxyConfiguration.html)API pour fournir le nom d'hôte et le numéro de port du site Web, et éventuellement le secret qui stocke vos informations d'identification de proxy Web.
+ **IAM role** —Spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur Web Crawler et. Amazon Kendra Pour plus d'informations, consultez la section [IAM Rôles des sources de données des robots d'exploration Web](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Mode d'exploration** : choisissez d'explorer uniquement les noms d'hôtes des sites Web ou les noms d'hôtes avec des sous-domaines, ou d'explorer également les autres domaines vers lesquels les pages Web renvoient.
+ La « profondeur » ou le nombre de niveaux entre le niveau de la graine et le rampage. Par exemple, la page URL initiale est de profondeur 1 et tous les hyperliens de cette page qui sont également explorés ont une profondeur de 2.
+ Le nombre maximum de pages Web à explorer URLs sur une seule page Web.
+ Taille maximale en Mo d'une page Web à explorer.
+ Le nombre maximum d' URLs explorations par hôte de site Web par minute.
+ L'hôte du proxy Web et le numéro de port permettant de se connecter aux sites Web internes et de les parcourir. Par exemple, le nom d'hôte *https://a.example.com/page1.html*est « a.example.com » et le numéro de port est 443, le port standard pour HTTPS. Si des informations d'identification de proxy Web sont requises pour se connecter à un hébergeur de site Web, vous pouvez en créer un AWS Secrets Manager qui stocke les informations d'identification.
+ Informations d'authentification permettant d'accéder aux sites Web qui nécessitent une authentification utilisateur et de les analyser.
+ Vous pouvez extraire des balises méta HTML sous forme de champs à l'aide de l'outil *d'enrichissement de documents personnalisé*. Pour plus d'informations, veuillez consulter la rubrique [Personnalisation des métadonnées de documents pendant le processus d'intégration](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html). Pour un exemple d'extraction de balises méta HTML, consultez les exemples [CDE](https://github.com/aws-samples/amazon-kendra-cde-examples).
+ **Filtres d'inclusion et d'exclusion** : spécifiez s'il faut inclure ou exclure certains URLs.
**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.
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de web crawler données, consultez :
+ [Réinventez la découverte des connaissances à l'aide Amazon Kendra du Web Crawler](https://aws.amazon.com/blogs/machine-learning/reimagine-knowledge-discovery-using-amazon-kendras-web-crawler/)
# Amazon Kendra Connecteur Web Crawler v2.0
Vous pouvez utiliser Amazon Kendra Web Crawler pour explorer et indexer des pages Web.
Vous ne pouvez explorer que les sites Web destinés au public ou les sites Web internes de l'entreprise qui utilisent le protocole de communication sécurisé Hypertext Transfer Protocol Secure (HTTPS). Si vous recevez un message d’erreur lors de l’indexation d’un site web, cela signifie peut-être que l’indexation du site web est bloquée. Pour indexer des sites Web internes, vous pouvez configurer un proxy Web. Le proxy Web doit être accessible au public. Vous pouvez également utiliser l’authentification pour accéder à des sites Web et les indexer.
Amazon Kendra Web Crawler v2.0 utilise le package Selenium Web Crawler et un pilote Chromium. Amazon Kendra met automatiquement à jour la version de Selenium et le pilote Chromium à l'aide de l'intégration continue (CI).
*Lorsque vous sélectionnez des sites web à indexer, vous devez respecter les [Politiques d'Amazon en matière d'utilisation acceptable](https://aws.amazon.com/aup/) et toutes les autres conditions d'Amazon. N'oubliez pas que vous ne devez utiliser Amazon Kendra Web Crawler que pour indexer vos propres pages Web ou les pages Web que vous êtes autorisé à indexer. Pour savoir comment empêcher Amazon Kendra Web Crawler d'indexer vos sites Web, consultez. [Configuration du `robots.txt` fichier pour Amazon Kendra Web Crawler](stop-web-crawler.md)* . L'utilisation abusive de Amazon Kendra Web Crawler pour explorer agressivement des sites Web ou des pages Web qui ne vous appartiennent pas n'est **pas** considérée comme une utilisation acceptable.
Pour résoudre les problèmes liés au connecteur de source de données de votre robot d'exploration Amazon Kendra Web, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Note**
Le connecteur Web Crawler v2.0 ne prend *pas* en charge l'analyse de listes de sites Web à partir de AWS KMS compartiments chiffrés. Amazon S3 Il prend uniquement en charge le chiffrement côté serveur avec des clés Amazon S3 gérées.
**Important**
La création de connecteurs Web Crawler v2.0 n'est pas prise en charge par. CloudFormation Utilisez le connecteur Web Crawler v1.0 si vous avez besoin d' CloudFormation assistance.
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v2-web-crawler)
+ [Conditions préalables](#prerequisites-v2-web-crawler)
+ [Instructions de connexion](#data-source-v2-procedure-web-crawler)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Proxy Web
+ Authentification de base, NTLM/Kerberos, SAML et par formulaire pour vos sites Web
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer vos sites Web, vérifiez les détails de vos sites Web et de vos AWS comptes.
**Pour vos sites Web, assurez-vous d'avoir :**
+ Vous avez copié la source ou le plan URLs du site Web que vous souhaitez indexer. Vous pouvez les stocker URLs dans un fichier texte et les télécharger dans un Amazon S3 bucket. Chaque URL du fichier texte doit être mise en forme sur une ligne distincte. Si vous souhaitez stocker vos plans de site dans un Amazon S3 bucket, assurez-vous d'avoir copié le code XML du plan de site et de l'avoir enregistré dans un fichier XML. Vous pouvez également regrouper plusieurs fichiers XML de plan de site dans un fichier ZIP.
**Note**
(Sur place/sur serveur) Amazon Kendra vérifie si les informations de point de terminaison incluses sont les mêmes AWS Secrets Manager que celles spécifiées dans les détails de configuration de votre source de données. Cela permet de se protéger contre le [problème de confusion des adjoints](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), qui est un problème de sécurité lorsqu'un utilisateur n'est pas autorisé à effectuer une action mais l'utilise Amazon Kendra comme proxy pour accéder au secret configuré et exécuter l'action. Si vous modifiez ultérieurement les informations de votre point de terminaison, vous devez créer un nouveau secret pour synchroniser ces informations.
+ **Pour les sites Web qui nécessitent une authentification basique, NTLM ou Kerberos :**
+ Notez les informations d'authentification de votre site Web, qui incluent un nom d'utilisateur et un mot de passe.
**Note**
Amazon Kendra Web Crawler v2.0 prend en charge le protocole d'authentification NTLM qui inclut le hachage des mots de passe, et le protocole d'authentification Kerberos qui inclut le chiffrement des mots de passe.
+ **Pour les sites Web qui nécessitent une authentification SAML ou par formulaire de connexion :**
+ Notez les informations d'authentification de votre site Web, qui incluent un nom d'utilisateur et un mot de passe.
+ J'ai copié le XPaths (langage de chemin XML) du champ du nom d'utilisateur (et le bouton du nom d'utilisateur si vous utilisez SAML), du champ de mot de passe et du bouton, et copié l'URL de la page de connexion. Vous pouvez trouver les éléments à l'aide XPaths des outils de développement de votre navigateur Web. XPaths suivent généralement ce format :`//tagname[@Attribute='Value']`.
**Note**
Amazon Kendra Web Crawler v2.0 utilise un navigateur Chrome sans en-tête et les informations du formulaire pour authentifier et autoriser l'accès avec une OAuth URL protégée 2.0.
+ **Facultatif** : vous avez copié le nom d'hôte et le numéro de port du serveur proxy Web si vous souhaitez utiliser un proxy Web pour vous connecter aux sites Web internes que vous souhaitez explorer. Le proxy Web doit être accessible au public. Amazon Kendra prend en charge la connexion à des serveurs proxy Web basés sur une authentification de base ou vous pouvez vous connecter sans authentification.
+ **Facultatif :** copié l’ID de sous-réseau du cloud privé virtuel (VPC) si vous souhaitez utiliser un VPC pour vous connecter aux sites Web internes que vous souhaitez indexer. Pour plus d'informations, consultez [Configuration d'un Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ Coché : chaque document de page Web que vous souhaitez indexer est unique et que vous comptez utiliser pour le même index parmi les autres sources de données. 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 AWS compte, 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 le nom de ressource Amazon 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.
+ Pour les sites Web qui nécessitent une authentification, ou s'ils utilisent un proxy Web avec authentification, stockez vos informations d'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 web crawler 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 web crawler données, vous devez fournir les informations nécessaires sur votre source de web crawler données afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré web crawler pour Amazon Kendra voir[Conditions préalables](#prerequisites-v2-web-crawler).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à web crawler**
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 **le connecteur Web Crawler**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Web Crawler** 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. **Source** —Choisissez Source, **Plans** de **site source URLs, Fichier source, URLs** **Fichier** de plans de site **source**. Si vous choisissez d'utiliser un fichier texte contenant une liste contenant jusqu'à 100 graines URLs, vous devez spécifier le chemin d'accès au Amazon S3 compartiment dans lequel votre fichier est stocké. Si vous choisissez d'utiliser un fichier XML de plan de site, vous devez spécifier le chemin d'accès au Amazon S3 compartiment dans lequel votre fichier est stocké. Vous pouvez également regrouper plusieurs fichiers XML de plan de site dans un fichier ZIP. Sinon, vous pouvez saisir manuellement jusqu'à 10 points de départ ou de départ URLs, et jusqu'à trois plans de site URLs.
**Note**
Si vous souhaitez explorer un plan du site, vérifiez que l'URL de base ou racine est identique à celle URLs répertoriée sur votre page de plan du site. Par exemple, si l'URL de votre plan du site est *https://example.com/sitemap-page.html*, celle URLs répertoriée sur cette page de plan du site doit également utiliser l'URL de base « https://example.com/ ».
Si vos sites Web nécessitent une authentification pour accéder aux sites Web, vous pouvez choisir l'authentification ether basic, NTLM/Kerberos, SAML ou par formulaire. Dans le cas contraire, choisissez l'option « Aucune authentification ».
**Note**
Si vous souhaitez modifier ultérieurement votre source de données pour modifier votre source de données en utilisant URLs l'authentification pour les plans de site, vous devez créer une nouvelle source de données. Amazon Kendra configure la source de données en utilisant les informations du URLs point de terminaison initial contenues dans le Secrets Manager secret à des fins d'authentification, et ne peut donc pas reconfigurer la source de données lors du passage à des plans de site.
1. **AWS Secrets Manager secret** —Si vos sites Web nécessitent la même authentification pour accéder aux sites Web, choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker les informations d'identification de votre site Web. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
Si vous avez choisi l'authentification **de base** ou **NTML/Kerberos**, entrez le nom du secret, ainsi que le nom d'utilisateur et le mot de passe. Le protocole d’authentification NTLM inclut le hachage des mots de passe, tandis que le protocole d’authentification Kerberos inclut le chiffrement des mots de passe.
Si vous avez choisi l'authentification **SAML** ou par **formulaire**, entrez le nom du secret, ainsi que le nom d'utilisateur et le mot de passe. XPath À utiliser pour le champ du nom d'utilisateur (et XPath pour le bouton du nom d'utilisateur si vous utilisez SAML). XPaths À utiliser pour le champ et le bouton du mot de passe, ainsi que pour l'URL de la page de connexion. Vous pouvez trouver le XPaths (langage de chemin XML) des éléments à l'aide des outils de développement de votre navigateur Web. XPaths suivent généralement ce format :`//tagname[@Attribute='Value']`.
1. (Facultatif) **Proxy Web** : entrez le nom d'hôte et le numéro de port du serveur proxy que vous souhaitez utiliser pour vous connecter aux sites Web internes. Par exemple, le nom d'hôte *https://a.example.com/page1.html*est « a.example.com » et le numéro de port est 443, le port standard pour HTTPS. Si des informations d'identification de proxy Web sont requises pour se connecter à un hébergeur de site Web, vous pouvez en créer un AWS Secrets Manager qui stocke les informations d'identification.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
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. **Étendue de la synchronisation** : définissez des limites pour l'exploration des pages Web, notamment leurs domaines, leurs tailles de fichiers et leurs liens, et filtrez à URLs l'aide de modèles regex.
1. (Facultatif) **Plage de domaines d'exploration** : choisissez d'explorer uniquement les domaines du site Web, les domaines avec des sous-domaines ou d'explorer également les autres domaines vers lesquels les pages Web renvoient. Par défaut, explore Amazon Kendra uniquement les domaines des sites Web que vous souhaitez explorer.
1. (Facultatif) **Configuration supplémentaire** : définissez les paramètres suivants :
+ **Profondeur de rampage** : la « profondeur » ou le nombre de niveaux entre le niveau de la graine et le rampage. Par exemple, la page URL initiale est de profondeur 1 et tous les hyperliens de cette page qui sont également explorés ont une profondeur de 2.
+ Taille de **fichier maximale : taille** maximale en Mo d'une page Web ou d'une pièce jointe à analyser.
+ **Nombre maximum de liens par page** : nombre maximum de liens à explorer URLs sur une même page Web.
+ **Limitation maximale de la vitesse d'exploration** : nombre maximal d' URLsexplorations par hôte de site Web et par minute.
+ **Fichiers** : choisissez d'explorer les fichiers vers lesquels les pages Web renvoient.
+ **Exploration et indexation URLs** : ajoutez des modèles d'expressions régulières pour inclure ou exclure l'exploration URLs, certains hyperliens et l'indexation de tous les hyperliens figurant sur ces pages Web URL.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. **Synchronisation du calendrier d'exécution** : dans **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. Sélectionnez parmi les champs par défaut Amazon Kendra générés des pages Web et des fichiers 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 à web crawler**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-web-crawler-schema) à l'aide de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `WEBCRAWLERV2` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **URLs**—Spécifiez le point de départ ou le point URLs de départ des sites Web ou le plan URLs du site Web que vous souhaitez explorer. Vous pouvez spécifier le chemin d'accès à un Amazon S3 compartiment qui stocke votre liste de graines URLs. Chaque URL du fichier texte pour la source URLs doit être formatée sur une ligne distincte. Vous pouvez également spécifier le chemin d'accès à un Amazon S3 compartiment qui stocke les fichiers XML de votre plan de site. Vous pouvez regrouper plusieurs fichiers de plan du site dans un fichier ZIP et le stocker dans votre Amazon S3 compartiment.
**Note**
Si vous souhaitez explorer un plan du site, vérifiez que l'URL de base ou racine est identique à celle URLs répertoriée sur votre page de plan du site. Par exemple, si l'URL de votre plan du site est *https://example.com/sitemap-page.html*, celle URLs répertoriée sur cette page de plan du site doit également utiliser l'URL de base « https://example.com/ ».
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Authentification** : si vos sites Web nécessitent la même authentification, spécifiez soit`BasicAuth`,`NTLM_Kerberos`,`SAML`, soit `Form` authentification. Si vos sites Web ne nécessitent pas d'authentification, spécifiez`NoAuthentication`.
+ **Nom de ressource Amazon secret (ARN)** : si vos sites Web nécessitent une authentification de base, NTLM ou Kerberos, vous fournissez un secret qui stocke vos informations d'authentification, à savoir votre nom d'utilisateur et votre mot de passe. Vous fournissez le Amazon Resource Name (ARN) d'un AWS Secrets Manager secret. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"seedUrlsHash": "Hash representation of all seed URLs",
"userName": "user name",
"password": "password"
}
```
Si vos sites Web nécessitent une authentification SAML, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"seedUrlsHash": "Hash representation of all seed URLs",
"userName": "user name",
"password": "password",
"userNameFieldXpath": "XPath for user name field",
"userNameButtonXpath": "XPath for user name button",
"passwordFieldXpath": "XPath for password field",
"passwordButtonXpath": "XPath for password button",
"loginPageUrl": "Full URL for website login page"
}
```
Si vos sites Web nécessitent une authentification par formulaire, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"seedUrlsHash": "Hash representation of all seed URLs",
"userName": "user name",
"password": "password",
"userNameFieldXpath": "XPath for user name field",
"passwordFieldXpath": "XPath for password field",
"passwordButtonXpath": "XPath for password button",
"loginPageUrl": "Full URL for website login page"
}
```
Vous pouvez trouver le XPaths (langage de chemin XML) des éléments à l'aide des outils de développement de votre navigateur Web. XPaths suivent généralement ce format :`//tagname[@Attribute='Value']`.
Vous pouvez également fournir les informations d'identification du proxy Web à l'aide d' AWS Secrets Manager un code secret.
+ **IAM role** —Spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur Web Crawler et. Amazon Kendra Pour plus d'informations, consultez la section [IAM Rôles des sources de données des robots d'exploration Web](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Plage de domaines** : choisissez d'explorer les domaines des sites Web contenant uniquement des sous-domaines ou d'explorer également les autres domaines vers lesquels les pages Web renvoient. Par défaut, explore Amazon Kendra uniquement les domaines des sites Web que vous souhaitez explorer.
+ La « profondeur » ou le nombre de niveaux entre le niveau de la graine et le rampage. Par exemple, la page URL initiale est de profondeur 1 et tous les hyperliens de cette page qui sont également explorés ont une profondeur de 2.
+ Le nombre maximum de pages Web à explorer URLs sur une seule page Web.
+ Taille maximale en Mo d'une page Web ou d'une pièce jointe à analyser.
+ Le nombre maximum d' URLs explorations par hôte de site Web par minute.
+ L'hôte du proxy Web et le numéro de port permettant de se connecter aux sites Web internes et de les parcourir. Par exemple, le nom d'hôte *https://a.example.com/page1.html*est « a.example.com » et le numéro de port est 443, le port standard pour HTTPS. Si des informations d'identification de proxy Web sont requises pour se connecter à un hébergeur de site Web, vous pouvez en créer un AWS Secrets Manager qui stocke les informations d'identification.
+ **Filtres d'inclusion et d'exclusion** : spécifiez s'il faut inclure ou exclure l'exploration de certains hyperliens URLs et l'indexation de tout hyperlien sur ces pages Web URL.
**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 des pages Web et des fichiers de pages Web à 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).
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du modèle Amazon Kendra Web Crawler](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-web-crawler).
------
# Configuration du `robots.txt` fichier pour Amazon Kendra Web Crawler
Amazon Kendra est un service de recherche intelligent que AWS les clients utilisent pour indexer et rechercher les documents de leur choix. Pour indexer des documents sur le Web, les clients peuvent utiliser le Amazon Kendra Web Crawler, qui indique les URL à indexer ainsi que d'autres paramètres opérationnels. Amazon Kendra les clients sont tenus d'obtenir une autorisation avant d'indexer un site Web en particulier.
Amazon Kendra Web Crawler respecte les directives standard de robots.txt telles que `Allow` et`Disallow`. Vous pouvez modifier le `robots.txt` fichier de votre site Web pour contrôler la façon dont Amazon Kendra Web Crawler explore votre site Web.
## Configuration de la façon dont Amazon Kendra Web Crawler accède à votre site Web
Vous pouvez contrôler la façon dont le Amazon Kendra Web Crawler indexe votre site Web à l'aide de directives `Allow` et`Disallow`. Vous pouvez également contrôler quelles pages Web sont indexées et lesquelles ne sont pas indexées.
**Pour autoriser Amazon Kendra Web Crawler à explorer toutes les pages Web à l'exception des pages Web interdites, utilisez la directive suivante :**
```
User-agent: amazon-kendra # Amazon Kendra Web Crawler
Disallow: /credential-pages/ # disallow access to specific pages
```
**Pour autoriser Amazon Kendra Web Crawler à explorer uniquement des pages Web spécifiques, utilisez la directive suivante :**
```
User-agent: amazon-kendra # Amazon Kendra Web Crawler
Allow: /pages/ # allow access to specific pages
```
**Pour autoriser Amazon Kendra Web Crawler à explorer tout le contenu du site Web et interdire l'exploration à tout autre robot, utilisez la directive suivante :**
```
User-agent: amazon-kendra # Amazon Kendra Web Crawler
Allow: / # allow access to all pages
User-agent: * # any (other) robot
Disallow: / # disallow access to any pages
```
## Amazon Kendra Empêcher Web Crawler d'explorer votre site Web
Vous pouvez empêcher Amazon Kendra Web Crawler d'indexer votre site Web à l'aide de cette directive. `Disallow` Vous pouvez également contrôler les pages Web qui sont explorées et celles qui ne le sont pas.
**Pour empêcher Amazon Kendra Web Crawler d'explorer le site Web, utilisez la directive suivante :**
```
User-agent: amazon-kendra # Amazon Kendra Web Crawler
Disallow: / # disallow access to any pages
```
Si vous avez des questions ou des préoccupations concernant Amazon Kendra Web Crawler, vous pouvez contacter l'[équipe d'AWS assistance](https://aws.amazon.com/contact-us/?nc1=f_m).
# Box
Box est un service de stockage dans le cloud qui offre des fonctionnalités d'hébergement de fichiers. Vous pouvez l'utiliser Amazon Kendra pour indexer le contenu de votre Box, notamment les commentaires, les tâches et les liens Web.
Vous pouvez vous connecter Amazon Kendra à votre source de données Box à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[BoxConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BoxConfiguration.html)API.
Pour résoudre les problèmes liés Amazon Kendra à votre connecteur de source de données Box, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-box)
+ [Conditions préalables](#prerequisites-box)
+ [Instructions de connexion](#data-source-procedure-box)
+ [En savoir plus](#box-learn-more)
+ [Remarques](#box-notes)
## Fonctionnalités prises en charge
Amazon KendraLe connecteur de source de données Box prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Journal des modifications, synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Box, apportez ces modifications à votre Box et à vos AWS comptes.
**Dans Box, assurez-vous d'avoir :**
+ Un compte Box Enterprise ou Box Enterprise Plus.
+ Configuration d'une application personnalisée Box dans la Box Developer Console, avec authentification côté serveur à l'aide de jetons Web JSON (JWT). Consultez [la documentation Box sur la création d'une application personnalisée](https://developer.box.com/guides/applications/app-types/platform-apps/) et la [documentation Box sur la configuration de JWT Auth](https://developer.box.com/guides/authentication/jwt/) pour plus de détails.
+ Défini le **Niveau d’accès à l’application** sur **Accès application \$1 Enterprise** et l’avez autorisé à **Effectuer des appels d’API à l’aide de l’en-tête as-user**.
+ Vous avez utilisé l'utilisateur administrateur pour ajouter les **champs d'application suivants** dans votre application Box :
+ Écrire tous les fichiers et dossiers stockés dans une Box
+ Gérer les utilisateurs
+ Gérer les groupes
+ Gérer les propriétés de l’entreprise
+ Paire de Public/Private clés configurée comprenant un identifiant client, un secret client, un identifiant de clé publique, un identifiant de clé privée, une phrase secrète et un identifiant d'entreprise à utiliser comme informations d'identification d'authentification. Consultez la section [Paire de clés publiques et privées](https://developer.box.com/guides/authentication/jwt/jwt-setup/#public-and-private-key-pair) pour plus de détails.
**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).
+ Vous avez copié votre identifiant Box Enterprise depuis les paramètres de votre Box Developer Console ou depuis votre application Box. Par exemple, *801234567*.
+ Coché : chaque document est unique dans Box et dans 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 votreCompte 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'authentification Box 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 données Box à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 données Box, vous devez fournir les informations nécessaires sur votre source de données Box afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Box pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-box).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Box**
1. Connectez-vous à la [Amazon Kendraconsole 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 **Box connector**, puis **Add connector**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Box** avec le tag « 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 tirets, 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. **Box Enterprise ID** —Entrez votre Box Enterprise ID. Par exemple, *801234567*.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Box. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Box-» est automatiquement ajouté à votre nom secret.
1. Pour l'**ID client**, **le secret client**, l'**ID de clé publique**, l'**ID de clé privée** et le mot de **passe**, entrez les valeurs de la Public/Private clé que vous avez configurée dans la case.
1. Ajoutez et enregistrez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. **Fichiers Box** : choisissez d'explorer les liens Web, les commentaires et les tâches.
1. Pour une **configuration supplémentaire** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains contenus.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution** pour **la fréquence** : choisissez la fréquence à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à Box**
Vous devez spécifier les éléments suivants à l'aide de l'[BoxConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BoxConfiguration.html)API :
**Box Enterprise ID** : saisissez votre Box Enterprise ID. Vous trouverez l'identifiant d'entreprise dans les paramètres de la Box Developer Console ou lorsque vous configurez une application dans Box.
+ **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 compte Box. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"clientID": "client-id",
"clientSecret": "client-secret",
"publicKeyID": "public-key-id",
"privateKey": "private-key",
"passphrase": "pass-phrase"
}
```
+ **IAMrole** —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 pour appeler le public requis APIs pour le connecteur Box etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de données Box](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC)** —Spécifiez dans le `VpcConfiguration` cadre de la configuration de la source de données. Consultez [la section Configuration Amazon Kendra pour utiliser un VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ **Journal des modifications** : Amazon Kendra faut-il utiliser le mécanisme de journal des modifications de la source de données Box pour déterminer si un document doit être mis à jour dans l'index.
**Note**
Utilisez le journal des modifications si vous ne Amazon Kendra souhaitez pas numériser tous les documents. Si votre journal des modifications est volumineux, la numérisation des documents de la source de données Box peut prendre Amazon Kendra moins de temps que le traitement du journal des modifications. Si vous synchronisez votre source de données Box avec votre index pour la première fois, tous les documents sont numérisés.
+ **Commentaires, tâches, liens Web** : indiquez si vous souhaitez explorer ces types de contenu.
**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.
+ **Filtres d'inclusion et d'exclusion** : indiquez si vous souhaitez inclure ou exclure certains fichiers et dossiers Box.
**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.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Box à vos champs d'Amazon Kendraindex. 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.
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Box, consultez :
+ [Commencer à utiliser le connecteur Amazon Kendra Box](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-box-connector/)
## Remarques
+ Lorsque les listes de contrôle d'accès (ACLs) sont activées, l'option « Synchroniser uniquement le contenu nouveau ou modifié » n'est pas disponible en raison des limites de l'API Box. Nous vous recommandons d'utiliser plutôt les modes « Synchronisation complète » ou « Synchronisation du contenu nouveau, modifié ou supprimé », ou de les désactiver ACLs si vous devez utiliser ce mode de synchronisation.
# Confluence
Confluence est un outil de gestion du travail collaboratif conçu pour partager, stocker et travailler sur la planification de projets, le développement de logiciels et la gestion de produits. Amazon Kendra prend en charge à la fois Confluence Server/Data Center et Confluence Cloud. Vous pouvez les utiliser Amazon Kendra pour indexer les entités Confluence suivantes :
+ **Espaces** : zones désignées de haut niveau pour organiser le contenu connexe. Chaque espace sert de conteneur, capable de contenir plusieurs pages, blogs et pièces jointes.
+ **Pages** : documents individuels dans un espace où les utilisateurs créent et gèrent du contenu. Les pages peuvent contenir du texte, des images, des tableaux et des éléments multimédias, et peuvent comporter des sous-pages imbriquées. Chaque page est considérée comme un document unique.
+ **Blogs** : contenu similaire à des pages, généralement utilisé pour des mises à jour ou des annonces. Chaque article de blog est considéré comme un document unique.
+ **Commentaires** — Permet aux utilisateurs de donner leur avis ou de participer à des discussions sur un contenu spécifique dans des pages ou des articles de blog.
+ **Pièces jointes** : fichiers chargés sur des pages ou des articles de blog dans Confluence, tels que des images, des documents ou d'autres types de fichiers.
Par défaut, Amazon Kendra n'indexe pas les archives Confluence ni les espaces personnels. Vous pouvez choisir de les indexer lorsque vous créez la source de données. Si vous ne souhaitez pas Amazon Kendra indexer un espace, marquez-le comme privé dans Confluence.
Vous pouvez vous connecter Amazon Kendra à votre source de données Confluence à l'aide de la [Amazon Kendra console](https://console.aws.amazon.com/kendra/), de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API ou de l'[ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)API.
Amazon Kendra possède deux versions du connecteur Confluence. Les fonctionnalités suivantes sont prises en charge.
****Connecteur Confluence V2.0/API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)****
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Modèles d'inclusion/exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
****Connecteur Confluence V1.0/[ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)API** (n'est plus pris en charge)**
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ (Confluence Server uniquement) Cloud privé virtuel (VPC)
**Note**
Le connecteur Confluence ConfluenceConfiguration V1.0/API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le connecteur Confluence V2.0/API. TemplateConfiguration
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Confluence, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [ACLs dans Confluence Connector](#data-source-confluence-acls)
+ [Connecteur Confluence V2.0](data-source-v2-confluence.md)
+ [Connecteur Confluence V1.0](data-source-v1-confluence.md)
## ACLs dans Confluence Connector
Les connecteurs permettent d'analyser les listes de contrôle d'accès (ACLs) et d'identifier les informations, le cas échéant, en fonction de la source de données. Si vous indexez des documents sans ACLs, tous les documents sont considérés comme publics. L'indexation des documents ACLs garantit la sécurité des données.
Le connecteur Amazon Kendra Confluence scanne les espaces pour collecter les pages et les articles de blog ainsi que leurs ACLs informations. Si aucune restriction n'est appliquée à une page ou à un blog, le connecteur hérite des autorisations de son espace. Si une restriction d'utilisateur ou de groupe spécifique est appliquée sur une page, seuls ces utilisateurs pourront accéder à cette page. Si la page est imbriquée, elle hérite des autorisations de la page parent si aucune restriction n'est appliquée. Un modèle d'autorisation similaire s'applique aux blogs ; toutefois, Confluence ne prend pas en charge les blogs imbriqués.
En outre, le connecteur Amazon Kendra Confluence analyse les informations principales de l'utilisateur (alias d'utilisateur local, configurations d'identité de groupe local et de groupe fédéré) et ses autorisations pour chaque espace configuré.
**Note**
Le connecteur Confluence Cloud ne prend pas en charge les macros d'exploration, les tableaux blancs ou les bases de données.
Le connecteur Amazon Kendra Confluence met à jour les modifications de l'ACL chaque fois qu'il analyse le contenu de votre source de données. Pour vous assurer que les bons utilisateurs ont accès au contenu approprié, resynchronisez régulièrement votre source de données pour capturer les mises à jour de l'ACL.
# Connecteur Confluence V2.0
Confluence est un outil de gestion du travail collaboratif conçu pour partager, stocker et travailler sur la planification de projets, le développement de logiciels et la gestion de produits. Vous pouvez l'utiliser Amazon Kendra pour indexer vos espaces Confluence, vos pages (y compris les pages imbriquées), vos blogs, ainsi que vos commentaires et pièces jointes vers des pages et des blogs indexés.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Confluence, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v2-confluence)
+ [Conditions préalables](#prerequisites-v2-confluence)
+ [Instructions de connexion](#data-source-procedure-v2-confluence)
## Fonctionnalités prises en charge
Amazon Kendra Le connecteur de source de données Confluence prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Modèles d'inclusion/exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Confluence, apportez ces modifications à votre Confluence et AWS à vos comptes.
**Dans Confluence, assurez-vous que vous disposez des éléments suivants :**
+ Vous avez copié l'URL de votre instance Confluence. Par exemple :*https://example.confluence.com*, ou*https://www.example.confluence.com/*, ou*https:// atlassian.net/*. Vous avez besoin de l'URL de votre instance Confluence pour vous connecter Amazon Kendra.
Si vous utilisez Confluence Cloud, l'URL de votre hôte doit se terminer par*atlassian.net/*.
**Note**
Les formats d'URL suivants **ne sont pas** pris en charge :
*https://example.confluence.com/xyz*
*https://www.example.confluence.com//wiki/spacekey/xxx*
*https://atlassian.net/xyz*
**Note**
(Sur place/sur serveur) Amazon Kendra vérifie si les informations de point de terminaison incluses sont les mêmes AWS Secrets Manager que celles spécifiées dans les détails de configuration de votre source de données. Cela permet de se protéger contre le [problème de confusion des adjoints](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), qui est un problème de sécurité lorsqu'un utilisateur n'est pas autorisé à effectuer une action mais l'utilise Amazon Kendra comme proxy pour accéder au secret configuré et exécuter l'action. Si vous modifiez ultérieurement les informations de votre point de terminaison, vous devez créer un nouveau secret pour synchroniser ces informations.
+ Identifiants d'authentification de base configurés contenant un nom d'utilisateur (identifiant e-mail utilisé pour se connecter à Confluence) et un mot de passe (jeton d'API Confluence comme mot de passe). Consultez [Gérer les jetons d'API pour votre compte Atlassian](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/#Create-an-API-token).
**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).
+ **Facultatif :** informations d'identification OAuth 2.0 configurées contenant une clé d'application Confluence, un secret d'application Confluence, un jeton d'accès Confluence et un jeton d'actualisation Confluence pour permettre la connexion Amazon Kendra à votre instance Confluence. Si votre jeton d'accès expire, vous pouvez utiliser le jeton d'actualisation pour régénérer votre jeton d'accès et actualiser la paire de jetons. Vous pouvez également répéter le processus d'autorisation. Pour plus d'informations sur les jetons d'accès, consultez la section [Gérer les jetons OAuth d'accès](https://support.atlassian.com/confluence-cloud/docs/manage-oauth-access-tokens/).
+ (Pour Confluence Server/Data Center uniquement) **Facultatif :** configuration d'un jeton d'accès personnel (PAT) dans Confluence. Voir [Utilisation de jetons d'accès personnels](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html).
**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'authentification Confluence 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 données Confluence à 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 données Confluence, vous devez fournir les informations nécessaires sur votre source de données Confluence afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Confluence pour Amazon Kendra voir[Conditions préalables](#prerequisites-v2-confluence).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Confluence**
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 le **connecteur Confluence**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Confluence** avec le tag « 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 tirets, 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. Dans **Source**, choisissez **Confluence Cloud** ou **Confluence Center Server/Data **.
1. URL **de confluence —Entrez l'URL** de l'hôte Confluence. Par exemple, *https://example.confluence.com*.
1. (Pour Confluence Server/Data Center uniquement) **Emplacement du certificat SSL - *facultatif* -** Entrez le Amazon S3 chemin d'accès à votre fichier de certificat SSL pour Confluence Server.
1. (Pour Confluence Server/Data Center uniquement) **Proxy Web - *facultatif*** : entrez le nom d'hôte du proxy Web (sans le `https://` protocole `http://` or) et le numéro de port (port utilisé par le protocole de transport d'URL de l'hôte). Le numéro de port doit être une valeur numérique comprise entre 0 et 65 535.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **Authentification** : choisissez **l'authentification de base, l'authentification** **Oauth 2.0 ou (pour Confluence Server/Data Center uniquement) l'authentification** par jeton d'accès **personnel**.
1. **AWS Secrets Manager secret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos identifiants d'authentification Confluence. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre. Saisissez les informations suivantes dans la fenêtre :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Confluence-» est automatiquement ajouté à votre nom secret.
1. Si vous utilisez l'**authentification de base**, entrez le nom secret, le nom d'utilisateur et le mot de passe (jeton d'API Confluence comme mot de passe) que vous avez configurés dans Confluence.
Si vous utilisez l'**authentification OAuth2 .0** : entrez le nom secret, la clé de l'application, le secret de l'application, le jeton d'accès et le jeton d'actualisation que vous avez configurés dans Confluence.
(Confluence Server/Data Center uniquement) Si vous utilisez l'**authentification par jeton d'accès personnel**, entrez le nom secret et le jeton Confluence que vous avez configurés dans votre Confluence.
1. Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
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. Dans la **zone de synchronisation**, pour **Synchroniser le contenu** : choisissez de synchroniser les types de contenu suivants : pages, commentaires de page, pièces jointes de page, blogs, commentaires de blog, pièces jointes de blog, espaces personnels et espaces archivés.
**Note**
**Les commentaires de page et les pièces jointes aux pages ne peuvent être sélectionnés que si vous choisissez de synchroniser les pages.** **Les commentaires de blog et les pièces jointes de blog ne peuvent être sélectionnés que si vous choisissez de synchroniser les blogs.**
**Important**
Si vous ne spécifiez pas de modèle d'expression régulière avec touche d'espace dans **Configuration supplémentaire**, toutes les pages et tous les blogs seront explorés par défaut.
1. Dans **Configuration supplémentaire**, pour **Taille de fichier maximale**, spécifiez la limite de taille de fichier MBs à Amazon Kendra analyser. Amazon Kendra explorera uniquement les fichiers dans la limite de taille que vous avez définie. La taille de fichier par défaut est de 50 Mo. La taille maximale du fichier doit être supérieure à 0 Mo et inférieure ou égale à 50 Mo.
Pour les **modèles de regex Spaces** : spécifiez si vous souhaitez inclure ou exclure des espaces spécifiques dans votre index en utilisant :
+ Touche espace (par exemple,*my-space-123*)
**Note**
Si vous ne spécifiez pas de modèle d'expression régulière avec une touche espace, toutes les pages et tous les blogs seront explorés par défaut.
+ URL (par exemple,*.\$1/MySite/MyDocuments/*)
+ Type de fichier (par exemple,*.\$1\$1.pdf, .\$1\$1.txt*)
Pour les **modèles d'expression régulière des titres d'entités** : spécifiez des modèles d'expressions régulières pour inclure ou exclure certains blogs, pages, commentaires et pièces jointes par titre.
**Note**
Si vous souhaitez inclure ou exclure l'exploration d'une page ou d'une sous-page spécifique, vous pouvez utiliser des modèles réguliers de titre de page.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. 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. Pour ajouter des champs de source de données personnalisés, créez un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à Confluence**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-confluence-schema) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `CONFLUENCEV2` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **URL de l'hôte** —Spécifiez l'instance de l'URL hôte Confluence. Par exemple, *https://example.confluence.com*.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Type d'authentification** : spécifiez le type d'authentification, si`Basic`,`OAuth2`, (Confluence Server uniquement). `Personal-token`
+ (Facultatif, pour Confluence Server uniquement) **Emplacement du certificat SSL** : spécifiez le `S3bucketName` et que `s3certificateName` vous avez utilisé pour stocker votre certificat SSL.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez configurées dans Confluence. Si vous utilisez l'authentification de base, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "email ID or user name",
"password": "Confluence API token"
}
```
Si vous utilisez l'authentification OAuth 2.0, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"confluenceAppKey": "app key",
"confluenceAppSecret": "app secret",
"confluenceAccessToken": "access token",
"confluenceRefreshToken": "refresh token"
}
```
(Pour Confluence Server uniquement) Si vous utilisez l'authentification de base, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"hostUrl": "Confluence Server host URL",
"username": "Confluence Server user name",
"password": "Confluence Server password"
}
```
(Pour Confluence Server uniquement) Si vous utilisez l'authentification par jeton d'accès personnel, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"hostUrl": "Confluence Server host URL",
"patToken": "personal access token"
}
```
+ **IAM role** —Spécifiez à quel `RoleArn` moment 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 connecteur Confluence et. Amazon Kendra Pour plus d'informations, consultez la section [IAM Rôles des sources de données Confluence](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Taille du fichier** —Spécifiez la taille maximale du fichier à analyser.
+ **Types de documents/contenus** : indiquez si vous souhaitez explorer les pages, les commentaires de page, les pièces jointes aux pages, les blogs, les commentaires de blog, les pièces jointes de blog, les espaces et les espaces archivés.
+ **Filtres d'inclusion et d'exclusion** : indiquez s'il faut inclure ou exclure certains espaces, pages, blogs, ainsi que leurs commentaires et pièces jointes.
**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.
+ **Proxy Web** —Spécifiez les informations de votre proxy Web si vous souhaitez vous connecter à votre instance d'URL Confluence via un proxy Web. Vous pouvez utiliser cette option pour Confluence Server.
+ **Liste de contrôle d'accès (ACL)** : indiquez si vous souhaitez analyser les informations ACL de vos documents, si vous disposez d'une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Confluence à vos Amazon Kendra champs d'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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du modèle Confluence](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-confluence-schema).
------
### Remarques
+ Le jeton d'accès personnel (PAT) n'est pas disponible pour Confluence Cloud.
# Connecteur Confluence V1.0
Confluence est un outil de gestion du travail collaboratif conçu pour partager, stocker et travailler sur la planification de projets, le développement de logiciels et la gestion de produits. Vous pouvez l'utiliser Amazon Kendra pour indexer vos espaces Confluence, vos pages (y compris les pages imbriquées), vos blogs, ainsi que vos commentaires et pièces jointes vers des pages et des blogs indexés.
**Note**
Le connecteur Confluence ConfluenceConfiguration V1.0/API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le connecteur Confluence V2.0/API. TemplateConfiguration
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Confluence, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v1-confluence)
+ [Conditions préalables](#prerequisites-v1-confluence)
+ [Instructions de connexion](#data-source-procedure-v1-confluence)
+ [En savoir plus](#confluence-v1-learn-more)
## Fonctionnalités prises en charge
Amazon Kendra Le connecteur de source de données Confluence prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ (Pour Confluence Server uniquement) Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Confluence, apportez ces modifications à votre Confluence et AWS à vos comptes.
**Dans Confluence, assurez-vous que vous disposez des éléments suivants :**
+ Amazon Kendra Autorisations accordées pour afficher tout le contenu de votre instance Confluence en :
+ Amazon Kendra Devenir membre d'un `confluence-administrators` groupe.
+ Accorder des autorisations d'administrateur de site pour tous les espaces, blogs et pages existants.
+ Vous avez copié l'URL de votre instance Confluence.
+ **Pour les utilisateurs du SSO (Single Sign-On) :** activation de la **page Afficher lors de la connexion** pour le nom d'utilisateur et le mot de passe lorsque vous configurez les **méthodes d'authentification** Confluence dans Confluence Data Center.
+ **Pour Confluence Server**
+ Vous avez noté vos informations d'authentification de base contenant le nom d'utilisateur et le mot de passe de votre compte administratif Confluence auxquels vous pouvez vous connecter Amazon Kendra.
**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).
+ **Facultatif :** vous avez généré un jeton d'accès personnel dans votre compte Confluence auquel vous connecter Amazon Kendra. Pour plus d'informations, consultez la [documentation de Confluence sur la génération de jetons d'accès personnels](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html).
+ **Pour Confluence Cloud**
+ Vous avez noté vos informations d'authentification de base contenant le nom d'utilisateur et le mot de passe de votre compte administratif Confluence auxquels vous pouvez vous connecter Amazon Kendra.
+ Il est vérifié que chaque document est unique dans Confluence et dans 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'authentification Confluence 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 données Confluence à 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 données Confluence, vous devez fournir les détails de vos informations d'identification Confluence afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Confluence pour Amazon Kendra voir[Conditions préalables](#prerequisites-v1-confluence).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Confluence**
1. Connectez-vous à la console AWS de gestion et [Amazon Kendra 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 **Confluence connector V1.0**, puis sélectionnez **Ajouter une source de données**.
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 tirets, 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. Choisissez entre **Confluence Cloud** et **Confluence Server**.
1. Si vous choisissez **Confluence Cloud**, saisissez les informations suivantes :
1. URL **de confluence : votre URL** de confluence.
1. **AWS Secrets Manager secret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos identifiants d'authentification Confluence. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Confluence-» est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le** **mot de passe** : entrez votre nom d'utilisateur et votre mot de passe Confluence.
1. Choisissez **Enregistrer l'authentification**.
1. Si vous choisissez **Confluence Server**, entrez les informations suivantes :
1. **URL Confluence** : votre nom d'utilisateur et votre mot de passe Confluence.
1. (Facultatif) Pour **le proxy Web**, entrez les informations suivantes :
1. **Nom d'hôte : nom** d'hôte de votre compte Confluence.
1. **Numéro de port** —Port utilisé par le protocole de transport d'URL de l'hôte.
1. Pour **l'authentification**, choisissez l'**authentification de base** ou le **jeton d'accès personnel** (Confluence Server uniquement).
1. **AWS Secrets Manager secret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos identifiants d'authentification Confluence. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Confluence-» est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le** **mot de passe** : entrez les valeurs d'identification d'authentification que vous avez configurées dans Confluence. Si vous utilisez l'authentification de base, utilisez votre nom d'utilisateur Confluence (identifiant e-mail) et votre mot de passe (jeton API). Si vous utilisez un jeton d'accès personnel, saisissez les détails du **jeton d'accès personnel** que vous avez configuré dans le compte Confluence.
1. Enregistrez et ajoutez votre secret.
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. Pour **Inclure les espaces personnels** et **Inclure les espaces archivés**, choisissez les types d'espaces facultatifs à inclure dans cette source de données.
1. Pour une **configuration supplémentaire** : spécifiez des modèles d'expressions régulières pour inclure ou exclure certains contenus. Vous pouvez ajouter jusqu’à 100 modèles.
1. Vous pouvez également choisir d'**explorer les pièces jointes dans les espaces choisis**.
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 **Space**, **Page**, **Blog** : sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés ou parmi les **mappages de champs suggérés supplémentaires** pour ajouter des champs d'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à Confluence**
Vous devez spécifier les éléments suivants à l'aide de l'[ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)API :
+ **Version Confluence** —Spécifiez la version de l'instance Confluence que vous utilisez en tant que ou. `CLOUD` `SERVER`
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant vos informations d'authentification Confluence.
Si vous utilisez Confluence Server, vous pouvez utiliser soit votre nom d'utilisateur et votre mot de passe Confluence, soit votre jeton d'accès personnel comme identifiants d'authentification.
Si vous utilisez votre nom d'utilisateur et votre mot de passe Confluence comme informations d'authentification, vous stockez les informations d'identification suivantes sous forme de structure JSON dans votre Secrets Manager secret :
```
{
"username": "user name",
"password": "password"
}
```
Si vous utilisez un jeton d'accès personnel pour vous connecter à Confluence Server Amazon Kendra, vous stockez les informations d'identification suivantes sous forme de structure JSON dans votre Secrets Manager secret :
```
{
"patToken": "personal access token"
}
```
Si vous utilisez Confluence Cloud, vous utilisez votre nom d'utilisateur Confluence et un jeton d'API, configuré dans Confluence, comme mot de passe. Vous stockez les informations d'identification suivantes sous forme de structure JSON dans votre Secrets Manager secret :
```
{
"username": "user name",
"password": "API token"
}
```
+ **IAM role** —Spécifiez à quel `RoleArn` moment 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 connecteur Confluence et. Amazon Kendra Pour plus d'informations, consultez la section [IAM Rôles des sources de données Confluence](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Proxy Web** : s'il faut se connecter à votre instance d'URL Confluence via un proxy Web. Vous pouvez utiliser cette option pour Confluence Server.
+ (Pour Confluence Server uniquement) **Virtual Private Cloud (VPC) —Spécifiez dans le** `VpcConfiguration` cadre de la configuration de la source de données. Consultez [la section Configuration Amazon Kendra pour utiliser un VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ **Filtres d'inclusion et d'exclusion** : spécifiez des modèles d'expressions régulières pour inclure ou exclure certains espaces, articles de blog, pages, espaces et pièces jointes. Si vous choisissez d'indexer les pièces jointes, seules les pièces jointes aux pages et aux blogs indexés sont indexées.
**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 données Confluence à vos Amazon Kendra champs d'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).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Confluence, consultez :
+ [Configuration de votre Amazon Kendra connecteur Confluence Server](https://aws.amazon.com/blogs/machine-learning/configuring-your-amazon-kendra-confluence-server-connector/)
# Connecteur de source de données personnalisé
Utilisez une source de données personnalisée lorsque vous disposez d'un référentiel qui Amazon Kendra ne fournit pas encore de connecteur de source de données pour. Vous pouvez l'utiliser pour consulter les mêmes statistiques d'historique d'exécution que celles fournies par Amazon Kendra les sources de données, même lorsque vous ne pouvez pas utiliser les sources Amazon Kendra de données pour synchroniser vos référentiels. Utilisez-le pour créer une expérience de surveillance de synchronisation cohérente entre les sources de Amazon Kendra données et les sources personnalisées. Plus précisément, utilisez une source de données personnalisée pour voir les métriques de synchronisation d'un connecteur de source de données que vous avez créé à l'aide du [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)et [BatchDeleteDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchDeleteDocument.html) APIs.
Pour résoudre les problèmes liés à votre connecteur de source de données personnalisé Amazon Kendra, consultez. [Dépannage des sources de données](troubleshooting-data-sources.md)
Lorsque vous créez une source de données personnalisée, vous contrôlez totalement la manière dont les documents à indexer sont sélectionnés. Amazon Kendra fournit uniquement des informations métriques que vous pouvez utiliser pour surveiller vos tâches de synchronisation de sources de données. Vous devez créer et exécuter le robot d'exploration qui détermine les documents indexés par votre source de données.
Vous devez spécifier le titre principal de vos documents à l'aide de l'objet [Document](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Document.html), `_source_uri` [DocumentAttribute](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttribute.html)afin de l'avoir `DocumentTitle` et de l'`DocumentURI`inclure dans la réponse du `Query` résultat.
Vous créez un identifiant pour votre source de données personnalisée à l'aide de la console ou de l'[CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)API. Pour utiliser la console, donnez un nom à votre source de données, éventuellement une description et des balises de ressources. Une fois la source de données créée, un identifiant de source de données est affiché. Copiez cet ID à utiliser lors de la synchronisation de la source de données avec l'index.
![\[Form for specifying data source details, including name, description, and optional tags.\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/images/CustomDataSource.png)
Vous pouvez également créer une source de données personnalisée à l'aide de l'`CreateDataSource`API. L'API renvoie un identifiant à utiliser lors de la synchronisation de la source de données. Lorsque vous utilisez l'`CreateDataSource`API pour créer une source de données personnalisée, vous ne pouvez pas définir `Configuration` les `Schedule` paramètres `RoleArn` ou. Si vous définissez ces paramètres, Amazon Kendra renvoie une `ValidationException` exception.
Pour utiliser une source de données personnalisée, créez une application chargée de mettre à jour l' Amazon Kendra index. L'application dépend d'un robot d'exploration que vous créez. Le robot lit les documents de votre dépôt et détermine ceux à qui ils doivent être envoyés Amazon Kendra. Votre application doit suivre les étapes suivantes :
1. Explorez votre référentiel et dressez une liste des documents ajoutés, mis à jour ou supprimés.
1. Appelez l'[StartDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StartDataSourceSyncJob.html)API pour signaler qu'une tâche de synchronisation est en cours de démarrage. Vous fournissez un ID de source de données pour identifier la source de données en cours de synchronisation. Amazon Kendra renvoie un ID d'exécution pour identifier une tâche de synchronisation particulière.
1. Appelez l'[BatchDeleteDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchDeleteDocument.html)API pour supprimer des documents de l'index. Vous fournissez l'ID de source de données et l'ID d'exécution pour identifier la source de données synchronisée et la tâche à laquelle cette mise à jour est associée.
1. Appelez l'[StopDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StopDataSourceSyncJob.html)API pour signaler la fin de la tâche de synchronisation. Après avoir appelé l'`StopDataSourceSyncJob`API, l'ID d'exécution associé n'est plus valide.
1. Appelez l'[ListDataSourceSyncJobs](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ListDataSourceSyncJobs.html)API avec l'index et les identifiants de source de données pour répertorier les tâches de synchronisation pour la source de données et pour voir les métriques relatives aux tâches de synchronisation.
Une fois que vous avez terminé une tâche de synchronisation, vous pouvez en démarrer une nouvelle. Il peut s'écouler un certain temps avant que tous les documents soumis soient ajoutés à l'index. Utilisez l'`ListDataSourceSyncJobs`API pour connaître l'état de la tâche de synchronisation. Si le résultat `Status` de la tâche de synchronisation est le cas`SYNCING_INDEXING`, certains documents sont toujours en cours d'indexation. Vous pouvez démarrer une nouvelle tâche de synchronisation lorsque le statut de la tâche précédente est `FAILED` ou`SUCCEEDED`.
Après avoir appelé l'`StopDataSourceSyncJob`API, vous ne pouvez pas utiliser d'identifiant de tâche de synchronisation dans un appel au `BatchPutDocument` ou `BatchDeleteDocument` APIs. Dans ce cas, tous les documents soumis sont renvoyés dans le message de `FailedDocuments` réponse de l'API.
## Attributs requis
Lorsque vous soumettez un document à Amazon Kendra l'aide de l'`BatchPutDocument`API, chaque document nécessite deux attributs pour identifier la source de données et le cycle de synchronisation auxquels il appartient. Vous devez fournir les deux attributs suivants pour mapper correctement les documents de votre source de données personnalisée vers un Amazon Kendra index :
+ `_data_source_id`: l'identifiant de la source de données. Cela est renvoyé lorsque vous créez la source de données à l'aide de la console ou de l'`CreateDataSource`API.
+ `_data_source_sync_job_execution_id`: identifiant de la synchronisation exécutée. Cela est renvoyé lorsque vous lancez la synchronisation de l'index avec l'`StartDataSourceSyncJob`API.
Voici le JSON requis pour indexer un document à l'aide d'une source de données personnalisée.
```
{
"Documents": [
{
"Attributes": [
{
"Key": "_data_source_id",
"Value": {
"StringValue": "data source identifier"
}
},
{
"Key": "_data_source_sync_job_execution_id",
"Value": {
"StringValue": "sync job identifier"
}
}
],
"Blob": "document content",
"ContentType": "content type",
"Id": "document identifier",
"Title": "document title"
}
],
"IndexId": "index identifier",
"RoleArn": "IAM role ARN"
}
```
Lorsque vous supprimez un document de l'index à l'aide de l'`BatchDeleteDocument`API, vous devez spécifier les deux champs suivants dans le `DataSourceSyncJobMetricTarget` paramètre :
+ `DataSourceId`: l'identifiant de la source de données. Cela est renvoyé lorsque vous créez la source de données à l'aide de la console ou de l'`CreateDataSource`API.
+ `DataSourceSyncJobId`: identifiant de la synchronisation exécutée. Cela est renvoyé lorsque vous lancez la synchronisation de l'index avec l'`StartDataSourceSyncJob`API.
Voici le JSON requis pour supprimer un document de l'index à l'aide de l'`BatchDeleteDocument`API.
```
{
"DataSourceSyncJobMetricTarget": {
"DataSourceId": "data source identifier",
"DataSourceSyncJobId": "sync job identifier"
},
"DocumentIdList": [
"document identifier"
],
"IndexId": "index identifier"
}
```
## Affichage des métriques
Une fois qu'une tâche de synchronisation est terminée, vous pouvez utiliser l'[DataSourceSyncJobMetrics](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DataSourceSyncJobMetrics.html)API pour obtenir les métriques associées à la tâche de synchronisation. Utilisez-le pour surveiller les synchronisations de vos sources de données personnalisées.
Si vous soumettez le même document plusieurs fois, soit dans le cadre de l'`BatchPutDocument`API, soit dans le cadre de l'`BatchDeleteDocument`API, soit s'il est soumis à la fois pour ajout et suppression, le document n'est pris en compte qu'une seule fois dans les statistiques.
+ `DocumentsAdded`: le nombre de documents soumis à l'aide de l'`BatchPutDocument`API associée à cette tâche de synchronisation ajoutés à l'index pour la première fois. Si un document est soumis pour ajout plusieurs fois lors d'une synchronisation, il n'est pris en compte qu'une seule fois dans les métriques.
+ `DocumentsDeleted`: le nombre de documents soumis à l'aide de l'`BatchDeleteDocument`API associée à cette tâche de synchronisation supprimés de l'index. Si un document est soumis pour suppression plusieurs fois lors d'une synchronisation, il n'est pris en compte qu'une seule fois dans les statistiques.
+ `DocumentsFailed`: le nombre de documents associés à cette tâche de synchronisation dont l'indexation a échoué. Il s'agit de documents qui ont été acceptés Amazon Kendra pour indexation mais qui n'ont pas pu être indexés ou supprimés. Si un document n'est pas accepté par Amazon Kendra, son identifiant est renvoyé dans la propriété de `FailedDocuments` réponse du `BatchPutDocument` et `BatchDeleteDocument` APIs.
+ `DocumentsModified`: le nombre de documents modifiés soumis à l'aide de l'`BatchPutDocument`API associée à cette tâche de synchronisation qui ont été modifiés dans l' Amazon Kendra index.
Amazon Kendra émet également des Amazon CloudWatch métriques lors de l'indexation des documents. Pour plus d'informations, consultez la section [Surveillance Amazon Kendra avec Amazon CloudWatch](https://docs.aws.amazon.com/kendra/latest/dg/cloudwatch-metrics.html).
Amazon Kendra ne renvoie pas la `DocumentsScanned` métrique pour les sources de données personnalisées. Il émet également les CloudWatch métriques répertoriées dans le document [Métriques pour les sources de Amazon Kendra données](https://docs.aws.amazon.com/kendra/latest/dg/cloudwatch-metrics.html#cloudwatch-metrics-data-source).
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données personnalisée, consultez :
+ [Ajouter des sources de données personnalisées à Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/adding-custom-data-sources-to-amazon-kendra/)
# Source de données personnalisée (Java)
Le code suivant fournit un exemple d'implémentation d'une source de données personnalisée à l'aide de Java. Le programme crée d'abord une source de données personnalisée, puis synchronise les documents récemment ajoutés à l'index avec la source de données personnalisée.
Le code suivant illustre la création et l'utilisation d'une source de données personnalisée. Lorsque vous utilisez une source de données personnalisée dans votre application, vous n'avez pas besoin de créer une nouvelle source de données (processus ponctuel) chaque fois que vous synchronisez votre index avec votre source de données. Vous utilisez l'ID d'index et l'ID de source de données pour synchroniser vos données.
```
package com.amazonaws.kendra;
import java.util.concurrent.TimeUnit;
import software.amazon.awssdk.services.kendra.KendraClient;
import csoftware.amazon.awssdk.services.kendra.model.BatchPutDocumentRequest;
import csoftware.amazon.awssdk.services.kendra.model.BatchPutDocumentResponse;
import software.amazon.awssdk.services.kendra.model.CreateDataSourceRequest;
import software.amazon.awssdk.services.kendra.model.CreateDataSourceResponse;
import software.amazon.awssdk.services.kendra.model.DataSourceType;
import software.amazon.awssdk.services.kendra.model.Document;
import software.amazon.awssdk.services.kendra.model.ListDataSourceSyncJobsRequest;
import software.amazon.awssdk.services.kendra.model.ListDataSourceSyncJobsResponse;
import software.amazon.awssdk.services.kendra.model.StartDataSourceSyncJobRequest;
import software.amazon.awssdk.services.kendra.model.StartDataSourceSyncJobResponse;
import software.amazon.awssdk.services.kendra.model.StopDataSourceSyncJobRequest;
import software.amazon.awssdk.services.kendra.model.StopDataSourceSyncJobResponse;
public class SampleSyncForCustomDataSource {
public static void main(String[] args) {
KendraClient kendra = KendraClient.builder().build();
String myIndexId = "yourIndexId";
String dataSourceName = "custom data source";
String dataSourceDescription = "Amazon Kendra custom data source connector"
// Create custom data source
CreateDataSourceRequest createDataSourceRequest = CreateDataSourceRequest
.builder()
.indexId(myIndexId)
.name(dataSourceName)
.description(dataSourceDescription)
.type(DataSourceType.CUSTOM)
.build();
CreateDataSourceResponse createDataSourceResponse = kendra.createDataSource(createDataSourceRequest);
System.out.println(String.format("Response of creating data source: %s", createDataSourceResponse));
// Get the data source ID from createDataSourceResponse
String dataSourceId = createDataSourceResponse.Id();
// Wait for the custom data source to become active
System.out.println(String.format("Waiting for Amazon Kendra to create the data source %s", dataSourceId));
// You can use the DescribeDataSource API to check the status
DescribeDataSourceRequest describeDataSourceRequest = DescribeDataSourceRequest
.builder()
.indexId(myIndexId)
.id(dataSourceId)
.build();
while (true) {
DescribeDataSourceResponse describeDataSourceResponse = kendra.describeDataSource(describeDataSourceRequest);
DataSourceStatus status = describeDataSourceResponse.status();
System.out.println(String.format("Creating data source. Status: %s", status));
if (status != DataSourceStatus.CREATING) {
break;
}
TimeUnit.SECONDS.sleep(60);
}
// Start syncing yor data source by calling StartDataSourceSyncJob and providing your index ID
// and your custom data source ID
System.out.println(String.format("Synchronize the data source %s", dataSourceId));
StartDataSourceSyncJobRequest startDataSourceSyncJobRequest = StartDataSourceSyncJobRequest
.builder()
.indexId(myIndexId)
.id(dataSourceId)
.build();
StartDataSourceSyncJobResponse startDataSourceSyncJobResponse = kendra.startDataSourceSyncJob(startDataSourceSyncJobRequest);
// Get the sync job execution ID from startDataSourceSyncJobResponse
String executionId = startDataSourceSyncJobResponse.ExecutionId();
System.out.println(String.format("Waiting for the data source to sync with the index %s for execution ID %s", indexId, startDataSourceSyncJobResponse.executionId()));
// Add 2 documents uploaded to S3 bucket to your index using the BatchPutDocument API
// The added documents should sync with your custom data source
Document pollyDoc = Document
.builder()
.s3Path(
S3Path.builder()
.bucket("amzn-s3-demo-bucket")
.key("what_is_Amazon_Polly.docx")
.build())
.title("What is Amazon Polly?")
.id("polly_doc_1")
.build();
Document rekognitionDoc = Document
.builder()
.s3Path(
S3Path.builder()
.bucket("amzn-s3-demo-bucket")
.key("what_is_amazon_rekognition.docx")
.build())
.title("What is Amazon rekognition?")
.id("rekognition_doc_1")
.build();
BatchPutDocumentRequest batchPutDocumentRequest = BatchPutDocumentRequest
.builder()
.indexId(myIndexId)
.documents(pollyDoc, rekognitionDoc)
.build();
BatchPutDocumentResponse result = kendra.batchPutDocument(batchPutDocumentRequest);
System.out.println(String.format("BatchPutDocument result: %s", result));
// Once custom data source synced, stop the sync job using the StopDataSourceSyncJob API
StopDataSourceSyncJobResponse stopDataSourceSyncJobResponse = kendra.stopDataSourceSyncJob(
StopDataSourceSyncJobRequest()
.indexId(myIndexId)
.id(dataSourceId)
);
// List your sync jobs
ListDataSourceSyncJobsRequest listDataSourceSyncJobsRequest = ListDataSourceSyncJobsRequest
.builder()
.indexId(myIndexId)
.id(dataSourceId)
.build();
while (true) {
ListDataSourceSyncJobsResponse listDataSourceSyncJobsResponse = kendra.listDataSourceSyncJobs(listDataSourceSyncJobsRequest);
DataSourceSyncJob job = listDataSourceSyncJobsResponse.history().get(0);
System.out.println(String.format("Status: %s", job.status()));
}
}
}
```
# Dropbox
Dropbox est un service d'hébergement de fichiers qui propose des services de stockage dans le cloud, d'organisation de documents et de création de modèles de documents. Si vous êtes un utilisateur de Dropbox, vous pouvez l'utiliser Amazon Kendra pour indexer vos fichiers Dropbox, Dropbox Paper, les modèles Dropbox Paper et les raccourcis enregistrés vers des pages Web. Vous pouvez également configurer Amazon Kendra pour indexer des fichiers Dropbox spécifiques, Dropbox Paper, des modèles Dropbox Paper et des raccourcis enregistrés vers des pages Web.
Amazon Kendraprend en charge Dropbox et Dropbox Advanced pour Dropbox Business.
Vous pouvez vous connecter Amazon Kendra à votre source de données Dropbox à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Dropbox, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-dropbox)
+ [Conditions préalables](#prerequisites-dropbox)
+ [Instructions de connexion](#data-source-procedure-dropbox)
+ [En savoir plus](#dropbox-learn-more)
+ [Remarques](#dropbox-notes)
## Fonctionnalités prises en charge
Amazon KendraLe connecteur de source de données Dropbox prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Dropbox, apportez ces modifications à votre Dropbox et à vos AWS comptes.
**Dans Dropbox, assurez-vous que vous disposez des éléments suivants :**
+ Vous avez créé un compte Dropbox Advanced et configuré un utilisateur administrateur.
+ Configuration d'une application Dropbox avec un **nom d'application** unique, activation de **Scoped Access.** Consultez [la documentation Dropbox sur la création d'une application](https://www.dropbox.com/developers/reference/getting-started#app%20console).
+ **Activation des autorisations Dropbox complètes** sur la console Dropbox et ajout des autorisations suivantes :
+ fichiers.contenu.read
+ fichiers.metadata.read
+ partager.lire
+ fichier\$1requests.read
+ groups.read
+ team\$1info.read
+ team\$1data.content.read
+ Vous avez pris note de votre clé d'application Dropbox, du secret de l'application Dropbox et du jeton d'accès Dropbox pour les informations d'authentification de base.
**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).
+ Vous avez configuré et copié un jeton d'accès Oauth 2.0 temporaire pour votre application Dropbox. Ce jeton est temporaire et expire au bout de 4 heures. Consultez [la documentation Dropbox sur OAuth l'authentification](https://developers.dropbox.com/oauth-guide).
**Note**
Il est recommandé de créer un jeton d'accès d'actualisation Dropbox qui n'expire jamais, plutôt que de vous fier à un jeton d'accès unique qui expire au bout de 4 heures. Un jeton d'accès à l'actualisation est permanent et n'expire jamais afin que vous puissiez continuer à synchroniser votre source de données à l'avenir.
+ **Recommandé :** Configurez un jeton d'actualisation permanent Dropbox qui n'expire jamais Amazon Kendra pour vous permettre de continuer à synchroniser votre source de données sans aucune interruption. Consultez [la documentation de Dropbox sur les jetons d'actualisation](https://developers.dropbox.com/oauth-guide).
+ Il est vérifié que chaque document est unique dans Dropbox et dans 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 votreCompte 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'authentification Dropbox 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 aucun IAM rôle ou 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 données Dropbox à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 données Dropbox, vous devez fournir les informations nécessaires sur celle-ci afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Dropbox pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-dropbox).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Dropbox**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Dropbox**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Dropbox** avec le tag « 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. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **Type de jeton d'authentification** : choisissez un jeton permanent (recommandé) ou un jeton d'accès temporaire.
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Dropbox. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Dropbox-» est automatiquement ajouté à votre nom secret.
1. Pour les informations relatives à la **clé** d'**application, au secret** de l'application et au jeton (permanent ou temporaire) : entrez les valeurs d'identification d'authentification configurées dans Dropbox.
1. Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. Pour **Sélectionner des entités ou des types de contenu** : choisissez les entités Dropbox ou les types de contenu que vous souhaitez analyser.
1. Dans **Configuration supplémentaire** pour les **modèles Regex** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains fichiers.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Fichiers**, **Dropbox Paper** et **modèles Dropbox Paper** : sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés que vous souhaitez associer à votre index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 à Dropbox**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-dropbox-schema) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `DROPBOX` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Type de jeton d'accès** : spécifiez si vous souhaitez utiliser un jeton d'accès permanent ou temporaire pour votre AWS Secrets Manager secret qui stocke vos informations d'authentification.
**Note**
Il est recommandé de créer un jeton d'accès d'actualisation qui n'expire jamais dans Dropbox plutôt que de vous fier à un jeton d'accès unique expirant au bout de 4 heures. Vous créez une application et un jeton d'accès actualisé dans la console de développement Dropbox, puis vous fournissez le jeton d'accès dans votre code secret.
+ **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 compte Dropbox. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"appKey": "Dropbox app key",
"appSecret": "Dropbox app secret",
"accesstoken": "temporary access token or refresh access token"
}
```
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **IAMrôle** : spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour accorder à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur Dropbox etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de données Dropbox](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Types de documents/contenus** : indiquez si vous souhaitez explorer les fichiers de votre Dropbox, les documents Dropbox Paper, les modèles Dropbox Paper et les raccourcis de pages Web stockés dans votre Dropbox.
+ **Filtres d'inclusion et d'exclusion** : indiquez si vous souhaitez inclure ou exclure certains fichiers.
**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.
+ **Liste de contrôle d'accès (ACL)** : indiquez si vous souhaitez analyser les informations ACL de vos documents, si vous disposez d'une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Dropbox à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du modèle Dropbox](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-dropbox-schema).
------
## En savoir plus
Pour en savoir plus sur l'intégration d'Amazon Kendra à votre source de données Dropbox, consultez :
+ [Indexez votre contenu Dropbox à l'aide du connecteur Dropbox pour Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/index-your-dropbox-content-using-the-dropbox-connector-for-amazon-kendra/)
## Remarques
+ Lorsque les listes de contrôle d'accès (ACLs) sont activées, l'option « Synchroniser uniquement le contenu nouveau ou modifié » n'est pas disponible en raison des limites de l'API Dropbox. Nous vous recommandons d'utiliser plutôt les modes « Synchronisation complète » ou « Synchronisation du contenu nouveau, modifié ou supprimé », ou de les désactiver ACLs si vous devez utiliser ce mode de synchronisation.
# Drupal
**Note**
Le connecteur Drupal reste entièrement pris en charge pour les clients existants jusqu'au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Drupal est un système de gestion de contenu (CMS) open source que vous pouvez utiliser pour créer des sites Web et des applications Web. Vous pouvez l'utiliser Amazon Kendra pour indexer les éléments suivants dans Drupal :
+ Contenu : articles, pages de base, blocs de base, types de contenu définis par l'utilisateur, types de blocs définis par l'utilisateur, types de contenu personnalisés, types de blocs personnalisés
+ Commentaire : pour tous les types de contenu et de bloc
+ Pièces jointes : pour tous les types de contenu et de blocs
Vous pouvez vous connecter Amazon Kendra à votre source de données Drupal à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) ou de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Drupal, consultez. [Dépannage des sources de données](troubleshooting-data-sources.md)
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-drupal)
+ [Conditions préalables](#prerequisites-drupal)
+ [Instructions de connexion](#data-source-procedure-drupal)
+ [Remarques](#drupal-notes)
## Fonctionnalités prises en charge
Amazon KendraLe connecteur de source de données Drupal prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Drupal, apportez ces modifications à votre Drupal et à vos comptes. AWS
**Dans Drupal, assurez-vous d'avoir :**
+ Création d'un compte Drupal (Standard) Suite et d'un utilisateur doté d'un rôle d'administrateur.
+ Vous avez copié le nom de votre site Drupal et configuré une URL d'hôte. Par exemple, *https:///*.
+ Identifiants d'authentification de base configurés contenant un nom d'utilisateur (nom d'utilisateur de connexion au site Web Drupal) et un mot de passe (mot de passe du site Web Drupal).
+ **Recommandé :** configuration d'un jeton d'identification OAuth 2.0. Utilisez ce jeton avec votre mot de passe Drupal, votre identifiant client, votre secret client, votre nom d'utilisateur (nom d'utilisateur de connexion au site Web Drupal) et votre mot de passe (mot de passe du site Web Drupal) pour vous connecter à. Amazon Kendra
+ Vous avez ajouté les autorisations suivantes à votre compte Drupal à l'aide d'un rôle d'administrateur :
+ administrer des blocs
+ administrer l’affichage de block\$1content
+ administrer les champs block\$1content
+ administrer l’affichage du formulaire block\$1content
+ administrer les vues
+ afficher les adresses e-mail des utilisateurs
+ afficher son propre contenu non publié
+ afficher les révisions de page
+ afficher les révisions de l’article
+ afficher toutes les révisions
+ afficher le thème de l’administration
+ accéder au contenu
+ accéder à la présentation du contenu
+ accéder aux commentaires
+ rechercher du contenu
+ accéder à l’aperçu des fichiers
+ accéder aux liens contextuels
**Note**
S'il existe des types de contenu définis par l'utilisateur ou des types de blocs définis par l'utilisateur, ou si des vues et des blocs sont ajoutés au site Web Drupal, ils doivent disposer d'un accès administrateur.
**Dans votreCompte 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'authentification Drupal 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 données Drupal à. 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 données Drupal, vous devez fournir les détails de vos informations d'identification Drupal afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Drupal pour Amazon Kendra voir. [Conditions préalables](#prerequisites-drupal)
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Drupal**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Drupal**, puis sélectionnez **Ajouter** un connecteur. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Drupal** avec le tag « 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. Dans **Source**, pour **URL hôte : URL** hôte de votre site Drupal. Par exemple, *https:///*.
1. Pour l'**emplacement du certificat SSL** : entrez le chemin d'accès au certificat SSL stocké dans votre Amazon S3 compartiment.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. Pour **l'authentification** : choisissez entre **l'authentification de base et l'****authentification OAuth 2.0** en fonction de votre cas d'utilisation.
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Drupal. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. Si vous avez choisi **l'authentification de base**, entrez le **nom secret, le nom** **d'utilisateur (nom d'utilisateur du** site Drupal) et le mot de **passe (mot de passe** du site Drupal) que vous avez copiés, puis choisissez **Enregistrer** et ajouter un secret.
1. **Si vous avez choisi **l'authentification OAuth 2.0**, entrez un **nom secret, un nom** **d'utilisateur (nom d'utilisateur du** site Drupal), un mot de **passe (mot** de passe du site Drupal), un **identifiant client** et un **secret client** générés dans votre compte Drupal, puis choisissez Enregistrer et ajouter un secret.**
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. Pour l'**étendue de la synchronisation**, choisissez l'une des options suivantes :
**Note**
Lorsque vous choisissez d’analyser les **articles**, les **pages de base** et les **blocs de base**, leurs champs par défaut sont automatiquement synchronisés. Vous pouvez également choisir de synchroniser leurs commentaires, leurs pièces jointes, leurs champs personnalisés et autres entités personnalisées.
1. Pour **Sélectionner des entités** :
+ **Articles** : choisissez si vous souhaitez indexer les **Articles**, leurs **Commentaires** et leurs **Pièces jointes**.
+ **Pages de base** : choisissez si vous souhaitez indexer les **Pages de base**, leurs **Commentaires** et leurs **Pièces jointes**.
+ **Blocs de base** : choisissez si vous souhaitez indexer les **Blocs de base**, leurs **Commentaires** et leurs **Pièces jointes**.
+ Vous pouvez également choisir d'ajouter des **types de contenu personnalisés** et **des blocs personnalisés**.
1. Pour une **configuration supplémentaire, optionnelle** :
+ Pour le **modèle Regex** : ajoutez des modèles d'expressions régulières pour inclure ou exclure des titres d'entités et des noms de fichiers spécifiques. Vous pouvez ajouter jusqu’à 100 modèles.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, **Fréquence** : fréquence Amazon Kendra de synchronisation avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Pour **le contenu**, les **commentaires** et les **pièces jointes** : 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 à Drupal**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-drupal-schema) à l'aide de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `DRUPAL` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon secret (ARN)** : fournissez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre compte Drupal.
Si vous utilisez l'authentification de base, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password"
}
```
Si vous utilisez l'authentification OAuth 2.0, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client 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).
+ **IAMrole** —Spécifiez `RoleArn` quand 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 connecteur Drupal et. Amazon Kendra Pour plus d'informations, consultez la section [IAMRôles des sources de données Drupal](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez indiquer si vous souhaitez inclure le contenu, les commentaires et les pièces jointes. Vous pouvez également spécifier des modèles d'expressions régulières pour inclure ou exclure du contenu, des commentaires et des pièces jointes.
**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.
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Drupal à vos champs d'index. Amazon Kendra 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez[Schéma du modèle Drupal](ds-schemas.md#ds-drupal-schema).
------
## Remarques
+ Drupal n'a APIs pas de limite officielle de régulation.
+ Java SDKs n'est pas disponible pour Drupal.
+ Les données Drupal ne peuvent être récupérées qu'à l'aide des API JSON natives.
+ Les types de contenu qui ne sont associés à aucune **vue** Drupal ne peuvent pas être analysés.
+ **Vous devez disposer d'un accès administrateur pour analyser les données de Drupal Blocks.**
+ Aucune API JSON n’est disponible pour créer le type de contenu défini par l’utilisateur à l’aide de verbes HTTP.
+ Le corps du document et les commentaires relatifs aux **Articles**, aux **Pages de base**, aux **Blocs de base**, au type de contenu défini par l’utilisateur et au type de bloc défini par l’utilisateur sont affichés au format HTML. Si le contenu HTML n’est pas bien formé, les balises associées au code HTML apparaîtront dans le corps du document et dans les commentaires, et seront visibles dans les résultats de recherche Amazon Kendra.
+ Les types de contenu et les types de **blocs** sans description ni corps ne seront pas ingérés. Amazon Kendra Seuls **les commentaires** et **les pièces jointes** de ce type de **contenu** ou de **bloc** seront ingérés dans votre Amazon Kendra index.
# GitHub
GitHub est un service d'hébergement Web pour le développement de logiciels fournissant des services de stockage et de gestion de code avec contrôle de version. Vous pouvez les utiliser Amazon Kendra pour indexer les fichiers de vos référentiels GitHub GitHub Enterprise Cloud (SaaS) et Enterprise Server (On Prem), émettre et extraire des demandes, émettre et extraire des commentaires, et émettre et extraire des pièces jointes aux commentaires. Vous pouvez également choisir d'inclure ou d'exclure certains fichiers.
**Note**
Amazon Kendraprend désormais en charge un GitHub connecteur amélioré.
La console a été automatiquement mise à niveau pour vous. Tous les nouveaux connecteurs que vous créez dans la console utiliseront l'architecture mise à niveau. Si vous utilisez l'API, vous devez désormais utiliser l'[https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet au lieu de l'`GitHubConfiguration`objet pour configurer votre connecteur.
Les connecteurs configurés à l'aide de l'ancienne console et de l'ancienne architecture d'API continueront de fonctionner tels qu'ils ont été configurés. Toutefois, vous ne pourrez ni les modifier ni les mettre à jour. Si vous souhaitez modifier ou mettre à jour la configuration de votre connecteur, vous devez créer un nouveau connecteur.
Nous vous recommandons de migrer le flux de travail de votre connecteur vers la version mise à niveau. Support pour les connecteurs configurés à l'aide de l'ancienne architecture devrait prendre fin en juin 2024.
Vous pouvez vous connecter Amazon Kendra à votre source de GitHub données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra GitHub données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-github)
+ [Conditions préalables](#prerequisites-github)
+ [Instructions de connexion](#data-source-procedure-github)
+ [En savoir plus](#github-learn-more)
## Fonctionnalités prises en charge
Amazon KendraGitHub le connecteur de source de données prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de GitHub données, apportez ces modifications à vos AWS comptes GitHub and.
**Dans GitHub, assurez-vous d'avoir :**
+ A créé un GitHub utilisateur doté d'autorisations administratives pour l' GitHub organisation.
+ Vous avez configuré un jeton d'accès personnel dans Git Hub à utiliser comme identifiant d'authentification. Consultez la [Documentation GitHub sur la création d’un jeton d’accès personnel](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token).
**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).
+ **Recommandé : j'**ai configuré un OAuth jeton pour les informations d'authentification. Utilisez un OAuth jeton pour améliorer les limites d'accélération des API et les performances du connecteur. Voir [GitHub la documentation sur OAuth l'autorisation](https://docs.github.com/en/rest/apps/oauth-applications?apiVersion=2022-11-28#about-oauth-apps-and-oauth-authorizations-of-github-apps).
+ Notez l'URL de l' GitHub hôte correspondant au type de GitHub service que vous utilisez. Par exemple, l'URL de l'hôte pour le GitHub cloud peut être *https://api.github.com* et l'URL de l'hôte pour le GitHub serveur peut être*https://on-prem-host-url/api/v3/*.
+ Notez le nom de votre organisation pour GitHub le compte GitHub Enterprise Cloud (SaaS) ou le compte GitHub Enterprise Server (sur site) auquel vous souhaitez vous connecter. Vous pouvez trouver le nom de votre organisation en vous connectant à votre GitHub ordinateur de bureau et en sélectionnant **Vos organisations** dans le menu déroulant de votre photo de profil.
+ **Facultatif (serveur uniquement) :** création d'un certificat SSL et copie du chemin d'accès au certificat stocké dans un Amazon S3 compartiment. Vous l'utilisez pour vous connecter GitHub si vous avez besoin d'une connexion SSL sécurisée. Vous pouvez simplement générer un certificat X509 auto-signé sur n'importe quel ordinateur utilisant OpenSSL. Pour un exemple d'utilisation d'OpenSSL pour créer un certificat X509, [voir Créer et](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/configuring-https-ssl.html) signer un certificat X509.
+ Les autorisations suivantes ont été ajoutées :
**Pour le cloud GitHub d'entreprise (SaaS)**
+ `repo:status`— Accorde read/write l'accès aux statuts de validation dans les référentiels publics et privés. Cette portée est uniquement nécessaire pour accorder à d’autres utilisateurs ou services l’accès aux statuts de validation du référentiel privé sans accorder l’accès au code.
+ `repo_deployment` : accorde l’accès aux statuts de déploiement pour les référentiels publics et privés. Cette portée est uniquement nécessaire pour accorder à d’autres utilisateurs ou services l’accès aux statuts de déploiement, sans accorder l’accès au code.
+ `public_repo` : limite l’accès aux référentiels publics. Cela inclut read/write l'accès au code, les statuts de validation, les projets de référentiel, les collaborateurs et les statuts de déploiement pour les référentiels publics et les organisations. Également nécessaire pour marquer d’une étoile les référentiels publics.
+ `repo:invite`— Accorde accept/decline des capacités pour les invitations à collaborer sur un référentiel. Cette portée est uniquement nécessaire pour accorder à d’autres utilisateurs ou services l’accès aux invites sans accorder l’accès au code.
+ `security_events` – Octrois : accès en lecture et en écriture aux événements de sécurité dans l’API d’analyse de code. Cette portée est uniquement nécessaire pour accorder à d’autres utilisateurs ou services l’accès à des événements de sécurité sans accorder l’accès au code.
+ `read:org` : accès en lecture seule aux membres de l’organisation, aux projets de l’organisation et aux membres de l’équipe.
+ `user:email` : accorde un accès en lecture aux adresses e-mail des utilisateurs. Requis par Amazon Kendra pour explorer. ACLs
+ `user:follow` : accorde l’accès pour suivre ou ne plus suivre d’autres utilisateurs. Requis par Amazon Kendra pour explorer. ACLs
+ `read:user` : autorise un accès pour lire les données du profil d’un utilisateur. Requis par Amazon Kendra pour explorer. ACLs
+ `workflow` : permet d’ajouter et de mettre à jour des fichiers de flux de travail GitHub Actions. Les fichiers de flux de travail peuvent être validés sans cette portée si le même fichier (avec le même chemin et le même contenu) existe sur une autre branche du même référentiel.
Pour plus d'informations, voir [Étendue des OAuth applications](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps) dans GitHub Docs.
**Pour GitHub Enterprise Server (sur site)**
+ `repo:status`— Accorde read/write l'accès aux statuts de validation dans les référentiels publics et privés. Cette portée est uniquement nécessaire pour accorder à d’autres utilisateurs ou services l’accès aux statuts de validation du référentiel privé sans accorder l’accès au code.
+ `repo_deployment` : accorde l’accès aux statuts de déploiement pour les référentiels publics et privés. Cette portée est uniquement nécessaire pour accorder à d’autres utilisateurs ou services l’accès aux statuts de déploiement, sans accorder l’accès au code.
+ `public_repo` : limite l’accès aux référentiels publics. Cela inclut read/write l'accès au code, les statuts de validation, les projets de référentiel, les collaborateurs et les statuts de déploiement pour les référentiels publics et les organisations. Également nécessaire pour marquer d’une étoile les référentiels publics.
+ `repo:invite`— Accorde accept/decline des capacités pour les invitations à collaborer sur un référentiel. Cette portée est uniquement nécessaire pour accorder à d’autres utilisateurs ou services l’accès aux invites sans accorder l’accès au code.
+ `security_events` – Octrois : accès en lecture et en écriture aux événements de sécurité dans l’API d’analyse de code. Cette portée est uniquement nécessaire pour accorder à d’autres utilisateurs ou services l’accès à des événements de sécurité sans accorder l’accès au code.
+ `read:user` : autorise un accès pour lire les données du profil d’un utilisateur. Requis par Amazon Q Business pour l'exploration ACLs.
+ `user:email` : accorde un accès en lecture aux adresses e-mail des utilisateurs. Requis par Amazon Q Business pour l'exploration ACLs.
+ `user:follow` : accorde l’accès pour suivre ou ne plus suivre d’autres utilisateurs. Requis par Amazon Q Business pour l'exploration ACLs.
+ `site_admin`— Accorde aux administrateurs du site l'accès aux points de terminaison de l'API d'administration des serveurs d' GitHub entreprise.
+ `workflow` : permet d’ajouter et de mettre à jour des fichiers de flux de travail GitHub Actions. Les fichiers de flux de travail peuvent être validés sans cette portée si le même fichier (avec le même chemin et le même contenu) existe sur une autre branche du même référentiel.
Pour plus d'informations, voir [Étendue des OAuth applications](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps) dans GitHub Docs et [Comprendre les étendues des OAuth applications dans GitHub Developer](https://developer.github.com/enterprise/2.16/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes).
+ Il est vérifié que chaque document est unique dans GitHub 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 votreCompte 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' GitHub 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 GitHub 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 GitHub données, vous devez fournir les informations nécessaires sur votre source de GitHub données afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré GitHub pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-github).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à GitHub**
1. Connectez-vous à la [Amazon Kendraconsole 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 **GitHub connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **GitHub 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 tirets, 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. **GitHubsource** —Choisissez entre **GitHub Enterprise Cloud** et **GitHubEnterprise Server**.
1. **GitHub URL de l'hôte** —Par exemple, l'URL de l'hôte pour le GitHub cloud peut être *https://api.github.com* et l'URL de l'hôte pour le GitHub serveur peut être*https://on-prem-host-url/api/v3/*.
1. **GitHub nom de l'organisation** : entrez le nom de votre GitHub organisation. Vous trouverez les informations relatives à votre organisation dans votre GitHub compte.
**Note**
GitHub connector prend en charge l'analyse d'une seule organisation par instance de connecteur de source de données.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations GitHub d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - GitHub - » est automatiquement ajouté à votre nom secret.
1. Pour le **GitHubjeton** : entrez la valeur d'identification d'authentification configurée dans. GitHub
1. Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. **Sélectionnez les référentiels** : choisissez d'explorer tous les référentiels ou de sélectionner.
Si vous choisissez d'explorer certains référentiels, ajoutez les noms des référentiels et, éventuellement, le nom de branches spécifiques.
1. **Types de contenu** : choisissez les types de contenu que vous souhaitez explorer parmi les fichiers, les problèmes, les pull requests, etc.
1. **Modèles Regex** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains fichiers.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution** pour **la fréquence** : choisissez la fréquence à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à GitHub**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-github-schema) à l'aide de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `GITHUB` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **GitHubtype** —Spécifiez le type comme suit : `SAAS` ou`ON_PREMISE`.
+ **URL de l'hôte** : spécifiez l'URL de l' GitHub hôte ou l'URL du point de terminaison de l'API. Par exemple, si vous utilisez le GitHub SaaS/Enterprise Cloud, l'URL de l'hôte peut être, et pour le serveur GitHub local ou d'entreprise`https://api.github.com`, l'URL de l'hôte peut être l'URL de l'hôte. `https://on-prem-host-url/api/v3/`
+ **Nom de l'organisation** —Spécifiez le nom de l'organisation du GitHub compte. Vous pouvez trouver le nom de votre organisation en vous connectant à votre GitHub ordinateur de bureau et en sélectionnant **Vos organisations** dans le menu déroulant de votre photo de profil.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **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 GitHub compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"personalToken": "token"
}
```
+ **IAMrole** —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 GitHub connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de GitHub 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
**Note**
Si vous utilisez un GitHub serveur, vous devez utiliser un Amazon VPC pour vous connecter à votre GitHub serveur.
+ **Filtre de référentiel** : filtrez les référentiels par nom et par nom de branche.
+ **Types de documents/contenus** : indiquez s'il faut analyser les documents du référentiel, les problèmes, les commentaires, les pièces jointes aux commentaires, les pull requests, les commentaires des demandes d'extraction, les pièces jointes aux commentaires des demandes d'extraction.
+ **Filtres d'inclusion et d'exclusion** : indiquez si vous souhaitez inclure ou exclure certains fichiers et dossiers.
**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.
+ **Liste de contrôle d'accès (ACL)** : indiquez si vous souhaitez analyser les informations ACL de vos documents, si vous disposez d'une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de GitHub données à vos champs d'Amazon Kendraindex. Vous pouvez inclure des champs de documents, des validations, des problèmes, des pièces jointes, des commentaires, des pull requests, des pièces jointes de pull request, des commentaires de pull request. 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 qu'Amazon Kendra puisse effectuer des recherches 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du GitHub modèle](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-github-schema).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de GitHub données, consultez :
+ [Réimaginez la recherche sur GitHub les référentiels grâce à la puissance du connecteur Amazon Kendra GitHub ](https://aws.amazon.com/blogs/machine-learning/reimagine-search-on-github-repositories-with-the-power-of-the-amazon-kendra-github-connector/)
# Gmail
Gmail est un client de messagerie développé par Google grâce auquel vous pouvez envoyer des e-mails avec des pièces jointes. Les messages Gmail peuvent être triés et stockés dans votre boîte de réception à l'aide de dossiers et d'étiquettes. Vous pouvez l'utiliser Amazon Kendra pour indexer vos e-mails et vos pièces jointes. Vous pouvez également configurer Amazon Kendra pour inclure ou exclure des e-mails, des pièces jointes et des étiquettes spécifiques à des fins d'indexation.
Vous pouvez vous connecter Amazon Kendra à votre source de données Gmail à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Gmail, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-gmail)
+ [Conditions préalables](#prerequisites-gmail)
+ [Instructions de connexion](#data-source-procedure-gmail)
+ [En savoir plus](#gmail-learn-more)
+ [Remarques](#gmail-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Gmail, apportez ces modifications à votre compte Gmail et à vos AWS comptes.
**Dans Gmail, assurez-vous d'avoir :**
+ Créé un compte d’administrateur Google Cloud Platform et un projet Google Cloud.
+ Vous avez activé l'API Gmail et l'API Admin SDK dans votre compte administrateur.
+ Vous avez créé un compte de service et téléchargé une clé privée JSON pour votre compte Gmail. Pour plus d'informations sur la création et l'accès à votre clé privée, consultez la documentation de Google Cloud sur la [création d'une clé de compte de service](https://cloud.google.com/iam/docs/keys-create-delete#creating) et les [informations d'identification du compte de service](https://cloud.google.com/iam/docs/service-account-creds#key-types).
+ Vous avez copié l'adresse e-mail de votre compte administrateur, celle de votre compte de service et votre clé privée pour les utiliser comme informations d'authentification.
**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).
+ Les étendues Oauth suivantes (en utilisant un rôle d'administrateur) ont été ajoutées pour votre utilisateur et les répertoires partagés que vous souhaitez indexer :
+ https://www.googleapis.com/auth/admin.directory.user.readonly
+ https://www.googleapis.com/auth/gmail.readonly
+ Il est vérifié que chaque document est unique dans Gmail et dans 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 votreCompte 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'authentification Gmail 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 données Gmail à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 données Gmail, vous devez fournir les détails de vos informations d'identification Gmail afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Gmail pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-gmail).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Gmail**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Gmail**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Gmail** 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 tirets, 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. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. Dans **Authentification** pour le **AWSSecrets Managersecret** : choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Gmail. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom secret** : nom de votre secret.
1. **Adresse e-mail du** client : adresse e-mail du client que vous avez copiée depuis votre compte de service Google.
1. **Adresse e-mail du compte administrateur** : adresse e-mail du compte administrateur que vous souhaitez utiliser.
1. **Clé privée** : clé privée que vous avez copiée depuis votre compte de service Google.
1. Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Pour les **types d'entités** : choisissez de synchroniser les pièces jointes des messages.
1. (Facultatif) Pour **Configuration supplémentaire**, entrez les informations suivantes :
1. **Plage de dates** : entrez une plage de dates pour spécifier les dates de début et de fin des e-mails que vous souhaitez analyser.
1. **Domaines de messagerie** : incluez ou excluez certains e-mails en fonction des domaines de messagerie « à », « de », « cc » et « bcc ».
1. **Mots clés dans les sujets** : incluez ou excluez les e-mails en fonction des mots clés figurant dans leur objet.
**Note**
Vous pouvez également choisir d'inclure tous les documents correspondant à tous les mots clés du sujet que vous avez saisis.
1. **Étiquettes** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certaines étiquettes d'e-mail.
1. **Pièces jointes** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certaines pièces jointes à des e-mails.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
**Important**
Comme il n'existe aucune API permettant de mettre à jour les messages Gmail définitivement supprimés, les contenus nouveaux, modifiés ou supprimés sont synchronisés :
Ne supprimera pas de votre Amazon Kendra index les messages définitivement supprimés de Gmail
Ne synchronisera pas les modifications dans les libellés des e-mails Gmail
Pour synchroniser les modifications apportées à l'étiquette de votre source de données Gmail et les e-mails définitivement supprimés avec votre Amazon Kendra index, vous devez effectuer régulièrement des analyses complètes.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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.
**Note**
Amazon KendraLe connecteur de source de données Gmail ne prend pas en charge la création de champs d'index personnalisés en raison des limites de l'API.
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 depuis 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 à Gmail**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-gmail-schema) à l'aide de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `GMAIL` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
**Important**
Comme il n'existe aucune API permettant de mettre à jour les messages Gmail définitivement supprimés, les contenus nouveaux, modifiés ou supprimés sont synchronisés :
Ne supprimera pas de votre Amazon Kendra index les messages définitivement supprimés de Gmail
Ne synchronisera pas les modifications dans les libellés des e-mails Gmail
Pour synchroniser les modifications apportées à l'étiquette de votre source de données Gmail et les e-mails définitivement supprimés avec votre Amazon Kendra index, vous devez effectuer régulièrement des analyses complètes.
+ **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 compte Gmail. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"adminAccountEmailId": "service account email",
"clientEmailId": "user account email",
"privateKey": "private key"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment 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 connecteur Gmail etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de données Gmail](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : indiquez s'il faut inclure ou exclure certains e-mails « à », « de », « cc » ou « bcc ».
**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.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Gmail à vos champs d'Amazon Kendraindex. 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.
**Note**
Amazon KendraLe connecteur de source de données Gmail ne prend pas en charge la création de champs d'index personnalisés en raison des limites de l'API.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du Gmail modèle](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-gmail-schema).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Gmail, consultez :
+ [Effectuez une recherche intelligente dans les e-mails de votre espace de travail Google à l'aide du connecteur Gmail pour Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/perform-intelligent-search-across-emails-in-your-google-workspace-using-the-gmail-connector-for-amazon-kendra/).
## Remarques
+ Comme il n'existe aucune API permettant de mettre à jour les messages Gmail définitivement supprimés, une **synchronisation de contenu`FULL_CRAWL`/Nouveau, modifié ou supprimé** :
+ Ne supprimera pas de votre Amazon Kendra index les messages définitivement supprimés de Gmail
+ Ne synchronisera pas les modifications dans les libellés des e-mails Gmail
Pour synchroniser les modifications apportées à l'étiquette de votre source de données Gmail et les e-mails définitivement supprimés avec votre Amazon Kendra index, vous devez effectuer régulièrement des analyses complètes.
+ Amazon KendraLe connecteur de source de données Gmail ne prend pas en charge la création de champs d'index personnalisés en raison des limites de l'API.
# Google Drive
Google Drive est un service de stockage de fichiers basé sur le cloud. Vous pouvez l'utiliser Amazon Kendra pour indexer les documents stockés dans des disques partagés, dans les dossiers Mes disques et dans les dossiers Shared with me de votre source de données Google Drive. Vous pouvez indexer à la fois les documents Google Workspace et les documents répertoriés dans [Types de documentation](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html). Vous pouvez également utiliser des filtres d'inclusion et d'exclusion pour indexer le contenu par nom de fichier, type de fichier et chemin de fichier.
Vous pouvez vous connecter Amazon Kendra à votre source de données Google Drive à l'aide de la [Amazon Kendra console](https://console.aws.amazon.com/kendra/), de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API ou de l'[GoogleDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_GoogleDriveConfiguration.html)API.
Amazon Kendra possède deux versions du connecteur Google Drive. Les fonctionnalités prises en charge par chaque version incluent :
**Connecteur Google Drive V1.0/API [GoogleDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_GoogleDriveConfiguration.html)**
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
**Connecteur Google Drive V2.0/API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
**Note**
Connecteur Google Drive V1.0/ L' DriveConfiguration API Google a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le connecteur Google Drive TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Google Drive, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Connecteur Google Drive V1.0](data-source-v1-google-drive.md)
+ [Connecteur Google Drive V2.0](data-source-v2-google-drive.md)
# Connecteur Google Drive V1.0
Google Drive est un service de stockage de fichiers basé sur le cloud. Vous pouvez l'utiliser Amazon Kendra pour indexer les documents et les commentaires stockés dans les dossiers Drive partagés, Mes Drives et Shared with me de votre source de données Google Drive. Vous pouvez indexer les documents Google Workspace, ainsi que les documents répertoriés dans [la section Types de documentation](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html). Vous pouvez également utiliser des filtres d'inclusion et d'exclusion pour indexer le contenu par nom de fichier, type de fichier et chemin de fichier.
**Note**
Connecteur Google Drive V1.0/ L' DriveConfiguration API Google a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le connecteur Google Drive TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Google Drive, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v1-google-drive)
+ [Conditions préalables](#prerequisites-v1-google-drive)
+ [Instructions de connexion](#data-source-v1-procedure-google-drive)
+ [En savoir plus](#google-drive-learn-more)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Google Drive, apportez ces modifications à votre Google Drive et à vos AWS comptes.
**Dans Google Drive, assurez-vous que vous disposez des éléments suivants :**
+ **Soit** vous avez obtenu l’accès par un rôle de super administrateur, **soit** vous êtes un utilisateur doté de privilèges administratifs. Vous n’avez pas besoin d’un rôle de super administrateur si l’accès vous a été accordé par un rôle de super administrateur.
+ Création d'un compte de service avec **Activer la délégation à l'échelle du domaine G Suite** activé et une clé JSON comme clé privée à l'aide du compte.
+ Vous avez copié l'e-mail de votre compte utilisateur et celui de votre compte de service. Lorsque vous vous connectez, entrez l'adresse e-mail de votre compte utilisateur en tant qu'adresse e-mail du compte administrateur et l'adresse e-mail de votre compte de service en tant qu'e-mail client dans votre AWS Secrets Manager code secret. Amazon Kendra
**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).
+ Ajout de l'API du SDK d'administration et de l'API Google Drive dans votre compte.
+ Vous avez ajouté (ou demandé à un utilisateur doté d'un rôle de super administrateur d'ajouter) les autorisations suivantes à votre compte de service à l'aide d'un rôle de super administrateur :
+ https://www.googleapis.com/auth/lecteur.readonly
+ https://www.googleapis.com/auth/drive.metadata.readonly
+ https://www.googleapis.com/auth/admin.directory.user.readonly
+ https://www.googleapis.com/auth/admin.directory.group.readonly
+ Il est vérifié que chaque document est unique dans Google Drive et dans 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'authentification Google Drive 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 données Google Drive à 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 données Google Drive, vous devez fournir les informations nécessaires sur votre source de données Google Drive afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Google Drive pour Amazon Kendra voir[Conditions préalables](#prerequisites-v1-google-drive).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Google Drive**
1. Connectez-vous à la console AWS de gestion et [Amazon Kendra 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 le **connecteur Google Drive V1.0**, puis sélectionnez **Ajouter un connecteur**.
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 tirets, 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. Pour le **type d'authentification**, choisissez entre **existant** et **nouveau**. Si vous choisissez d'utiliser un secret existant, utilisez **Select secret** pour choisir votre secret.
1. Si vous choisissez de créer un nouveau secret, une option AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Google Drive » est automatiquement ajouté à votre nom secret.
1. Pour l'**adresse e-mail du compte administrateur**, l'**adresse e-mail du client** et la **clé privée**, entrez les valeurs d'identification d'authentification que vous avez générées et téléchargées depuis votre compte Google Drive.
1. 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. **Exclure les comptes utilisateur** : les utilisateurs de Google Drive que vous souhaitez exclure de l'index. Vous pouvez ajouter jusqu'à 100 comptes utilisateurs.
1. **Exclure les lecteurs partagés** : les lecteurs partagés Google Drive que vous souhaitez exclure de votre index. Vous pouvez ajouter jusqu'à 100 disques partagés.
1. **Exclure les types de fichiers lecteurs** : les types de fichiers Google Drive que vous souhaitez exclure de votre index. Vous pouvez également choisir de modifier les sélections de type MIME.
1. **Configurations supplémentaires** : modèles d'expressions régulières pour inclure ou exclure certains contenus. Vous pouvez ajouter jusqu’à 100 modèles.
1. **Fréquence : fréquence** Amazon Kendra de synchronisation avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Pour **GoogleDrive le nom du champ** et **les mappages de champs supplémentaires suggérés**, 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à Google Drive**
Vous devez spécifier les éléments suivants à l'aide de l'[GoogleDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_GoogleDriveConfiguration.html)API :
+ **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 compte Google Drive. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"clientAccount": "service account email",
"adminAccount": "user account email"",
"privateKey": "private key"
}
```
+ **IAM role** —Spécifiez à quel `RoleArn` moment 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 connecteur Google Drive et Amazon Kendra. Pour plus d'informations, consultez la section [IAM Rôles des sources de données Google Drive](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** : Amazon Kendra indexe par défaut tous les documents de Google Drive. Vous pouvez spécifier si vous souhaitez inclure ou exclure certains contenus dans les lecteurs partagés, les comptes utilisateur, les types MIME de documents et les fichiers. Si vous choisissez d'exclure des comptes utilisateurs, aucun des fichiers du My Drive appartenant au compte n'est indexé. Les fichiers partagés avec l'utilisateur sont indexés sauf si le propriétaire du fichier est également exclu.
**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 données Google Drive à 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).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Google Drive, consultez :
+ [Commencer à utiliser le connecteur Amazon Kendra Google Drive](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-google-drive-connector/)
# Connecteur Google Drive V2.0
Google Drive est un service de stockage de fichiers basé sur le cloud. Vous pouvez l'utiliser Amazon Kendra pour indexer les documents et les commentaires stockés dans les dossiers Drive partagés, Mes Drives et Shared with me de votre source de données Google Drive. Vous pouvez indexer les documents Google Workspace, ainsi que les documents répertoriés dans [la section Types de documentation](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html). Vous pouvez également utiliser des filtres d'inclusion et d'exclusion pour indexer le contenu par nom de fichier, type de fichier et chemin de fichier.
**Note**
Connecteur Google Drive V1.0/ L' DriveConfiguration API Google a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le connecteur Google Drive TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Google Drive, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v2-google-drive)
+ [Conditions préalables](#prerequisites-v2-google-drive)
+ [Instructions de connexion](#data-source-procedure-v2-google-drive)
+ [Remarques](#google-drive-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Google Drive, apportez ces modifications à votre Google Drive et à vos AWS comptes.
**Dans Google Drive, assurez-vous que vous disposez des éléments suivants :**
+ **Soit** vous avez obtenu l’accès par un rôle de super administrateur, **soit** vous êtes un utilisateur doté de privilèges administratifs. Vous n’avez pas besoin d’un rôle de super administrateur si l’accès vous a été accordé par un rôle de super administrateur.
+ Configuré des informations d’identification de connexion au compte de service Google Drive contenant l’adresse e-mail de votre compte administrateur, l’adresse e-mail du client (adresse e-mail du compte de service) et votre clé privée. Consultez la [Documentation Google Cloud sur la création et la suppression de clés de compte de service](https://cloud.google.com/iam/docs/keys-create-delete).
**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).
+ Vous avez créé un compte de service Google Cloud (un compte doté de l'autorité déléguée pour assumer une identité d'utilisateur) avec l'activation de l'**option Activer la délégation à l'échelle du domaine G Suite** à des fins server-to-server d'authentification, puis généré une clé privée JSON à l'aide du compte.
**Note**
La clé privée doit être générée après la création du compte de service.
+ Ajouté l’API du kit SDK d’administration et l’API Google Drive dans votre compte utilisateur.
+ **Facultatif :** J'ai configuré les informations de connexion Google Drive OAuth 2.0 contenant l'identifiant du client, le secret du client et le jeton d'actualisation en tant qu'informations de connexion pour un utilisateur spécifique. Vous en avez besoin pour indexer les données de chaque compte. Consultez [la documentation Google sur l'utilisation de la OAuth version 2.0 pour y accéder APIs](https://developers.google.com/identity/protocols/oauth2).
+ Vous avez ajouté (ou demandé à un utilisateur doté d'un rôle de super administrateur d'ajouter) les OAuth étendues suivantes à votre compte de service à l'aide d'un rôle de super administrateur. Ces portées d’API sont nécessaires pour indexer tous les documents et les informations de liste de contrôle d’accès (ACL) pour tous les utilisateurs d’un domaine Google Workspace :
+ https://www.googleapis.com/auth/Drive.readOnly : affichez et téléchargez tous vos fichiers Google Drive
+ https://www.googleapis.com/auth/drive.metadata.readonly : affiche les métadonnées des fichiers de votre Google Drive
+ https://www.googleapis.com/auth/Admin.Directory.Group.ReadOnly : possibilité de récupérer uniquement les informations relatives au groupe, à l'alias du groupe et aux membres. Cela est nécessaire pour l' Amazon Kendra Identity Crawler.
+ https://www.googleapis.com/auth/Admin.Directory.User.ReadOnly : possibilité de récupérer uniquement les utilisateurs ou les alias d'utilisateurs. Cela est nécessaire pour répertorier les utilisateurs dans Amazon Kendra Identity Crawler et pour le ACLs paramétrer.
+ https://www.googleapis.com/auth/Plateforme cloud : possibilité de générer un jeton d'accès pour récupérer le contenu de fichiers Google Drive volumineux.
+ https://www.googleapis.com/auth/forms.body.readonly : possibilité de récupérer des données depuis Google Forms.
**Pour prendre en charge l'API Forms, ajoutez le champ d'application supplémentaire suivant :**
+ https://www.googleapis.com/auth/forms.body.readonly
+ Il est vérifié que chaque document est unique dans Google Drive et dans 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'authentification Google Drive 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 données Google Drive à 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 données Google Drive, vous devez fournir les informations nécessaires sur votre source de données Google Drive afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Google Drive pour Amazon Kendra voir[Conditions préalables](#prerequisites-v2-google-drive).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Google Drive**
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 le **connecteur Google Drive**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Google Drive** 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 tirets, 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. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. Pour **l'authentification** : choisissez entre **un compte de service Google** et une **authentification OAuth 2.0** en fonction de votre cas d'utilisation.
1. **AWS Secrets Manager secret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Google Drive. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Si vous avez choisi un **compte de service Google**, saisissez le nom de votre code secret, l'identifiant e-mail de l'utilisateur administrateur ou « utilisateur du compte de service » dans la configuration de votre compte de service (e-mail d'administrateur), l'identifiant e-mail du compte de service (e-mail du client) et la clé privée que vous avez créée dans votre compte de service.
Enregistrez et ajoutez votre secret
1. Si vous avez choisi **l'authentification OAuth 2.0**, entrez un nom pour votre code secret, votre identifiant client, votre secret client et le jeton d'actualisation que vous avez créé dans votre OAuth compte. L'identifiant de messagerie de l'utilisateur (utilisateur dont les détails de connexion sont configurés) sera défini comme ACL. Le connecteur ne définit pas les autres informations user/group principales sous forme d'ACL en raison des limites de l'API.
Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. (Pour les utilisateurs authentifiés par un compte de service Google uniquement)
**Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
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. **Synchroniser le contenu** : sélectionnez les options ou le contenu que vous souhaitez analyser. Vous pouvez choisir d'explorer My Drive (dossiers personnels), Shared Drive (dossiers partagés avec vous) ou les deux. Vous pouvez également inclure des commentaires sur les fichiers.
1. Dans **Configuration supplémentaire - facultatif** Vous pouvez également saisir les informations facultatives suivantes :
1. **Taille maximale des fichiers** : définissez la taille maximale MBs des fichiers à analyser.
1. **E-mail utilisateur** : ajoutez les e-mails utilisateur que vous souhaitez inclure ou exclure.
1. **Lecteurs partagés** : ajoutez les noms des lecteurs partagés que vous souhaitez inclure ou exclure.
1. **Types MIME** : ajoutez les types MIME que vous souhaitez inclure ou exclure.
1. Modèles d'expression **régulière d'entité : ajoutez des modèles** d'expressions régulières pour inclure ou exclure certaines pièces jointes pour toutes les entités prises en charge. Vous pouvez ajouter jusqu’à 100 modèles.
Vous pouvez configurer des modèles d' include/exclude expression régulière pour **le nom de fichier**, **le type de fichier** et **le chemin du fichier**.
+ **Nom du fichier** : nom du fichier à inclure ou à exclure. Par exemple, pour indexer un fichier avec un nom`teamroster.txt`, fournissez`teamroster`.
+ **Type de fichier** : type de fichier à inclure ou à exclure. Par exemple, .pdf .txt .docx.
+ **Chemin du fichier** : chemin du fichier à inclure ou à exclure. Par exemple, pour indexer des fichiers uniquement dans le dossier `Products list` d'un lecteur, fournissez`/Products list`.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
**Important**
L’API Google Drive ne permet pas d’extraire les commentaires d’un fichier définitivement supprimé. Les commentaires des fichiers mis à la poubelle sont récupérables. Lorsqu'un fichier est détruit, le connecteur supprime les commentaires de l' Amazon Kendra index.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence, choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Dans **Synchroniser l'historique** des exécutions, choisissez de stocker les rapports générés automatiquement dans et Amazon S3 lors de la synchronisation de votre source de données. Cela est utile pour suivre les problèmes lors de la synchronisation de votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Pour **les fichiers** : 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.
**Note**
L'API Google Drive ne permet pas de créer des champs personnalisés. Le mappage de champs personnalisé n'est pas disponible pour le connecteur Google Drive.
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 depuis 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 à Google Drive**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `GOOGLEDRIVEV2` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type d'authentification** : spécifiez si vous souhaitez utiliser l'authentification du compte de service ou l'authentification OAuth 2.0.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
**Important**
L’API Google Drive ne permet pas d’extraire les commentaires d’un fichier définitivement supprimé. Les commentaires des fichiers mis à la poubelle sont récupérables. Lorsqu'un fichier est détruit, le connecteur supprime les commentaires de l' Amazon Kendra index.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre compte Google Drive. Si vous utilisez l'authentification par compte de service Google, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"clientEmail": "user account email",
"adminAccountEmail": "service account email",
"privateKey": "private key"
}
```
Si vous utilisez l'authentification OAuth 2.0, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"clientID": "OAuth client ID",
"clientSecret": "client secret",
"refreshToken": "refresh token"
}
```
+ **IAM role** —Spécifiez à quel `RoleArn` moment 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 connecteur Google Drive et Amazon Kendra. Pour plus d'informations, consultez la section [IAM Rôles des sources de données Google Drive](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Mes lecteurs, lecteurs partagés, commentaires** : vous pouvez indiquer si vous souhaitez analyser ces types de contenu.
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure ou exclure certains comptes utilisateurs, lecteurs partagés et types MIME.
**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.
+ **Liste de contrôle d'accès (ACL)** : indiquez si vous souhaitez analyser les informations ACL de vos documents, si vous disposez d'une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Google Drive à 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du modèle Google Drive](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-google-drive-schema).
------
## Remarques
+ Le mappage des champs personnalisés n’est pas disponible pour le connecteur Google Drive, car l’interface utilisateur de Google Drive ne permet pas de créer des champs personnalisés.
+ L'API Google Drive ne permet pas de récupérer les commentaires d'un fichier définitivement supprimé. Les commentaires peuvent toutefois être extraits pour les fichiers mis à la corbeille. Lorsqu'un fichier est détruit, le Amazon Kendra connecteur supprime les commentaires de l' Amazon Kendra index.
+ L’API Google Drive ne renvoie pas les commentaires présents dans un fichier .docx.
+ Si l'autorisation pour un document en particulier Google document (document, feuille de calcul, diapositive, etc.) est définie sur **Accès général : toute personne disposant du lien ou ayant partagé le** **domaine spécifique de votre entreprise**, le document ne sera pas visible pour les utilisateurs de la recherche Amazon Kendra tant que l'utilisateur ayant effectué la requête n'aura pas accédé au document.
# IBM DB2
**Note**
Le connecteur IBM DB2 reste entièrement pris en charge pour les clients existants jusqu’au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
IBM DB2est un système de gestion de base de données relationnelle développé parIBM. Si vous êtes un utilisateur IBM DB2, vous pouvez utiliser Amazon Kendra pour indexer votre source de données IBM DB2. Le connecteur de source Amazon Kendra IBM DB2 de données prend en charge la version DB2 11.5.7.
Vous pouvez vous connecter Amazon Kendra à votre source de IBM DB2 données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra IBM DB2 données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-ibm-db2)
+ [Conditions préalables](#prerequisites-ibm-db2)
+ [Instructions de connexion](#data-source-procedure-ibm-db2)
+ [Remarques](#ibm-db2-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de IBM DB2 données, apportez ces modifications à vos AWS comptes IBM DB2 and.
**Dans IBM DB2, assurez-vous d’avoir :**
+ Notez le nom d'utilisateur et le mot de passe de votre base de données.
**Important**
Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Vous avez copié l'URL, le port et l'instance de votre hôte de base de données.
+ Il est vérifié que chaque document est unique dans IBM DB2 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 votreCompte 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'IBM DB2authentification 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 IBM DB2 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 IBM DB2 données, vous devez fournir les détails de vos IBM DB2 informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré IBM DB2 pour Amazon Kendra voir[Conditions préalables](#prerequisites-ibm-db2).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à IBM DB2**
1. Connectez-vous à la [Amazon Kendraconsole 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 **IBM DB2connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **IBM DB2connecteur** 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 tirets, 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. Dans **Source**, saisissez les informations suivantes :
1. **Hôte** : entrez le nom d'hôte de la base de données.
1. **Port** — Entrez le port de base de données.
1. **Instance** — Entrez l'instance de base de données.
1. **Activer l'emplacement du certificat SSL** : choisissez d'entrer le Amazon S3 chemin d'accès à votre fichier de certificat SSL.
1. Dans **Authentification**, entrez les informations suivantes :
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations IBM DB2 d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - IBM DB2 - » est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le mot de **passe de** la base** de données, entrez les valeurs d'identification d'authentification que vous avez copiées depuis votre base de données.
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
+ **Requête SQL** : saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Colonne de clé primaire** : indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données.
+ **Colonne de titre** : indiquez le nom de la colonne de titre du document dans votre table de base de données.
+ **Colonne du corps** : indiquez le nom de la colonne du corps du document dans votre table de base de données.
1. Dans **Configuration supplémentaire — *facultatif***, choisissez l'une des options suivantes pour synchroniser un contenu spécifique au lieu de synchroniser tous les fichiers :
+ **Colonnes détectant les modifications** : entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendraréindexera le contenu en cas de modification de l'une de ces colonnes.
+ ** IDsColonne utilisateur** : entrez le nom de la colonne contenant l'utilisateur devant être autorisé IDs à accéder au contenu.
+ **Colonne des groupes** : saisissez le nom de la colonne contenant les groupes autorisés à accéder au contenu.
+ ** URLsColonne source** —Entrez le nom de la colonne contenant la source URLs à indexer.
+ **Colonne horodatage** : entrez le nom de la colonne contenant les horodatages. Amazon Kendrautilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié.
+ **Colonne des fuseaux horaires** : saisissez le nom de la colonne contenant les fuseaux horaires du contenu à explorer.
+ **Format d’horodatage** : saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : à quelle fréquence Amazon Kendra sera synchronisée avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés (**Document IDs****, Titres** des documents et **Source URLs**) que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à IBM DB2**
Vous devez spécifier les éléments suivants à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API :
+ **Source de données** —Spécifiez le type de source de données tel que `JDBC` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type de base de données** —Vous devez spécifier le type de base de données sous `db2` la forme.
+ **Requête SQL** : spécifiez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre IBM DB2 compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"user name": "database user name",
"password": "password"
}
```
**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).
+ **IAMrole** —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 IBM DB2 connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de IBM DB2 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure un contenu spécifique en utilisant l'utilisateur IDs, les groupes, la source URLs, les horodatages et les fuseaux horaires.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de IBM DB2 données à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez[Schéma DB2 du modèle IBM](ds-schemas.md#ds-ibm-db2-schema).
------
## Remarques
+ Les lignes de base de données supprimées ne seront pas suivies lors de la Amazon Kendra vérification du contenu mis à jour.
+ La taille des noms et des valeurs des champs d’une ligne de votre base de données ne peut pas dépasser 400 Ko.
+ Si la source de données de votre base de données contient une grande quantité de données et que vous ne Amazon Kendra souhaitez pas indexer tout le contenu de votre base de données après la première synchronisation, vous pouvez choisir de synchroniser uniquement les documents nouveaux, modifiés ou supprimés.
+ Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Il est recommandé d'éviter d'ajouter des tableaux contenant des données sensibles ou des informations personnelles identifiables (PII).
# Jira
Jira est un outil de gestion de projet pour le développement de logiciels, la gestion de produits et le suivi de bogues. Vous pouvez l'utiliser Amazon Kendra pour indexer vos projets, problèmes, commentaires, pièces jointes, journaux de travail et statuts Jira.
Amazon Kendrane prend actuellement en charge que Jira Cloud.
Vous pouvez vous connecter Amazon Kendra à votre source de données Jira à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) ou de l'[JiraConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_JiraConfiguration.html)API. Pour obtenir la liste des fonctionnalités prises en charge par chacune d'entre elles, consultez[Fonctionnalités prises en charge](#supported-features-jira).
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Jira, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-jira)
+ [Conditions préalables](#prerequisites-jira)
+ [Instructions de connexion](#data-source-procedure-jira)
+ [En savoir plus](#jira-learn-more)
## Fonctionnalités prises en charge
Amazon KendraLe connecteur de source de données Jira prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Jira, apportez ces modifications à votre Jira et AWS à vos comptes.
**Dans Jira, assurez-vous d’avoir :**
+ Identifiants d'authentification par jeton d'API configurés, notamment un identifiant Jira (nom d'utilisateur ou e-mail) et un identifiant Jira (jeton d'API Jira). Consultez la [documentation Atlassian sur la gestion des jetons d'API](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/).
**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).
+ Noté l’URL du compte Jira dans les paramètres de votre compte Jira. Par exemple, *https://company.atlassian.net/*.
+ Il est vérifié que chaque document est unique dans Jira et dans 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 votreCompte 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'authentification Jira 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 données Jira à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 données Jira, vous devez fournir les informations nécessaires pour Amazon Kendra accéder à vos données. Si vous n'avez pas encore configuré Jira pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-jira).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Jira**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Jira**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Jira** avec le tag « 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. URL du **compte Jira —Entrez l'URL** de votre compte Jira. Par exemple : *https://company.atlassian.net/*.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Jira. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Jira » est automatiquement ajouté à votre nom secret.
1. Pour **Jira ID** : entrez le nom d'utilisateur ou l'e-mail Jira.
1. Pour le **mot de passe/le jeton** : entrez le jeton d'API Jira configuré dans Jira.
1. Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage contextuel utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) des résultats de recherche. Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. **Sélectionnez les projets Jira à indexer** : choisissez d'explorer tous les projets ou des projets spécifiques.
1. **Configuration supplémentaire** : spécifiez certains statuts et types de problèmes. Choisissez d'explorer les commentaires, les pièces jointes et les journaux de travail. Utilisez des modèles d'expressions régulières pour inclure ou exclure certains contenus.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 qu'elle aura été ajoutée avec succès.
------
#### [ API ]
**Pour vous connecter Amazon Kendra à Jira**
Vous devez spécifier les éléments suivants à l'aide de l'[JiraConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_JiraConfiguration.html)API :
+ **URL de la source de données** : spécifiez l'URL de votre compte Jira. Par exemple, *company.atlassian.net*.
+ **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 compte Jira. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"jiraId": "Jira user name or email",
"jiraCredential": "Jira API token"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur Jira et. Amazon Kendra Pour plus d'informations, consultez la section [IAMRôles des sources de données Jira](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC)** —Spécifiez dans le `VpcConfiguration` cadre de la configuration de la source de données. [Reportez-vous Amazon Kendra à la section Configuration pour utiliser un VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ Journal des **modifications : Amazon Kendra faut-il utiliser le mécanisme du journal** des modifications de la source de données Jira pour déterminer si un document doit être mis à jour dans l'index.
**Note**
Utilisez le journal des modifications si vous ne Amazon Kendra souhaitez pas numériser tous les documents. Si votre journal des modifications est volumineux, la numérisation des documents de la source de données Jira peut prendre Amazon Kendra moins de temps que le traitement du journal des modifications. Si vous synchronisez votre source de données Jira avec votre index pour la première fois, tous les documents sont numérisés.
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier d'inclure ou d'exclure certains fichiers.
**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.
+ **Commentaires, pièces jointes et journaux de travail** : vous pouvez indiquer si vous souhaitez analyser certains commentaires, pièces jointes et journaux de travail relatifs aux problèmes.
+ **Projets, problèmes, statuts** : vous pouvez spécifier si vous souhaitez analyser certains projets IDs, types de problèmes et statuts.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Jira à vos Amazon Kendra champs d'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.
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Jira, consultez :
+ [Effectuez des recherches intelligentes dans vos projets Jira avec le connecteur Amazon Kendra Jira Cloud](https://aws.amazon.com/blogs/machine-learning/intelligently-search-your-jira-projects-with-amazon-kendra-jira-cloud-connector/)
# Microsoft Exchange
Microsoft Exchange est un outil de collaboration d'entreprise pour la messagerie, les réunions et le partage de fichiers. Si vous êtes un utilisateur de Microsoft Exchange, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de données Microsoft Exchange.
Vous pouvez vous connecter Amazon Kendra à votre source de données Microsoft Exchange à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Microsoft Exchange, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
## Fonctionnalités prises en charge
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Microsoft Exchange, apportez ces modifications à votre Microsoft Exchange et à vos AWS comptes.
**Dans Microsoft Exchange, assurez-vous que vous disposez des éléments suivants :**
+ Création d'un compte Microsoft Exchange dans Office 365.
+ Vous avez noté votre identifiant de client Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application.
+ J'ai configuré une OAuth application sur le portail Azure et noté l'ID du client et le secret du client ou les informations d'identification du client. Consultez le [didacticiel Microsoft](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) et [l'exemple d'application enregistrée](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application) pour plus d'informations.
**Note**
Lorsque vous créez ou enregistrez une application sur le portail Azure, l'ID secret représente la valeur secrète réelle. Vous devez prendre note ou enregistrer la valeur secrète réelle immédiatement lors de la création du secret et de l'application. Vous pouvez accéder à votre secret en sélectionnant le nom de votre application sur le portail Azure, puis en accédant à l'option de menu sur les certificats et les secrets.
Vous pouvez accéder à votre ID client en sélectionnant le nom de votre application sur le portail Azure, puis en accédant à la page de présentation. L'ID de l'application (client) est l'ID du client.
**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).
+ Ajouté les autorisations suivantes pour l’application de connecteur :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/data-source-exchange.html)
+ Il est vérifié que chaque document est unique dans Microsoft Exchange et dans 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 votreCompte 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'authentification Microsoft Exchange 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 données Microsoft Exchange à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 données Microsoft Exchange, vous devez fournir les informations nécessaires sur votre source de données Microsoft Exchange afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Microsoft Exchange pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-exchange).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Microsoft Exchange**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Microsoft Exchange**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Microsoft Exchange** 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 tirets, 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. **ID de locataire** —Entrez votre identifiant de locataire Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Microsoft Exchange. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Microsoft Exchange
1. Pour l'**ID client**, **secret du client** : entrez les informations d'authentification configurées dans Microsoft Exchange sur le portail Azure.
1. Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. **Utilisateur IDs** : fournissez les e-mails de l'utilisateur si vous souhaitez filtrer le contenu en fonction de certains e-mails.
1. **Configuration supplémentaire** —Spécifiez les types de contenu que vous souhaitez analyser.
+ **Types d'entités** : vous pouvez choisir d'explorer le contenu du calendrier ou OneNotes des contacts.
+ Analyse du **calendrier :** entrez les dates de début et de fin pour analyser le contenu entre certaines dates.
+ **Inclure l'e-mail** : saisissez « à », « de » et les lignes d'objet de l'e-mail pour filtrer certains e-mails que vous souhaitez analyser.
+ **Accès aux dossiers partagés** : choisissez d'activer l'analyse de la liste de contrôle d'accès pour contrôler l'accès à votre source de données Microsoft Exchange.
+ **Regex pour les domaines** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains domaines de messagerie.
+ **Modèles Regex** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains fichiers.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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.
**Note**
Le connecteur de source de données Amazon Kendra Microsoft Exchange ne prend pas en charge les mappages de champs personnalisés.
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 depuis 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 à Microsoft Exchange**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-msexchange-schema.html) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `MSEXCHANGE` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **ID de locataire** : vous pouvez trouver votre identifiant de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **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 compte Microsoft Exchange. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"clientId": "client ID",
"clientSecret": "client secret"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur Microsoft Exchange etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de données Microsoft Exchange](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : spécifiez s'il faut inclure ou exclure certains contenus.
**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.
+ **Liste de contrôle d'accès (ACL)** : indiquez si vous souhaitez analyser les informations ACL de vos documents, si vous disposez d'une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Microsoft Exchange à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du modèle Microsoft Exchange](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-msexchange-schema).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Microsoft Exchange, consultez :
+ [Indexez votre contenu Microsoft Exchange à l'aide du connecteur Exchange pour Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/index-your-microsoft-exchange-content-using-the-exchange-connector-for-amazon-kendra/)
## Remarques
+ Lorsque les listes de contrôle d'accès (ACLs) sont activées, l'option « Synchroniser uniquement le contenu nouveau ou modifié » n'est pas disponible en raison des limites de l'API Microsoft Exchange. Nous vous recommandons d'utiliser plutôt les modes « Synchronisation complète » ou « Synchronisation du contenu nouveau, modifié ou supprimé », ou de les désactiver ACLs si vous devez utiliser ce mode de synchronisation.
# Microsoft OneDrive
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 de OneDrive données.
Vous pouvez vous connecter Amazon Kendra à votre source de OneDrive données à l'aide de la [Amazon Kendra console](https://console.aws.amazon.com/kendra/) et de l'[OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_OneDriveConfiguration.html)API.
Amazon Kendra possède deux versions du OneDrive connecteur. Les fonctionnalités prises en charge par chaque version incluent :
** OneDrive Connecteur Microsoft V1.0/API [OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_OneDriveConfiguration.html)**
+ Mappages de champs
+ Filtres d’inclusion et d’exclusion
** OneDrive Connecteur Microsoft V2.0/API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**
+ Filtrage du contexte utilisateur
+ explorateur d'identité utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
**Note**
Support pour le OneDrive connecteur V1.0/ OneDriveConfiguration API 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**
+ [OneDrive Connecteur Microsoft V1.0](data-source-v1-onedrive.md)
+ [OneDrive Connecteur Microsoft V2.0](data-source-v2-onedrive.md)
+ [En savoir plus](#onedrive-learn-more)
+ [Remarques](#onedrive-notes)
# 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).
------
# OneDrive Connecteur Microsoft V2.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 de OneDrive données.
Vous pouvez vous connecter Amazon Kendra à votre source de OneDrive données à l'aide de la [Amazon Kendra console](https://console.aws.amazon.com/kendra/) et de l'[OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/OneDriveConfiguration.html)API.
**Note**
Support pour OneDrive Connector V1.0/ OneDriveConfiguration API devrait prendre fin en juin 2023. Nous vous recommandons d'utiliser OneDrive Connector TemplateConfiguration V2.0/API. La version 2.0 fournit des fonctionnalités supplémentaires ACLs et des fonctionnalités d'explorateur d'identité.
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-v2-onedrive)
+ [Conditions préalables](#prerequisites-v2-onedrive)
+ [Instructions de connexion](#data-source-procedure-v2-onedrive)
## Fonctionnalités prises en charge
Amazon Kendra OneDrive le connecteur de source de données prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de OneDrive données, apportez ces modifications à vos AWS comptes OneDrive and.
**Dans OneDrive, assurez-vous d'avoir :**
+ Vous avez créé un OneDrive compte dans Office 365.
+ Vous avez noté votre identifiant de client Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application.
+ Vous avez créé une OAuth application sur le portail Azure et avez noté l'ID client et le secret du client ou les informations d'identification du client utilisées pour l'authentification avec un AWS Secrets Manager secret. Consultez le [didacticiel Microsoft](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) et [l'exemple d'application enregistrée](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application) pour plus d'informations.
**Note**
Lorsque vous créez ou enregistrez une application sur le portail Azure, l'ID secret représente la valeur secrète réelle. Vous devez prendre note ou enregistrer la valeur secrète réelle immédiatement lors de la création du secret et de l'application. Vous pouvez accéder à votre secret en sélectionnant le nom de votre application sur le portail Azure, puis en accédant à l'option de menu sur les certificats et les secrets.
Vous pouvez accéder à votre ID client en sélectionnant le nom de votre application sur le portail Azure, puis en accédant à la page de présentation. L'ID de l'application (client) est l'ID du client.
**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).
+ 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.
+ Vous avez ajouté les autorisations suivantes à votre application AD sur l'option Microsoft Graph :
+ Lire des fichiers dans toutes les collections de sites (File.Read.All)
+ Lire les profils complets de tous les utilisateurs (User.Read.All)
+ Lire tous les groupes (Group.Read.All)
+ Lire toutes les notes (Notes.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.
Le OneDrive connecteur utilise le **courrier électronique provenant des informations de contact** présentes dans les propriétés **utilisateur de Onedrive**. Assurez-vous que le champ e-mail de l'utilisateur dont vous souhaitez analyser les données est configuré dans la page **Informations de contact**, car pour les nouveaux utilisateurs, ce champ peut être vide.
**Dans votre AWS compte, assurez-vous d'avoir :**
+ Création d'un Amazon Kendra index et, si vous utilisez l'API, notez l'identifiant de l'index.
+ Vous avez créé un IAM rôle pour votre source de données et, si vous utilisez l'API, notez l'ARN du IAM rôle.
+ Stockez vos informations d' OneDrive authentification dans un AWS Secrets Manager secret et, si vous utilisez l'API, notez l'ARN du secret.
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, consultez[Conditions préalables](#prerequisites-v2-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. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. Dans **Authentification**, choisissez entre **nouveau** et **existant**.
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 client** et **le secret du client** : entrez l'ID client et le secret du client.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
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.
1. Pour l'**étendue de la synchronisation** : choisissez les OneDrive données des utilisateurs à indexer. Vous pouvez ajouter un maximum de 10 utilisateurs manuellement.
1. Pour les **configurations supplémentaires** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains contenus. Vous pouvez ajouter jusqu’à 100 modèles.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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 un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-onedrive-schema) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `ONEDRIVEV2` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **ID de locataire** —Spécifiez l'ID de locataire Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre OneDrive compte.
Si vous utilisez l'authentification OAuth 2.0, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"clientId": "client ID",
"clientSecret": "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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez indiquer si vous souhaitez inclure ou exclure certains fichiers, OneNote sections et OneNote pages.
**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.
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **Mappages de champs** : vous ne pouvez mapper que des champs d'index intégrés ou communs pour le Amazon Kendra OneDrive connecteur. Le mappage de champs personnalisé n'est pas disponible pour le OneDrive connecteur en raison des limites de l'API. Pour plus d’informations, consultez [Mappage des champs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du OneDrive modèle](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-onedrive-schema).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de OneDrive données, consultez :
+ [Annonce de la mise à jour OneDrive du connecteur Microsoft (V2) pour Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-updated-microsoft-onedrive-connector-v2-for-amazon-kendra/).
## Remarques
+ Lorsque les listes de contrôle d'accès (ACLs) sont activées, l'option « Synchroniser uniquement le contenu nouveau ou modifié » n'est pas disponible en raison des limites de OneDrive l'API. Nous vous recommandons d'utiliser plutôt les modes « Synchronisation complète » ou « Synchronisation du contenu nouveau, modifié ou supprimé », ou de les désactiver ACLs si vous devez utiliser ce mode de synchronisation.
# Microsoft SharePoint
SharePoint est un service collaboratif de création de sites Web que vous pouvez utiliser pour personnaliser le contenu Web et créer des pages, des sites, des bibliothèques de documents et des listes. Vous pouvez l'utiliser Amazon Kendra pour indexer votre source de SharePoint données.
Amazon Kendra est actuellement compatible avec SharePoint Online et SharePoint Server (versions 2013, 2016, 2019 et édition par abonnement).
Vous pouvez vous connecter Amazon Kendra à votre source de SharePoint données à l'aide de la [Amazon Kendra console](https://console.aws.amazon.com/kendra/), de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API ou de l'[SharePointConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SharePointConfiguration.html)API.
Amazon Kendra possède deux versions du SharePoint connecteur. Les fonctionnalités prises en charge par chaque version incluent :
**SharePoint Connecteur V1.0/API [SharePointConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SharePointConfiguration.html)**
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Journal des modifications
+ Cloud privé virtuel (VPC)
**SharePoint Connecteur V2.0/API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
**Note**
SharePoint le connecteur V1.0/ SharePointConfiguration API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le SharePoint connecteur TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra SharePoint données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [SharePoint connecteur V1.0](data-source-v1-sharepoint.md)
+ [SharePoint connecteur V2.0](data-source-v2-sharepoint.md)
# SharePoint connecteur V1.0
SharePoint est un service collaboratif de création de sites Web que vous pouvez utiliser pour personnaliser le contenu Web et créer des pages, des sites, des bibliothèques de documents et des listes. Si vous êtes un SharePoint utilisateur, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de SharePoint données.
**Note**
SharePoint le connecteur V1.0/ SharePointConfiguration API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le SharePoint connecteur TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra SharePoint données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v1-sharepoint)
+ [Conditions préalables](#prerequisites-v1-sharepoint)
+ [Instructions de connexion](#data-source-procedure-v1-sharepoint)
+ [En savoir plus](#sharepoint-v1-learn-more)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Journal des modifications
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de SharePoint données, apportez ces modifications à vos AWS comptes SharePoint and.
Vous devez fournir des informations d'authentification, que vous stockez en toute sécurité dans un AWS Secrets Manager 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).
**Dans SharePoint, assurez-vous d'avoir :**
+ Notez l'URL des SharePoint sites que vous souhaitez indexer.
+ **Pour SharePoint en ligne :**
+ Vous avez noté vos informations d'authentification de base contenant un nom d'utilisateur et un mot de passe avec des autorisations d'administrateur du site.
+ **Facultatif :** informations d'identification OAuth 2.0 générées contenant un nom d'utilisateur, un mot de passe, un identifiant client et un secret client.
+ Désactivé les **paramètres de sécurité par défaut** sur votre portail Azure à l’aide d’un utilisateur administratif. Pour plus d'informations sur la gestion des paramètres de sécurité par défaut sur le portail Azure, consultez la [documentation Microsoft sur la procédure à suivre pour définir les paramètres enable/disable de sécurité par défaut](https://learn.microsoft.com/en-us/microsoft-365/business-premium/m365bp-conditional-access?view=o365-worldwide&tabs=secdefaults#security-defaults-1).
+ **Pour le SharePoint serveur :**
+ Vous avez noté le nom de domaine de votre SharePoint serveur (le nom NetBIOS dans votre Active Directory). Vous l'utilisez, ainsi que votre nom d'utilisateur et votre mot de passe d'authentification de SharePoint base, pour connecter le SharePoint serveur à Amazon Kendra.
**Note**
Si vous utilisez SharePoint Server et devez convertir votre liste de contrôle d'accès (ACL) au format e-mail pour le filtrage en fonction du contexte utilisateur, fournissez l'URL du serveur LDAP et la base de recherche LDAP. Vous pouvez également utiliser le remplacement du domaine de l'annuaire. L'URL du serveur LDAP est le nom de domaine complet et le numéro de port (par exemple, ldap : //example.com:389). La base de recherche LDAP est constituée des contrôleurs de domaine « example » et « com ». Avec le remplacement du domaine de l'annuaire, vous pouvez utiliser le domaine de messagerie au lieu d'utiliser l'URL du serveur LDAP et la base de recherche LDAP. Par exemple, le domaine de messagerie pour username@example.com est « exemple.com ». Vous pouvez utiliser cette dérogation si la validation de votre domaine ne vous préoccupe pas et si vous souhaitez simplement utiliser votre domaine de messagerie.
+ Vous avez ajouté les autorisations suivantes à votre SharePoint compte :
**Pour les SharePoint listes**
+ Éléments ouverts : affichez la source des documents à l'aide des gestionnaires de fichiers côté serveur.
+ Afficher les pages de candidature : affichez les formulaires, les vues et les pages de candidature. Énumérez des listes.
+ Afficher les éléments : affichez les éléments dans les listes et les documents dans les bibliothèques de documents.
+ Afficher les versions : permet d'afficher les versions précédentes d'un élément de liste ou d'un document.
**Pour les SharePoint sites Web**
+ Parcourir les répertoires : énumère les fichiers et les dossiers d'un site Web à l'aide de SharePoint Designer et de l'interface Web DAV.
+ Parcourir les informations utilisateur : affichez les informations sur les utilisateurs du site Web.
+ Énumérer les autorisations : énumère les autorisations sur le site Web, la liste, le dossier, le document ou l'élément de liste.
+ Ouvrir : ouvrez un site Web, une liste ou un dossier pour accéder aux éléments contenus dans le conteneur.
+ Utiliser les fonctionnalités d'intégration du client : utilisez SOAP, WebDAV, le modèle d'objet client ou SharePoint les interfaces Designer pour accéder au site Web.
+ Utiliser des interfaces distantes : utilisez des fonctionnalités qui lancent des applications clientes.
+ Afficher les pages : affiche les pages d'un site Web.
+ Il est vérifié que chaque document est unique dans SharePoint 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' SharePoint 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 SharePoint 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 SharePoint données, vous devez fournir les détails de vos SharePoint informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré SharePoint pour Amazon Kendra voir[Conditions préalables](#prerequisites-v1-sharepoint).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à SharePoint**
1. Connectez-vous à la console AWS de gestion et [Amazon Kendra 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 le **SharePoint connecteur v1.0**, puis sélectionnez **Ajouter une source de données**.
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 tirets, 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. Pour la **méthode d'hébergement** : choisissez entre **SharePoint Online** et **SharePointServer**.
1. Pour **SharePointen ligne** —Entrez le **site URLs spécifique à votre SharePoint référentiel**.
1. Pour le **SharePointserveur** : choisissez votre **SharePoint version**, entrez **le site URLs spécifique à votre SharePoint référentiel**, puis le Amazon S3 chemin d'accès à l'**emplacement de votre certificat SSL**.
1. (SharePoint Serveur uniquement) Pour le **proxy Web** : entrez le **nom d'hôte** et le **numéro de port** de votre SharePoint instance interne. Le numéro de port doit être une valeur numérique comprise entre 0 et 65 535.
1. Pour **l'authentification** : choisissez l'une des options suivantes en fonction de votre cas d'utilisation :
1. Pour SharePoint en ligne : choisissez entre l'**authentification de base et l'authentification OAuth ** **2.0**.
1. **Pour le SharePoint serveur : choisissez entre **None**, **LDAP** et Manual.**
1. Pour le **AWS Secrets Manager secret** : choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations SharePoint d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre. Vous devez saisir un **nom secret**. Le préfixe « AmazonKendra - SharePoint - » est automatiquement ajouté à votre nom secret.
1. Entrez les autres informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. Choisissez parmi les options d'authentification SharePoint dans le cloud suivantes, en fonction de votre cas d'utilisation :
1. **Authentification de base** —Entrez le nom d'utilisateur de votre SharePoint compte comme **nom d'utilisateur et le** mot de passe du SharePoint compte comme mot de **passe**.
1. **OAuth Authentification 2.0** —Entrez le nom d'utilisateur de votre SharePoint compte comme **nom d'utilisateur**, le mot de **passe du SharePoint compte comme mot de passe**, votre SharePoint identifiant unique généré automatiquement comme **identifiant client** et la chaîne secrète partagée utilisée par les deux SharePoint et Amazon Kendra comme secret **client**.
1. Choisissez l'une des options d'authentification SharePoint du serveur suivantes, en fonction de votre cas d'utilisation :
1. **Aucun** —Entrez le nom d'utilisateur de votre SharePoint compte comme **nom d'utilisateur, le** mot de passe de votre SharePoint compte comme **mot de passe** et le **nom de domaine de votre serveur**.
1. **LDAP** —Entrez le nom d'utilisateur de votre SharePoint compte comme **nom d'utilisateur**, le mot de passe du SharePoint compte comme **mot de passe**, le point de **terminaison de votre serveur LDAP** (y compris le protocole et le numéro de port, par exemple*ldap://example.com:389*) et votre **base de recherche LDAP** (par exemple,). *dc=example, dc=com*
1. **Manuel** —Entrez le nom d'utilisateur de votre SharePoint compte en tant que **nom d'utilisateur**, le mot de passe de votre SharePoint compte en tant que **mot de passe** et votre **remplacement de domaine de messagerie (domaine** de messagerie de l'utilisateur ou du groupe de l'annuaire).
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** **: vous devez également ajouter des sous-réseaux **et** des groupes de sécurité VPC.**
**Note**
Vous devez utiliser un VPC si vous utilisez SharePoint un serveur. Amazon VPC est facultatif pour les autres SharePoint versions.
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. **Utiliser le journal des modifications** : sélectionnez cette option pour mettre à jour votre index au lieu de synchroniser tous vos fichiers.
1. **Analyser les pièces jointes** : sélectionnez cette option pour analyser les pièces jointes.
1. **Utiliser des mappages de groupes locaux** : sélectionnez cette option pour vous assurer que les documents sont correctement filtrés.
1. **Configuration supplémentaire** —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 **la fréquence** : à quelle fréquence Amazon Kendra se synchronisera avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Amazon Kendra mappages de champs par défaut** : 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. Pour les **mappages de champs personnalisés** : ajoutez des champs de source de données personnalisés pour créer un nom de champ d'index auquel mapper et le type de données du champ.
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 depuis 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 à SharePoint**
Vous devez spécifier les éléments suivants à l'aide de l'[SharePointConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SharePointConfiguration.html)API :
+ **SharePointVersion** : spécifiez la SharePoint version que vous utilisez lors de la configuration SharePoint. C'est le cas, que vous utilisiez SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 ou SharePoint Online.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre SharePoint compte. Le secret est stocké dans une structure JSON.
Pour **l'authentification de base SharePoint en ligne**, voici la structure JSON minimale qui doit figurer dans votre secret :
```
{
"userName": "user name",
"password": "password"
}
```
Pour **l'authentification SharePoint en ligne OAuth 2.0**, voici la structure JSON minimale qui doit figurer dans votre secret :
```
{
"userName": "SharePoint account user name"",
"password": "SharePoint account password",
"clientId": "SharePoint auto-generated unique client id",
"clientSecret": "secret string shared by Amazon Kendra and SharePoint to authorize communications"
}
```
Pour **l'authentification de base du SharePoint serveur**, voici la structure JSON minimale qui doit figurer dans votre secret :
```
{
"userName": "user name",
"password": "password",
"domain": "server domain name"
}
```
Pour **l'authentification LDAP SharePoint du serveur** (si vous devez convertir votre liste de contrôle d'accès (ACL) au format e-mail pour filtrer le contexte utilisateur, vous pouvez inclure l'URL du serveur LDAP et la base de recherche LDAP dans votre secret), voici la structure JSON minimale qui doit figurer dans votre secret :
```
{
"userName": "user name",
"password": "password",
"domain": "server domain name"
"ldapServerUrl": "ldap://example.com:389",
"ldapSearchBase": "dc=example,dc=com"
}
```
Pour **l'authentification manuelle du SharePoint serveur**, voici la structure JSON minimale qui doit figurer dans votre secret :
```
{
"userName": "user name",
"password": "password",
"domain": "server domain name",
"emailDomainOverride": "example.com"
}
```
+ **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 SharePoint connecteur et Amazon Kendra. Pour plus d'informations, consultez la section [IAM Rôles des sources de SharePoint données](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
+ **Amazon VPC**—Si vous utilisez SharePoint Server, spécifiez-le dans `VpcConfiguration` le cadre de la configuration de la source de données. Consultez [la section Configuration Amazon Kendra pour utiliser un VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Proxy Web** : s'il faut se connecter à votre SharePoint site URLs via un proxy Web. Vous ne pouvez utiliser cette option que pour le SharePoint serveur.
+ **Listes d'indexation : indique** si le contenu des pièces jointes Amazon Kendra doit être indexé sur les éléments de la SharePoint liste.
+ **Journal des modifications** : Amazon Kendra faut-il utiliser le mécanisme du journal des modifications de la source de SharePoint données pour déterminer si un document doit être mis à jour dans l'index.
**Note**
Utilisez le journal des modifications si vous ne Amazon Kendra souhaitez pas numériser tous les documents. Si votre journal des modifications est volumineux, la numérisation des documents de la source de SharePoint données peut prendre Amazon Kendra moins de temps que le traitement du journal des modifications. Si vous synchronisez votre source de SharePoint données avec votre index pour la première fois, tous les documents sont numérisés.
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure ou exclure certains contenus.
**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 SharePoint 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).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de SharePoint données, consultez :
+ [Commencer à utiliser le connecteur Amazon Kendra SharePoint en ligne](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-sharepoint-online-connector/)
# SharePoint connecteur V2.0
SharePoint est un service collaboratif de création de sites Web que vous pouvez utiliser pour personnaliser le contenu Web et créer des pages, des sites, des bibliothèques de documents et des listes. Vous pouvez l'utiliser Amazon Kendra pour indexer votre source de SharePoint données.
Amazon Kendra est actuellement compatible avec SharePoint Online et SharePoint Server (2013, 2016, 2019 et édition par abonnement).
**Note**
SharePoint le connecteur V1.0/ SharePointConfiguration API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le SharePoint connecteur TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra SharePoint données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v2-sharepoint)
+ [Conditions préalables](#prerequisites-v2-sharepoint)
+ [Instructions de connexion](#data-source-procedure-v2-sharepoint)
+ [Remarques](#sharepoint-notes)
## Fonctionnalités prises en charge
Amazon Kendra SharePoint le connecteur de source de données prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de SharePoint données, apportez ces modifications à vos AWS comptes SharePoint and.
Vous devez fournir des informations d'authentification, que vous stockez en toute sécurité dans un AWS Secrets Manager 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).
**Dans SharePoint Online, assurez-vous d'avoir :**
+ Vous avez copié votre SharePoint instance URLs. Le format de l'URL d'hôte que vous entrez est*https://yourdomain.com/sites/mysite*. Votre URL doit commencer par`https`.
+ Vous avez copié le nom de domaine de l'URL de votre SharePoint instance.
+ Vous avez noté vos informations d'authentification de base contenant le nom d'utilisateur et le mot de passe avec les autorisations d'administrateur du site pour vous connecter à SharePoint Online.
+ Désactivé les **paramètres de sécurité par défaut** sur votre portail Azure à l’aide d’un utilisateur administratif. Pour plus d'informations sur la gestion des paramètres de sécurité par défaut sur le portail Azure, consultez la [documentation Microsoft sur la procédure à suivre pour définir les paramètres enable/disable de sécurité par défaut](https://learn.microsoft.com/en-us/microsoft-365/business-premium/m365bp-conditional-access?view=o365-worldwide&tabs=secdefaults#security-defaults-1).
+ L'authentification multifactorielle (MFA) a été désactivée dans votre SharePoint compte, afin de ne pas empêcher l' Amazon Kendra exploration de votre contenu. SharePoint
+ **Si vous utilisez un type d'authentification autre que l'authentification de base :** copiez l'ID de locataire de votre SharePoint instance. Pour plus de détails sur la façon de trouver votre identifiant de locataire, voir [Rechercher votre identifiant de locataire Microsoft 365](https://learn.microsoft.com/en-us/sharepoint/find-your-office-365-tenant-id).
+ Si vous devez passer à l'authentification des utilisateurs dans le cloud avec Microsoft Entra, consultez la [documentation Microsoft sur l'authentification dans le cloud](https://learn.microsoft.com/en-us/entra/identity/hybrid/connect/migrate-from-federation-to-cloud-authentication).
+ **Pour l'authentification OAuth OAuth 2.0 et l'authentification par jeton d'actualisation 2.0 :** notez vos informations **d'authentification de base** contenant le nom d'utilisateur et le mot de passe que vous utilisez pour vous connecter à SharePoint Online, ainsi que l'ID client et le secret du client générés après l'enregistrement SharePoint auprès d'Azure AD.
+ **Si vous n'utilisez pas l'ACL**, ajoutez les autorisations suivantes :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/data-source-v2-sharepoint.html)
**Note**
Note.Read.All et Sites.Read.All sont obligatoires uniquement si vous souhaitez analyser des documents. OneNote
Si vous souhaitez explorer des sites spécifiques, l'autorisation peut être limitée à des sites spécifiques plutôt qu'à tous les sites disponibles dans le domaine. Vous configurez l'**autorisation Sites.Selected (Application).** Avec cette autorisation d'API, vous devez définir explicitement l'autorisation d'accès sur chaque site via l'API Microsoft Graph. Pour plus d’informations, consultez le [Blog de Microsoft sur les autorisations Sites.Selected](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476).
+ **Si vous utilisez ACL**, ajoutez les autorisations suivantes :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/data-source-v2-sharepoint.html)
**Note**
GroupMember**.Read.All et User.Read.All ne sont obligatoires que si Identity Crawler est activé.**
Si vous souhaitez explorer des sites spécifiques, l'autorisation peut être limitée à des sites spécifiques plutôt qu'à tous les sites disponibles dans le domaine. Vous configurez l'**autorisation Sites.Selected (Application).** Avec cette autorisation d'API, vous devez définir explicitement l'autorisation d'accès sur chaque site via l'API Microsoft Graph. Pour plus d’informations, consultez le [Blog de Microsoft sur les autorisations Sites.Selected](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476).
+ **Pour l'authentification réservée aux applications Azure AD :** clé privée et ID client que vous avez générés après votre inscription SharePoint auprès d'Azure AD. Notez également le certificat X.509.
+ **Si vous n'utilisez pas l'ACL**, ajoutez les autorisations suivantes :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/data-source-v2-sharepoint.html)
**Note**
Si vous souhaitez explorer des sites spécifiques, l'autorisation peut être limitée à des sites spécifiques plutôt qu'à tous les sites disponibles dans le domaine. Vous configurez l'**autorisation Sites.Selected (Application).** Avec cette autorisation d'API, vous devez définir explicitement l'autorisation d'accès sur chaque site via l'API Microsoft Graph. Pour plus d’informations, consultez le [Blog de Microsoft sur les autorisations Sites.Selected](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476).
+ **Si vous utilisez ACL**, ajoutez les autorisations suivantes :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/data-source-v2-sharepoint.html)
**Note**
Si vous souhaitez explorer des sites spécifiques, l'autorisation peut être limitée à des sites spécifiques plutôt qu'à tous les sites disponibles dans le domaine. Vous configurez l'**autorisation Sites.Selected (Application).** Avec cette autorisation d'API, vous devez définir explicitement l'autorisation d'accès sur chaque site via l'API Microsoft Graph. Pour plus d’informations, consultez le [Blog de Microsoft sur les autorisations Sites.Selected](https://techcommunity.microsoft.com/t5/microsoft-sharepoint-blog/develop-applications-that-use-sites-selected-permissions-for-spo/ba-p/3790476).
+ **Pour l'authentification SharePoint uniquement par application :** notez votre identifiant SharePoint client et votre code secret client générés lors de l'octroi de l'autorisation à SharePoint App Only, ainsi que votre identifiant client et votre secret client générés lorsque vous avez enregistré votre SharePoint application auprès d'Azure AD.
**Note**
SharePoint L'authentification par application uniquement n'est *pas* prise en charge pour la version SharePoint 2013.
+ **(Facultatif) Si vous analysez OneNote des documents et utilisez **Identity Crawler****, ajoutez les autorisations suivantes :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/data-source-v2-sharepoint.html)
**Note**
Aucune autorisation d'API n'est requise pour analyser des entités à l'aide de l'**authentification de base et de l'authentification** uniquement SharePoint **par application**.
**Dans SharePoint Server, assurez-vous que vous disposez des éléments suivants :**
+ Vous avez copié votre SharePoint instance URLs et le nom de domaine de votre SharePoint URLs. Le format de l'URL d'hôte que vous entrez est*https://yourcompany/sites/mysite*. Votre URL doit commencer par`https`.
**Note**
(Sur place/sur serveur) Amazon Kendra vérifie si les informations de point de terminaison incluses sont les mêmes AWS Secrets Manager que celles spécifiées dans les détails de configuration de votre source de données. Cela permet de se protéger contre le [problème de confusion des adjoints](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), qui est un problème de sécurité lorsqu'un utilisateur n'est pas autorisé à effectuer une action mais l'utilise Amazon Kendra comme proxy pour accéder au secret configuré et exécuter l'action. Si vous modifiez ultérieurement les informations de votre point de terminaison, vous devez créer un nouveau secret pour synchroniser ces informations.
+ L'authentification multifactorielle (MFA) a été désactivée dans votre SharePoint compte, afin de ne pas empêcher l' Amazon Kendra exploration de votre contenu. SharePoint
+ Si vous utilisez l'**authentification SharePoint App-Only** pour le contrôle d'accès :
+ Vous avez copié l'ID SharePoint client généré lors de l'enregistrement de l'application uniquement au niveau du site. Le format de l'ID client est ClientId @TenantId. Par exemple, *ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe*.
+ Vous avez copié le secret SharePoint client généré lors de l'enregistrement de l'application uniquement au niveau du site.
**Remarque :** étant donné que les secrets client IDs et client sont générés pour des sites uniques uniquement lorsque vous enregistrez le SharePoint serveur pour l'authentification App Only, une seule URL de site est prise en charge pour SharePoint l'authentification App Only.
**Note**
SharePoint L'authentification par application uniquement n'est *pas* prise en charge pour la version SharePoint 2013.
+ Si vous utilisez **un identifiant e-mail avec un domaine personnalisé** pour le contrôle d'accès :
+ Vous avez noté la valeur de votre domaine de messagerie personnalisé, par exemple : « »*amazon.com*.
+ Si vous utilisez l'**adresse e-mail avec l'autorisation Domain from IDP**, copiez votre :
+ Point de terminaison du serveur LDAP (point de terminaison du serveur LDAP, y compris le protocole et le numéro de port). Par exemple : *ldap://example.com:389*.
+ Base de recherche LDAP (base de recherche de l'utilisateur LDAP). Par exemple : *CN=Users,DC=sharepoint,DC=com*.
+ Nom d'utilisateur et mot de passe LDAP.
+ Vous avez configuré des informations d'authentification NTLM **ou** des informations d'authentification Kerberos configurées contenant un nom d'utilisateur (nom d'utilisateur du SharePoint compte) et un mot de passe (mot de passe du compte). SharePoint
**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' SharePoint 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 SharePoint 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 SharePoint données, vous devez fournir les détails de vos SharePoint informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré SharePoint pour Amazon Kendra voir[Conditions préalables](#prerequisites-v2-sharepoint).
------
#### [ Console: SharePoint Online ]
**Pour vous connecter Amazon Kendra à SharePoint Online**
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 **SharePoint connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **SharePoint 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 tirets, 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. **Méthode d'hébergement** —Choisissez **SharePointen ligne**.
1. **Site URLs spécifique à votre SharePoint dépôt** —Entrez l' SharePoint hôte URLs. Le format de l'hôte URLs que vous entrez est*https://yourdomain.sharepoint.com/sites/mysite*. L’URL doit commencer par le protocole `https`. Séparez URLs par une nouvelle ligne. Vous pouvez en ajouter jusqu'à 100 URLs.
1. **Domaine** —Entrez le SharePoint domaine. Par exemple, le domaine de l'URL *https://yourdomain.sharepoint.com/sites/mysite* est*yourdomain*.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
Vous pouvez également choisir le type d'ID utilisateur, qu'il s'agisse du nom d'utilisateur principal ou de l'e-mail de l'utilisateur extrait du portail Azure. Si vous ne le spécifiez pas, l'e-mail est utilisé par défaut.
1. **Authentification** : choisissez l'authentification de base, OAuth 2.0, l'authentification Azure AD uniquement, l'authentification uniquement les SharePoint applications ou OAuth l'authentification par jeton d'actualisation 2.0. Vous pouvez soit choisir un AWS Secrets Manager secret existant pour stocker vos informations d'authentification, soit créer un secret.
1. Si vous utilisez l'**authentification de base**, votre code secret doit inclure un nom secret, un nom SharePoint d'utilisateur et un mot de passe.
1. Si vous utilisez l'**authentification OAuth 2.0**, votre code secret doit inclure l'identifiant du SharePoint locataire, le nom secret, le nom SharePoint d'utilisateur, le mot de passe, l'identifiant du client Azure AD généré lors de votre inscription SharePoint dans Azure AD et le secret du client Azure AD généré lorsque vous vous inscrivez SharePoint dans Azure AD.
1. Si vous utilisez l'**authentification Azure AD App-Only**, votre code secret doit inclure l'ID du SharePoint locataire, le certificat X.509 autosigné Azure AD, le nom secret, l'identifiant du client Azure AD généré lors de votre inscription SharePoint dans Azure AD et la clé privée pour authentifier le connecteur pour Azure AD.
1. Si vous utilisez l'**authentification SharePoint App-Only**, votre code secret doit inclure l' SharePoint identifiant du client, le nom secret, l'identifiant SharePoint client que vous avez généré lors de l'enregistrement de l'application uniquement au niveau du locataire, le secret SharePoint client généré lors de votre inscription à App Only au niveau du locataire, l'identifiant client Azure AD généré lorsque vous vous inscrivez SharePoint dans Azure AD et le secret client Azure AD généré lorsque vous vous inscrivez SharePoint sur Azure AD.
Le format de l'ID SharePoint client est*ClientID@TenantId*. Par exemple, *ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe*.
1. Si vous utilisez l'**authentification par jeton d'actualisation OAuth 2.0**, votre code secret doit inclure l'identifiant du SharePoint locataire, le nom du secret, l'identifiant client Azure AD unique généré lorsque vous vous inscrivez SharePoint dans Azure AD, le secret du client Azure AD généré lorsque vous vous inscrivez SharePoint sur Azure AD, le jeton d'actualisation généré pour vous connecter Amazon Kendra à SharePoint.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
Vous pouvez également choisir d'explorer le mappage de groupe local ou le mappage de groupe Azure Active Directory.
**Note**
L'analyse cartographique du groupe AD n'est disponible que pour les authentifications OAuth OAuth 2.0, 2.0 et SharePoint App Only.
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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
1. **Sélectionnez les entités** : choisissez les entités que vous souhaitez analyser. Vous pouvez choisir d'explorer **toutes les** entités ou toute combinaison de **fichiers**, de **pièces jointes**, de **pages** de **liens**, d'**événements**, de **commentaires** et de **données de liste**.
1. Dans **Configuration supplémentaire**, pour les modèles d'expression régulière **d'entité : ajoutez des modèles** d'expressions régulières pour les **liens**, les **pages** et les **événements** afin d'inclure des entités spécifiques au lieu de synchroniser tous vos documents.
1. **Modèles Regex** : ajoutez des modèles d'expressions régulières pour inclure ou exclure des fichiers par **chemin de fichier**, **nom de fichier**, **type de fichier**, nom de **OneNote section et nom** de **OneNote page** au lieu de synchroniser tous vos documents. Vous pouvez en ajouter jusqu'à 100.
**Note**
OneNote l'exploration n'est disponible que pour la OAuth version OAuth 2.0, le jeton d'actualisation 2.0 et SharePoint l'authentification App Only.
1. Pour le **mode de synchronisation**, choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données avec Amazon Kendra pour la première fois, tout le contenu est synchronisé par défaut.
+ **Synchronisation complète** : synchronisez tout le contenu, quel que soit l’état de synchronisation précédent.
+ Synchronisation des **documents nouveaux ou modifiés : synchronisez** uniquement les documents nouveaux ou modifiés.
+ Synchronisation des **documents nouveaux, modifiés ou supprimés : synchronisez** uniquement les documents nouveaux, modifiés et supprimés.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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.
------
#### [ Console: SharePoint Server ]
**Pour vous connecter Amazon Kendra à SharePoint**
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 **SharePoint connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **SharePoint 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 tirets, 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. **Méthode d'hébergement** : choisissez le **SharePointserveur.**
1. **Choisissez SharePoint la version** —Choisissez **SharePoint 2013**, **SharePoint 2016**, **SharePoint 2019** et **SharePoint (édition par abonnement).**
1. **Site URLs spécifique à votre SharePoint dépôt** —Entrez l' SharePoint hôte URLs. Le format de l'hôte URLs que vous entrez est*https://yourcompany/sites/mysite*. L’URL doit commencer par le protocole `https`. Séparez URLs par une nouvelle ligne. Vous pouvez en ajouter jusqu'à 100 URLs.
1. **Domaine** —Entrez le SharePoint domaine. Par exemple, le domaine de l'URL *https://yourcompany/sites/mysite* est *yourcompany*
1. **Emplacement du certificat SSL** —Entrez le Amazon S3 chemin d'accès à votre fichier de certificat SSL.
1. (Facultatif) Pour le **proxy Web** : entrez le nom d'hôte (sans le `https://` protocole `http://` OR) et le numéro de port utilisé par le protocole de transport d'URL de l'hôte. La valeur numérique du numéro de port doit être comprise entre 0 et 65 535.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
Pour le SharePoint serveur, vous pouvez choisir l'une des options ACL suivantes :
1. **ID e-mail avec domaine provenant de l'IDP** : l'ID utilisateur est basé sur le courrier électronique dont IDs les domaines ont été récupérés auprès du fournisseur d'identité (IDP) sous-jacent. Vous fournissez les détails de connexion IDP dans votre Secrets Manager secret dans le cadre de l'**authentification**.
1. **ID e-mail avec domaine personnalisé :** l'ID utilisateur est basé sur la valeur du domaine de messagerie personnalisé. Par exemple, « *amazon.com* ». Le domaine de messagerie sera utilisé pour créer l’identifiant de messagerie pour le contrôle d’accès. Vous devez saisir votre domaine de messagerie personnalisé.
1. **Domaine \$1 Utilisateur avec domaine :** l'ID utilisateur est construit au format Domain \$1 User ID. Vous devez fournir un nom de domaine valide. Par exemple : pour *"sharepoint2019"* créer un contrôle d'accès.
1. Pour **Authentification**, choisissez l'authentification SharePoint App-Only, l'authentification NTLM ou l'authentification Kerberos. Vous pouvez soit choisir un AWS Secrets Manager secret existant pour stocker vos informations d'authentification, soit créer un secret.
1. Si vous utilisez l'**authentification NTLM** ou **Kerberos**, votre code secret doit inclure un nom secret, un nom d' SharePoint utilisateur et un mot de passe.
Si vous utilisez l’**ID de messagerie avec le domaine de l’IDP**, saisissez également les informations suivantes :
+ Point de **terminaison du serveur LDAP** : point de terminaison du serveur LDAP, y compris le protocole et le numéro de port. Par exemple : *ldap://example.com:389*.
+ Base de **recherche LDAP —Base de** recherche de l'utilisateur LDAP. Par exemple : *CN=Users,DC=sharepoint,DC=com*.
+ **Nom d'utilisateur LDAP : votre nom d'utilisateur** LDAP.
+ Mot de passe **LDAP : votre mot de passe** LDAP.
1. Si vous utilisez l'**authentification SharePoint App Only**, votre code secret doit inclure un nom secret, l'ID SharePoint client que vous avez généré lorsque vous avez enregistré App Only au niveau du site, le secret SharePoint client généré lorsque vous vous inscrivez à App Only at Site Level.
Le format de l'ID SharePoint client est*ClientID@TenantId*. Par exemple, *ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe*.
**Remarque :** étant donné que les secrets client IDs et client sont générés pour des sites uniques uniquement lorsque vous enregistrez le SharePoint serveur pour l'authentification App Only, une seule URL de site est prise en charge pour SharePoint l'authentification App Only.
Si vous utilisez l’**ID de messagerie avec le domaine de l’IDP**, saisissez également les informations suivantes :
+ Point de **terminaison du serveur LDAP** : point de terminaison du serveur LDAP, y compris le protocole et le numéro de port. Par exemple : *ldap://example.com:389*.
+ Base de **recherche LDAP —Base de** recherche de l'utilisateur LDAP. Par exemple : *CN=Users,DC=sharepoint,DC=com*.
+ **Nom d'utilisateur LDAP : votre nom d'utilisateur** LDAP.
+ Mot de passe **LDAP : votre mot de passe** LDAP.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
Vous pouvez également choisir d'explorer le mappage de groupe local ou le mappage de groupe Azure Active Directory.
**Note**
L'analyse cartographique du groupe AD est disponible uniquement avec l'authentification SharePoint App Only.
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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
1. **Sélectionnez les entités** : choisissez les entités que vous souhaitez analyser. Vous pouvez choisir d'explorer **toutes les** entités ou toute combinaison de **fichiers**, de **pièces jointes**, de **pages** de **liens**, d'**événements** et de **données de liste**.
1. Dans **Configuration supplémentaire**, pour les modèles d'expression régulière **d'entité : ajoutez des modèles** d'expressions régulières pour les **liens**, les **pages** et les **événements** afin d'inclure des entités spécifiques au lieu de synchroniser tous vos documents.
1. **Modèles Regex** : ajoutez des modèles d'expressions régulières pour inclure ou exclure des fichiers par **chemin de fichier** **Nom de fichier** **Type de fichier**, **nom de OneNote section** et **nom de OneNote page** au lieu de synchroniser tous vos documents. Vous pouvez en ajouter jusqu'à 100.
**Note**
OneNote l'exploration n'est disponible que pour SharePoint l'authentification par application uniquement.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à SharePoint**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `SHAREPOINTV2` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Métadonnées du point de terminaison du référentiel** : spécifiez le `tenantID` `domain` et `siteUrls` de votre SharePoint instance.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
**Note**
Identity Crawler n'est disponible que lorsque vous le configurez sur`crawlAcl`. `true`
+ **Propriétés supplémentaires du référentiel** : spécifiez :
+ (pour Azure AD) `s3bucketName` et `s3certificateName` que vous utilisez pour stocker votre certificat X.509 autosigné Azure AD.
+ Type d'authentification (`auth_Type`) que vous utilisez`OAuth2`, qu'il s'agisse de `OAuth2App` `OAuth2Certificate``Basic`,`OAuth2_RefreshToken`,`NTLM`,, et`Kerberos`.
+ Version (`version`) que vous utilisez, que ce soit `Server` ou`Online`. Si vous en utilisez, `Server` vous pouvez spécifier davantage le `onPremVersion` as`2013`, `2016``2019`, ou`SubscriptionEdition`.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre SharePoint compte.
Si vous utilisez SharePoint Online, vous pouvez choisir entre l'authentification de base, l'authentification OAuth 2.0, l'authentification Azure AD uniquement et SharePoint l'authentification uniquement pour les applications. Voici la structure JSON minimale qui doit figurer dans votre code secret pour chaque option d'authentification :
+ **Authentification basique**
```
{
"userName": "SharePoint account user name",
"password": "SharePoint account password"
}
```
+ **OAuth Authentification 2.0**
```
{
"clientId": "client id generated when registering SharePoint with Azure AD",
"clientSecret": "client secret generated when registering SharePoint with Azure AD",
"userName": "SharePoint account user name",
"password": "SharePoint account password"
}
```
+ **Authentification uniquement avec les applications Azure AD**
```
{
"clientId": "client id generated when registering SharePoint with Azure AD",
"privateKey": "private key to authorize connection with Azure AD"
}
```
+ **SharePoint Authentification uniquement par application**
```
{
"clientId": "client id generated when registering SharePoint for App Only at Tenant Level",
"clientSecret": "client secret generated when registering SharePoint for App Only at Tenant Level",
"adClientId": "client id generated while registering SharePoint with Azure AD",
"adClientSecret": "client secret generated while registering SharePoint with Azure AD"
}
```
+ **OAuth Authentification par jeton d'actualisation 2.0**
```
{
"clientId": "client id generated when registering SharePoint with Azure AD",
"clientSecret": "client secret generated when registering SharePoint with Azure AD",
"refreshToken": "refresh token generated to connect to SharePoint"
}
```
Si vous utilisez SharePoint Server, vous pouvez choisir entre l'authentification SharePoint App-Only, l'authentification NTLM et l'authentification Kerberos. Voici la structure JSON minimale qui doit figurer dans votre code secret pour chaque option d'authentification :
+ ** SharePoint Authentification uniquement par application**
```
{
"siteUrlsHash": "Hash representation of SharePoint site URLs",
"clientId": "client id generated when registering SharePoint for App Only at Site Level",
"clientSecret": "client secret generated when registering SharePoint for App Only at Site Level"
}
```
+ ** SharePoint Authentification uniquement par application avec autorisation du domaine depuis l'IDP**
```
{
"siteUrlsHash": "Hash representation of SharePoint site URLs",
"clientId": "client id generated when registering SharePoint for App Only at Site Level",
"clientSecret": "client secret generated when registering SharePoint for App Only at Site Level",
"ldapUrl": "LDAP Account url eg. ldap://example.com:389",
"baseDn": "LDAP Account base dn eg. CN=Users,DC=sharepoint,DC=com",
"ldapUser": "LDAP account user name",
"ldapPassword": "LDAP account password"
}
```
+ **Authentification NTLM ou Kerberos (serveur uniquement)**
```
{
"siteUrlsHash": "Hash representation of SharePoint site URLs",
"userName": "SharePoint account user name",
"password": "SharePoint account password"
}
```
+ **Authentification NTLM ou Kerberos (serveur uniquement) avec autorisation de domaine depuis l'IDP**
```
{
"siteUrlsHash": "Hash representation of SharePoint site URLs",
"userName": "SharePoint account user name",
"password": "SharePoint account password",
"ldapUrl": "ldap://example.com:389",
"baseDn": "CN=Users,DC=sharepoint,DC=com",
"ldapUser": "LDAP account user name",
"ldapPassword": "LDAP account password"
}
```
+ **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 SharePoint connecteur et Amazon Kendra. Pour plus d'informations, consultez la section [IAM Rôles des sources de SharePoint 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure ou exclure certains fichiers et autres contenus. OneNotes
**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 SharePoint 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du SharePoint modèle](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-sharepoint).
------
## Remarques
+ Le connecteur prend en charge les mappages de champs personnalisés uniquement pour l'entité **Files**.
+ Pour toutes les versions SharePoint du serveur, le jeton ACL doit être en minuscules. Pour **un e-mail avec un domaine provenant de l'IDP** et **un identifiant de messagerie avec une ACL de domaine personnalisée**, par exemple :*user@sharepoint2019.com*. Pour **Domain \$1 User with Domain** ACL, par exemple :*sharepoint2013\$1user*.
+ Lorsque les listes de contrôle d'accès (ACLs) sont activées, l'option « Synchroniser uniquement le contenu nouveau ou modifié » n'est pas disponible en raison des limites de SharePoint l'API. Nous vous recommandons d'utiliser plutôt les modes « Synchronisation complète » ou « Synchronisation du contenu nouveau, modifié ou supprimé », ou de les désactiver ACLs si vous devez utiliser ce mode de synchronisation.
+ Le connecteur ne prend pas en charge le mode journal des changements/la **synchronisation du contenu nouveau ou modifié** pour SharePoint 2013.
+ Si le nom d’une entité contient un caractère `%`, le connecteur ignorera ces fichiers en raison des limitations de l’API.
+ OneNote ne peut être exploré par le connecteur qu'à l'aide d'un identifiant de locataire et avec un jeton d'actualisation OAuth OAuth 2.0, 2.0 ou une authentification SharePoint App Only activée pour SharePoint Online.
+ Le connecteur explore la première section d'un OneNote document en utilisant uniquement son nom par défaut, même si le document est renommé.
+ **Le connecteur analyse les liens dans les éditions SharePoint 2019, SharePoint en ligne et par abonnement, uniquement si les **pages** et **les fichiers** sont sélectionnés comme entités à analyser en plus des liens.**
+ Le connecteur analyse les liens en SharePoint 2013 et SharePoint 2016 si **Links** est sélectionné comme entité à analyser.
+ Le connecteur analyse les pièces jointes et les commentaires des listes uniquement lorsque **List Data** est également sélectionnée comme entité à analyser.
+ Le connecteur indexe les pièces jointes aux événements uniquement lorsque les **Événements** sont également sélectionnés en tant qu’entité à indexer.
+ Pour la version SharePoint en ligne, le jeton ACL sera en minuscules. Par exemple, si le **nom principal de l'utilisateur** se trouve *MaryMajor@domain.com* dans le portail Azure, le jeton ACL du SharePoint connecteur sera*marymajor@domain.com*.
+ Dans **Identity Crawler** for SharePoint Online and Server, si vous souhaitez explorer des groupes imbriqués, vous devez activer Local et AD Group Crawling.
+ Si vous utilisez SharePoint Online et que le nom d'utilisateur principal de votre portail Azure est une combinaison de majuscules et de minuscules, l' SharePoint API le convertit en interne en minuscules. Pour cette raison, le Amazon Kendra SharePoint connecteur définit l'ACL en minuscules.
# Microsoft SQL Server
**Note**
Le connecteur Microsoft SQL Server reste entièrement pris en charge pour les clients existants jusqu’au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Microsoft SQL Server est un système de gestion de base de données relationnelle (SGBDR) développé par Microsoft. Si vous êtes un Microsoft SQL Server utilisateur, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de Microsoft SQL Server données. Le connecteur Amazon Kendra Microsoft SQL Server de source de données prend en charge MS SQL Server 2019.
Vous pouvez vous connecter Amazon Kendra à votre source de Microsoft SQL Server données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra Microsoft SQL Server données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-ms-sql-server)
+ [Conditions préalables](#prerequisites-ms-sql-server)
+ [Instructions de connexion](#data-source-procedure-ms-sql-server)
+ [Remarques](#ms-sql-server-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de Microsoft SQL Server données, apportez ces modifications à vos AWS comptes Microsoft SQL Server and.
**Dans Microsoft SQL Server, assurez-vous d’avoir :**
+ Notez le nom d'utilisateur et le mot de passe de votre base de données.
**Important**
Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Vous avez copié l'URL, le port et l'instance de votre hôte de base de données.
+ Il est vérifié que chaque document est unique dans Microsoft SQL Server 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 votreCompte 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'Microsoft SQL Serverauthentification 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 Microsoft SQL Server 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 Microsoft SQL Server données, vous devez fournir les détails de vos Microsoft SQL Server informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Microsoft SQL Server pour Amazon Kendra voir[Conditions préalables](#prerequisites-ms-sql-server).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Microsoft SQL Server**
1. Connectez-vous à la [Amazon Kendraconsole 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 **Microsoft SQL Serverconnecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **Microsoft SQL Serverconnecteur** 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 tirets, 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. Dans **Source**, saisissez les informations suivantes :
1. **Hôte** : entrez le nom d'hôte de la base de données.
1. **Port** — Entrez le port de base de données.
1. **Instance** — Entrez l'instance de base de données.
1. **Activer l'emplacement du certificat SSL** : choisissez d'entrer le Amazon S3 chemin d'accès à votre fichier de certificat SSL.
1. Dans **Authentification**, entrez les informations suivantes :
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations Microsoft SQL Server d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - Microsoft SQL Server - » est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le mot de **passe de** la base** de données, entrez les valeurs d'identification d'authentification que vous avez copiées depuis votre base de données.
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
+ **Requête SQL** : saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
**Note**
Si le nom d'une table contient des caractères spéciaux (non alphanumériques), vous devez utiliser des crochets autour du nom de la table. Par exemple, *select \$1 from [my-database-table]*
+ **Colonne de clé primaire** : indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données.
+ **Colonne de titre** : indiquez le nom de la colonne de titre du document dans votre table de base de données.
+ **Colonne du corps** : indiquez le nom de la colonne du corps du document dans votre table de base de données.
1. Dans **Configuration supplémentaire *(facultatif)***, choisissez l'une des options suivantes pour synchroniser un contenu spécifique au lieu de synchroniser tous les fichiers :
+ **Colonnes détectant les modifications** : entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendraréindexera le contenu en cas de modification de l'une de ces colonnes.
+ ** IDsColonne utilisateur** : entrez le nom de la colonne contenant l'utilisateur devant être autorisé IDs à accéder au contenu.
+ **Colonne des groupes** : saisissez le nom de la colonne contenant les groupes autorisés à accéder au contenu.
+ ** URLsColonne source** —Entrez le nom de la colonne contenant la source URLs à indexer.
+ **Colonne horodatage** : entrez le nom de la colonne contenant les horodatages. Amazon Kendrautilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié.
+ **Colonne des fuseaux horaires** : saisissez le nom de la colonne contenant les fuseaux horaires du contenu à explorer.
+ **Format d’horodatage** : saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : à quelle fréquence Amazon Kendra se synchronisera avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés (**Document IDs****, Titres** des documents et **Source URLs**) que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à Microsoft SQL Server**
Vous devez spécifier les éléments suivants à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API :
+ **Source de données** —Spécifiez le type de source de données tel que `JDBC` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type de base de données** —Vous devez spécifier le type de base de données sous `sqlserver` la forme.
+ **Requête SQL** : spécifiez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
**Note**
Si le nom d'une table contient des caractères spéciaux (non alphanumériques), vous devez utiliser des crochets autour du nom de la table. Par exemple, *select \$1 from [my-database-table]*
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre Microsoft SQL Server compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"user name": "database user name",
"password": "password"
}
```
**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).
+ **IAMrole** —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 Microsoft SQL Server connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de Microsoft SQL Server 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure un contenu spécifique en utilisant l'utilisateur IDs, les groupes, la source URLs, les horodatages et les fuseaux horaires.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de Microsoft SQL Server données à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez[Schéma de modèle Microsoft SQL Server](ds-schemas.md#ds-ms-sql-server-schema).
------
## Remarques
+ Les lignes de base de données supprimées ne seront pas suivies lors de la Amazon Kendra vérification du contenu mis à jour.
+ La taille des noms et des valeurs des champs d’une ligne de votre base de données ne peut pas dépasser 400 Ko.
+ Si la source de données de votre base de données contient une grande quantité de données et que vous ne souhaitez pas Amazon Kendra indexer tout le contenu de votre base de données après la première synchronisation, vous pouvez choisir de ne synchroniser que les documents nouveaux, modifiés ou supprimés.
+ Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Il est recommandé d'éviter d'ajouter des tableaux contenant des données sensibles ou des informations personnelles identifiables (PII).
# Microsoft Teams
Microsoft Teams est un outil de collaboration d'entreprise pour la messagerie, les réunions et le partage de fichiers. Si vous êtes un utilisateur de Microsoft Teams, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de données Microsoft Teams.
Vous pouvez vous connecter Amazon Kendra à votre source de données Microsoft Teams à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Microsoft Teams, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-teams)
+ [Conditions préalables](#prerequisites-teams)
+ [Instructions de connexion](#data-source-procedure-teams)
+ [En savoir plus](#teams-learn-more)
+ [Remarques](#teams-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Microsoft Teams, apportez ces modifications à vos AWS comptes et à vos équipes Microsoft.
**Dans Microsoft Teams, assurez-vous que vous disposez des éléments suivants :**
+ Création d'un compte Microsoft Teams dans Office 365.
+ Vous avez noté votre identifiant de client Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application.
+ J'ai configuré une OAuth application sur le portail Azure et noté l'ID du client et le secret du client ou les informations d'identification du client. Consultez le [didacticiel Microsoft](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) et [l'exemple d'application enregistrée](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application) pour plus d'informations.
**Note**
Lorsque vous créez ou enregistrez une application sur le portail Azure, l'ID secret représente la valeur secrète réelle. Vous devez prendre note ou enregistrer la valeur secrète réelle immédiatement lors de la création du secret et de l'application. Vous pouvez accéder à votre secret en sélectionnant le nom de votre application sur le portail Azure, puis en accédant à l'option de menu sur les certificats et les secrets.
Vous pouvez accéder à votre ID client en sélectionnant le nom de votre application sur le portail Azure, puis en accédant à la page de présentation. L'ID de l'application (client) est l'ID du client.
**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).
+ Ajouté les autorisations nécessaires. Vous pouvez choisir d'ajouter toutes les autorisations ou de limiter la portée en sélectionnant moins d'autorisations en fonction des entités que vous souhaitez explorer. Le tableau suivant répertorie les autorisations au niveau de l'application par entité correspondante :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/data-source-teams.html)
+ Il est vérifié que chaque document est unique dans Microsoft Teams et dans 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 votreCompte 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'authentification Microsoft Teams 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 données Microsoft Teams à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 données Microsoft Teams, vous devez fournir les informations nécessaires sur votre source de données Microsoft Teams afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Microsoft Teams pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-teams).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Microsoft Teams**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Microsoft Teams**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Microsoft Teams** 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. **ID de locataire** —Entrez votre identifiant de locataire Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Microsoft Teams. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Microsoft Teams-» est automatiquement ajouté à votre nom secret.
1. Pour l'**ID client** et **le secret du client** : entrez les informations d'authentification configurées dans Microsoft Teams sur le portail Azure.
1. Enregistrez et ajoutez votre secret.
1. **Modèle de paiement** : vous pouvez choisir un modèle de licence et de paiement pour votre compte Microsoft Teams. Les modèles de paiement du modèle A sont limités aux modèles de licence et de paiement qui nécessitent une conformité en matière de sécurité. Les modèles de paiement du modèle B conviennent aux modèles de licence et de paiement qui ne nécessitent pas de conformité en matière de sécurité.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. **Synchroniser le contenu** : sélectionnez les types de contenu à analyser. Vous pouvez choisir d'explorer le contenu du chat, des équipes et du calendrier.
1. **Configuration supplémentaire** : spécifiez certaines dates de début et de fin du calendrier, les e-mails des utilisateurs, les noms des équipes, les noms des chaînes, les pièces jointes et OneNotes.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 à Microsoft Teams**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `MSTEAMS` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **ID de locataire** : vous pouvez trouver votre identifiant de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **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 compte Microsoft Teams. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"clientId": "client ID",
"clientSecret": "client secret"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur Microsoft Teams etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles pour les sources de données Microsoft Teams](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Types de documents/contenus** : indiquez si vous souhaitez explorer les messages de chat et les pièces jointes, les publications et les pièces jointes des chaînes, les wikis des chaînes, le contenu du calendrier, les discussions de réunion, les fichiers et les notes.
+ **Contenu du calendrier** : spécifiez une date de début et une heure de fin pour analyser le contenu du calendrier.
+ **Filtres d'inclusion et d'exclusion** : spécifiez si vous souhaitez inclure ou exclure certains contenus dans Microsoft Teams. Vous pouvez inclure ou exclure les noms d'équipes, les noms de chaînes, les noms de fichiers et les types de fichiers, les e-mails des utilisateurs, OneNote les sections et OneNote les pages.
**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.
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Microsoft Teams à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du modèle Microsoft Teams](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-msteams-schema).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Microsoft Teams, consultez :
+ [Effectuez des recherches intelligentes dans la source de données Microsoft Teams de votre organisation à l'aide du Amazon Kendra connecteur pour Microsoft Teams](https://aws.amazon.com/blogs/machine-learning/intelligently-search-your-organizations-microsoft-teams-data-source-with-the-amazon-kendra-connector-for-microsoft-teams/)
## Remarques
+ Lorsque les listes de contrôle d'accès (ACLs) sont activées, l'option « Synchroniser uniquement le contenu nouveau ou modifié » n'est pas disponible en raison des limites de l'API Microsoft Teams. Nous vous recommandons d'utiliser plutôt les modes « Synchronisation complète » ou « Synchronisation du contenu nouveau, modifié ou supprimé », ou de les désactiver ACLs si vous devez utiliser ce mode de synchronisation.
# Microsoft Yammer
**Note**
Le connecteur Microsoft Yammer reste entièrement pris en charge pour les clients existants jusqu'au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Microsoft Yammer est un outil de collaboration d'entreprise pour la messagerie, les réunions et le partage de fichiers. Si vous êtes un utilisateur de Microsoft Yammer, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de données Microsoft Yammer.
Vous pouvez vous connecter Amazon Kendra à votre source de données Microsoft Yammer à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Microsoft Yammer, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
## Fonctionnalités prises en charge
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Microsoft Yammer, apportez ces modifications à votre compte et AWS à votre compte Microsoft Yammer.
**Dans Microsoft Yammer, assurez-vous que vous disposez des éléments suivants :**
+ Création d'un compte administratif Microsoft Yammer dans Office 365.
+ Vous avez noté votre nom d'utilisateur et votre mot de passe Microsoft Yammer.
+ Vous avez noté votre identifiant de client Microsoft 365. Vous pouvez trouver votre ID de locataire dans les propriétés de votre portail Azure Active Directory ou dans votre OAuth application.
+ J'ai configuré une OAuth application sur le portail Azure et noté l'ID du client et le secret du client ou les informations d'identification du client. Consultez le [didacticiel Microsoft](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory) et [l'exemple d'application enregistrée](https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application) pour plus d'informations.
**Note**
Lorsque vous créez ou enregistrez une application sur le portail Azure, l'ID secret représente la valeur secrète réelle. Vous devez prendre note ou enregistrer la valeur secrète réelle immédiatement lors de la création du secret et de l'application. Vous pouvez accéder à votre secret en sélectionnant le nom de votre application sur le portail Azure, puis en accédant à l'option de menu sur les certificats et les secrets.
Vous pouvez accéder à votre ID client en sélectionnant le nom de votre application sur le portail Azure, puis en accédant à la page de présentation. L'ID de l'application (client) est l'ID du client.
**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).
+ Il est vérifié que chaque document est unique dans Microsoft Yammer et dans 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 votreCompte 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'authentification Microsoft Yammer 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 données Microsoft Yammer à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 données Microsoft Yammer, vous devez fournir les informations nécessaires sur votre source de données Microsoft Yammer afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Microsoft Yammer pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-yammer).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Microsoft Yammer**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Microsoft Yammer**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Microsoft Yammer** 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. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Microsoft Yammer. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Saisissez les informations suivantes dans la **fenêtre Créer un secret AWS Secrets Manager** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Microsoft Yammer » est automatiquement ajouté à votre nom secret.
1. Pour **Nom d'utilisateur**, **mot de passe** : entrez votre nom d'utilisateur et votre mot de passe Microsoft Yammer.
1. Pour l'**ID client**, **secret du client** : entrez les informations d'authentification configurées dans Microsoft Yammer sur le portail Azure.
1. Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. **Depuis la date** : spécifiez la date de début de l'analyse de vos données dans Microsoft Yammer.
1. **Synchroniser le contenu** : sélectionnez le type de contenu à explorer. Par exemple, les messages publics, les messages privés et les pièces jointes.
1. **Configuration supplémentaire** : spécifiez certains noms de communauté que vous souhaitez explorer et utilisez également des modèles d'expressions régulières pour inclure ou exclure certains contenus.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 à Microsoft Yammer**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `YAMMER` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **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 compte Microsoft Yammer. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password",
"clientId": "client ID",
"clientSecret": "client secret"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur Microsoft Yammer et. Amazon Kendra Pour plus d'informations, consultez la section [IAMRôles des sources de données Microsoft Yammer](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Types de documents/contenus** : indiquez si vous souhaitez analyser le contenu de la communauté, les messages et pièces jointes, ainsi que les messages privés.
+ **Filtres d'inclusion et d'exclusion** : spécifiez s'il faut inclure ou exclure certains contenus.
**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.
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Microsoft Yammer à vos Amazon Kendra champs d'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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du modèle Microsoft Yammer](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-yammer).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Microsoft Yammer, consultez :
+ [Annonce du connecteur Yammer pour Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-yammer-connector-for-amazon-kendra/)
# MySQL
**Note**
Le connecteur MySQL reste entièrement pris en charge pour les clients existants jusqu’au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
MySQLest un système de gestion de base de données relationnelle open source. Si vous êtes un MySQL utilisateur, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de MySQL données. Le connecteur Amazon Kendra MySQL de source de données prend en charge MySQL 8.0. 21.
Vous pouvez vous connecter Amazon Kendra à votre source de MySQL données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra MySQL données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-mysql)
+ [Conditions préalables](#prerequisites-mysql)
+ [Instructions de connexion](#data-source-procedure-mysql)
+ [Remarques](#mysql-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de MySQL données, apportez ces modifications à vos AWS comptes MySQL and.
**Dans MySQL, assurez-vous d’avoir :**
+ Notez le nom d'utilisateur et le mot de passe de votre base de données.
**Important**
Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Vous avez copié l'URL, le port et l'instance de votre hôte de base de données.
+ Il est vérifié que chaque document est unique dans MySQL 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 votreCompte 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'MySQLauthentification 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 MySQL 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 MySQL données, vous devez fournir les détails de vos MySQL informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré MySQL pour Amazon Kendra voir[Conditions préalables](#prerequisites-mysql).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à MySQL**
1. Connectez-vous à la [Amazon Kendraconsole 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 **MySQLconnecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **MySQLconnecteur** 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. Dans **Source**, saisissez les informations suivantes :
1. **Hôte** : entrez le nom d'hôte de la base de données.
1. **Port** — Entrez le port de base de données.
1. **Instance** — Entrez l'instance de base de données.
1. **Activer l'emplacement du certificat SSL** : choisissez d'entrer le Amazon S3 chemin d'accès à votre fichier de certificat SSL.
1. Dans **Authentification**, entrez les informations suivantes :
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations MySQL d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - MySQL - » est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le mot de **passe de** la base** de données, entrez les valeurs d'identification d'authentification que vous avez copiées depuis votre base de données.
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
+ **Requête SQL** : saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Colonne de clé primaire** : indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données.
+ **Colonne de titre** : indiquez le nom de la colonne de titre du document dans votre table de base de données.
+ **Colonne du corps** : indiquez le nom de la colonne du corps du document dans votre table de base de données.
1. Dans **Configuration supplémentaire — *facultatif***, choisissez l'une des options suivantes pour synchroniser un contenu spécifique au lieu de synchroniser tous les fichiers :
+ **Colonnes détectant les modifications** : entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendraréindexera le contenu en cas de modification de l'une de ces colonnes.
+ ** IDsColonne des utilisateurs** : entrez le nom de la colonne contenant l'utilisateur devant être autorisé IDs à accéder au contenu.
+ **Colonne des groupes** : saisissez le nom de la colonne contenant les groupes autorisés à accéder au contenu.
+ ** URLsColonne source** —Entrez le nom de la colonne contenant la source URLs à indexer.
+ **Colonne horodatage** : entrez le nom de la colonne contenant les horodatages. Amazon Kendrautilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié.
+ **Colonne des fuseaux horaires** : saisissez le nom de la colonne contenant les fuseaux horaires du contenu à explorer.
+ **Format d’horodatage** : saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : à quelle fréquence Amazon Kendra sera synchronisée avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés (**Document IDs****, Titres** des documents et **Source URLs**) que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 à MySQL**
Vous devez spécifier les éléments suivants à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API :
+ **Source de données** —Spécifiez le type de source de données tel que `JDBC` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type de base de données** —Vous devez spécifier le type de base de données sous `mySql` la forme.
+ **Requête SQL** : spécifiez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre MySQL compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"user name": "database user name",
"password": "password"
}
```
**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).
+ **IAMrole** —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 MySQL connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de MySQL 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure un contenu spécifique en utilisant l'utilisateur IDs, les groupes, la source URLs, les horodatages et les fuseaux horaires.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de MySQL données à vos champs d'Amazon Kendraindex. 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.
------
## Remarques
+ Les lignes de base de données supprimées ne seront pas suivies lors de la Amazon Kendra vérification du contenu mis à jour.
+ La taille des noms et des valeurs des champs d’une ligne de votre base de données ne peut pas dépasser 400 Ko.
+ Si la source de données de votre base de données contient une grande quantité de données et que vous ne souhaitez pas Amazon Kendra indexer tout le contenu de votre base de données après la première synchronisation, vous pouvez choisir de ne synchroniser que les documents nouveaux, modifiés ou supprimés.
+ Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Il est recommandé d'éviter d'ajouter des tableaux contenant des données sensibles ou des informations personnelles identifiables (PII).
# Oracle Database
**Note**
Le connecteur Oracle Database reste entièrement pris en charge pour les clients existants jusqu’au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Oracle Database est un système de gestion de base de données. Si vous êtes un Oracle Database utilisateur, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de Oracle Database données. Le connecteur de source de Amazon Kendra Oracle Database données prend en charge les bases de données Oracle 18c, 19c et 21c.
Vous pouvez vous connecter Amazon Kendra à votre source de Oracle Database données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra Oracle Database données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-oracle-database)
+ [Conditions préalables](#prerequisites-oracle-database)
+ [Instructions de connexion](#data-source-procedure-oracle-database)
+ [Remarques](#oracle-database-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de Oracle Database données, apportez ces modifications à vos AWS comptes Oracle Database and.
**Dans Oracle Database, assurez-vous d’avoir :**
+ Notez le nom d'utilisateur et le mot de passe de votre base de données.
**Important**
Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Vous avez copié l'URL, le port et l'instance de votre hôte de base de données.
+ Il est vérifié que chaque document est unique dans Oracle Database 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 votreCompte 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'Oracle Databaseauthentification 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 Oracle Database 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 Oracle Database données, vous devez fournir les détails de vos Oracle Database informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Oracle Database pour Amazon Kendra voir[Conditions préalables](#prerequisites-oracle-database).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Oracle Database**
1. Connectez-vous à la [Amazon Kendraconsole 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 **Oracle Databaseconnecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **Oracle Databaseconnecteur** 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 tirets, 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. Dans **Source**, saisissez les informations suivantes :
1. **Hôte** : entrez le nom d'hôte de la base de données.
1. **Port** — Entrez le port de base de données.
1. **Instance** — Entrez l'instance de base de données.
1. **Activer l'emplacement du certificat SSL** : choisissez d'entrer le Amazon S3 chemin d'accès à votre fichier de certificat SSL.
1. Dans **Authentification**, entrez les informations suivantes :
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations Oracle Database d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - Oracle Database - » est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le mot de **passe de** la base** de données, entrez les valeurs d'identification d'authentification que vous avez copiées depuis votre base de données.
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
+ **Requête SQL** : saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Colonne de clé primaire** : indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données.
+ **Colonne de titre** : indiquez le nom de la colonne de titre du document dans votre table de base de données.
+ **Colonne du corps** : indiquez le nom de la colonne du corps du document dans votre table de base de données.
1. Dans **Configuration supplémentaire — *facultatif***, choisissez l'une des options suivantes pour synchroniser un contenu spécifique au lieu de synchroniser tous les fichiers :
+ **Colonnes détectant les modifications** : entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendraréindexera le contenu en cas de modification de l'une de ces colonnes.
+ ** IDsColonne utilisateur** : entrez le nom de la colonne contenant l'utilisateur devant être autorisé IDs à accéder au contenu.
+ **Colonne des groupes** : saisissez le nom de la colonne contenant les groupes autorisés à accéder au contenu.
+ ** URLsColonne source** —Entrez le nom de la colonne contenant la source URLs à indexer.
+ **Colonne horodatage** : entrez le nom de la colonne contenant les horodatages. Amazon Kendrautilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié.
+ **Colonne des fuseaux horaires** : saisissez le nom de la colonne contenant les fuseaux horaires du contenu à explorer.
+ **Format d’horodatage** : saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : à quelle fréquence Amazon Kendra sera synchronisée avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés (**Document IDs****, Titres** des documents et **Source URLs**) que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à Oracle Database**
Vous devez spécifier les éléments suivants à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API :
+ **Source de données** —Spécifiez le type de source de données tel que `JDBC` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type de base de données** —Vous devez spécifier le type de base de données sous `oracle` la forme.
+ **Requête SQL** : spécifiez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre Oracle Database compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"user name": "database user name",
"password": "password"
}
```
**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).
+ **IAMrole** —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 Oracle Database connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de Oracle Database 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure un contenu spécifique en utilisant l'utilisateur IDs, les groupes, la source URLs, les horodatages et les fuseaux horaires.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de Oracle Database données à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez[Schéma du modèle de base de données Oracle](ds-schemas.md#ds-oracle-database-schema).
------
## Remarques
+ Les lignes de base de données supprimées ne seront pas suivies lors de la Amazon Kendra vérification du contenu mis à jour.
+ La taille des noms et des valeurs des champs d’une ligne de votre base de données ne peut pas dépasser 400 Ko.
+ Si la source de données de votre base de données contient une grande quantité de données et que vous ne Amazon Kendra souhaitez pas indexer tout le contenu de votre base de données après la première synchronisation, vous pouvez choisir de synchroniser uniquement les documents nouveaux, modifiés ou supprimés.
+ Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Il est recommandé d'éviter d'ajouter des tableaux contenant des données sensibles ou des informations personnelles identifiables (PII).
# PostgreSQL
**Note**
Le connecteur PostgreSQL reste entièrement pris en charge pour les clients existants jusqu’au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
PostgreSQL est un système de gestion de base de données open source. Si vous êtes un PostgreSQL utilisateur, vous pouvez l'utiliser Amazon Kendra pour indexer votre source de PostgreSQL données. Le connecteur de source de Amazon Kendra PostgreSQL données prend en charge PostgreSQL 9.6.
Vous pouvez vous connecter Amazon Kendra à votre source de PostgreSQL données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra PostgreSQL données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-postgresql)
+ [Conditions préalables](#prerequisites-postgresql)
+ [Instructions de connexion](#data-source-procedure-postgresql)
+ [Remarques](#postgresql-notes)
## Fonctionnalités prises en charge
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de PostgreSQL données, apportez ces modifications à vos AWS comptes PostgreSQL and.
**Dans PostgreSQL, assurez-vous d’avoir :**
+ Notez le nom d'utilisateur et le mot de passe de votre base de données.
**Important**
Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Vous avez copié l'URL, le port et l'instance de votre hôte de base de données.
+ Il est vérifié que chaque document est unique dans PostgreSQL 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 votreCompte 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'PostgreSQLauthentification 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 PostgreSQL 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 PostgreSQL données, vous devez fournir les détails de vos PostgreSQL informations d'identification afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré PostgreSQL pour Amazon Kendra voir[Conditions préalables](#prerequisites-postgresql).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à PostgreSQL**
1. Connectez-vous à la [Amazon Kendraconsole 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 **PostgreSQLconnecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **PostgreSQLconnecteur** 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 tirets, 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. Dans **Source**, saisissez les informations suivantes :
1. **Hôte** : entrez le nom d'hôte de la base de données.
1. **Port** — Entrez le port de base de données.
1. **Instance** — Entrez l'instance de base de données.
1. **Activer l'emplacement du certificat SSL** : choisissez d'entrer le Amazon S3 chemin d'accès à votre fichier de certificat SSL.
1. Dans **Authentification**, entrez les informations suivantes :
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations PostgreSQL d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - PostgreSQL - » est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le mot de **passe de** la base** de données, entrez les valeurs d'identification d'authentification que vous avez copiées depuis votre base de données.
1. Choisissez **Enregistrer**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. Dans **Portée de la synchronisation**, choisissez parmi les options suivantes :
+ **Requête SQL** : saisissez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Colonne de clé primaire** : indiquez la clé primaire pour la table de base de données. Cela identifie une table au sein de votre base de données.
+ **Colonne de titre** : indiquez le nom de la colonne de titre du document dans votre table de base de données.
+ **Colonne du corps** : indiquez le nom de la colonne du corps du document dans votre table de base de données.
1. Dans **Configuration supplémentaire — *facultatif***, choisissez l'une des options suivantes pour synchroniser un contenu spécifique au lieu de synchroniser tous les fichiers :
+ **Colonnes détectant les modifications** : entrez le nom des colonnes qui Amazon Kendra seront utilisées pour détecter les modifications de contenu. Amazon Kendraréindexera le contenu en cas de modification de l'une de ces colonnes.
+ ** IDsColonne des utilisateurs** : entrez le nom de la colonne contenant l'utilisateur devant être autorisé IDs à accéder au contenu.
+ **Colonne des groupes** : saisissez le nom de la colonne contenant les groupes autorisés à accéder au contenu.
+ ** URLsColonne source** —Entrez le nom de la colonne contenant la source URLs à indexer.
+ **Colonne horodatage** : entrez le nom de la colonne contenant les horodatages. Amazon Kendrautilise les informations d'horodatage pour détecter les modifications apportées à votre contenu et synchroniser uniquement le contenu modifié.
+ **Colonne des fuseaux horaires** : saisissez le nom de la colonne contenant les fuseaux horaires du contenu à explorer.
+ **Format d’horodatage** : saisissez le nom de la colonne contenant les formats d’horodatage à utiliser pour détecter les modifications de contenu et resynchroniser votre contenu.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : à quelle fréquence Amazon Kendra sera synchronisée avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés (**Document IDs****, Titres** des documents et **Source URLs**) que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à PostgreSQL**
Vous devez spécifier les éléments suivants à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API :
+ **Source de données** —Spécifiez le type de source de données tel que `JDBC` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **Type de base de données** —Vous devez spécifier le type de base de données sous `postgresql` la forme.
+ **Requête SQL** : spécifiez des instructions de requête SQL telles que les opérations SELECT et JOIN. La taille des requêtes SQL doit être inférieure à 32 Ko. Amazon Kendra explorera tout le contenu de la base de données correspondant à votre requête.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre PostgreSQL compte. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"user name": "database user name",
"password": "password"
}
```
**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).
+ **IAMrole** —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 PostgreSQL connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de PostgreSQL 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure un contenu spécifique en utilisant l'utilisateur IDs, les groupes, la source URLs, les horodatages et les fuseaux horaires.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de PostgreSQL données à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez[Schéma du modèle PostgreSQL](ds-schemas.md#ds-postgresql-schema).
------
## Remarques
+ Les lignes de base de données supprimées ne seront pas suivies lors de la Amazon Kendra vérification du contenu mis à jour.
+ La taille des noms et des valeurs des champs d’une ligne de votre base de données ne peut pas dépasser 400 Ko.
+ Si la source de données de votre base de données contient une grande quantité de données et que vous ne souhaitez pas Amazon Kendra indexer tout le contenu de votre base de données après la première synchronisation, vous pouvez choisir de ne synchroniser que les documents nouveaux, modifiés ou supprimés.
+ Il est recommandé de fournir des informations d'identification Amazon Kendra de base de données en lecture seule.
+ Il est recommandé d'éviter d'ajouter des tableaux contenant des données sensibles ou des informations personnelles identifiables (PII).
# Quip
**Note**
Le connecteur Quip reste entièrement pris en charge pour les clients existants jusqu’au 31 mai 2026. Bien que ce connecteur ne soit plus disponible pour les nouveaux utilisateurs, les utilisateurs actuels peuvent continuer à l’utiliser sans interruption. Nous faisons constamment évoluer notre portefeuille de connecteurs afin de proposer des solutions plus évolutives et personnalisables. Pour les intégrations futures, nous vous recommandons d'explorer le framework de connecteurs personnalisés Amazon Kendra [1], conçu pour prendre en charge un plus large éventail de cas d'utilisation en entreprise avec une flexibilité accrue.
Quip est un logiciel de productivité collaboratif qui offre des fonctionnalités de création de documents en temps réel. Vous pouvez l'utiliser Amazon Kendra pour indexer vos dossiers, fichiers, commentaires de fichiers, forums de discussion et pièces jointes Quip.
Vous pouvez vous connecter Amazon Kendra à votre source de données Quip à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[QuipConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QuipConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Quip, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-quip)
+ [Conditions préalables](#prerequisites-quip)
+ [Instructions de connexion](#data-source-procedure-quip)
+ [En savoir plus](#quip-learn-more)
## Fonctionnalités prises en charge
Amazon KendraLe connecteur de source de données Quip prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Quip, apportez ces modifications à votre Quip et AWS à vos comptes.
**Dans Quip, assurez-vous d’avoir :**
+ Un compte Quip avec des autorisations d’administration.
+ Créé des informations d’identification d’authentification Quip qui incluent un jeton d’accès personnel. Le jeton est utilisé comme identifiant d'authentification stocké dans un AWS Secrets Manager secret. Consultez la [Documentation de Quip sur l’authentification](https://quip.com/dev/admin/documentation/current#section/Authentication) pour plus d’informations.
**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).
+ Copié le domaine de votre site Quip. Par exemple, *https://quip-company.quipdomain.com/browse* où se *quipdomain* trouve le domaine ?
+ Il est vérifié que chaque document est unique dans Quip et dans 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 votreCompte 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'authentification Quip 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 données Quip à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 données Quip, vous devez fournir les détails nécessaires de votre source de données Quip afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Quip pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-quip).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Quip**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Quip**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Quip** avec le tag « 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. Nom de **domaine Quip —Entrez le nom** de domaine Quip que vous avez copié depuis votre compte Quip.
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Quip. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Quip » est automatiquement ajouté à votre nom secret.
1. **Jeton Quip** —Entrez l'accès personnel Quip configuré pour Quip.
1. Ajoutez et enregistrez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **IAMrô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**
IAMles 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. **Ajouter le dossier Quip IDs à explorer** : le dossier Quip que IDs vous souhaitez explorer.
**Note**
Pour explorer un dossier racine, y compris tous les sous-dossiers et documents qu'il contient, ajoutez l'ID du dossier racine. Pour explorer des sous-dossiers spécifiques, ajoutez-les. IDs
1. **Configuration supplémentaire (types de contenu)** : entrez les types de contenu que vous souhaitez analyser.
1. Modèles **Regex : modèles** d'expressions régulières permettant d'inclure ou d'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** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Sélectionnez parmi les champs de source de données par défaut générés que vous souhaitez Amazon Kendra mapper à l'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 à Quip**
Vous devez spécifier les éléments suivants à l'aide de l'[QuipConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QuipConfiguration.html)API :
+ **Domaine du site Quip** : par exemple, *https://quip-company.quipdomain.com/browse* où se *quipdomain* trouve le domaine ?
+ **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 compte Quip. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"accessToken": "token"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur Quip et. Amazon Kendra Pour plus d'informations, consultez la section [IAMRôles des sources de données Quip](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC)** —Spécifiez dans le `VpcConfiguration` cadre de la configuration de la source de données. Consultez [la section Configuration Amazon Kendra pour utiliser un VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ **Filtres d'inclusion et d'exclusion** : spécifiez si vous souhaitez inclure ou exclure certains fichiers.
**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.
+ **Dossiers** : spécifiez les dossiers et sous-dossiers Quip que vous souhaitez indexer
**Note**
Pour indexer un dossier racine, y compris tous les sous-dossiers et documents qu’il contient, saisissez l’ID du dossier racine. Pour explorer des sous-dossiers spécifiques, ajoutez-les. IDs
+ **Pièces jointes, salons de discussion, commentaires sur les fichiers** : choisissez d'inclure ou non l'exploration des pièces jointes, du contenu des salons de discussion et des commentaires sur les fichiers.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Quip à vos Amazon Kendra champs d'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.
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Quip, consultez :
+ [Recherchez des connaissances dans des documents Quip grâce à la recherche intelligente à l'aide du connecteur Quip pour Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/search-for-knowledge-in-quip-documents-with-intelligent-search-using-the-quip-connector-for-amazon-kendra/)
# Salesforce
Salesforce est un outil de gestion de la relation client (CRM) permettant de gérer les équipes d’assistance, de vente et de marketing. Vous pouvez l'utiliser Amazon Kendra pour indexer vos objets standard Salesforce et même vos objets personnalisés.
Vous pouvez vous connecter Amazon Kendra à votre source de données Salesforce à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/), de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API ou de l'[SalesforceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SalesforceConfiguration.html)API.
Amazon Kendrapossède deux versions du connecteur Salesforce. Les fonctionnalités prises en charge par chaque version incluent :
**Connecteur Salesforce V1.0/API [SalesforceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SalesforceConfiguration.html)**
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d’inclusion et d’exclusion
**Connecteur Salesforce V2.0/API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
**Note**
Le connecteur Salesforce SalesforceConfiguration V1.0/API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le connecteur Salesforce TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Salesforce, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Connecteur Salesforce V1.0](data-source-v1-salesforce.md)
+ [Connecteur Salesforce V2.0](data-source-v2-salesforce.md)
# Connecteur Salesforce V1.0
Salesforce est un outil de gestion de la relation client (CRM) permettant de gérer les équipes d’assistance, de vente et de marketing. Vous pouvez l'utiliser Amazon Kendra pour indexer vos objets standard Salesforce et même vos objets personnalisés.
**Important**
Amazon Kendrautilise la version 48 de l'API Salesforce. L'API Salesforce limite le nombre de demandes que vous pouvez effectuer par jour. Si Salesforce dépasse le nombre de demandes, il réessaie jusqu'à ce qu'il soit en mesure de continuer.
**Note**
Le connecteur Salesforce SalesforceConfiguration V1.0/API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le connecteur Salesforce TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Salesforce, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v1-salesforce)
+ [Conditions préalables](#prerequisites-v1-salesforce)
+ [Instructions de connexion](#data-source-procedure-v1-salesforce)
## Fonctionnalités prises en charge
Amazon KendraLe connecteur de source de données Salesforce prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d’inclusion et d’exclusion
## Conditions préalables
Avant de pouvoir l'utiliser Amazon Kendra pour indexer votre source de données Salesforce, apportez ces modifications à votre Salesforce et à vos AWS comptes.
**Dans Salesforce, assurez-vous que vous disposez des éléments suivants :**
+ J'ai créé un compte Salesforce et j'ai noté le nom d'utilisateur et le mot de passe que vous utilisez pour vous connecter à Salesforce.
+ Vous avez créé un compte Salesforce Connected App en OAuth activant et en copiant la clé client (ID client) et le secret client (secret client) attribués à votre application Salesforce Connected. L'ID client et le secret du client sont utilisés comme informations d'authentification stockées dans un AWS Secrets Manager secret. Consultez [la documentation Salesforce sur les applications connectées](https://help.salesforce.com/s/articleView?id=sf.connected_app_overview.htm&type=5) pour plus d'informations.
**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).
+ Le jeton de sécurité Salesforce associé au compte utilisé pour se connecter à Salesforce a été copié.
+ Vous avez copié l'URL de l'instance Salesforce que vous souhaitez indexer. Il s'agit généralement de *https://.salesforce.com/*. Le serveur doit exécuter une application connectée à Salesforce.
+ Vous avez ajouté des informations d'identification à votre serveur Salesforce pour un utilisateur ayant un accès en lecture seule à Salesforce en clonant le ReadOnly profil, puis en ajoutant les autorisations Afficher toutes les données et Gérer les articles. Ces informations d'identification identifient l'utilisateur qui établit la connexion et l'application connectée Salesforce à laquelle Amazon Kendra elle se connecte.
+ Il est vérifié que chaque document est unique dans Salesforce et dans 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 votreCompte 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'authentification Salesforce 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 données Salesforce à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 données Salesforce, vous devez fournir les informations nécessaires sur votre source de données Salesforce afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Salesforce pour Amazon Kendra voir[Conditions préalables](#prerequisites-v1-salesforce).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Salesforce**
1. Connectez-vous à la console AWS de gestion et [Amazon Kendraouvrez-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 le **connecteur Salesforce V1.0**, puis sélectionnez **Ajouter un connecteur**.
1. Sur la page **Spécifier les détails de la source de données**, entrez les informations suivantes :
1. **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. **Langue par défaut** : langue permettant de 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 remplace la langue sélectionnée.
1. **Ajouter une nouvelle balise** : des balises pour rechercher et filtrer vos ressources ou suivre vos coûts partagés.
1. Choisissez **Suivant**.
1. Sur la page **Définir l'accès et la sécurité**, entrez les informations suivantes :
1. **URL Salesforce** —Entrez l'URL de l'instance du site Salesforce que vous souhaitez indexer.
1. Pour **Type d'authentification**, choisissez entre **Existant** et **Nouveau** pour stocker vos informations d'authentification Salesforce. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Salesforce-» est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur**, le **mot de passe**, le **jeton de sécurité**, la **clé** du **client, le secret du consommateur** et **l'URL d'authentification**, entrez les valeurs d'identification d'authentification que vous avez créées dans votre compte Salesforce.
1. Choisissez **Enregistrer l'authentification**.
1. **IAMrô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**
IAMles 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. Pour **explorer les pièces jointes** : sélectionnez cette option pour analyser tous les objets, articles et flux joints.
1. Pour les **objets standard, les** **articles de connaissances** et les fils **Chatter,** sélectionnez les entités Salesforce ou les types de contenu que vous souhaitez analyser.
**Note**
Vous devez fournir des informations de configuration pour indexer au moins un objet standard, des articles de connaissances ou des fils de membres de la discussion. Si vous choisissez d’indexer les **Articles de connaissances**, vous devez spécifier les types d’articles de connaissances à indexer, le nom des articles et indiquer si vous souhaitez indexer les champs standard de tous les articles de connaissances ou uniquement les champs d’un type d’article personnalisé. Si vous choisissez d’indexer des articles personnalisés, vous devez spécifier le nom interne du type d’article. Vous pouvez spécifier jusqu'à 10 types d'articles.
1. **Fréquence : fréquence** Amazon Kendra de synchronisation avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Pour **l'article de connaissance standard****, les pièces jointes aux objets standard** 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.
**Note**
Un index mappé à `_document_body` est requis. Vous ne pouvez pas modifier le mappage entre le `Salesforce ID` champ et le Amazon Kendra `_document_id ` champ.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 à Salesforce**
Vous devez spécifier l'[SalesforceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SalesforceConfiguration.html)API suivante :
+ **URL du serveur** : URL de l'instance du site Salesforce que vous souhaitez indexer.
+ **Nom de ressource Amazon secret (ARN)** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification de votre compte Salesforce. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"authenticationUrl": "OAUTH endpoint that Amazon Kendra connects to get an OAUTH token",
"consumerKey": "Application public key generated when you created your Salesforce application",
"consumerSecret": "Application private key generated when you created your Salesforce application.",
"password": "Password associated with the user logging in to the Salesforce instance",
"securityToken": "Token associated with the user account logging in to the Salesforce instance",
"username": "User name of the user logging in to the Salesforce instance"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment 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 connecteur Salesforce etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles pour les sources de données Salesforce](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
+ Vous devez fournir des informations de configuration pour indexer au moins un objet standard, des articles de connaissances ou des fils de membres de la discussion.
+ **Objets standard** : si vous choisissez d'analyser des **objets standard**, vous devez spécifier le nom de l'objet standard et le nom du champ dans la table des objets standard qui contient le contenu du document.
+ **Articles de connaissances** : si vous choisissez d'explorer les **articles de connaissances**, vous devez spécifier les types d'articles de connaissances à indexer, l'état des articles de connaissances à indexer et indiquer si vous souhaitez indexer les champs standard de tous les articles de connaissances ou uniquement les champs d'un type d'article personnalisé.
+ **Flux Chatter** : si vous choisissez d'analyser les **flux Chatter**, vous devez spécifier le nom de la colonne du FeedItem tableau Salesforce qui contient le contenu à indexer.
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Filtres d'inclusion et d'exclusion** : spécifiez si vous souhaitez inclure ou exclure certaines pièces jointes.
**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 données Salesforce à vos champs d'Amazon Kendraindex. 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).
------
# Connecteur Salesforce V2.0
Salesforce est un outil de gestion de la relation client (CRM) permettant de gérer les équipes d’assistance, de vente et de marketing. Vous pouvez l'utiliser Amazon Kendra pour indexer vos objets standard Salesforce et même vos objets personnalisés.
Le connecteur de source de données Amazon Kendra Salesforce prend en charge les éditions Salesforce suivantes : Developer Edition et Enterprise Edition.
**Note**
Le connecteur Salesforce SalesforceConfiguration V1.0/API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le connecteur Salesforce TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Salesforce, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v2-salesforce)
+ [Conditions préalables](#prerequisites-v2-salesforce)
+ [Instructions de connexion](#data-source-procedure-v2-salesforce)
+ [En savoir plus](#salesforce-v2-learn-more)
+ [Remarques](#salesforce-notes)
## Fonctionnalités prises en charge
Amazon KendraLe connecteur de source de données Salesforce prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir l'utiliser Amazon Kendra pour indexer votre source de données Salesforce, apportez ces modifications à votre Salesforce et à vos AWS comptes.
**Dans Salesforce, assurez-vous que vous disposez des éléments suivants :**
+ J'ai créé un compte administratif Salesforce et j'ai noté le nom d'utilisateur et le mot de passe que vous utilisez pour vous connecter à Salesforce.
+ Le jeton de sécurité Salesforce associé au compte utilisé pour se connecter à Salesforce a été copié.
+ Vous avez créé un compte Salesforce Connected App en OAuth activant et en copiant la clé client (ID client) et le secret client (secret client) attribués à votre application Salesforce Connected. L'ID client et le secret du client sont utilisés comme informations d'authentification stockées dans un AWS Secrets Manager secret. Consultez [la documentation Salesforce sur les applications connectées](https://help.salesforce.com/s/articleView?id=sf.connected_app_overview.htm&type=5) pour plus d'informations.
**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).
+ Vous avez copié l'URL de l'instance Salesforce que vous souhaitez indexer. Il s'agit généralement de *https://.salesforce.com/*. Le serveur doit exécuter une application connectée à Salesforce.
+ Vous avez ajouté des informations d'identification à votre serveur Salesforce pour un utilisateur ayant un accès en lecture seule à Salesforce en clonant le ReadOnly profil, puis en ajoutant les autorisations Afficher toutes les données et Gérer les articles. Ces informations d'identification identifient l'utilisateur qui établit la connexion et l'application connectée Salesforce à laquelle Amazon Kendra elle se connecte.
+ Il est vérifié que chaque document est unique dans Salesforce et dans 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 votreCompte 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'authentification Salesforce 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 données Salesforce à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 données Salesforce, vous devez fournir les informations nécessaires sur votre source de données Salesforce afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Salesforce pour Amazon Kendra voir[Conditions préalables](#prerequisites-v2-salesforce).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Salesforce** :
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Salesforce**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Salesforce** 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. **URL Salesforce** —Entrez l'URL de l'instance du site Salesforce que vous souhaitez indexer.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. Entrez un secret existant ou, si vous en créez un nouveau, une fenêtre de AWS Secrets Manager secret s'ouvre.
1. **Authentification** : entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Salesforce-» est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur**, le **mot de passe**, le **jeton de sécurité**, la **clé** du client, le **secret du consommateur** et **l'URL d'authentification**, entrez les valeurs d'identification d'authentification que vous avez générées et téléchargées depuis votre compte Salesforce.
**Note**
Si vous utilisez Salesforce Developer Edition, utilisez `https://login.salesforce.com/services/oauth2/token` l'URL de connexion My Domain (par exemple* https://MyCompany.my.salesforce.com*) comme **URL d'authentification**. Si vous utilisez Salesforce Sandbox Edition, utilisez `https://test.salesforce.com/services/oauth2/token ` l'URL de connexion My Domain (par exemple* MyDomainName--SandboxName.sandbox.my.salesforce.com*) comme **URL d'authentification**.
1. Choisissez **Enregistrer l'authentification**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. Pour analyser **les pièces jointes** : sélectionnez cette option pour analyser tous les objets Salesforce attachés.
1. Pour les **objets standard, les** **objets standard avec pièces jointes** et les **objets standard sans pièce jointe** et **articles de connaissances**, sélectionnez les entités ou les types de contenu Salesforce que vous souhaitez analyser.
1. Vous devez fournir des informations de configuration pour indexer au moins un objet standard, des articles de connaissances ou des fils de membres de la discussion. Si vous choisissez d'explorer les **articles de connaissances**, vous devez spécifier les types d'articles de connaissances à indexer. Vous pouvez choisir les versions publiées, archivées, les brouillons et les pièces jointes.
**Filtre Regex** : spécifiez un modèle d'expression régulière pour inclure des éléments de catalogue spécifiques.
1. Pour une **configuration supplémentaire** :
+ **Informations ACL** Toutes les listes de contrôle d'accès sont incluses par défaut. La désélection d'une liste de contrôle d'accès rendra publics tous les fichiers de cette catégorie.
+ **Modèles Regex** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains fichiers. Vous pouvez ajouter jusqu’à 100 modèles.
**Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Pour **l'article de connaissance standard****, les pièces jointes aux objets standard** 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.
**Note**
Un index mappé à `_document_body` est requis. Vous ne pouvez pas modifier le mappage entre le `Salesforce ID` champ et le Amazon Kendra `_document_id ` champ. Vous pouvez associer n'importe quel champ Salesforce au titre du document ou aux champs d' reserved/default index Amazon Kendra du corps du document.
Si vous associez un champ Salesforce aux champs du titre et du corps du document Amazon Kendra, Amazon Kendra utilisera les données du titre et des champs du corps du document dans les réponses de recherche.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 à Salesforce**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `SALESFORCEV2` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **URL de l'hôte** : spécifiez l'URL de l'hôte de l'instance Salesforce.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon secret (ARN)** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification de votre compte Salesforce. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"authenticationUrl": "OAUTH endpoint that Amazon Kendra connects to get an OAUTH token",
"consumerKey": "Application public key generated when you created your Salesforce application",
"consumerSecret": "Application private key generated when you created your Salesforce application",
"password": "Password associated with the user logging in to the Salesforce instance",
"securityToken": "Token associated with the user account logging in to the Salesforce instance",
"username": "User name of the user logging in to the Salesforce instance"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment 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 connecteur Salesforce etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles pour les sources de données Salesforce](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure ou exclure certains documents, comptes, campagnes, cas, contacts, prospects, opportunités, solutions, tâches, groupes, chatteurs et fichiers d'entités personnalisés.
**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.
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Salesforce à vos champs d'Amazon Kendraindex. 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.
**Note**
Un index mappé à `_document_body` est requis. Vous ne pouvez pas modifier le mappage entre le `Salesforce ID` champ et le Amazon Kendra `_document_id ` champ. Vous pouvez associer n'importe quel champ Salesforce au titre du document ou aux champs d' reserved/default index Amazon Kendra du corps du document.
Si vous associez un champ Salesforce aux champs du titre et du corps du document Amazon Kendra, Amazon Kendra utilisera les données du titre et des champs du corps du document dans les réponses de recherche.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du modèle Salesforce](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-salesforce-schema).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Salesforce, consultez :
+ [Annonce de la mise à jour du connecteur Salesforce (V2) pour Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-updated-salesforce-connector-v2-for-amazon-kendra/)
## Remarques
+ Lorsque les listes de contrôle d'accès (ACLs) sont activées, l'option « Synchroniser uniquement le contenu nouveau ou modifié » n'est pas disponible en raison des limites de l'API Salesforce. Nous vous recommandons d'utiliser plutôt les modes « Synchronisation complète » ou « Synchronisation du contenu nouveau, modifié ou supprimé », ou de les désactiver ACLs si vous devez utiliser ce mode de synchronisation.
# ServiceNow
ServiceNow fournit un système de gestion des services basé sur le cloud pour créer et gérer des flux de travail au niveau de l'organisation, tels que les services informatiques, les systèmes de billetterie et le support. Vous pouvez l'utiliser Amazon Kendra pour indexer vos ServiceNow catalogues, articles de connaissances, incidents et leurs pièces jointes.
Vous pouvez vous connecter Amazon Kendra à votre source de ServiceNow données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/), de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API ou de l'[ServiceNowConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html)API.
Amazon Kendrapossède deux versions du ServiceNow connecteur. Les fonctionnalités prises en charge par chaque version incluent :
**ServiceNow connecteur V1.0/API [ServiceNowConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html)**
+ Mappages de champs
+ ServiceNow versions d'instance : Londres, Autres
+ Filtres d’inclusion et d’exclusion
**ServiceNow connecteur V2.0/API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ ServiceNow versions d'instance : Rome, Sandiego, Tokyo, autres
+ Cloud privé virtuel (VPC)
**Note**
ServiceNow le connecteur V1.0/ ServiceNowConfiguration API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le ServiceNow connecteur TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra ServiceNow données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [ServiceNow connecteur V1.0](data-source-v1-servicenow.md)
+ [ServiceNow connecteur V2.0](data-source-v2-servicenow.md)
+ [Spécification des documents à indexer à l'aide d'une requête](servicenow-query.md)
# ServiceNow connecteur V1.0
ServiceNow fournit un système de gestion des services basé sur le cloud pour créer et gérer des flux de travail au niveau de l'organisation, tels que les services informatiques, les systèmes de billetterie et le support. Vous pouvez l'utiliser Amazon Kendra pour indexer vos ServiceNow catalogues, vos articles de connaissances et leurs pièces jointes.
**Note**
ServiceNow le connecteur V1.0/ ServiceNowConfiguration API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le ServiceNow connecteur TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra ServiceNow données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v1-servicenow)
+ [Conditions préalables](#prerequisites-v1-servicenow)
+ [Instructions de connexion](#data-source-procedure-v1-servicenow)
+ [En savoir plus](#servicenow-v1-learn-more)
## Fonctionnalités prises en charge
Amazon KendraServiceNow le connecteur de source de données prend en charge les fonctionnalités suivantes :
+ ServiceNow versions d'instance : Londres, Autres
+ Modèles d'inclusion/exclusion : catalogues de services, articles de connaissances et leurs pièces jointes
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de ServiceNow données, apportez ces modifications à vos AWS comptes ServiceNow and.
**Dans ServiceNow, assurez-vous d'avoir :**
+ J'ai créé un compte ServiceNow administrateur et j'ai créé une ServiceNow instance.
+ Vous avez copié l'URL de l'hôte de votre ServiceNow instance. Par exemple, si l'URL de l'instance est*https://your-domain.service-now.com*, le format de l'URL hôte que vous entrez est le suivant*your-domain.service-now.com*.
+ Vous avez noté vos informations d'authentification de base contenant un nom d'utilisateur et un mot de passe pour vous Amazon Kendra permettre de vous connecter à votre ServiceNow instance.
**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).
+ **Facultatif :** configuration d'un jeton d'identification OAuth 2.0 capable d'identifier Amazon Kendra et de générer un nom d'utilisateur, un mot de passe, un identifiant client et un secret client. Le nom d'utilisateur et le mot de passe doivent permettre d'accéder à la base de ServiceNow connaissances et au catalogue de services. Consultez [ServiceNow la documentation sur l'authentification OAuth 2.0](https://www.servicenow.com/docs/bundle/utah-platform-security/page/integrate/single-sign-on/concept/c_Authentication.html) pour plus d'informations.
+ Les autorisations suivantes ont été ajoutées :
+ kb\$1category
+ kb\$1knowledge
+ kb\$1knowledge\$1base
+ kb\$1uc\$1ne peut pas lire le mtom
+ kb\$1uc\$1can\$1read\$1mtom
+ sc\$1catalog
+ sc\$1category
+ sc\$1cat\$1item
+ sys\$1attachment
+ sys\$1attachment\$1doc
+ rôle\$1utilisateur système
+ Il est vérifié que chaque document est unique dans ServiceNow 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 votreCompte 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' ServiceNow 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 ServiceNow 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 ServiceNow données, vous devez fournir les informations nécessaires sur votre source de ServiceNow données afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré ServiceNow pour Amazon Kendra voir[Conditions préalables](#prerequisites-v1-servicenow).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à ServiceNow**
1. Connectez-vous à la console AWS de gestion et [Amazon Kendraouvrez-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 le **ServiceNowconnecteur V1.0**, puis sélectionnez **Ajouter une source de données**.
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 tirets, 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. **ServiceNow host** —Entrez l'URL de l' ServiceNowhôte.
1. **ServiceNow version** —Sélectionnez votre ServiceNow version.
1. Choisissez entre **l'authentification de base et l'authentification** **Oauth 2.0 en fonction de votre cas d'**utilisation.
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations ServiceNow d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - ServiceNow - » est automatiquement ajouté à votre nom secret.
1. Si vous utilisez l'authentification de base, entrez le **nom secret, le nom** **d'utilisateur** et le mot de **passe de votre compte**. ServiceNow
Si vous utilisez l' OAuth2 authentification, entrez le **nom secret, le nom** **d'utilisateur**, le **mot de passe**, l'**identifiant client** et le **secret client** que vous avez créés dans votre compte. ServiceNow
1. Choisissez **Enregistrer et ajouter un secret**.
1. **IAMrô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**
IAMles 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. **Inclure les articles de connaissances** : choisissez d'indexer les articles de connaissances.
1. **Type d'articles de connaissances** : choisissez entre **Inclure uniquement les articles publics** et **Inclure les articles en fonction d'une requête de ServiceNow filtrage** basée sur votre cas d'utilisation. Si vous sélectionnez **Inclure les articles en fonction d'une requête de ServiceNow filtre**, vous devez saisir une **requête de filtre** copiée depuis votre ServiceNow compte.
1. **Inclure les pièces jointes aux articles de connaissances** : choisissez d'indexer les pièces jointes aux articles de connaissances. Vous pouvez également sélectionner des types de fichiers spécifiques à indexer.
1. **Inclure les éléments du catalogue** : choisissez d'indexer les éléments du catalogue.
1. **Inclure les pièces jointes aux éléments du catalogue** : choisissez d'indexer les pièces jointes aux éléments du catalogue. Vous pouvez également sélectionner des types de fichiers spécifiques à indexer.
1. **Fréquence : fréquence** Amazon Kendra de synchronisation avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Articles de connaissances** et **catalogue de services** : sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés et les mappages de champs suggérés supplémentaires que vous souhaitez mapper à votre index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à ServiceNow**
Vous devez spécifier les éléments suivants à l'aide de l'[ServiceNowConfiguration API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html) :
+ **URL de la source de données** : spécifiez l' ServiceNow URL. Le point de terminaison de l'hôte doit ressembler à ce qui suit :*your-domain.service-now.com*.
+ **Instance hôte de source de données** : spécifiez la version de l'instance ServiceNow hôte sous la forme `LONDON` ou`OTHERS`.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre ServiceNow compte.
Si vous utilisez l'authentification de base, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password"
}
```
Si vous utilisez l' OAuth2 authentification, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
}
```
+ **IAMrole** —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 ServiceNow connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de ServiceNow 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 :
+ **Mappages de champs : choisissez de mapper** les champs de votre source de ServiceNow données à vos champs d'Amazon Kendraindex. 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.
+ **Filtres d'inclusion et d'exclusion** : indiquez si vous souhaitez inclure ou exclure certaines pièces jointes de catalogues et d'articles de connaissances.
**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.
+ **Paramètres d'indexation** : vous pouvez également choisir de spécifier si vous souhaitez :
+ Indexez les articles de connaissances et les catalogues de services, ou les deux. Si vous choisissez d'indexer des articles de connaissances et des éléments du catalogue de services, vous devez fournir le nom du ServiceNow champ mappé au champ de contenu du document d'index dans l'Amazon Kendraindex.
+ Indexez les pièces jointes aux articles de connaissances et aux éléments du catalogue.
+ Utilisez une ServiceNow requête qui sélectionne des documents dans une ou plusieurs bases de connaissances. Les bases de connaissances peuvent être publiques ou privées. Pour plus d'informations, veuillez consulter la rubrique [Spécification des documents à indexer avec une requête](https://docs.aws.amazon.com/kendra/latest/dg/servicenow-query.html).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de ServiceNow données, consultez :
+ [Commencer à utiliser le connecteur Amazon Kendra ServiceNow en ligne](https://aws.amazon.com/blogs/machine-learning/getting-started-with-amazon-kendra-servicenow-online-connector/)
# ServiceNow connecteur V2.0
ServiceNow fournit un système de gestion des services basé sur le cloud pour créer et gérer des flux de travail au niveau de l'organisation, tels que les services informatiques, les systèmes de billetterie et le support. Vous pouvez l'utiliser Amazon Kendra pour indexer vos ServiceNow catalogues, articles de connaissances, incidents et leurs pièces jointes.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra ServiceNow données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v2-servicenow)
+ [Conditions préalables](#prerequisites-v2-servicenow)
+ [Instructions de connexion](#data-source-procedure-v2-servicenow)
+ [En savoir plus](#servicenow-learn-more)
## Fonctionnalités prises en charge
Amazon KendraServiceNow le connecteur de source de données prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ ServiceNow versions d'instance : Rome, Sandiego, Tokyo, autres
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de ServiceNow données, apportez ces modifications à vos AWS comptes ServiceNow and.
**Dans ServiceNow, assurez-vous d'avoir :**
+ créé une instance de développeur personnelle ou d’entreprise et disposer d’une instance ServiceNow dotée d’un rôle administratif ;
+ Vous avez copié l'URL de l'hôte de votre ServiceNow instance. Le format de l'URL d'hôte que vous entrez est*your-domain.service-now.com*. Vous avez besoin de l’URL de votre instance ServiceNow pour vous connecter à Amazon Kendra ;
+ Vous avez pris note de vos informations d'authentification de base, à savoir un nom d'utilisateur et un mot de passe Amazon Kendra pour autoriser la connexion à votre ServiceNow instance.
**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).
+ **Facultatif :** informations d'identification client OAuth 2.0 configurées qui peuvent être identifiées à l'Amazon Kendraaide d'un nom d'utilisateur, d'un mot de passe, d'un identifiant client généré et d'un secret client. Consultez [ServiceNow la documentation sur l'authentification OAuth 2.0](https://www.servicenow.com/docs/bundle/utah-platform-security/page/integrate/single-sign-on/concept/c_Authentication.html) pour plus d'informations.
+ Les autorisations suivantes ont été ajoutées :
+ kb\$1category
+ kb\$1knowledge
+ kb\$1knowledge\$1base
+ kb\$1uc\$1ne peut pas lire le mtom
+ kb\$1uc\$1can\$1read\$1mtom
+ sc\$1catalog
+ sc\$1category
+ sc\$1cat\$1item
+ sys\$1attachment
+ sys\$1attachment\$1doc
+ rôle\$1utilisateur système
+ Il est vérifié que chaque document est unique dans ServiceNow 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 votreCompte 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' ServiceNow 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 ServiceNow 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 ServiceNow données, vous devez fournir les informations nécessaires sur votre source de ServiceNow données afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré ServiceNow pour Amazon Kendra voir[Conditions préalables](#prerequisites-v2-servicenow).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à ServiceNow**
1. Connectez-vous à la [Amazon Kendraconsole 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 **ServiceNow connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **ServiceNow 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 tirets, 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. **ServiceNow host** —Entrez l'URL de l' ServiceNowhôte. Le format de l'URL d'hôte que vous entrez est*your-domain.service-now.com*.
1. **ServiceNow version** —Sélectionnez la version de votre ServiceNow instance. Vous pouvez choisir entre Rome, Sandiego, Tokyo ou autres.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **Authentification** : choisissez entre **l'authentification de base et l'authentification** **Oauth 2.0.**
1. **AWSSecrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations ServiceNow d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre. Saisissez les informations suivantes dans la fenêtre :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - ServiceNow - » est automatiquement ajouté à votre nom secret.
1. Si vous utilisez l'authentification de base, entrez le **nom secret, le nom** **d'utilisateur** et le mot de **passe de votre compte**. ServiceNow
Si vous utilisez l'authentification OAuth2 .0, entrez le **nom secret, le nom** **d'utilisateur**, le mot de **passe**, l'**identifiant client** et le **secret client** que vous avez créés dans votre compte. ServiceNow
1. Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. Pour les **Articles de connaissances**, choisissez l’une des options suivantes :
+ **Articles de connaissances** : choisissez d'indexer les articles de connaissances.
+ **Pièces jointes aux articles de connaissances** : choisissez d'indexer les pièces jointes aux articles de connaissances.
+ **Type d'articles de connaissances** : choisissez entre **uniquement les articles publics et les articles** de **connaissances en fonction d'une requête de ServiceNow filtrage** basée sur votre cas d'utilisation. Si vous sélectionnez **Inclure les articles en fonction d'une requête de ServiceNow filtre**, vous devez saisir une **requête de filtre** copiée depuis votre ServiceNow compte. Les exemples de requêtes de filtrage incluent :*workflow\$1state=draft^EQ*,*kb\$1knowledge\$1base=dfc19531bf2021003f07e2c1ac0739ab^text ISNOTEMPTY^EQ*,*article\$1type=text^active=true^EQ*.
**Important**
Si vous choisissez d'explorer **uniquement les articles publics, n'Amazon Kendraexplore que les articles** de connaissances auxquels un rôle d'accès public a été attribué dans. ServiceNow
+ **Inclure des articles en fonction d'un filtre de brève description** : spécifiez des modèles d'expressions régulières pour inclure ou exclure des articles spécifiques.
1. Pour les **Éléments du catalogue de services** :
+ **Articles du catalogue de services** : choisissez d'indexer les articles du catalogue de services.
+ **Pièces jointes des articles du catalogue de services** : choisissez d'indexer les pièces jointes des articles du catalogue de services.
+ **Éléments du catalogue de services actifs** : choisissez d'indexer les éléments du catalogue de services actifs.
+ **Éléments du catalogue de services inactifs** : choisissez d'indexer les éléments du catalogue de services inactifs.
+ **Requête de filtre** : choisissez d'inclure les éléments du catalogue de services en fonction d'un filtre défini dans votre ServiceNow instance. Les exemples de requêtes de filtrage incluent :*short\$1descriptionLIKEAccess^category=2809952237b1300054b6a3549dbe5dd4^EQ*,*nameSTARTSWITHService^active=true^EQ*.
+ **Inclure les éléments du catalogue de services en fonction d'un filtre de brève description** : spécifiez un modèle d'expression régulière pour inclure des articles de catalogue spécifiques.
1. Pour les **Incidents** :
+ **Incidents** : choisissez d'indexer les incidents de service.
+ **Pièces jointes aux incidents** : choisissez d'indexer les pièces jointes aux incidents.
+ **Incidents actifs** : choisissez d'indexer les incidents actifs.
+ **Incidents inactifs** : choisissez d'indexer les incidents inactifs.
+ **Type d'incident actif** : choisissez entre **Tous les incidents, Incidents** **ouverts, Incidents** **non assignés et Incidents** **résolus en fonction de votre cas** d'utilisation.
+ **Requête de filtre** : choisissez d'inclure les incidents en fonction d'un filtre défini dans votre ServiceNow instance. Les exemples de requêtes de filtrage incluent :*short\$1descriptionLIKETest^urgency=3^state=1^EQ*,*priority=2^category=software^EQ *.
+ **Inclure les incidents en fonction d'un filtre de brève description** : spécifiez un modèle d'expression régulière pour inclure des incidents spécifiques.
1. Pour une **configuration supplémentaire** :
+ **Informations ACL** : les listes de contrôle d'accès pour les entités que vous avez sélectionnées sont incluses par défaut. La désélection d'une liste de contrôle d'accès rendra publics tous les fichiers de cette catégorie. Les options ACL sont automatiquement désactivées pour les entités non sélectionnées. Pour les articles publics, l'ACL n'est pas appliquée.
+ Pour la **taille de fichier maximale** : spécifiez la taille limite de fichier MBs qu'Amazon Kendra explorera. Amazon Kendra explorera uniquement les fichiers dans la limite de taille que vous avez définie. La taille de fichier par défaut est de 50 Mo. La taille de fichier maximale doit être supérieure à 0 Mo et inférieure ou égale à 50 Mo.
+ **Modèles d'expressions régulières pour pièces jointes** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains fichiers joints de catalogues, d'articles de connaissances et d'incidents. Vous pouvez ajouter jusqu’à 100 modèles.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Mappages de champs par défaut** : 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à ServiceNow**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `SERVICENOWV2` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **URL de l'hôte** : spécifiez la version de l'instance ServiceNow hôte. Par exemple, *your-domain.service-now.com*.
+ **Type d'authentification** : spécifiez le type d'authentification que vous utilisez, que ce soit `basicAuth` ou `OAuth2` pour votre ServiceNow instance.
+ **ServiceNow version de l'instance** —Spécifiez l' ServiceNow instance que vous utilisez`Tokyo`, si`Sandiego`,`Rome`, ou`Others`.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre ServiceNow compte.
Si vous utilisez l'authentification de base, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password"
}
```
+ Si vous utilisez les informations d'identification du OAuth2 client, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
}
```
+ **IAMrole** —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 ServiceNow connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de ServiceNow 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 :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure ou exclure certains fichiers joints en utilisant les noms de fichiers et les types de fichiers des articles de connaissances, des catalogues de services et des incidents.
**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.
+ **Documents spécifiques à indexer** : vous pouvez utiliser une ServiceNow requête pour spécifier les documents que vous souhaitez obtenir à partir d'une ou de plusieurs bases de connaissances, y compris les bases de connaissances privées. L'accès aux bases de connaissances est déterminé par l'utilisateur que vous utilisez pour vous connecter à l' ServiceNow instance. Pour plus d'informations, veuillez consulter la rubrique [Spécification des documents à indexer avec une requête](https://docs.aws.amazon.com//kendra/latest/dg/servicenow-query.html).
+ **Paramètres d'indexation** : vous pouvez également choisir de spécifier si vous souhaitez :
+ Indexez les articles de connaissances, les catalogues de services et les incidents, ou tous ces éléments. Si vous choisissez d'indexer des articles de connaissances, des éléments du catalogue de services et des incidents, vous devez fournir le nom du ServiceNow champ mappé au champ de contenu du document d'index dans l'Amazon Kendraindex.
+ Indexez les pièces jointes aux articles de connaissances, aux éléments du catalogue de services et aux incidents.
+ Incluez des articles de connaissances, des éléments du catalogue de services et des incidents en fonction du modèle de `short description` filtre.
+ Choisissez de filtrer les articles et incidents du catalogue de services actifs et inactifs.
+ Choisissez de filtrer les incidents en fonction du type d'incident.
+ Choisissez les entités dont l'ACL doit être analysée.
+ Vous pouvez utiliser une ServiceNow requête pour spécifier les documents que vous souhaitez obtenir à partir d'une ou de plusieurs bases de connaissances, y compris des bases de connaissances privées. L'accès aux bases de connaissances est déterminé par l'utilisateur que vous utilisez pour vous connecter à l' ServiceNowinstance. Pour plus d'informations, veuillez consulter la rubrique [Spécification des documents à indexer avec une requête](https://docs.aws.amazon.com//kendra/latest/dg/servicenow-query.html).
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de ServiceNow données à vos champs d'Amazon Kendraindex. 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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du ServiceNow modèle](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-servicenow-schema).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de ServiceNow données, consultez :
+ [Commencer à Amazon Kendra annoncer le ServiceNow connecteur mis à jour (V2) pour Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-updated-servicenow-connector-v2-for-amazon-kendra/)
# Spécification des documents à indexer à l'aide d'une requête
Vous pouvez utiliser une ServiceNow requête pour spécifier les documents que vous souhaitez inclure dans un Amazon Kendra index. Lorsque vous utilisez une requête, vous pouvez spécifier plusieurs bases de connaissances, y compris des bases de connaissances privées. L'accès aux bases de connaissances est déterminé par l'utilisateur que vous utilisez pour vous connecter à l' ServiceNow instance.
Pour créer une requête, vous devez utiliser le générateur de ServiceNow requêtes. Vous pouvez utiliser le générateur pour créer la requête et vérifier qu'elle renvoie la bonne liste de documents.
**Pour créer une requête à l'aide de la ServiceNow console**
1. Connectez-vous à la ServiceNow console.
1. Dans le menu de gauche, choisissez **Connaissances**, puis **Articles**, puis choisissez **Tout**.
1. En haut de la page, choisissez l'icône du filtre.
1. Utilisez le générateur de requêtes pour créer la requête.
1. Lorsque la requête est terminée, cliquez avec le bouton droit sur la requête et choisissez **Copier la requête** pour copier la requête depuis le générateur de requêtes. Enregistrez cette requête pour l'utiliser dansAmazon Kendra.
![\[Query builder interface showing Knowledge base filters with options to run, save, and copy query.\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/images/ServiceNowQuery.png)
Assurez-vous de ne modifier aucun paramètre de requête lorsque vous copiez la requête. Si l'un des paramètres de requête n'est pas reconnu, ServiceNow traite le paramètre comme vide et ne l'utilise pas pour filtrer les résultats.
# Slack
Slack est une application de communication d’entreprise qui permet aux utilisateurs d’envoyer des messages et des pièces jointes via différents canaux publics et privés. Vous pouvez l'utiliser Amazon Kendra pour indexer vos chaînes publiques et privées Slack, envoyer et archiver des messages, des fichiers et des pièces jointes, des messages directs et de groupe. Vous pouvez également choisir un contenu spécifique à filtrer.
**Note**
Amazon Kendraprend désormais en charge un connecteur Slack amélioré.
La console a été automatiquement mise à niveau pour vous. Tous les nouveaux connecteurs que vous créez dans la console utiliseront l'architecture mise à niveau. Si vous utilisez l'API, vous devez désormais utiliser l'[https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objet au lieu de l'`SlackConfiguration`objet pour configurer votre connecteur.
Les connecteurs configurés à l'aide de l'ancienne console et de l'ancienne architecture d'API continueront de fonctionner tels qu'ils ont été configurés. Toutefois, vous ne pourrez ni les modifier ni les mettre à jour. Si vous souhaitez modifier ou mettre à jour la configuration de votre connecteur, vous devez créer un nouveau connecteur.
Nous vous recommandons de migrer le flux de travail de votre connecteur vers la version mise à niveau. Support pour les connecteurs configurés à l'aide de l'ancienne architecture devrait prendre fin en juin 2024.
Vous pouvez vous connecter Amazon Kendra à votre source de données Slack à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) ou de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Slack, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-slack)
+ [Conditions préalables](#prerequisites-slack)
+ [Instructions de connexion](#data-source-procedure-slack)
+ [En savoir plus](#slack-learn-more)
## Fonctionnalités prises en charge
Amazon KendraLe connecteur de source de données Slack prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Slack, apportez ces modifications à votre compte Slack et AWS à vos comptes.
**Dans Slack, assurez-vous d'avoir :**
+ Vous avez configuré un OAuth jeton utilisateur Slack Bot ou un jeton utilisateur OAuth Slack. Vous pouvez choisir l'un ou l'autre des jetons pour vous connecter Amazon Kendra à votre source de données Slack. Un jeton est requis comme identifiant d'authentification. Consultez la [Documentation Slack sur les jetons d’accès](https://api.slack.com/authentication/token-types) pour plus d’informations.
**Note**
Si vous utilisez le jeton de bot dans vos informations d'identification Slack, vous ne pouvez pas indexer les messages directs et les messages de groupe et vous devez ajouter le jeton de bot à la chaîne que vous souhaitez indexer.
**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).
+ Vous avez noté votre identifiant d'équipe Slack sur l'URL de la page principale de votre espace de travail Slack. Par exemple, *https://app.slack.com/client/T0123456789/... * où se *T0123456789* trouve l'identifiant de l'équipe ?
+ Les étendues et autorisations Oauth suivantes ont été ajoutées :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/data-source-slack.html)
+ Il est vérifié que chaque document est unique dans Slack et dans 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 votreCompte 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'authentification Slack 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 données Slack à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 données Slack, vous devez fournir les informations nécessaires sur votre source de données Slack afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Slack pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-slack).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Slack**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Slack**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Slack** avec le tag « 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 tirets, 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. Pour l'**identifiant d'équipe de l'espace de travail Slack** : l'identifiant d'équipe de votre espace de travail Slack. Vous trouverez votre identifiant d'équipe sur l'URL de la page principale de votre espace de travail Slack. Par exemple, *https://app.slack.com/client/T0123456789/...* où se *T0123456789* trouve l'identifiant de l'équipe ?
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Slack. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Slack » est automatiquement ajouté à votre nom secret.
1. Pour le **jeton Slack** : entrez les valeurs des informations d'authentification que vous avez configurées dans Slack.
1. Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. **Sélectionnez le type de contenu** : sélectionnez les entités ou les types de contenu Slack que vous souhaitez analyser. Vous pouvez choisir parmi toutes les chaînes, les chaînes publiques, les chaînes privées, les messages de groupe et les messages privés.
1. **Sélectionnez la date de début** de l'analyse : entrez la date à laquelle vous souhaitez commencer à analyser votre contenu.
1. Pour une **configuration supplémentaire** : choisissez d'inclure les messages du bot et les messages archivés et d'utiliser des modèles d'expressions régulières pour inclure ou exclure certains contenus.
**Note**
Si vous choisissez d'inclure à la fois les noms des chaînes IDs et des chaînes, le connecteur Amazon Kendra Slack donnera la priorité aux chaînes IDs par rapport aux noms de chaînes.
Si vous avez choisi d'inclure certains messages privés et de groupe, le connecteur Amazon Kendra Slack ignorera tous les messages privés et de groupe et n'analysera que les messages privés et de groupe que vous spécifiez.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 depuis 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 à Slack**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-slack) à l'aide de l'[https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `SLACK` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ ID d'équipe **Slack Workspace : identifiant d'équipe** Slack que vous avez copié à partir de l'URL de votre page principale de Slack.
+ **Depuis la date** : date à laquelle vous avez commencé à analyser vos données auprès de votre équipe Slack Workspace. La date doit suivre ce format : yyyy-mm-dd.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ `CHANGE_LOG`pour indexer uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **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 compte Slack. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"slackToken": "token"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour fournir à un IAM rôle l'autorisation d'accéder à votre Secrets Manager secret et d'appeler le public requis APIs pour le connecteur Slack et. Amazon Kendra Pour plus d'informations, consultez la section [IAMRôles des sources de données Slack](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Chaînes spécifiques** : filtrez par chaînes publiques ou privées et spécifiez certaines chaînes en fonction de leur identifiant.
+ **Types de chaînes et de messages** : indiquez si vous Amazon Kendra devez indexer vos chaînes publiques et privées, vos messages de groupe et directs, ainsi que votre bot et vos messages archivés. Si vous utilisez un jeton de bot dans le cadre de vos identifiants d'authentification Slack, vous devez ajouter le jeton de bot à la chaîne que vous souhaitez indexer. Vous ne pouvez pas indexer les messages directs et les messages de groupe à l'aide d'un jeton de bot.
+ **Rétrospective** : vous pouvez choisir de configurer un `lookBack` paramètre afin que le connecteur Slack analyse le contenu mis à jour ou supprimé jusqu'à un certain nombre d'heures avant la dernière synchronisation de votre connecteur.
+ **Filtres d'inclusion et d'exclusion** : indiquez si vous souhaitez inclure ou exclure certains contenus de Slack. Si vous utilisez un jeton de bot dans le cadre de vos identifiants d'authentification Slack, vous devez ajouter le jeton de bot à la chaîne que vous souhaitez indexer. Vous ne pouvez pas indexer les messages directs et les messages de groupe à l'aide d'un jeton de bot.
**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 données Slack à vos Amazon Kendra champs d'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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du Slack modèle](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-slack).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Slack, consultez :
+ [Exploitez les connaissances des espaces de travail Slack grâce à la recherche intelligente à l'aide du connecteur Slack Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/unravel-the-knowledge-in-slack-workspaces-with-intelligent-search-using-the-amazon-kendra-slack-connector/)
# Zendesk
Zendesk est un système de gestion de la relation client qui aide les entreprises à automatiser et à améliorer les interactions avec le service client. Vous pouvez l'utiliser Amazon Kendra pour indexer vos tickets d'assistance Zendesk, les commentaires sur les tickets, les pièces jointes aux tickets, les articles du centre d'aide, les commentaires d'articles, les pièces jointes aux commentaires d'articles, les sujets de la communauté des guides, les publications communautaires et les commentaires des publications communautaires.
Vous pouvez filtrer par nom d'organisation si vous souhaitez indexer les tickets qui concernent uniquement une organisation spécifique. Vous pouvez également choisir de définir une date d'exploration à laquelle vous souhaitez commencer à explorer les données de Zendesk.
Vous pouvez vous connecter Amazon Kendra à votre source de données Zendesk à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Zendesk, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-zendesk)
+ [Conditions préalables](#prerequisites-zendesk)
+ [Instructions de connexion](#data-source-procedure-zendesk)
+ [En savoir plus](#zendesk-learn-more)
+ [Remarques](#zendesk-notes)
## Fonctionnalités prises en charge
Amazon KendraLe connecteur de source de données Zendesk prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès des utilisateurs
+ Filtres d’inclusion et d’exclusion
+ Journal des modifications, synchronisation complète et incrémentielle du contenu
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir l'utiliser Amazon Kendra pour indexer votre source de données Zendesk, apportez ces modifications à votre Zendesk et AWS à vos comptes.
**Dans Zendesk, assurez-vous d'avoir :**
+ Création d'un compte administratif Zendesk Suite (Professional/Enterprise).
+ Vous avez noté l'URL de votre hôte Zendesk. Par exemple, *https://\$1sub-domain\$1.zendesk.com/*.
**Note**
(Sur place/sur serveur) Amazon Kendra vérifie si les informations de point de terminaison incluses sont les mêmes AWS Secrets Manager que celles spécifiées dans les détails de configuration de votre source de données. Cela permet de se protéger contre le [problème de confusion des adjoints](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), qui est un problème de sécurité lorsqu'un utilisateur n'est pas autorisé à effectuer une action mais l'utilise Amazon Kendra comme proxy pour accéder au secret configuré et exécuter l'action. Si vous modifiez ultérieurement les informations de votre point de terminaison, vous devez créer un nouveau secret pour synchroniser ces informations.
+ Configurez l'authentification OAuth 2.0 à l'aide du flux d'octroi du code d'autorisation :
1. Dans le Centre d'administration, accédez à Applications et intégrations > APIs > API Zendesk.
1. Sélectionnez l'onglet OAuth Clients et cliquez sur « Ajouter un OAuth client ».
1. Configurez les OAuth détails du client : définissez le nom et la description du client, définissez le type de client sur « Confidentiel », ajoutez la redirection appropriée URLs (par exemple, https://localhost/callback pour les tests), enregistrez et stockez en toute sécurité l'identifiant client et le secret client générés.
1. Assurez-vous que le OAuth client dispose de l'étendue « lecture » requise (ou « lecture-écriture » si vous avez besoin d'un accès en écriture).
1. Générez un jeton d'accès à l'aide du flux d'octroi du code d'autorisation :
+ Dans un navigateur, accédez à : `https://{subdomain}.zendesk.com/oauth/authorizations/new?response_type=code&client_id={your_client_id}&redirect_uri={your_redirect_uri}&scope=read`
+ Authentifiez et autorisez l'application lorsque vous y êtes invité.
+ Après autorisation, Zendesk redirige vers le redirect\$1uri avec un paramètre de code (par exemple, le code d'autorisation). https://localhost/callback?code=\$1authorization\$1code\$1). Copy
+ Échangez le code d'autorisation contre un jeton d'accès en envoyant une demande POST au point de terminaison du jeton de Zendesk :
```
curl -X POST https://{subdomain}.zendesk.com/oauth/tokens \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=authorization_code&code={authorization_code}&client_id={your_client_id}&client_secret={your_client_secret}&redirect_uri={your_redirect_uri}&scope=read"
```
+ Zendesk répond avec un objet JSON contenant le access\$1token. Extrayez et stockez en toute sécurité ce jeton d'accès.
1. Stockez le jeton d'accès généré en toute sécurité. Ce jeton d'accès sera utilisé pour l'intégration de Kendra.
+
**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).
+ **Facultatif :** un certificat SSL a été installé Amazon Kendra pour permettre la connexion.
+ Il est vérifié que chaque document est unique dans Zendesk et dans 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 votreCompte 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'authentification Zendesk 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 données Zendesk à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 données Zendesk, vous devez fournir les informations nécessaires sur votre source de données Zendesk afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Zendesk pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-zendesk).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Zendesk**
1. Connectez-vous à la [Amazon Kendraconsole 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 le **connecteur Zendesk**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur Zendesk** 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. URL **Zendesk —Entrez votre URL** Zendesk. Par exemple, *https://\$1sub-domain\$1.zendesk.com/*.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. 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#context-filter-user-incl-datasources).
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations d'authentification Zendesk. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Créez un nouveau secret avec la structure suivante :
```
{
"hostUrl": "https://yoursubdomain.zendesk.com/",
"accessToken": "your_access_token"
}
```
**Note**
Pour l'intégration de Kendra, le nom secret doit commencer par « AmazonKendra -Zendesk-» suivi de l'identifiant que vous avez choisi (par exemple, « -Zendesk- »). AmazonKendra MyConnector
1. Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrô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**
IAMles 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. **Sélectionnez le contenu** : sélectionnez les types de contenu que vous souhaitez explorer à partir des tickets, des articles du centre d'aide, des sujets communautaires, etc.
1. **Nom de l'organisation** : entrez les noms des organisations Zendesk pour filtrer le contenu.
1. **Date de début de synchronisation** : entrez la date à partir de laquelle vous souhaitez commencer à analyser votre contenu.
1. **Modèles Regex** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains fichiers. Vous pouvez ajouter jusqu’à 100 modèles.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Nouvelle synchronisation modifiée : Indexez uniquement le contenu nouveau et modifié chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Synchroniser le calendrier d'exécution** pour **la fréquence** : choisissez la fréquence à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Champs de source de données par défaut** : 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. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
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 à Zendesk**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `ZENDESK` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **URL de l'hôte** : fournissez l'URL de votre hôte Zendesk dans le cadre de la configuration de la connexion ou des détails du point de terminaison du référentiel. Par exemple, * https://yoursubdomain.zendesk.com*.
+ **Journal des modifications** : Amazon Kendra faut-il utiliser le mécanisme du journal des modifications des sources de données Zendesk pour déterminer si un document doit être mis à jour dans l'index.
**Note**
Utilisez le journal des modifications si vous ne Amazon Kendra souhaitez pas numériser tous les documents. Si votre journal des modifications est volumineux, la numérisation des documents de la source de données Zendesk peut prendre Amazon Kendra moins de temps que le traitement du journal des modifications. Si vous synchronisez votre source de données Zendesk avec votre index pour la première fois, tous les documents sont numérisés.
+ **Nom de ressource Amazon secret (ARN)** : fournissez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification de votre compte Zendesk. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"hostUrl": "https://yoursubdomain.zendesk.com",
"clientId": "client ID",
"clientSecret": "Zendesk client secret",
"userName": "Zendesk user name",
"password": "Zendesk password"
}
```
+ **IAMrole** —Spécifiez à quel `RoleArn` moment 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 connecteur Zendesk et. Amazon Kendra Pour plus d'informations, consultez la section [IAMRôles pour les sources de données Zendesk](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Types de documents/contenus** : spécifiez si vous souhaitez explorer :
+ Tickets d'assistance, commentaires sur les and/or tickets, pièces jointes aux commentaires sur les tickets
+ Articles du centre d'aide, pièces jointes aux articles et commentaires d'articles
+ Guidez les sujets, les publications ou les commentaires de la communauté
+ **Filtres d'inclusion et d'exclusion** : indiquez si vous souhaitez inclure ou exclure certains contenus de Slack. Si vous utilisez un jeton de bot dans le cadre de vos identifiants d'authentification Slack, vous devez ajouter le jeton de bot à la chaîne que vous souhaitez indexer. Vous ne pouvez pas indexer les messages directs et les messages de groupe à l'aide d'un jeton de bot.
**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.
+ **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).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Zendesk à vos Amazon Kendra champs d'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.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du modèle Zendesk](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-zendesk).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Zendesk, consultez :
+ [Découvrez les informations de Zendesk grâce à la recherche Amazon Kendra intelligente](https://aws.amazon.com/blogs/machine-learning/discover-insights-from-zendesk-with-amazon-kendra-intelligent-search/)
## Remarques
+ Lorsque les listes de contrôle d'accès (ACLs) sont activées, l'option « Synchroniser uniquement le contenu nouveau ou modifié » n'est pas disponible en raison des limites de l'API Zendesk. Nous vous recommandons d'utiliser plutôt les modes « Synchronisation complète » ou « Synchronisation du contenu nouveau, modifié ou supprimé », ou de les désactiver ACLs si vous devez utiliser ce mode de synchronisation.
# Mappage de champs de source de données
Amazon Kendra les connecteurs de source de données peuvent mapper les champs de document ou de contenu de votre source de données aux champs de votre Amazon Kendra index. Par défaut, chaque connecteur est conçu pour analyser des champs de source de données spécifiques. Les champs de source de données par défaut et leurs propriétés ne peuvent pas être modifiés ou personnalisés. Sur la Amazon Kendra console, les champs par défaut et les propriétés des champs par défaut qui ne peuvent pas être modifiés sont grisés.
Amazon Kendra les connecteurs vous permettent également de mapper des champs de document ou de contenu personnalisés de votre source de données aux champs personnalisés de votre index. Par exemple, si votre source de données contient un champ appelé « département » qui contient les informations relatives au service d'un document, vous pouvez le mapper à un champ d'index appelé « Département ». Ainsi, vous pouvez utiliser le champ lorsque vous interrogez des documents.
Vous pouvez également mapper des champs Amazon Kendra réservés ou communs tels que`_created_at`. Si votre source de données possède un champ appelé « creation\$1date », vous pouvez le mapper au champ Amazon Kendra réservé équivalent appelé. `_created_at` Pour plus d'informations sur les champs Amazon Kendra réservés, consultez la section [Attributs ou champs du document](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html).
Vous pouvez mapper les champs de la plupart des sources de données. Vous pouvez créer des mappages de champs pour les sources de données suivantes :
+ Adobe Experience Manager
+ Alfresco
+ Aurora (MySQL)
+ Aurora (PostgreSQL)
+ Amazon FSx (Fenêtres)
+ Amazon FSx (NetApp ONTAP)
+ Amazon RDS/Aurora
+ Amazon RDS (Microsoft SQL Server)
+ Amazon RDS (MySQL)
+ Amazon RDS (Oracle)
+ Amazon RDS (PostgreSQL)
+ Amazon Kendra robot d'exploration Web
+ WorkDocs
+ Box
+ Confluence
+ Dropbox
+ Drupal
+ GitHub
+ Disques durs Google Workspace
+ Gmail
+ IBM DB2
+ Jira
+ Microsoft Exchange
+ Microsoft OneDrive
+ Microsoft SharePoint
+ Microsoft Teams
+ Microsoft SQL Server
+ Microsoft Yammer
+ MySQL
+ Oracle Database
+ PostgreSQL
+ Quip
+ Salesforce
+ ServiceNow
+ Slack
+ Zendesk
Si vous stockez vos documents dans un compartiment S3 ou une source de données S3, vous spécifiez vos champs à l'aide d'un fichier de métadonnées JSON. Pour plus d'informations, consultez la section [Connecteur de source de données S3](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html).
Le mappage des champs de votre source de données vers un champ d'index s'effectue en trois étapes :
1. Créez un index. Pour plus d'informations, consultez la section [Création d'un index](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html).
1. Mettez à jour l'index pour ajouter des champs.
1. Créez une source de données et incluez des mappages de champs pour mapper les champs réservés et tous les champs personnalisés pour Amazon Kendra indexer les champs.
Pour mettre à jour l'index afin d'ajouter des champs personnalisés, utilisez la console pour modifier les mappages de champs de la source de données et ajouter un champ personnalisé ou utilisez l'[UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API. Vous pouvez ajouter un total de 500 champs personnalisés à votre index.
Pour les sources de données de base de données, si le nom de la colonne de base de données correspond au nom d'un champ réservé, le champ et la colonne sont automatiquement mappés.
Avec l'[UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API, vous pouvez ajouter des champs réservés et personnalisés à l'aide de`DocumentMetadataConfigurationUpdates`.
L’exemple JSON suivant utilise `DocumentMetadataConfigurationUpdates` pour ajouter un champ appelé « Département » à l’index.
```
"DocumentmetadataConfigurationUpdates": [
{
"Name": "Department",
"Type": "STRING_VALUE"
}
]
```
Lorsque vous créez le champ, vous avez la possibilité de définir la manière dont le champ est utilisé pour la recherche. Sélectionnez parmi les éléments suivants :
+ **Affichable** —Détermine si le champ est renvoyé dans la réponse à la requête. La valeur par défaut est `true`.
+ **Facetable** —Indique que le champ peut être utilisé pour créer des facettes. La valeur par défaut est `false`.
+ **Consultable —Détermine si le champ est utilisé dans la recherche**. La valeur par défaut est `true` pour les champs de chaîne et `false` pour les champs de nombre et de date.
+ **Triable** —Indique que le champ peut être utilisé pour trier la réponse d'une requête. Ne peut être défini que pour les champs de date, de numéro et de chaîne. Impossible de définir les champs de liste de chaînes.
L'exemple JSON suivant permet `DocumentMetadataConfigurationUpdates` d'ajouter un champ appelé « Department » à l'index et de le marquer comme facetable.
```
"DocumentMetadataConfigurationUpdates": [
{
"Name": "Department",
"Type": "STRING_VALUE",
"Search": {
"Facetable": true
}
}
]
```
## Utilisation de champs de document Amazon Kendra réservés ou communs
Avec l'[UpdateIndex API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html), vous pouvez créer des champs réservés ou communs en utilisant `DocumentMetadataConfigurationUpdates` et en spécifiant le nom du champ d'index Amazon Kendra réservé à mapper à votre attribute/field nom de document équivalent. Vous pouvez également créer des champs personnalisés. Si vous utilisez un connecteur de source de données, la plupart incluent des mappages de champs qui font correspondre les champs de votre document de source de données aux champs d' Amazon Kendra index. Si vous utilisez la console, vous mettez à jour les champs en sélectionnant votre source de données, en sélectionnant l'action de modification, puis en passant à côté de la section des mappages de champs pour configurer la source de données.
Vous pouvez configurer l'`Search`objet pour définir un champ comme affichable, facetable, consultable ou triable. Vous pouvez configurer l'`Relevance`objet pour définir l'ordre de classement d'un champ, la durée d'augmentation ou la période à appliquer aux valeurs de renforcement, de fraîcheur, de valeur d'importance et d'importance mappées à des valeurs de champ spécifiques. Si vous utilisez la console, vous pouvez définir les paramètres de recherche d'un champ en sélectionnant l'option à facettes dans le menu de navigation. Pour définir le réglage de la pertinence, sélectionnez l'option permettant de rechercher votre index dans le menu de navigation, entrez une requête et utilisez les options du panneau latéral pour ajuster la pertinence de la recherche. Vous ne pouvez pas modifier le type de champ une fois que vous l'avez créé.
Amazon Kendra possède les champs de document réservés ou communs suivants que vous pouvez utiliser :
+ `_authors`—Une liste d'un ou de plusieurs auteurs responsables du contenu du document.
+ `_category`: catégorie qui place un document dans un groupe spécifique.
+ `_created_at`: date et heure au format ISO 8601 auxquelles le document a été créé. Par exemple, 2012-03-25T12:30:10\$101:00 est le format de date et d'heure ISO 8601 pour le 25 mars 2012 à 12 h 30 (plus 10 secondes) à l'heure d'Europe centrale.
+ `_data_source_id`: l'identifiant de la source de données qui contient le document.
+ `_document_body`: le contenu du document.
+ `_document_id`—Un identifiant unique pour le document.
+ `_document_title`: le titre du document.
+ `_excerpt_page_number`: le numéro de page d'un fichier PDF où apparaît l'extrait du document. Si votre index a été créé avant le 8 septembre 2020, vous devez réindexer vos documents avant de pouvoir utiliser cet attribut.
+ `_faq_id`—S'il s'agit d'un document de type question-réponse (FAQ), un identifiant unique pour la FAQ.
+ `_file_type`: le type de fichier du document, tel que pdf ou doc.
+ `_last_updated_at`: date et heure au format ISO 8601 auxquelles le document a été mis à jour pour la dernière fois. Par exemple, 2012-03-25T12:30:10\$101:00 est le format de date et d'heure ISO 8601 pour le 25 mars 2012 à 12 h 30 (plus 10 secondes) à l'heure d'Europe centrale.
+ `_source_uri`: l'URI où le document est disponible. Par exemple, l’URI du document sur le site Web d’une entreprise.
+ `_version`—Identifiant pour la version spécifique d'un document.
+ `_view_count`: le nombre de fois que le document a été consulté.
+ `_language_code`(String) : code d'une langue qui s'applique au document. La valeur par défaut est l'anglais si vous ne spécifiez aucune langue. Pour plus d'informations sur les langues prises en charge, y compris leurs codes, voir [Ajout de documents dans des langues autres que l'anglais](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html).
Pour les champs personnalisés, vous pouvez les créer à l'`DocumentMetadataConfigurationUpdates`aide de l'`UpdateIndex`API, comme vous le faites lorsque vous créez un champ réservé ou commun. Vous devez définir le type de données approprié pour votre champ personnalisé. Si vous utilisez la console, vous mettez à jour les champs en sélectionnant votre source de données, en sélectionnant l'action de modification, puis en passant à côté de la section des mappages de champs pour configurer la source de données. Certaines sources de données ne prennent pas en charge l'ajout de nouveaux champs ou de champs personnalisés. Vous ne pouvez pas modifier le type de champ une fois que vous l'avez créé.
Les types que vous pouvez définir pour les champs personnalisés sont les suivants :
+ Date
+ Number
+ String
+ Liste de chaînes
Si vous avez ajouté des documents à l'index à l'aide fields/attributes de l'[BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API, `Attributes` répertorie vos documents et créez des champs à l'aide de l'`DocumentAttribute`objet.
Pour les documents indexés à partir d'une source de Amazon S3 données, vous créez des champs à l'aide d'un [fichier de métadonnées JSON](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) qui inclut les informations des champs.
Si vous utilisez une base de données prise en charge comme source de données, vous pouvez configurer vos champs à l'aide de l'[option de mappage de champs](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database).
# Ajouter des documents dans des langues autres que l'anglais
Vous pouvez indexer des documents dans plusieurs langues. Si vous ne spécifiez aucune langue, Amazon Kendra indexe les documents en anglais par défaut. Vous incluez le code de langue d'un document dans les métadonnées du document sous forme de champ. Voir [Mappages de champs](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html) et [Attributs personnalisés](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html) pour plus d'informations sur le `_language_code` champ d'un document.
Vous pouvez spécifier le code de langue de tous vos documents dans votre source de données lorsque vous appelez [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html). Si aucun code de langue n'est spécifié dans un champ de métadonnées, le document est indexé à l'aide du code de langue spécifié pour tous les documents au niveau de la source de données. Dans la console, vous pouvez indexer des documents dans une langue prise en charge uniquement au niveau de la source de données. Accédez à **Sources de données**, puis à la page **Spécifier les détails de la source de données**, puis choisissez une langue dans la liste déroulante **Langue**.
Vous pouvez également rechercher ou interroger des documents dans une langue prise en charge. Pour plus d'informations, consultez [la section Recherche dans les langues](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-languages).
Les langues suivantes et leurs codes sont pris en charge (anglais ou `en` pris en charge par défaut si vous ne spécifiez aucune langue). Ce tableau inclut les langues qui prennent Amazon Kendra en charge la recherche sémantique complète, ainsi que les langues qui ne prennent en charge que la correspondance de mots clés simples. Les langues qui prennent en charge la recherche sémantique complète sont signalées par un astérisque et apparaissent en gras dans le tableau suivant. L'anglais (langue par défaut) est également pris en charge avec la recherche sémantique complète.
| **Nom de langue** | **Code de langue** |
| --- | --- |
| Arabe | ar |
| Arménien | hy |
| Basque | eu |
| Bengali | bn |
| Bulgare | bg |
| Catalan | ca |
| Chinois : simplifié et traditionnel\$1 | zh |
| Tchèque | cs |
| Danois | da |
| Néerlandais | nl |
| Finnois | fi |
| Français — y compris le français (Canada) \$1 | fr |
| Galicien | gl |
| Allemand\$1 | de |
| Grec | el |
| Hindi | hi |
| Hongrois | hu |
| Indonésien | id |
| Irlandais | ga |
| Italien | it |
| Japonais\$1 | ja |
| Coréen\$1 | ko |
| Letton | lv |
| Lituanien | lt |
| Norvégien | no |
| Persan | fa |
| Portugais | pt |
| Portugais (Brésil) \$1 | pt-BR |
| Roumain | ro |
| Russe | ru |
| Sorani | ckb |
| Espagnol — inclut l'espagnol (Mexique) \$1 | es |
| Suédois | sv |
| Turc | tr |
*\$1La recherche sémantique est prise en charge pour la langue.*
Pour les langues qui prennent en charge la recherche sémantique, les fonctionnalités suivantes sont prises en charge.
+ La pertinence du document va au-delà de la simple correspondance de mots clés.
+ FAQs au-delà de la simple correspondance de mots clés.
+ Extraire des réponses à partir de documents en fonction Amazon Kendra de sa compréhension écrite.
+ Tranches de confiance (très élevée, élevée, moyenne et faible) des résultats de recherche.
Pour les langues qui ne prennent pas en charge la recherche sémantique, la simple correspondance de mots clés est prise en charge pour la pertinence du document et FAQs.
Les [synonymes](https://docs.aws.amazon.com/kendra/latest/dg/index-synonyms.html) (y compris les synonymes personnalisés), [l'apprentissage progressif et les commentaires](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html), ainsi que les [suggestions de requêtes](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html) ne sont pris en charge qu'en anglais (langue par défaut).
# Configuration Amazon Kendra pour utiliser un Amazon VPC
Amazon Kendra peut se connecter à un cloud privé virtuel (VPC) que vous avez créé Amazon Virtual Private Cloud pour indexer le contenu stocké dans les sources de données exécutées dans votre cloud privé. Lorsque vous créez un connecteur de source de données, vous pouvez fournir des identifiants de groupe de sécurité et de sous-réseau pour le sous-réseau qui contient votre source de données. À partir de ces informations, il Amazon Kendra crée une interface réseau élastique qu'il utilise pour communiquer en toute sécurité avec votre source de données au sein de votre VPC.
Pour configurer un connecteur de source de Amazon Kendra données avec Amazon VPC, vous pouvez utiliser l'opération AWS Management Console ou l'opération [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html)API. Si vous utilisez la console, vous connectez un VPC pendant le processus de configuration du connecteur.
**Note**
Amazon VPC Cette fonctionnalité est facultative lors de la configuration d'un connecteur de source de Amazon Kendra données. Si votre source de données est accessible depuis l'Internet public, il n'est pas nécessaire d'activer Amazon VPC cette fonctionnalité. Les connecteurs de source de données Amazon Kendra ne prennent pas tous en charge Amazon VPC.
Si votre source de données n'est pas active Amazon VPC et n'est pas accessible depuis l'Internet public, vous devez d'abord la connecter à votre VPC via un réseau privé virtuel (VPN). Vous pouvez ensuite connecter votre source de données à Amazon Kendra l'aide d'une combinaison de Amazon VPC et AWS Virtual Private Network. Pour plus d’informations sur la configuration d’un VPN, consultez la [Documentation sur le Site-to-Site VPN](https://docs.aws.amazon.com/vpn/).
**Topics**
+ [Configuration de la Amazon VPC prise en charge des Amazon Kendra connecteurs](connector-vpc-steps.md)
+ [Configuration d'une source Amazon Kendra de données à laquelle se connecter Amazon VPC](connector-vpc-setup.md)
+ [Connexion à une base de données dans un VPC](vpc-example.md)
+ [Résolution des problèmes de connexion VPC](vpc-connector-troubleshoot.md)
# Configuration de la Amazon VPC prise en charge des Amazon Kendra connecteurs
Amazon VPC Pour configurer en vue de l'utiliser avec vos Amazon Kendra connecteurs, procédez comme suit.
**Topics**
+ [Étape 1. Créez des Amazon VPC sous-réseaux pour Amazon Kendra](#connector-vpc-prerequisites-1)
+ [Étape 2. Créez des groupes Amazon VPC de sécurité pour Amazon Kendra](#connector-vpc-prerequisites-2)
+ [Étape 3. Configurez votre source de données externe et Amazon VPC](#connector-vpc-prerequisites-3)
## Étape 1. Créez des Amazon VPC sous-réseaux pour Amazon Kendra
Créez ou choisissez un Amazon VPC sous-réseau existant qui Amazon Kendra peut être utilisé pour accéder à votre source de données. Les sous-réseaux préparés doivent se trouver dans l'une des zones Régions AWS de disponibilité suivantes :
+ USA Ouest (Oregon)/us-west-2—usw2-az1, usw2-az2, usw2-az3
+ USA Est (Virginie du Nord)/us-east-1—use1-az1, use1-az2, use1-az4
+ USA Est (Ohio) /us-east-2—use2-az1, use2-az2, use2-az3
+ Asie-Pacifique (Tokyo) /ap-northeast-1—apne1-az1, apne1-az2, apne1-az4
+ Asie-Pacifique (Mumbai) /ap-south-1—aps1-az1, aps1-az2, aps1-az3
+ Asie-Pacifique (Singapour) /ap-southeast-1—apse1-az1, apse1-az2, apse1-az3
+ Asie-Pacifique (Sydney)/ap-southeast-2—apse2-az1, apse2-az2, apse2-az3
+ Canada (Centre) /ca-central-1—cac1-az1, cac1-az2, cac1-az4
+ Europe (Irlande) /eu-west-1—euw1-az1, uew1-az2, euw1-az3
+ Europe (Londres) /eu-west-2—euw2-az1, euw2-az2, euw2-az3
Votre source de données doit être accessible à partir des sous-réseaux que vous avez fournis au connecteur Amazon Kendra .
Pour plus d'informations sur la configuration des Amazon VPC sous-réseaux, consultez la section [Sous-réseaux pour vous Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/configure-subnets.html) dans le guide de l'utilisateur Amazon *VPC*.
Si vous Amazon Kendra devez acheminer la connexion entre deux ou plusieurs sous-réseaux, vous pouvez préparer plusieurs sous-réseaux. Par exemple, le sous-réseau qui contient votre source de données n’a plus d’adresses IP. Dans ce cas, vous pouvez Amazon Kendra fournir un sous-réseau supplémentaire qui possède suffisamment d'adresses IP et qui est connecté au premier sous-réseau. Si vous répertoriez plusieurs sous-réseaux, ceux-ci doivent pouvoir communiquer entre eux.
## Étape 2. Créez des groupes Amazon VPC de sécurité pour Amazon Kendra
Pour connecter votre connecteur de source de Amazon Kendra données à Amazon VPC, vous devez préparer un ou plusieurs groupes de sécurité à partir de votre VPC auxquels vous souhaitez les attribuer. Amazon Kendra Les groupes de sécurité seront associés à l’interface réseau Elastic créée par Amazon Kendra. Cette interface réseau contrôle le trafic entrant et sortant à destination et en provenance des sous-réseaux Amazon Kendra lors de l' Amazon VPC accès aux sous-réseaux.
Assurez-vous que les règles sortantes de votre groupe de sécurité autorisent le trafic provenant des connecteurs de source de données Amazon Kendra à accéder aux sous-réseaux et à la source de données avec lesquels vous allez effectuer la synchronisation. Par exemple, vous pouvez utiliser un connecteur MySQL pour effectuer une synchronisation à partir d’une base de données MySQL. Si vous utilisez le port par défaut, les groupes de sécurité doivent autoriser l'accès Amazon Kendra au port 3306 sur l'hôte qui exécute la base de données.
Nous vous recommandons de configurer un groupe de sécurité par défaut avec les valeurs suivantes Amazon Kendra à utiliser :
+ **Règles de trafic entrant** : si vous choisissez de laisser ce champ vide, tout le trafic entrant sera bloqué.
+ **Règles de trafic sortant** : ajoutez une règle pour autoriser tout le trafic sortant afin de lancer les demandes de synchronisation à partir de votre source de données. Amazon Kendra
+ **Version IP** — IPv4
+ **Type** : tout le trafic
+ **Protocole** : tout le trafic
+ **Gamme de ports** : tous
+ **Destination** : 0.0.0.0/0
Pour plus d'informations sur la configuration des groupes Amazon VPC de sécurité, consultez la section [Règles des groupes de sécurité](https://docs.aws.amazon.com/vpc/latest/userguide/security-group-rules.html) dans le guide de l'*utilisateur Amazon VPC*.
## Étape 3. Configurez votre source de données externe et Amazon VPC
Assurez-vous que la configuration des autorisations et les paramètres réseau de votre source de données externe sont corrects Amazon Kendra pour y accéder. Vous trouverez des instructions détaillées sur la configuration de vos sources de données dans la section des prérequis de chaque page de connecteur.
Vérifiez également vos Amazon VPC paramètres et assurez-vous que votre source de données externe est accessible depuis le sous-réseau auquel vous allez l'attribuer Amazon Kendra. Pour ce faire, nous vous recommandons de créer une Amazon EC2 instance dans le même sous-réseau avec les mêmes groupes de sécurité et de tester l'accès à votre source de données à partir de cette Amazon EC2 instance. Pour plus d'informations, consultez la section [Résolution des problèmes de Amazon VPC connexion](https://docs.aws.amazon.com/kendra/latest/dg/vpc-connector-troubleshoot.html).
# Configuration d'une source Amazon Kendra de données à laquelle se connecter Amazon VPC
Lorsque vous ajoutez une nouvelle source de données Amazon Kendra, vous pouvez utiliser la Amazon VPC fonctionnalité si le connecteur de source de données sélectionné prend en charge cette fonctionnalité.
Vous pouvez configurer une nouvelle source de Amazon Kendra données Amazon VPC activée à l'aide de l'API AWS Management Console ou de l' Amazon Kendra API. Plus précisément, utilisez l’opération d’API [https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateDataSource.html), puis utilisez le paramètre `VpcConfiguration` pour fournir les informations suivantes :
+ `SubnetIds`— Une liste d'identifiants de sous-réseaux Amazon VPC
+ `SecurityGroupIds`— Une liste d'identifiants de groupes de Amazon VPC sécurité
Si vous utilisez la console, vous fournissez les Amazon VPC informations requises lors de la configuration du connecteur. Pour utiliser la console afin d’activer la fonctionnalité Amazon VPC pour un connecteur, vous devez d’abord choisir un VPC Amazon. Ensuite, vous indiquez les identifiants de tous les sous-réseaux Amazon VPC et les identifiants de tous les groupes de sécurité Amazon VPC. Vous pouvez choisir les sous-réseaux Amazon VPC et les groupes de sécurité Amazon VPC que vous avez créés dans [Configuration d’Amazon VPC](https://docs.aws.amazon.com/kendra/latest/dg/connector-vpc-steps.html), ou utiliser les sous-réseaux existants.
**Topics**
+ [Affichage des Amazon VPC identifiants](#viewing-vpc-identifiers)
+ [Vérification de votre IAM rôle dans la source de données](#vpc-iam-roles)
## Affichage des Amazon VPC identifiants
Les identifiants des sous-réseaux et des groupes de sécurité sont configurés dans la Amazon VPC console. Pour afficher les identifiants, utilisez les procédures suivantes.
**Pour afficher les identificateurs de sous-réseau**
1. Connectez-vous à la console Amazon VPC AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)
1. Dans le panneau de navigation, choisissez **Sous-réseaux**.
1. Dans la liste **Sous-réseaux**, sélectionnez le sous-réseau qui contient votre serveur de base de données.
1. Dans l’onglet **Détails**, notez l’identifiant dans le champ **ID de sous-réseau**.
**Pour afficher les identifiants des groupes de sécurité**
1. Connectez-vous à la console Amazon VPC AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)
1. À partir du panneau de navigation, sélectionnez **Groupes de sécurité**.
1. Dans la liste des groupes de sécurité, choisissez le groupe auquel vous souhaitez attribuer l’identifiant.
1. Dans l’onglet **Détails**, notez l’identifiant dans le champ **ID du groupe de sécurité**.
## Vérification de votre IAM rôle dans la source de données
Assurez-vous que votre rôle de source de données Gestion des identités et des accès AWS IAM(connecteur) contient les autorisations nécessaires pour accéder à votre Amazon VPC.
Si vous utilisez la console pour créer un nouveau rôle pour votre IAM rôle, ajoute Amazon Kendra automatiquement les autorisations appropriées à votre IAM rôle en votre nom. Si vous utilisez l'API ou utilisez un IAM rôle existant, vérifiez que votre rôle contient des autorisations d'accès Amazon VPC. Pour vérifier que vous disposez des autorisations appropriées, consultez la section [IAM Rôles du VPC](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-vpc).
Vous pouvez modifier une source de données existante pour qu’elle utilise un sous-réseau Amazon VPC différent. Vérifiez toutefois le IAM rôle de votre source de données et, si nécessaire, modifiez-le pour qu'il reflète le changement afin que le connecteur de source de Amazon Kendra données fonctionne correctement.
# Connexion à une base de données dans un VPC
L'exemple suivant montre comment connecter une MySQL base de données exécutée dans un cloud privé virtuel (VPC). L'exemple suppose que vous commencez par votre VPC par défaut et que vous devez créer une MySQL base de données. Si vous possédez déjà un VPC, assurez-vous qu'il est configuré comme indiqué. Si vous avez une MySQL base de données, vous pouvez l'utiliser au lieu d'en créer une nouvelle.
**Topics**
+ [Étape 1 : Configuration d'un VPC](#vpc-example-1)
+ [Étape 2 : créer et configurer des groupes de sécurité](#vpc-example-2)
+ [Étape 3 : Création d'une base de données](#vpc-example-3)
+ [Étape 4 : Création d'un connecteur de source de données](#vpc-example-4)
## Étape 1 : Configuration d'un VPC
Configurez votre VPC de manière à disposer d'un sous-réseau privé et d'un groupe de sécurité pour accéder Amazon Kendra à une MySQL base de données exécutée dans le sous-réseau. Les sous-réseaux fournis dans la configuration VPC doivent se trouver dans la région USA Ouest (Oregon), la région USA Est (Virginie du Nord) ou la région Europe (Irlande).
**Pour configurer un VPC à l'aide de Amazon VPC**
1. Connectez-vous à la console Amazon VPC AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)
1. Dans le volet de navigation, choisissez **Table de routage**, puis choisissez **Créer une table de routage**.
1. Dans le champ **Nom**, entrez**Private subnet route table**. **Dans la liste déroulante **VPC**, sélectionnez votre VPC, puis choisissez Créer une table de routage.** Choisissez **Fermer** pour revenir à la liste des tables de routage.
1. Dans le volet de navigation, choisissez les **passerelles NAT**, puis choisissez **Create NAT gateway**.
1. Dans la liste déroulante **Sous-réseau**, sélectionnez le sous-réseau public. Notez l'ID du sous-réseau.
1. Si vous n'avez pas d'adresse IP élastique, choisissez **Create New EIP**, **Create a NAT Gateway**, puis **Close**.
1. Dans le volet de navigation, choisissez **Route tables**.
1. Dans la liste des tables de routage, choisissez la **table de routage du sous-réseau privé** que vous avez créée à l'étape 3. Dans **Actions**, choisissez **Modifier les itinéraires**.
1. Choisissez **Ajouter une route**. Pour la destination, entrez **0.0.0.0/0** pour autoriser tout le trafic sortant vers Internet. Pour **Target**, choisissez **NAT Gateway**, puis choisissez la passerelle que vous avez créée à l'étape 4. Choisissez **Enregistrer les modifications**, puis **Fermer**.
1. Dans **Actions**, choisissez **Modifier les associations de sous-réseaux**.
1. Choisissez les sous-réseaux que vous souhaitez rendre privés. Ne choisissez pas le sous-réseau avec la passerelle NAT que vous avez mentionnée précédemment. Choisissez **Enregistrer les associations** lorsque vous avez terminé.
## Étape 2 : créer et configurer des groupes de sécurité
Configurez ensuite les groupes de sécurité pour votre base de données.
**Pour créer et configurer des groupes de sécurité**
1. Connectez-vous à la console Amazon VPC AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)
1. Dans la description de votre VPC, notez le IPv4 CIDR.
1. Dans le volet de navigation, choisissez **Security groups**, puis **Create security group**.
1. Sous **Security group name (Nom du groupe de sécurité)**, saisissez **DataSourceInboundSecurityGroup**. Fournissez une description, puis choisissez votre VPC dans la liste. Choisissez **Créer un groupe de sécurité**, puis **Fermer**.
1. Choisissez l’onglet **Inbound rules** (Règles entrantes).
1. Choisissez **Modifier les règles de trafic entrant**, puis sélectionnez **Ajouter une** règle
1. Pour une base de données, entrez le numéro de port pour la **plage de ports**. Par exemple, pour MySQL c'est**3306**, et pour HTTPS, c'est**443**. Pour la **source**, tapez le routage interdomaine sans classe (CIDR) de votre VPC. Choisissez **Enregistrer les règles**, puis **Fermer**.
Le groupe de sécurité permet à tous les membres du VPC de se connecter à la base de données et autorise les connexions sortantes vers Internet.
## Étape 3 : Création d'une base de données
Créez une base de données pour stocker vos documents, ou vous pouvez utiliser votre base de données existante.
Pour obtenir des instructions sur la création d'une MySQL base de données, consultez [https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html](https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html).
## Étape 4 : Création d'un connecteur de source de données
Après avoir configuré votre VPC et créé votre base de données, vous pouvez créer un connecteur de source de données pour la base de données. Pour plus d'informations sur les connecteurs de base de données compatibles Amazon Kendra , voir [Connecteurs pris en charge](https://docs.aws.amazon.com/kendra/latest/dg/data-sources.html).
Pour votre base de données, assurez-vous de configurer votre VPC, les sous-réseaux privés que vous avez créés dans votre VPC et le groupe de sécurité que vous avez créé dans votre VPC.
# Résolution des problèmes de connexion VPC
Si vous rencontrez des problèmes avec votre connexion au cloud privé virtuel (VPC), vérifiez que vos IAM autorisations, les paramètres du groupe de sécurité et les tables de routage du sous-réseau sont correctement configurés.
L'une des causes potentielles de l'échec de la synchronisation du connecteur de source de données est que la source de données est peut-être inaccessible depuis le sous-réseau auquel vous l'avez affectée. Amazon Kendra Pour résoudre ce problème, nous vous recommandons de créer une Amazon EC2 instance avec les mêmes Amazon VPC paramètres. Essayez ensuite d'accéder à la source de données depuis cette Amazon EC2 instance à l'aide d'appels d'API REST ou d'autres méthodes (en fonction du type spécifique de votre source de données).
Si vous accédez à la source de données depuis l' Amazon EC2 instance que vous créez, cela signifie que votre source de données est accessible depuis ce sous-réseau. Par conséquent, votre problème de synchronisation n'est pas lié au fait que votre source de données est inaccessible par Amazon VPC.
Si vous ne pouvez pas accéder à votre Amazon EC2 instance à partir de la configuration de votre VPC et la valider avec l' Amazon EC2 instance que vous avez créée, vous devez poursuivre le dépannage. Par exemple, si la synchronisation d'un Amazon S3 connecteur a échoué en raison d'erreurs liées à des problèmes de connexion, vous pouvez configurer une Amazon EC2 instance avec la même Amazon VPC configuration que celle que vous avez attribuée à votre Amazon S3 connecteur. Utilisez ensuite cette instance Amazon EC2 pour vérifier si vous avez Amazon VPC été correctement configurée.
Voici un exemple de configuration d'une Amazon EC2 instance pour résoudre les problèmes de Amazon VPC connexion à une source de Amazon S3 données.
**Topics**
+ [Étape 1 : Lancer une Amazon EC2 instance](#vpc-connector-troubleshoot-1)
+ [Étape 2 : Se connecter à l' Amazon EC2 instance](#vpc-connector-troubleshoot-2)
+ [Étape 3 : Tester Amazon S3 l'accès](#vpc-connector-troubleshoot-3)
## Étape 1 : Lancer une Amazon EC2 instance
1. Connectez-vous à la console Amazon EC2 AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Sélectionnez **Lancer une instance**.
1. Choisissez **Paramètres réseau**, puis **Modifier**, puis procédez comme suit :
1. Choisissez le même VPC et le même **sous-réseau** que ceux auxquels vous avez été affectés. Amazon Kendra
1. Pour **Firewall (security groups)** (Pare-feu (groupes de sécurité), choisissez **Select existing security group** (Sélectionner un groupe de sécurité existant). Sélectionnez ensuite le groupe de sécurité auquel vous avez assigné Amazon Kendra.
**Note**
Le groupe de sécurité doit autoriser le trafic sortant à Amazon S3.
1. Définissez l'**attribution automatique de l'adresse IP publique** sur **Désactiver**.
1. Dans **Détails avancés**, procédez comme suit :
+ Pour le **profil d'instance IAM**, sélectionnez **Créer un nouveau profil IAM** pour créer et associer un profil d' IAM instance à votre instance. Assurez-vous que le profil dispose des autorisations d'accès Amazon S3. Pour plus d'informations, consultez [Comment puis-je accorder à mon Amazon EC2 instance l'accès à un Amazon S3 bucket ?](https://repost.aws/knowledge-center/ec2-instance-access-s3-bucket) dans AWS re:Post.
+ Conservez tous les autres paramètres par défaut.
1. Vérifiez et lancez l' Amazon EC2 instance.
## Étape 2 : Se connecter à l' Amazon EC2 instance
Une fois que votre Amazon EC2 instance est en cours d'exécution, rendez-vous sur la page détaillée de votre instance et connectez-vous à votre instance. Pour ce faire, suivez les étapes décrites dans [Connect to your instances sans avoir besoin d'une adresse IPv4 publique à l'aide du point de terminaison EC2 Instance Connect](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect-with-ec2-instance-connect-endpoint.html) dans le *guide de l'Amazon EC2 utilisateur pour les instances Linux*.
## Étape 3 : Tester Amazon S3 l'accès
Une fois connecté à votre terminal d' Amazon EC2 instance, exécutez une AWS CLI commande pour tester la connexion entre ce sous-réseau privé et votre Amazon S3 bucket.
Pour tester Amazon S3 l'accès, tapez la AWS CLI commande suivante dans le AWS CLI : `aws s3 ls`
Une fois la AWS CLI commande exécutée, passez en revue les points suivants :
+ Si vous avez correctement configuré les IAM autorisations nécessaires et que votre Amazon S3 configuration est correcte, vous devriez voir la liste de vos Amazon S3 buckets.
+ Si vous constatez des erreurs d'autorisation, par exemple`Access Denied`, il est probable que la configuration de votre VPC soit correcte, mais qu'il y a un problème avec vos IAM autorisations ou votre politique de Amazon S3 compartiment.
Si le délai de la commande est expiré, il est probable que votre connexion soit interrompue car la configuration de votre VPC est incorrecte et l'instance Amazon EC2 ne peut pas accéder à Amazon S3 depuis votre sous-réseau. Reconfigurez votre VPC, puis réessayez.