Seleccione sus preferencias de cookies

Usamos cookies esenciales y herramientas similares que son necesarias para proporcionar nuestro sitio y nuestros servicios. Usamos cookies de rendimiento para recopilar estadísticas anónimas para que podamos entender cómo los clientes usan nuestro sitio y hacer mejoras. Las cookies esenciales no se pueden desactivar, pero puede hacer clic en “Personalizar” o “Rechazar” para rechazar las cookies de rendimiento.

Si está de acuerdo, AWS y los terceros aprobados también utilizarán cookies para proporcionar características útiles del sitio, recordar sus preferencias y mostrar contenido relevante, incluida publicidad relevante. Para aceptar o rechazar todas las cookies no esenciales, haga clic en “Aceptar” o “Rechazar”. Para elegir opciones más detalladas, haga clic en “Personalizar”.

SharePoint conector V1.0 - Amazon Kendra

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.

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 un SharePoint usuario, puede utilizarlo Amazon Kendra para indexar su fuente SharePoint de datos.

nota

SharePoint El conector V1.0/ SharePointConfiguration API finalizó en 2023. Recomendamos migrar o utilizar el SharePoint conector V2.0/API. TemplateConfiguration

Para solucionar problemas del conector de la fuente de Amazon Kendra SharePoint datos, consulte. Solución de problemas con los orígenes de datos

Características admitidas

  • Asignaciones de campo

  • Control de acceso de usuarios

  • Filtros de inclusión/exclusión

  • Registro de cambios

  • Nube privada virtual (VPC)

Requisitos previos

Antes de poder utilizarla Amazon Kendra para indexar la fuente de SharePoint datos, realice estos cambios en sus AWS cuentas SharePoint y.

Debe proporcionar las credenciales de autenticación, que se almacenan de forma segura en 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úrese de tener:

  • Apuntó la URL de los SharePoint sitios que desea indexar.

  • Para SharePoint en línea:

    • 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: credenciales OAuth 2.0 generadas 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 Microsoft documentation on how to enable/disable security defaults.

  • Para el SharePoint servidor:

    • Apuntó el nombre de dominio de su SharePoint servidor (el nombre de NetBIOS en su Active Directory). Úselo, junto con su nombre de usuario y contraseña de autenticación SharePoint básicos, para conectarse al SharePoint Amazon Kendra servidor.

    nota

    Si utiliza SharePoint Server y necesita convertir la lista de control de acceso (ACL) al formato de correo electrónico para filtrar según 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 agregaron 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

    • Examinar directorios: enumere los archivos y carpetas de un sitio web mediante la interfaz SharePoint Designer y 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 SharePoint las interfaces de diseñador para acceder al sitio web.

    • Utilizar interfaces remotas: use características que lanzan aplicaciones cliente.

    • Ver páginas: vea las páginas de un sitio web.

  • Marcó que cada documento es ú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. IDs Los documentos son globales en relación con un índice y deben ser únicos por índice.

En el tuyo Cuenta de AWS, asegúrate de tener:

  • Creó un Amazon Kendra índice y, si usa la API, anotó el ID del índice.

  • Creó un IAM rol para su fuente de datos y, si usa 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.

  • Guardó sus credenciales de SharePoint autenticación en un AWS Secrets Manager secreto y, si usa la API, anotó 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 tiene un IAM rol o secreto existente, puede usar la consola para crear un nuevo IAM rol y un Secrets Manager secreto al conectar su fuente de SharePoint datos. Amazon Kendra Si utiliza la API, debe proporcionar el ARN de un IAM rol y un Secrets Manager secreto existentes y 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 que Amazon Kendra pueda acceder a sus datos. Si aún no lo ha configurado SharePoint , Amazon Kendra consulteRequisitos previos.

Console

Para conectarse Amazon Kendra a SharePoint

  1. Inicie sesión en la consola AWS de administración y abra la Amazon Kendra consola.

  2. 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.

  3. En la página Introducción, seleccione Agregar origen de datos.

  4. En la página Agregar fuente de datos, elija el SharePoint conector v1.0 y, a continuación, elija Agregar fuente de datos.

  5. 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.

    2. (Opcional) Descripción: introduzca una descripción opcional para el origen de datos.

    3. En el 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.

    4. En Etiquetas, para añadir una nueva etiqueta: incluya etiquetas opcionales para buscar y filtrar sus recursos o realizar un seguimiento de sus AWS costes.

    5. Elija Next (Siguiente).

  6. 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 el SharePointmodo en línea: introduzca el sitio URLs específico de su repositorio. SharePoint

      2. Para el SharePointservidor: elija su SharePoint versión, introduzca el sitio URLs específico de su SharePoint repositorio e introduzca la Amazon S3 ruta a la ubicación de su certificado SSL.

    2. (Solo SharePoint servidor) Para el proxy web: introduzca el nombre de host y el número de puerto de la instancia interna SharePoint . El número de puerto debe ser un valor numérico entre 0 y 65535.

    3. En Autenticación: elija entre las siguientes opciones según el caso de uso:

      1. Para conexión SharePoint en línea: elija entre la autenticación básica y OAuth la autenticación 2.0.

      2. Para el SharePoint servidor: elija entre Ninguno, LDAP y Manual.

    4. Para 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.

    5. Introduzca la siguiente información adicional en la ventana Crear un secreto de AWS Secrets Manager :

      1. Elija entre las siguientes opciones de autenticación SharePoint en la nube, según su caso de uso:

        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.

        2. OAuth Autenticación 2.0: introduzca SharePoint el nombre de usuario de su SharePoint cuenta como nombre de usuario, la contraseña de la cuenta como contraseña, su SharePoint ID único generado automáticamente como ID de cliente y la cadena de secreto compartido utilizada por ambos SharePoint y Amazon Kendra como secreto de cliente.

      2. Elija una de las siguientes opciones de autenticación SharePoint del servidor, según su caso de uso:

        1. Ninguna: introduzca el nombre de usuario de su SharePoint cuenta como nombre de usuario, la contraseña de su SharePoint cuenta como contraseña y el nombre de dominio del servidor.

        2. LDAP: introduzca el nombre de usuario de su SharePoint cuenta como nombre de usuario, la contraseña de la SharePoint cuenta como contraseña, el punto de conexión del servidor LDAP (incluidos el protocolo y el número de puerto, por ejemploldap://example.com:389) y su base de búsqueda de LDAP (por ejemplo,). dc=example, dc=com

        3. Manual: introduzca el nombre de usuario de su SharePoint cuenta como nombre de usuario, la contraseña de su 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).

      3. Seleccione Guardar.

    6. Nube privada virtual (VPC): también debe agregar Subredes y Grupos de seguridad de VPC.

      nota

      Debe usar una VPC si usa SharePoint Server. Amazon VPC es opcional para otras SharePoint versiones.

    7. IAM rol: elija un IAM rol existente o cree uno nuevo IAM para acceder a las credenciales del 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.

    8. Elija Next (Siguiente).

  7. 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.

    2. Rastrear archivos adjuntos: seleccione esta opción para rastrear los archivos adjuntos.

    3. Utilizar asignaciones de grupos locales: seleccione esta opción para asegurarse de que los documentos se filtran correctamente.

    4. Configuración adicional: añada patrones de expresión regular para incluir o excluir determinados archivos. Puede agregar hasta 100 patrones.

    5. En Programa de ejecución de sincronización, en Frecuencia: la frecuencia con la que Amazon Kendra se sincronizará con el origen de datos.

    6. Elija Next (Siguiente).

  8. 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.

    2. 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.

    3. Elija Next (Siguiente).

  9. 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 SharePointConfigurationAPI:

  • SharePointVersión: especifique la SharePoint versión que utiliza al configurar SharePoint. Este es el caso independientemente de si utiliza SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 u 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 debe estar en el secreto:

    { "userName": "user name", "password": "password" }

    Para la autenticación SharePoint Online OAuth 2.0, la siguiente es la estructura JSON mínima que debe estar en el 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 tu secreto:

    { "userName": "user name", "password": "password", "domain": "server domain name" }

    Para la autenticación LDAP SharePoint del servidor (si necesita convertir la lista de control de acceso (ACL) al formato de correo electrónico para filtrar según el contexto del usuario, puede incluir la URL del servidor LDAP y la base de búsqueda de LDAP en su secreto), la siguiente es la estructura JSON mínima que debe estar en su 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 permisos para acceder a su Secrets Manager secreto y para llamar al público requerido APIs para el SharePoint conector y Amazon Kendra. Para obtener más información, consulte Roles de IAM para orígenes de datos de SharePoint .

  • Amazon VPC—Si usa SharePoint Server, especifíquelo VpcConfiguration como parte de la configuración de la fuente de datos. Consulte Configuración Amazon Kendra para usar una VPC.

También puede añadir las siguientes características opcionales:

  • Proxy web: si desea conectarse a su SharePoint sitio URLs mediante un proxy web. Puede usar esta opción solo para el SharePoint servidor.

  • Listas de indexación: si se Amazon Kendra debe indexar el contenido de los archivos adjuntos a los elementos de la SharePoint lista.

  • 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 en digitalizar 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.

    nota

    El campo del cuerpo del documento o el cuerpo del documento equivalente de sus documentos es obligatorio Amazon Kendra para poder buscarlos. Debe asignar el nombre del campo del cuerpo del documento en la fuente de datos al nombre del campo de índice_document_body. Todos los demás campos son opcionales.

  • Filtrado por contexto de usuario y control de acceso:Amazon Kendra rastrea la lista de control de acceso (ACL) de sus documentos, si tiene una ACL para ellos. 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.

Para conectarse Amazon Kendra a SharePoint

  1. Inicie sesión en la consola AWS de administración y abra la Amazon Kendra consola.

  2. 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.

  3. En la página Introducción, seleccione Agregar origen de datos.

  4. En la página Agregar fuente de datos, elija el SharePoint conector v1.0 y, a continuación, elija Agregar fuente de datos.

  5. 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.

    2. (Opcional) Descripción: introduzca una descripción opcional para el origen de datos.

    3. En el 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.

    4. En Etiquetas, para añadir una nueva etiqueta: incluya etiquetas opcionales para buscar y filtrar sus recursos o realizar un seguimiento de sus AWS costes.

    5. Elija Next (Siguiente).

  6. 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 el SharePointmodo en línea: introduzca el sitio URLs específico de su repositorio. SharePoint

      2. Para el SharePointservidor: elija su SharePoint versión, introduzca el sitio URLs específico de su SharePoint repositorio e introduzca la Amazon S3 ruta a la ubicación de su certificado SSL.

    2. (Solo SharePoint servidor) Para el proxy web: introduzca el nombre de host y el número de puerto de la instancia interna SharePoint . El número de puerto debe ser un valor numérico entre 0 y 65535.

    3. En Autenticación: elija entre las siguientes opciones según el caso de uso:

      1. Para conexión SharePoint en línea: elija entre la autenticación básica y OAuth la autenticación 2.0.

      2. Para el SharePoint servidor: elija entre Ninguno, LDAP y Manual.

    4. Para 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.

    5. Introduzca la siguiente información adicional en la ventana Crear un secreto de AWS Secrets Manager :

      1. Elija entre las siguientes opciones de autenticación SharePoint en la nube, según su caso de uso:

        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.

        2. OAuth Autenticación 2.0: introduzca SharePoint el nombre de usuario de su SharePoint cuenta como nombre de usuario, la contraseña de la cuenta como contraseña, su SharePoint ID único generado automáticamente como ID de cliente y la cadena de secreto compartido utilizada por ambos SharePoint y Amazon Kendra como secreto de cliente.

      2. Elija una de las siguientes opciones de autenticación SharePoint del servidor, según su caso de uso:

        1. Ninguna: introduzca el nombre de usuario de su SharePoint cuenta como nombre de usuario, la contraseña de su SharePoint cuenta como contraseña y el nombre de dominio del servidor.

        2. LDAP: introduzca el nombre de usuario de su SharePoint cuenta como nombre de usuario, la contraseña de la SharePoint cuenta como contraseña, el punto de conexión del servidor LDAP (incluidos el protocolo y el número de puerto, por ejemploldap://example.com:389) y su base de búsqueda de LDAP (por ejemplo,). dc=example, dc=com

        3. Manual: introduzca el nombre de usuario de su SharePoint cuenta como nombre de usuario, la contraseña de su 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).

      3. Seleccione Guardar.

    6. Nube privada virtual (VPC): también debe agregar Subredes y Grupos de seguridad de VPC.

      nota

      Debe usar una VPC si usa SharePoint Server. Amazon VPC es opcional para otras SharePoint versiones.

    7. IAM rol: elija un IAM rol existente o cree uno nuevo IAM para acceder a las credenciales del 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.

    8. Elija Next (Siguiente).

  7. 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.

    2. Rastrear archivos adjuntos: seleccione esta opción para rastrear los archivos adjuntos.

    3. Utilizar asignaciones de grupos locales: seleccione esta opción para asegurarse de que los documentos se filtran correctamente.

    4. Configuración adicional: añada patrones de expresión regular para incluir o excluir determinados archivos. Puede agregar hasta 100 patrones.

    5. En Programa de ejecución de sincronización, en Frecuencia: la frecuencia con la que Amazon Kendra se sincronizará con el origen de datos.

    6. Elija Next (Siguiente).

  8. 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.

    2. 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.

    3. Elija Next (Siguiente).

  9. 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.

Más información

Para obtener más información sobre la integración Amazon Kendra con su fuente SharePoint de datos, consulte:

PrivacidadTérminos del sitioPreferencias de cookies
© 2025, Amazon Web Services, Inc o sus afiliados. Todos los derechos reservados.