Microsoft OneDrive conector V1.0 - Amazon Kendra
Características admitidasRequisitos previosInstrucciones de conexión

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.

Microsoft OneDrive conector V1.0

Microsoft OneDrive es un servicio de almacenamiento en la nube de. Puede usar para almacenar, compartir y hospedar su contenido de. Puedes usarAmazon Kendrapara indexar tu Microsoft OneDrive Origen de datos.

nota

Support para OneDrive conector V1.0/ Microsoft OneDrive Está previsto que la API finalice en junio de 2023. Elección de utilizar OneDrive conector V2.0/ TemplateConfiguration API.

Para solucionar problemas de suAmazon Kendra OneDrive conector de fuente de datos, consulteSolución de problemas de fuentes de datos.

Características admitidas

  • asignado de datos

  • Filtros de inclusión/exclusión

Requisitos previos

Antes de poder usarlosAmazon Kendrapara indexar su OneDrive fuente de datos, realice estos cambios en su OneDrive yAWScuentas.

En su Azure Active Directory (AD), asegúrese de que tiene:

  • Creó una aplicación de Azure Active Directory (AD).

  • Utilizó el ID de la aplicación de AD para registrar una clave secreta para la aplicación en el sitio de AD. La clave secreta debe contener el ID de la aplicación y una clave secreta.

  • Se ha copiado el dominio de AD de la organización.

  • Se agregaron los siguientes permisos a su aplicación de AD en la opción Microsoft Graph:

    • Lea los archivos de todas las colecciones de sitios (File.Read-All)

    • Lea el perfil completo de todos los usuarios (User.Read.All)

    • Lea los datos del directorio (Directory.Read.All)

    • Leer todos los grupos (Group.Read.All)

    • Lea los elementos de todas las colecciones de sitios (Site.Read.All)

  • Se ha copiado la lista de usuarios cuyos documentos deben indexarse. Puede elegir entre proporcionar una lista de nombres de usuario o puede proporcionarlos en un archivo almacenado enAmazon S3. Tras crear la fuente de datos, puede:

    • Modificar la lista de usuarios.

    • Cambiar de una lista de usuarios a una lista almacenada en unAmazon S3balde.

    • Cambia elAmazon S3ubicación del depósito de una lista de usuarios. Si cambias la ubicación del depósito, también debes actualizar elIAMrol para la fuente de datos para que tenga acceso al depósito.

      nota

      Si almacena la lista de nombres de usuario en unAmazon S3bucket, elIAMla política de la fuente de datos debe proporcionar acceso al depósito y acceso a la clave con la que se cifró el depósito, si la hubiera.

  • Se ha marcado que cada documento es único en OneDrive y en otras fuentes de datos que vaya a utilizar para el mismo índice. Cada fuente de datos que desee utilizar para un índice no debe contener el mismo documento en todas las fuentes de datos. Los ID de los documentos son globales para un índice y deben ser únicos para cada índice.

En tuCuenta de AWS, asegúrese de tener:

  • Creó unAmazon Kendraíndicey, si utiliza la API, anota el ID del índice.

  • Creó unIAMpapelpara su fuente de datos y, si utiliza la API, anotó el ARN delIAMrol.

    nota

    Si cambia el tipo de autenticación y las credenciales, debe actualizar susIAMrol para acceder a la correctaAWS Secrets Manageridentificador secreto.

  • Guardó su OneDrive credenciales de autenticación en unAWS Secrets Managersecreto y, si se utiliza la API, anota el ARN del secreto.

    nota

    Le recomendamos que actualice o modifique sus credenciales y su secreto con regularidad. Proporcione solo el nivel de acceso necesario para su propia seguridad. Lo hacemosnole recomendamos que vuelva a utilizar las credenciales y los secretos en todas las fuentes de datos y en las versiones 1.0 y 2.0 del conector (si procede).

Si no tiene unIAMrol o secreto, puede usar la consola para crear un nuevoIAMrol ySecrets Managersecreto cuando conectas tu OneDrive Origen de datos paraAmazon Kendra. Si está utilizando la API, debe proporcionar el ARN de unaIAMrol ySecrets Managersecreto y un identificador de índice.

Instrucciones de conexión

Para conectarseAmazon Kendraa tu OneDrive fuente de datos, debe proporcionar detalles de su OneDrive credenciales para queAmazon Kendrapuede acceder a sus datos. Si aún no lo ha configurado OneDrive porAmazon KendraverRequisitos previos.

Console

Para conectarseAmazon Kendraa OneDrive

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

  2. En el panel de navegación izquierdo, elijaÍndicesy, a continuación, elija el índice que desee usar de la lista de índices.

    nota

    Puede elegir configurar o editar suControl de acceso de usuarioconfiguración enConfiguración del índice.

  3. En elElección de los pasospágina, eligeElección de fuente de datos.

  4. En elElección de fuente de datospágina, elijaOneDrive conectory, a continuación, Elección deElección de fuente de datos.

  5. En elEspecifique los detalles de la fuente de datospágina, introduzca la siguiente información:

    1. EnNombre y descripción, paraNombre de fuente de datos—Introduzca un nombre para la fuente de datos. Puede incluir guiones pero no espacios.

    2. (Opcional)Descripción—Introduzca una descripción opcional para la fuente de datos.

    3. EnIdioma, paraIdioma por defecto: 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. EnEtiquetas, paraAñadir nueva etiqueta—Etiquetas para buscar y filtrar sus recursos o para rastrear susAWScostos.

    5. Elija Siguiente.

  6. En elElección de las credenciales de acceso y seguridadpágina, introduzca la siguiente información:

    1. OneDrive ID de inquilino—Introduzca OneDrive ID de inquilino sin el protocolo.

    2. Tipo de autenticación—Elija entre¿NuevoyExistente.

      1. Si eliges¿Existente, seleccione un secreto existente paraSelecciona un secreto.

      2. Si eliges¿Nuevo, introduzca la siguiente información en elNuevoAWS Secrets Managersecretosección:

        1. Nombre secreto—Un nombre para tu secreto. El prefijo 'AmazonKendra-OneDrive-' se añade automáticamente a tu nombre secreto.

        2. ¿ParaID de la aplicaciónyContraseña de aplicación—Introduzca los valores de las credenciales de autenticación de su OneDrive cuenta y, a continuación, elijaElección de la autenticación.

    4. IAMpapel—Elige un existenteIAMrol o crea uno nuevoIAMrol para acceder a las credenciales del repositorio y al contenido del índice.

      nota

      IAMlos 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, elijaElección de un rol nuevopara evitar errores.

    5. Elija Siguiente.

  7. En elConfigurar los ajustes de sincronizaciónpágina, introduzca la siguiente información:

    1. Elige entreArchivo de listayListado de nombresen base a su caso de uso.

      1. Si eligesArchivo de lista, introduzca la siguiente información:

        1. Elección de la ubicación—Elección de la ruta de acceso a suAmazon S3balde.

          Añadir un archivo de lista de usuarios aAmazon S3—Seleccione esta opción para añadir los archivos de su lista de usuarios a suAmazon S3cubo.

          Mapeos de grupos locales de usuarios—Seleccione utilizar el mapeo de grupos locales para filtrar el contenido.

      2. Si eligesListado de nombres, introduzca la siguiente información:

        1. Nombre de usuario—Introduzca hasta 10 unidades de usuario para indexarlas. Para añadir más de 10 usuarios, cree un archivo que contenga los nombres.

          Añada otro—Elija añadir más usuarios.

          Asignaciones de grupos locales de usuarios—Seleccione utilizar el mapeo de grupos locales para filtrar el contenido.

    2. ¿ParaConfiguraciones adicionales—Añada patrones de expresiones regulares para incluir o excluir ciertos archivos. Puede añadir hasta 100 patrones.

    3. EnSincronizar el horario de ejecución, paraFrecuencia—Elige con qué frecuenciaAmazon Kendrase sincronizará con su fuente de datos.

    4. Elija Siguiente.

  8. En elElección de las asignaciones de campopágina, introduzca la siguiente información:

    1. ParaElección de los campos de fuente de datosyAsignaciones de campo adicionales sugeridas—Seleccione una de lasAmazon Kendrageneró los campos de fuentes de datos predeterminados que desea asignar a su índice.

    2. Elija Siguiente.

  9. En elRevisar y crearpágina, compruebe que la información que ha introducido es correcta y, a continuación, seleccioneElección de fuente de datos. También puede optar por editar su información desde esta página. La fuente de datos aparecerá enOrigen de datospágina después de que la fuente de datos se haya agregado correctamente.

API

Para conectarseAmazon Kendraa OneDrive

Debe especificar lo siguiente con elOneDriveConfigurationAPI:

  • ID de inquilino—Especifique el dominio de Azure Active Directory de la organización.

  • OneDrive Usuarios—Especifique la lista de cuentas de usuario cuyos documentos deben indexarse.

  • Nombre de recurso secreto de Amazon (ARN)—Proporcione el nombre de recurso de Amazon (ARN) de unSecrets Managersecreto que contiene las credenciales de autenticación de su OneDrive cuenta. El secreto se almacena en una estructura JSON con las siguientes claves:

    {
    "username": "OAuth client ID",
    "password": "client secret"
}
    nota

    Se recomienda que actualice o modifique sus credenciales y su secreto de. Proporcione solo el nivel de acceso necesario para su propia seguridad. Lo hacemosnole recomendamos que vuelva a utilizar las credenciales y los secretos en todas las fuentes de datos y en las versiones 1.0 y 2.0 del conector (si procede).

  • IAMpapel—EspecificarRoleArncuando llamasCreateDataSourcepara proporcionar unIAMrol con permisos para acceder a suSecrets Managersecreto y para llamar a las API públicas necesarias para OneDrive conector yAmazon Kendra. Para obtener más información, consulteIAMfunciones para OneDrive Origen de datos.

También puede añadir las siguientes funciones opcionales:

  • Filtros de inclusión y exclusión—Especifique si desea incluir o excluir determinados documentos.

    nota

    La mayoría de las fuentes 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.

  • asignado de datos—Elija mapear su OneDrive campos de fuente de datos a suAmazon Kendraindexar campos. Para obtener más información, consulte Mapping data source fields (Asignación de campos de origen de datos).

  • Filtrado de contexto de usuario—Amazon Kendrarastrea la lista de control de acceso (ACL) de la fuente de datos de forma predeterminada. La información de la ACL se utiliza para filtrar los resultados de la búsqueda en función del acceso del usuario o de su grupo a los documentos. Para obtener más información, consulteFiltrado de contexto de usuario para OneDrive Origen de datos.