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

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

Confluence Connector V1.0

Confluence es una herramienta colaborativa de gestión del trabajo diseñada para compartir, almacenar y trabajar en la planificación de proyectos, el desarrollo de software y la gestión de productos. Puedes utilizarla Amazon Kendra para indexar tus espacios, páginas (incluidas las páginas anidadas), blogs, comentarios y archivos adjuntos de páginas y blogs indexados de Confluence.

nota

El conector ConfluenceConfiguration V1.0/API de Confluence finalizó en 2023. Recomendamos migrar o utilizar el conector V2.0/API de Confluence. TemplateConfiguration

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

Características admitidas

Amazon Kendra El conector de fuente de datos de Confluence admite las siguientes funciones:

  • Asignaciones de campos

  • Control de acceso de usuarios

  • Filtros de inclusión/exclusión

  • (Solo para Confluence Server) Nube privada virtual (VPC)

Requisitos previos

Antes de poder utilizarla Amazon Kendra para indexar tu fuente de datos de Confluence, realiza estos cambios en tu Confluence y AWS en tus cuentas.

En Confluence, asegúrese de que:

  • Has concedido Amazon Kendra permisos para ver todo el contenido de tu instancia de Confluence de la siguiente manera:

    • Hacer Amazon Kendra miembro de un confluence-administrators grupo.

    • Ha otorgado permisos de administrador del sitio para todos los espacios, blogs y páginas existentes.

  • Ha copiado la dirección URL de la instancia de Confluence.

  • Para los usuarios de SSO (inicio de sesión único): ha activado la página Mostrar al iniciar sesión para el nombre de usuario y la contraseña al configurar los Métodos de autenticación de Confluence en el centro de datos de Confluence.

  • Para Confluence Server

    • Ha apuntado sus credenciales de autenticación básica, que incluyen el nombre de usuario y la contraseña de su cuenta administrativa de Confluence para conectarse a Amazon Kendra.

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

    • Opcional: ha generado un token de acceso personal en la cuenta de Confluence para conectarse a Amazon Kendra. Para obtener más información, consulte la Documentación de Confluence sobre la generación de tokens de acceso personal.

  • Para Confluence Cloud

    • Ha apuntado sus credenciales de autenticación básica, que incluyen el nombre de usuario y la contraseña de su cuenta administrativa de Confluence para conectarse a Amazon Kendra.

  • Ha comprobado que cada documento es único en Confluence y en otros orígenes de datos que vaya a utilizar 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. IDs Los documentos son globales para 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.

  • Ha guardado sus credenciales de autenticación de Confluence 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 tienes un IAM rol o un secreto existente, puedes usar la consola para crear un nuevo IAM rol y un Secrets Manager secreto al conectar tu fuente de datos de Confluence. 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 conectarte Amazon Kendra a tu fuente de datos de Confluence, debes proporcionar los detalles de tus credenciales de Confluence para que Amazon Kendra puedas acceder a tus datos. Si aún no has configurado Confluence para consultarlo. Amazon Kendra Requisitos previos

Console

Para conectarse a Amazon Kendra Confluence

  1. Inicia sesión en la consola AWS de administración y abre 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 origen de datos, elija el Confluence Connector V1.0 y, a continuación, elija Agregar origen 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. Elige entre Confluence Cloud y Confluence Server.

    2. Si eliges Confluence Cloud, introduce la siguiente información:

      1. URL de Confluence: la URL de Confluence.

      2. AWS Secrets Manager secreto: elige un secreto existente o crea uno nuevo para almacenar tus Secrets Manager credenciales de autenticación de Confluence. 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-Confluence» se añade automáticamente a tu nombre secreto.

          2. Para el nombre de usuario y la contraseña: introduce tu nombre de usuario y contraseña de Confluence.

          3. Seleccione Guardar autenticación.

    3. Si eliges Confluence Server, introduce la siguiente información:

      1. URL de Confluence: su nombre de usuario y contraseña de Confluence.

      2. (Opcional) Para el Proxy web, introduzca la siguiente información:

        1. Nombre de host: nombre de host de su cuenta de Confluence.

        2. Número de puerto: puerto utilizado por el protocolo de transporte de URL del host.

      3. Para la autenticación, elige la autenticación básica o el token de acceso personal (solo en el servidor de Confluence).

      4. AWS Secrets Manager secreto: elige un secreto existente o crea uno nuevo para almacenar tus Secrets Manager credenciales de autenticación de Confluence. 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-Confluence» se añade automáticamente a tu nombre secreto.

          2. Para el nombre de usuario y la contraseña: introduce los valores de las credenciales de autenticación que configuraste en Confluence. Si utilizas la autenticación básica, utiliza tu nombre de usuario (ID de correo electrónico) y contraseña (token de API) de Confluence. Si utilizas un token de acceso personal, introduce los detalles del token de acceso personal que configuraste en la cuenta de Confluence.

          3. Guarda y añade tu secreto.

    4. IAM rol: elige un IAM rol existente o crea 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.

    5. Elija Next (Siguiente).

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

    1. En Incluir espacios personales e Incluir espacios archivados: elija los tipos de espacio opcionales que desee incluir en este origen de datos.

    2. En Configuración adicional: especifique los patrones de expresión regular para incluir o excluir cierto contenido. Puede agregar hasta 100 patrones.

    3. También puede elegir Rastrear archivos adjuntos dentro de los espacios elegidos.

    4. Calendario de ejecución sincronizado, para Frecuencia: elija la frecuencia con la que Amazon Kendra se sincronizará con la fuente de datos.

    5. Elija Next (Siguiente).

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

    1. Para espacio, página o blog: seleccione entre los campos de fuente de datos predeterminados Amazon Kendra generados o las asignaciones de campos sugeridas adicionales para agregar campos de í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 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 Confluence Amazon Kendra

Debes especificar lo siguiente mediante la ConfluenceConfigurationAPI:

  • Versión de Confluence: especifique la versión de la instancia de Confluence que está utilizando como CLOUD o SERVER.

  • Nombre secreto de recurso de Amazon (ARN): proporciona el nombre de recurso de Amazon (ARN) de un Secrets Manager secreto que contenga tus credenciales de autenticación de Confluence.

    Si utilizas Confluence Server, puedes usar tu nombre de usuario y contraseña de Confluence o tu token de acceso personal como credenciales de autenticación.

    Si utilizas tu nombre de usuario y contraseña de Confluence como credenciales de autenticación, guardas las siguientes credenciales como una estructura JSON en tu secreto: Secrets Manager

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

    Si utilizas un token de acceso personal para conectarte a Confluence Server Amazon Kendra, guardas las siguientes credenciales como una estructura JSON en tu Secrets Manager secreto:

    { "patToken": "personal access token" }

    Si utilizas Confluence Cloud, utilizas tu nombre de usuario de Confluence y un token de API, configurado en Confluence, como contraseña. Guardas las siguientes credenciales como una estructura JSON en tu secreto: Secrets Manager

    { "username": "user name", "password": "API token" }
  • IAM rol: especifica RoleArn cuándo llamas CreateDataSource para proporcionar un IAM rol con permisos para acceder a tu Secrets Manager secreto y para llamar al público requerido APIs para el conector de Confluence y. Amazon Kendra Para obtener más información, consulte Roles de IAM para orígenes de datos de Confluence.

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

  • Proxy web: si conectarse a la instancia de la URL de Confluence a través de un proxy web. Puede utilizar esta opción para Confluence Server.

  • (Solo para Confluence Server) Nube privada virtual (VPC): especifique VpcConfiguration como parte de la configuración del origen de datos. Consulte Configuración Amazon Kendra para usar una VPC.

  • Filtros de inclusión y exclusión: especifique patrones de expresiones regulares para incluir o excluir determinados espacios, publicaciones de blog, páginas y archivos adjuntos. Si decide indexar los archivos adjuntos, solo se indexarán los adjuntos de las páginas y blogs indexados.

    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 Confluence 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 a Amazon Kendra Confluence

  1. Inicia sesión en la consola AWS de administración y abre 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 origen de datos, elija el Confluence Connector V1.0 y, a continuación, elija Agregar origen 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. Elige entre Confluence Cloud y Confluence Server.

    2. Si eliges Confluence Cloud, introduce la siguiente información:

      1. URL de Confluence: la URL de Confluence.

      2. AWS Secrets Manager secreto: elige un secreto existente o crea uno nuevo para almacenar tus Secrets Manager credenciales de autenticación de Confluence. 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-Confluence» se añade automáticamente a tu nombre secreto.

          2. Para el nombre de usuario y la contraseña: introduce tu nombre de usuario y contraseña de Confluence.

          3. Seleccione Guardar autenticación.

    3. Si eliges Confluence Server, introduce la siguiente información:

      1. URL de Confluence: su nombre de usuario y contraseña de Confluence.

      2. (Opcional) Para el Proxy web, introduzca la siguiente información:

        1. Nombre de host: nombre de host de su cuenta de Confluence.

        2. Número de puerto: puerto utilizado por el protocolo de transporte de URL del host.

      3. Para la autenticación, elige la autenticación básica o el token de acceso personal (solo en el servidor de Confluence).

      4. AWS Secrets Manager secreto: elige un secreto existente o crea uno nuevo para almacenar tus Secrets Manager credenciales de autenticación de Confluence. 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-Confluence» se añade automáticamente a tu nombre secreto.

          2. Para el nombre de usuario y la contraseña: introduce los valores de las credenciales de autenticación que configuraste en Confluence. Si utilizas la autenticación básica, utiliza tu nombre de usuario (ID de correo electrónico) y contraseña (token de API) de Confluence. Si utilizas un token de acceso personal, introduce los detalles del token de acceso personal que configuraste en la cuenta de Confluence.

          3. Guarda y añade tu secreto.

    4. IAM rol: elige un IAM rol existente o crea 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.

    5. Elija Next (Siguiente).

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

    1. En Incluir espacios personales e Incluir espacios archivados: elija los tipos de espacio opcionales que desee incluir en este origen de datos.

    2. En Configuración adicional: especifique los patrones de expresión regular para incluir o excluir cierto contenido. Puede agregar hasta 100 patrones.

    3. También puede elegir Rastrear archivos adjuntos dentro de los espacios elegidos.

    4. Calendario de ejecución sincronizado, para Frecuencia: elija la frecuencia con la que Amazon Kendra se sincronizará con la fuente de datos.

    5. Elija Next (Siguiente).

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

    1. Para espacio, página o blog: seleccione entre los campos de fuente de datos predeterminados Amazon Kendra generados o las asignaciones de campos sugeridas adicionales para agregar campos de í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 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 tu fuente de datos de Confluence, consulta:

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