Microsoft Yammer - Amazon Kendra
Características admitidasRequisitos previosInstrucciones de conexiónMás informació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 Yammer

Microsoft Yammer es una herramienta de colaboración empresarial para mensajería, reuniones e intercambio de archivos. Si es usuario de Microsoft Yammer, puede usarlo Amazon Kendra para indexar su fuente de datos de Microsoft Yammer.

Puede conectarse Amazon Kendra a la fuente de datos de Microsoft Yammer mediante la Amazon Kendra consola y la TemplateConfigurationAPI.

Para solucionar problemas del conector de fuente de datos de Amazon Kendra Microsoft Yammer, consulteSolución de problemas con los orígenes de datos.

Características admitidas

  • Asignaciones de campo

  • Filtros de inclusión/exclusión

  • Sincronizaciones de contenido completas e incrementales

  • Nube privada virtual (VPC)

Requisitos previos

Antes de poder utilizarla Amazon Kendra para indexar la fuente de datos de Microsoft Yammer, realice estos cambios en su cuenta y AWS en su cuenta de Microsoft Yammer.

En Microsoft Yammer, asegúrese de que:

  • Creó una cuenta administrativa de Microsoft Yammer en Office 365.

  • Apuntó su nombre de usuario y contraseña de Microsoft Yammer.

  • Ha apuntado su ID de inquilino de Microsoft 365. Puede encontrar su ID de inquilino en las propiedades de su portal de Azure Active Directory o en su aplicación OAuth.

  • Creó una aplicación OAuth en el portal Azure y anotó el ID de cliente y el secreto de cliente o las credenciales de cliente. Consulte el tutorial de Microsoft y el ejemplo de aplicación registrada para obtener más información.

    nota

    Al crear o registrar una aplicación en el portal de Azure, el ID secreto representa el valor secreto real. Debe anotar o guardar el valor secreto real inmediatamente al crear el secreto y la aplicación. Para acceder a su secreto, seleccione el nombre de la aplicación en el portal de Azure y, a continuación, vaya a la opción de menú relativa a los certificados y secretos.

    Para acceder a su ID de cliente, seleccione el nombre de su aplicación en el portal de Azure y, a continuación, vaya a la página de información general. El ID de la aplicación (cliente) es el ID del cliente.

  • Comprobó que cada documento es único en Microsoft Yammer y en otros orígenes que planea usar para el mismo índice. 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 el suyo Cuenta de AWS, asegúrese 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.

  • Ha guardado sus credenciales de autenticación de Microsoft Yammer en un secreto de AWS Secrets Manager y, si utiliza la API, ha anotado 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 Secrets Manager secreto al conectar la fuente de datos de Microsoft Yammer a 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 la fuente de datos de Microsoft Yammer, debe proporcionar los detalles necesarios de la fuente de datos de Microsoft Yammer para que Amazon Kendra pueda acceder a los datos. Si aún no ha configurado Microsoft Yammer para Amazon Kendra, consulteRequisitos previos.

Console

Para conectarse Amazon Kendra a Microsoft Yammer

  1. Inicie sesión en la Amazon Kendra consola AWS Management Console y ábrala.

  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 conector de Microsoft Yammer y, a continuación, elija Agregar conector.

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

  6. En la página Definir acceso y seguridad, introduzca la siguiente información:

    1. Fuente: utilice la URL de Microsoft Yammer.

    2. AWS Secrets Manager secreto: elija un secreto existente o cree uno nuevo Secrets Manager para almacenar sus credenciales de autenticación de Microsoft Yammer. Si decide crear un secreto nuevo, se abrirá una ventana de secreto de AWS Secrets Manager .

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

        1. Nombre del secreto: un nombre para su secreto. El prefijo 'AmazonKendra-Microsoft Yammer-' se añade automáticamente a tu nombre secreto.

        2. Para Nombre de usuario y Contraseña: introduzca su nombre de usuario y contraseña de Microsoft Yammer.

        3. En ID de cliente y Secreto de cliente: introduzca los valores de las credenciales de autenticación que creó en la cuenta de Microsoft Yammer en el portal de Azure.

      2. Seleccione Guardar.

    3. Nube privada virtual (VPC): puede optar por utilizar una VPC. Si es así, debe agregar Subredes y Grupos de seguridad de VPC.

    4. Rastreador de identidad: especifique si se debe activar el rastreador de identidad. Amazon Kendra El rastreador de identidades utiliza la información de la lista de control de acceso (ACL) de los documentos para filtrar los resultados de la búsqueda en función del acceso del usuario o de su grupo a los documentos. Si tiene una ACL para sus documentos y decide utilizarla, también puede optar por activar el rastreador de identidades para configurar el filtrado Amazon Kendra de los resultados de búsqueda según el contexto del usuario. De lo contrario, si el rastreador de identidades está desactivado, se pueden realizar búsquedas públicas en todos los documentos. Si quieres usar el control de acceso para tus documentos y el rastreador de identidad está desactivado, también puedes usar la PutPrincipalMappingAPI para cargar información de acceso de usuarios y grupos para filtrar el contexto de los usuarios.

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

    6. Elija Siguiente.

  7. En la página Configurar ajustes de sincronización, introduzca la siguiente información:

    1. Desde la fecha: especifique la fecha para empezar a rastrear los datos en Microsoft Yammer.

    2. Sincronizar contenido: seleccione el tipo de contenido que desee indexar. Por ejemplo, mensajes públicos, mensajes privados y archivos adjuntos.

    3. Configuración adicional: si lo desea, puede utilizar estas opciones para indexar determinados contenidos en lugar de sincronizar todos los documentos. Por ejemplo, puede indexar nombres de comunidades específicas y utilizar patrones de expresiones regulares para incluir o excluir determinados archivos.

    4. Modo de sincronización: puede elegir cómo desea actualizar el índice cuando cambie el contenido del origen de datos.

      1. Si elige la sincronización completa, Amazon Kendra sincronizará todos los contenidos de todas las entidades, independientemente del estado de sincronización anterior.

      2. Si elige la sincronización de contenido nuevo o modificado, Amazon Kendra solo sincronizará el contenido nuevo o modificado.

      3. Si eliges la sincronización de contenido nuevo, modificado o eliminado, Amazon Kendra solo sincronizará el contenido nuevo, modificado o eliminado.

  8. En la página Establecer asignaciones de campos, especifique la siguiente información:

    1. Campos de fuente de datos predeterminados: seleccione entre los campos de fuente de datos predeterminados Amazon Kendra generados que desee asignar a su índice.

    2. Agregar campo: para agregar campos de origen de datos personalizados para crear un nombre de campo de índice al que asignarlos y el tipo de datos del campo.

    3. Elija 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 Amazon Kendra a Microsoft Yammer

Debe especificar un JSON del esquema de la fuente de datos mediante la TemplateConfigurationAPI. Debe proporcionar la siguiente información:

  • Fuente de datos: especifique el tipo de fuente de datos como YAMMER cuando utiliza el esquema TemplateConfigurationJSON. Especifique también la fuente de datos TEMPLATE al llamar a la CreateDataSourceAPI.

  • Modo de sincronización: especifique si Amazon Kendra debe actualizar su índice sincronizando todos los documentos o solo los documentos nuevos, modificados y eliminados. Puede elegir entre las opciones siguientes:

    • FORCED_FULL_CRAWL para volver a rastrear todo el contenido y reemplazar el contenido existente cada vez que el origen de datos se sincronice con el índice.

    • FULL_CRAWL para rastrear de forma incremental solo el contenido nuevo, modificado y eliminado cada vez que el origen de datos se sincronice con el índice.

    • CHANGE_LOG para rastrear de forma incremental solo el contenido nuevo y modificado cada vez que el origen de datos se sincronice con el índice.

  • 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 de su cuenta de Microsoft Yammer. El secreto se almacena en una estructura JSON con las siguientes claves:

    {
    "username": "user name",
    "password": "password",
    "clientId": "client ID",
    "clientSecret": "client secret"
}
    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).

  • IAM rol: especifique RoleArn cuándo llama CreateDataSource para proporcionar un IAM rol con permisos para acceder a su Secrets Manager secreto y para llamar a las API públicas requeridas para el conector de Microsoft Yammer y. Amazon Kendra Para obtener más información, consulte los roles de IAM para los orígenes de datos de Microsoft Yammer.

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

  • Nube privada virtual (VPC): especifique a VpcConfiguration cuándo llamar a CreateDataSource. Para obtener más información, consulte Configuración Amazon Kendra para usar un Amazon VPC.

  • Filtros de inclusión y exclusión: especifique 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.

  • Rastreador de identidad: especifique si se debe activar el rastreador de identidad. Amazon Kendra El rastreador de identidades utiliza la información de la lista de control de acceso (ACL) de los documentos para filtrar los resultados de la búsqueda en función del acceso del usuario o de su grupo a los documentos. Si tiene una ACL para sus documentos y decide utilizarla, también puede optar por activar el rastreador de identidades para configurar el filtrado Amazon Kendra de los resultados de búsqueda según el contexto del usuario. De lo contrario, si el rastreador de identidades está desactivado, se pueden realizar búsquedas públicas en todos los documentos. Si quieres usar el control de acceso para tus documentos y el rastreador de identidad está desactivado, también puedes usar la PutPrincipalMappingAPI para cargar información de acceso de usuarios y grupos para filtrar el contexto de los usuarios.

  • Asignaciones de campos: elija asignar los campos del origen de datos de Microsoft Yammer 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.

Más información

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