Amazon Kendra ya no está abierto a nuevos clientes. Para obtener capacidades similares a Amazon Kendra, consulte las bases de conocimiento de Amazon Bedrock. [Más información](https://docs.aws.amazon.com/kendra/latest/dg/kendra-availability-change.html).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# SharePoint conector V1.0
SharePoint es un servicio colaborativo de creación de sitios web que puede utilizar para personalizar el contenido web y crear páginas, sitios, bibliotecas de documentos y listas. Si es SharePoint usuario, puede usarlo Amazon Kendra para indexar su fuente SharePoint de datos.
**nota**
SharePoint V1.0 El SharePointConfiguration conector/API finalizó en 2023. Recomendamos migrar o utilizar el SharePoint conector V2.0 / TemplateConfiguration API.
Para solucionar problemas con el conector de la fuente de Amazon Kendra SharePoint datos, consulte[Solución de problemas con los orígenes de datos](troubleshooting-data-sources.md).
**Topics**
+ [Características admitidas](#supported-features-v1-sharepoint)
+ [Requisitos previos](#prerequisites-v1-sharepoint)
+ [Instrucciones de conexión](#data-source-procedure-v1-sharepoint)
+ [Más información](#sharepoint-v1-learn-more)
## Características admitidas
+ Asignaciones de campo
+ Control de acceso de usuarios
+ Inclusion/exclusion filtros
+ Registro de cambios
+ Nube privada virtual (VPC)
## Requisitos previos
Antes de poder utilizarla Amazon Kendra para indexar la fuente de SharePoint datos, realiza estos cambios en tus AWS cuentas SharePoint y.
Debe proporcionar las credenciales de autenticación, que puede almacenar de forma segura en un AWS Secrets Manager secreto.
**nota**
Le recomendamos que actualice o modifique con regularidad las credenciales y el secreto. Por su propia seguridad, proporcione solo el nivel de acceso necesario. **No** se recomienda volver a utilizar las credenciales y los datos secretos en varios orígenes de datos ni en las versiones 1.0 y 2.0 del conector (si procede).
**En SharePoint, asegúrate de tener: **
+ Anotó la URL de los SharePoint sitios que desea indexar.
+ **Para SharePoint Internet: **
+ Ha apuntado sus credenciales de autenticación básica, que incluyen un nombre de usuario y una contraseña con permisos de administrador del sitio.
+ **Opcional**: ha generado credenciales OAuth 2.0 que contienen un nombre de usuario, una contraseña, un ID de cliente y un secreto de cliente.
+ Ha desactivado los **Valores predeterminados de seguridad** en su portal de Azure mediante un usuario administrativo. Para obtener más información sobre la administración de la configuración predeterminada de seguridad en el portal de Azure, consulte la documentación de [ Microsoft sobre cómo establecer los valores predeterminados enable/disable ](https://learn.microsoft.com/en-us/microsoft-365/business-premium/m365bp-conditional-access?view=o365-worldwide&tabs=secdefaults#security-defaults-1) de seguridad.
+ **Para el SharePoint servidor: **
+ Anotó el nombre de dominio de su SharePoint servidor (el nombre NetBIOS en su Active Directory). Lo usa, junto con su nombre de usuario y contraseña de autenticación SharePoint básicos, para conectarse al SharePoint Amazon Kendra servidor.
**nota**
Si usa el SharePoint servidor y necesita convertir la lista de control de acceso (ACL) a un formato de correo electrónico para filtrar el contexto del usuario, proporcione la URL del servidor LDAP y la base de búsqueda de LDAP. También puede utilizar la anulación del dominio del directorio. La URL del servidor LDAP es el nombre de dominio completo y el número de puerto (por ejemplo, ldap://example.com:389). La base de búsqueda de LDAP son los controladores de dominio “example” y “com”. Al anular el dominio del directorio, puede utilizar el dominio del correo electrónico en lugar de la URL del servidor LDAP y la base de búsqueda LDAP. Por ejemplo, el dominio de correo electrónico de username@example.com es “example.com”. Puede usar esta anulación si no le interesa validar su dominio y simplemente quiere usar su dominio de correo electrónico.
+ Se han agregado los siguientes permisos a su cuenta: SharePoint
**Para SharePoint listas **
+ Abrir elementos: vea el origen de los documentos con los controladores de archivos del servidor.
+ Ver páginas de aplicaciones: vea formularios, vistas y páginas de aplicaciones. Enumere las listas.
+ Ver elementos: vea los elementos de las listas y los documentos de las bibliotecas de documentos.
+ Ver versiones: vea las versiones anteriores de un documento o elemento de la lista.
**Para SharePoint sitios web **
+ Explorar directorios: enumere los archivos y carpetas de un sitio web mediante el SharePoint Diseñador y la interfaz Web DAV.
+ Examinar la información del usuario: vea información sobre los usuarios del sitio web.
+ Enumerar permisos: enumere los permisos en el sitio web, la lista, la carpeta, el documento o el elemento de la lista.
+ Abrir: abra un sitio web, una lista o una carpeta para acceder a los elementos del contenedor.
+ Utilice las funciones de integración de clientes: utilice SOAP, WebDAV, el modelo de objetos del cliente o las interfaces de diseñador para acceder al sitio web. SharePoint
+ Utilizar interfaces remotas: use características que lanzan aplicaciones cliente.
+ Ver páginas: vea las páginas de un sitio web.
+ Se ha marcado que cada documento sea único en las demás fuentes de datos que vaya a utilizar para el mismo índice SharePoint y entre ellas. Cada origen de datos que desee utilizar para un índice no debe contener el mismo documento en varios orígenes de datos. Los ID de documento son globales para un índice y deben ser únicos por índice.
**En su Cuenta de AWS, asegúrese de tener: **
+ [Creaste un Amazon Kendra índice ](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) y, si usaste la API, anotaste el ID del índice.
+ [Creó un IAM rol ](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) para su fuente de datos y, si utilizaba la API, anotó el ARN del IAM rol.
**nota**
Si cambias el tipo de autenticación y las credenciales, debes actualizar tu IAM rol para acceder al ID AWS Secrets Manager secreto correcto.
+ SharePoint Guardaste tus credenciales de autenticación en un AWS Secrets Manager secreto y, si utilizabas la API, anotaste el ARN del secreto.
**nota**
Le recomendamos que actualice o modifique con regularidad las credenciales y el secreto. Por su propia seguridad, proporcione solo el nivel de acceso necesario. **No** se recomienda volver a utilizar las credenciales y los datos secretos en varios orígenes de datos ni en las versiones 1.0 y 2.0 del conector (si procede).
Si no tienes un IAM rol o un secreto existentes, puedes usar la consola para crear un IAM rol y un Secrets Manager secreto nuevos al conectar tu fuente de SharePoint datos. Amazon Kendra Si utilizas la API, debes proporcionar el ARN de un IAM rol y un Secrets Manager secreto existentes, así como un ID de índice.
## Instrucciones de conexión
Para conectarse Amazon Kendra a su fuente de SharePoint datos, debe proporcionar los detalles de sus SharePoint credenciales para Amazon Kendra poder acceder a sus datos. Si aún no lo ha configurado SharePoint , Amazon Kendra consulte[Requisitos previos](#prerequisites-v1-sharepoint).
------
#### [ Console ]
**Para conectarse Amazon Kendra a SharePoint **
1. Inicie sesión en la consola AWS de administración y [Amazon Kendra ábrala](https://console.aws.amazon.com/kendra/).
1. En el panel de navegación izquierdo, elija **Índices** y, a continuación, elija el índice que desee usar de la lista de índices.
**nota**
Puede elegir configurar o editar los ajustes de **Control de acceso de usuarios** en la **Configuración del índice**.
1. En la página **Introducción**, seleccione **Agregar origen de datos**.
1. En la ** página ** Agregar fuente de datos, elija el ** SharePoint conector v1.0 y**, a continuación, elija ** Agregar fuente ** de datos.
1. En la página **Especificar detalles del origen de datos**, introduzca la siguiente información:
1. En **Nombre y descripción**, en **Nombre del origen de datos**: introduzca un nombre para el origen de datos. Puede incluir guiones, pero no espacios.
1. (Opcional)** Descripción**: introduzca una descripción opcional para el origen de datos.
1. En **Idioma predeterminado**: elija un idioma para filtrar los documentos para el índice. A menos que especifique lo contrario, el idioma predeterminado es el inglés. El idioma especificado en los metadatos del documento anula el idioma seleccionado.
1. En ** Etiquetas**, para ** Agregar una nueva etiqueta, ** incluya etiquetas opcionales para buscar y filtrar sus recursos o realizar un seguimiento de sus AWS costos.
1. Elija **Siguiente**.
1. En la página **Definir acceso y seguridad**, introduzca la siguiente información:
1. Para el método ** de alojamiento**: elija entre ** SharePoint en línea ** y ** SharePoint servidor. **
1. Para sitios ** SharePoint en línea**: introduzca las URL ** del sitio específicas de su repositorio. SharePoint **
1. Para el ** SharePoint servidor**: elija su ** SharePoint versión**, introduzca las URL ** del sitio específicas de su SharePoint repositorio ** e introduzca la Amazon S3 ruta a la ubicación de su ** certificado SSL. **
1. (Solo SharePoint servidor) Para el proxy ** web**: introduzca el nombre de ** host ** y el número ** de ** puerto de su instancia interna. SharePoint El número de puerto debe ser un valor numérico entre 0 y 65535.
1. En **Autenticación**: elija entre las siguientes opciones según el caso de uso:
1. En SharePoint línea: elija entre la autenticación ** básica ** y la autenticación ** OAuth 2.0. **
1. Para el SharePoint servidor: elija entre ** ninguna**, LDAP y manual. ** ** ** **
1. Para el **AWS Secrets Manager secreto**: elija un secreto existente o cree uno nuevo para almacenar sus credenciales de Secrets Manager autenticación. SharePoint Si decide crear un secreto nuevo, se abrirá una ventana de secreto de AWS Secrets Manager . Debe introducir un **Nombre del secreto**. El prefijo «AmazonKendra-SharePoint-» se añade automáticamente a tu nombre secreto.
1. Introduzca la siguiente información adicional en la **ventana Crear un secreto de AWS Secrets Manager **:
1. Elige entre las siguientes opciones de autenticación SharePoint en la nube, según tu caso práctico:
1. **Autenticación básica**: introduzca el nombre de usuario de su SharePoint cuenta como nombre ** de usuario ** y la contraseña de la SharePoint cuenta como ** contraseña**.
1. **Autenticación OAuth 2.0**: introduzca el nombre de usuario de su SharePoint cuenta como nombre de ** usuario**, la contraseña de la SharePoint cuenta como ** contraseña**, su SharePoint ID único generado automáticamente como ID de ** cliente y la cadena secreta compartida utilizada por ambos como SharePoint secreto de cliente. ** Amazon Kendra ** **
1. Elige entre las siguientes opciones de autenticación SharePoint del servidor, según tu caso práctico:
1. **Ninguna**: introduzca el nombre de usuario de la SharePoint cuenta como nombre de ** usuario**, la contraseña de la SharePoint cuenta como ** contraseña ** y el nombre ** de dominio ** del servidor.
1. **LDAP**: introduzca el nombre de usuario de la SharePoint cuenta como nombre de ** usuario**, la contraseña de la SharePoint cuenta como ** contraseña**, el punto final del servidor ** LDAP ** (incluidos el protocolo y el número de puerto, por ejemplo{{ldap://example.com:389}}) y la base de búsqueda de ** LDAP (por ejemplo,). ** {{dc=example, dc=com}}
1. **Manual**: introduzca el nombre de usuario de la SharePoint cuenta como nombre de ** usuario**, la contraseña de la SharePoint cuenta como ** contraseña ** y la anulación del dominio de correo electrónico ** (dominio de correo ** electrónico del usuario o grupo del directorio).
1. Seleccione **Save**.
1. **Nube privada virtual (VPC)**: también debe agregar **Subredes** y **Grupos de seguridad de VPC**.
**nota**
Debes usar una VPC si usas un servidor. SharePoint Amazon VPC es opcional para otras SharePoint versiones.
1. **IAM rol**: elige un IAM rol existente o crea uno nuevo IAM para acceder a las credenciales de tu repositorio y al contenido del índice.
**nota**
IAM los roles utilizados para los índices no se pueden usar para las fuentes de datos. Si no está seguro de si un rol existente se utiliza para un índice o para las preguntas frecuentes, elija **Crear un nuevo rol** para evitar errores.
1. Elija **Siguiente**.
1. En la página **Configurar ajustes de sincronización**, introduzca la siguiente información:
1. **Usar registro de cambios**: seleccione esta opción para actualizar el índice en lugar de sincronizar todos los archivos.
1. **Rastrear archivos adjuntos**: seleccione esta opción para rastrear los archivos adjuntos.
1. **Utilizar asignaciones de grupos locales**: seleccione esta opción para asegurarse de que los documentos se filtran correctamente.
1. **Configuración adicional**: añada patrones de expresión regular para incluir o excluir determinados archivos. Puede agregar hasta 100 patrones.
1. En **Programa de ejecución de sincronización**, en **Frecuencia**: la frecuencia con la que Amazon Kendra se sincronizará con el origen de datos.
1. Elija **Siguiente**.
1. En la página **Establecer asignaciones de campos**, especifique la siguiente información:
1. **Amazon Kendra asignaciones de campos predeterminadas**: seleccione entre las fuentes de datos predeterminadas Amazon Kendra generadas los campos que desee asignar a su índice.
1. En **Asignaciones de campo personalizado**: agregue campos de origen de datos personalizados a fin de crear un nombre de campo de índice al que asignarlos y el tipo de datos del campo.
1. Elija **Siguiente**.
1. En la página **Revisar y crear**, compruebe que la información que ha introducido es correcta y, a continuación, seleccione **Añadir origen de datos**. También puede elegir editar la información desde esta página. El origen de datos aparecerá en la página **Orígenes de datos** una vez que el origen de datos se haya agregado correctamente.
------
#### [ API ]
**Para conectarse a Amazon Kendra SharePoint **
Debe especificar lo siguiente mediante la [ SharePointConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SharePointConfiguration.html) API:
+ **SharePointVersión**: especifique la SharePoint versión que utiliza al realizar la configuración SharePoint. Este es el caso independientemente de si usa SharePoint Server 2013, SharePoint Server Subscription Edition o SharePoint Online.
+ **Nombre de recurso secreto de Amazon (ARN)**: proporcione el nombre de recurso de Amazon (ARN) de un Secrets Manager secreto que contenga las credenciales de autenticación que creó en su SharePoint cuenta. El secreto se almacena en una estructura JSON.
Para la autenticación básica ** SharePoint en línea**, la siguiente es la estructura JSON mínima que debes guardar en secreto:
```
{
"userName": "{{user name}}",
"password": "{{password}}"
}
```
Para la autenticación OAuth 2.0 ** SharePoint en línea**, la siguiente es la estructura JSON mínima que debe estar en secreto:
```
{
"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}}"
}
```
Para la autenticación básica ** SharePoint del servidor**, la siguiente es la estructura JSON mínima que debe estar en secreto:
```
{
"userName": "{{user name}}",
"password": "{{password}}",
"domain": "{{server domain name}}"
}
```
Para la autenticación LDAP ** SharePoint del servidor ** (si necesitas convertir tu lista de control de acceso (ACL) a un formato de correo electrónico para filtrar según el contexto del usuario, puedes incluir la URL del servidor LDAP y la base de búsqueda de LDAP en tu secreto), la siguiente es la estructura JSON mínima que debe estar en secreto:
```
{
"userName": "{{user name}}",
"password": "{{password}}",
"domain": "{{server domain name}}"
"ldapServerUrl": "{{ldap://example.com:389}}",
"ldapSearchBase": "{{dc=example,dc=com}}"
}
```
Para la autenticación manual ** SharePoint del servidor**, la siguiente es la estructura JSON mínima que debe estar en secreto:
```
{
"userName": "{{user name}}",
"password": "{{password}}",
"domain": "{{server domain name}}",
"emailDomainOverride": "{{example.com}}"
}
```
+ **IAM rol**: especifique `RoleArn` cuándo llama `CreateDataSource` para proporcionar a un IAM rol los permisos para acceder a su Secrets Manager secreto y para llamar a las API públicas requeridas para el SharePoint conector y Amazon Kendra. Para obtener más información, consulte [Roles de IAM para orígenes de datos de SharePoint ](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
+ **Amazon VPC**—Si usa el SharePoint servidor, especifíquelo `VpcConfiguration` como parte de la configuración de la fuente de datos. Consulte [ Configurar Amazon Kendra para usar una ](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html) VPC.
También puede añadir las siguientes características opcionales:
+ **Proxy web**: si desea conectarse a las URL de su SharePoint sitio a través de un proxy web. Puede usar esta opción solo para SharePoint el servidor.
+ **Listas de indexación**: si se Amazon Kendra debe indexar el contenido de los archivos adjuntos para SharePoint enumerar los elementos.
+ **Registro de cambios**: si se Amazon Kendra debe utilizar el mecanismo de registro de cambios de la fuente de SharePoint datos para determinar si un documento debe actualizarse en el índice.
**nota**
Utilice el registro de cambios si no quiere que Amazon Kendra digitalice todos los documentos. Si el registro de cambios es grande, es posible que se Amazon Kendra tarde menos tiempo en escanear los documentos de la fuente de SharePoint datos que en procesar el registro de cambios. Si está sincronizando el origen de datos de SharePoint con su índice por primera vez, se escanean todos los documentos.
+ **Filtros de inclusión y exclusión**: puede especificar si desea incluir o excluir determinado contenido.
**nota**
La mayoría de los orígenes de datos utilizan patrones de expresiones regulares, que son patrones de inclusión o exclusión denominados filtros. Si especifica un filtro de inclusión, solo se indexará el contenido que coincida con el filtro de inclusión. Los documentos que no coincidan con el filtro de inclusión no se indexan. Si especifica un filtro de inclusión y exclusión, los documentos que coincidan con el filtro de exclusión no se indexarán, aunque coincidan con el filtro de inclusión.
+ **Asignaciones de campos**: elija asignar los campos del origen de datos de SharePoint a los campos de índice de Amazon Kendra . Para obtener más información, consulte [Asignación de campos de origen de datos](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**nota**
El campo del cuerpo del documento o el equivalente en cuerpo del documento para los documentos es necesario Amazon Kendra para poder buscar en los documentos. Debe asignar el nombre del campo del cuerpo del documento en el origen de datos al nombre del campo del índice `_document_body`. Todos los demás campos son opcionales.
+ **Filtrado de contexto de usuario y control de acceso**: si hay una lista de control de acceso (ACL) para los documentos,Amazon Kendra la rastreará. La información de la ACL se utiliza para filtrar los resultados de búsqueda en función del acceso del usuario o su grupo a los documentos. Para obtener más información, consulte [Filtrado de contexto de usuario](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------
## Más información
Para obtener más información sobre la integración Amazon Kendra con su fuente de SharePoint datos, consulte:
+ [Cómo comenzar con el conector Amazon Kendra SharePoint en línea ](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-sharepoint-online-connector/)