Configura conectores externos para tareas de enriquecimiento

Los proveedores de autenticación de terceros te permiten conectar de forma segura las tareas de enriquecimiento de Knowledge Studio con plataformas externas, como GitHub, Microsoft SharePoint y Atlassian (Confluence y Jira). Completa los pasos de generación de credenciales y configuración del proveedor de autenticación que se indican en este documento como parte de la configuración de requisitos previos.

Antes de comenzar

Antes de configurar los conectores externos, completa los siguientes requisitos previos:

  • Revisa el flujo de trabajo general de configuración del enriquecimiento. Para obtener más información, consulta Configura los requisitos previos para las tareas de enriquecimiento.
  • Asegúrate de tener los permisos de administrador o desarrollador necesarios en tus plataformas de terceros de destino (GitHub, Microsoft SharePoint o Atlassian Confluence y Jira) para generar tokens de acceso o registrar aplicaciones.
  • Para almacenar credenciales de forma segura y adjuntarlas a las tareas, configura el servicio de identidad del agente. Para obtener más información, consulta la sección Configura los permisos de IAM para los proveedores de autenticación en Configura los requisitos previos para las tareas de enriquecimiento.

Cuando conectas el agente de enriquecimiento a fuentes de conocimiento de terceros, debes usar el servicio de identidad del agente de Google Cloud . Agent Identity actúa como un administrador de autenticación que almacena de forma segura tus credenciales de terceros y aprovisiona tokens de acceso de corta duración al agente de enriquecimiento para que los operadores humanos nunca tengan que administrar directamente los secretos de cliente sin procesar durante la ejecución de la tarea.

Configurar GitHub

Para conectar Knowledge Studio a los repositorios de GitHub, debes crear un token de acceso personal (PAT) detallado en GitHub y almacenarlo en un proveedor de autenticación de clave de API.

  1. Accede a GitHub, haz clic en tu foto de perfil y, luego, en Configuración.
  2. Ve a Developer settings > Personal access tokens > Fine-grained tokens.
  3. Haz clic en Generate new token.
  4. Configura las propiedades del token:
    • Nombre del token: Ingresa un nombre descriptivo (por ejemplo, enrichment-agent).
    • Vencimiento: Establece una fecha de vencimiento adecuada.
    • Propietario del recurso: Selecciona la organización o la cuenta de usuario propietaria de los repositorios de destino.
    • Acceso al repositorio: Selecciona Solo repositorios seleccionados y elige los repositorios que deseas enriquecer.
    • Permisos: Otorga acceso específico de Lectura o Lectura y escritura para los permisos requeridos (como Problemas, Solicitudes de extracción y Contenido).
  5. Haz clic en Generar token y copia el token de forma segura.
  6. Registra un proveedor de autenticación de clave de API en Google Cloud y proporciona el PAT como la clave de API.

Para obtener instrucciones sobre cómo registrar un proveedor de autenticación de clave de API, consulta la sección Crea el proveedor de autenticación de clave de API en Configura proveedores de autenticación de clave de API. Para obtener más información sobre cómo crear un PAT, consulta Administra tus tokens de acceso personal en la documentación de GitHub.

Configura Microsoft SharePoint

Si te conectas a Microsoft SharePoint, obtén credenciales de OAuth de Microsoft Entra ID (antes Azure Active Directory) con un flujo de OAuth de 2 segmentos.

  1. Registra una aplicación en el centro de administración de Microsoft Entra.
  2. Otorga permisos de la API de Microsoft Graph:
    1. Ve a Permisos de API > Agregar un permiso > Microsoft Graph > Permisos de la aplicación (no selecciones Permisos delegados).
    2. Agrega los permisos Sites.Read.All y Files.Read.All.
    3. Haz clic en Otorgar consentimiento de administrador para tu usuario, de modo que ambos permisos de la aplicación se muestren como "Otorgados".

  3. Crea un secreto del cliente y registra su valor de inmediato, ya que solo se muestra una vez.

  4. Copia los valores de configuración de tu aplicación. Después del registro, recopila los siguientes valores para la configuración de tu proveedor de autenticación:

    • ID de cliente: Es el ID de aplicación (cliente) de la descripción general de tu app.
    • URL del token: En la página Descripción general, haz clic en la pestaña Extremos. Copia la URL etiquetada como Extremo de token de OAuth 2.0 (v2).

  5. Registra un proveedor de autenticación de OAuth de 2 patas en Google Cloud con estos secrets. Cuando crees el proveedor, proporciona el permiso predeterminado al parámetro --allowed-scopes:

    --allowed-scopes="https://graph.microsoft.com/.default"

Para obtener más información sobre cómo registrar una aplicación y crear un secreto de cliente, consulta Registra una aplicación con la plataforma de identidad de Microsoft y Crea un nuevo secreto de cliente en la documentación de Microsoft Entra.

Configura Atlassian Confluence y Jira

Debido a que Atlassian no admite OAuth de 2 segmentos para agentes de servidor a servidor, debes crear una cuenta de servicio dedicada (o una cuenta de usuario dedicada) en Atlassian, otorgarle los permisos necesarios y generar un PAT.

  1. Accede a la cuenta de servicio dedicada en Atlassian.
  2. Haz clic en tu foto de perfil y, luego, selecciona Configuración (o Configuración de la cuenta) en el menú.
  3. En la pestaña Seguridad, ve a la sección Tokens de API.
  4. Haz clic en Crear token de API con permisos. No uses un token sin alcance, ya que no recuperará todas las herramientas necesarias.
  5. Proporciona un nombre descriptivo (por ejemplo, enrichment-agent), configura la fecha de vencimiento y haz clic en Siguiente.
  6. En la lista Selecciona la app, elige Atlassian MCP y haz clic en Siguiente.
  7. Selecciona todos los siguientes permisos de lectura y búsqueda de Confluence y Jira:
    • read:page:confluence
    • read:space:confluence
    • search:confluence
    • read:confluence-content.all
    • read:confluence-content.summary
    • read:confluence-space.summary
    • search:rovo:mcp
    • read:jira-work
  8. Haz clic en Siguiente y, luego, en Crear.
  9. Copia el token generado.
  10. Asigna el formato ATLASSIAN_EMAIL:API_TOKEN a la cadena de credenciales del proveedor de autenticación de Google Cloud . Atlassian requiere la codificación de autenticación básica de HTTP (email:api_token) para usar tokens de API personales de manera programática.
  11. Registra un proveedor de autenticación de clave de API en Google Cloud y proporciona la cadena ATLASSIAN_EMAIL:API_TOKEN como la clave de API.

Para obtener instrucciones sobre cómo registrar un proveedor de autenticación de clave de API, consulta la sección Crea el proveedor de autenticación de clave de API en Configura proveedores de autenticación de clave de API. Para obtener más información sobre cómo crear un PAT, consulta Administra tokens de API para tu cuenta de Atlassian en la documentación de Atlassian.

¿Qué sigue?