Conecta una fuente de datos de terceros

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta página, se describe cómo conectar fuentes de datos de terceros a Vertex AI Search.

Cuando conectas una fuente de datos de terceros, Vertex AI Search crea un conector de datos y lo asocia con almacenes de datos (llamados almacenes de datos de entidad) para las entidades que especifiques. Los tipos de entidades son específicos de la fuente de datos a la que te conectas. Por ejemplo, las entidades de Jira Cloud incluyen problemas, archivos adjuntos, comentarios y registros de trabajo.

Las fuentes de datos de terceros solo están disponibles para las apps de búsqueda genéricas. Las apps de chat, recomendaciones y agentes no pueden usar fuentes de datos de terceros.

Para importar datos desde una fuente de datos de Google, consulta Cómo crear un almacén de datos de búsqueda.

Si usas claves de encriptación administradas por el cliente, consulta Acerca de las claves de una sola región para conectores de terceros en la documentación de Agentspace de Google.

Antes de comenzar

1. Comunícate con tu equipo de Cuentas de Google y pídele que te agregue a la lista de entidades permitidas para los conectores de fuentes de datos de terceros.

2. Ve a la sección de la fuente que planeas usar:

   • Cómo conectar Adobe Experience Manager
   • Connect AODocs (lista de entidades permitidas adicional)
   • Cómo conectar Asana
   • Cuadro de conexión
   • Cómo conectar Coda
   • Cómo conectar Confluence Cloud
   • Cómo conectar Confluence Data Center de forma local
   • Cómo conectar DocuSign
   • Cómo conectar Dropbox
   • Cómo conectar Entra ID
   • Cómo conectar GitHub
   • Cómo conectar GitLab
   • Cómo conectar Jira Cloud
   • Cómo conectar Jira Data Center de forma local
   • Cómo conectar Marketo
   • Conectar Microsoft Outlook (lista de entidades permitidas adicional)
   • Conectar Microsoft Teams (lista de entidades permitidas adicional)
   • Conéctate el lunes
   • Connect Notion (lista de entidades permitidas adicional)
   • Cómo conectar Okta
   • Cómo conectar OneDrive
   • Cómo conectar Salesforce
   • Cómo conectar ServiceNow
   • Cómo conectar el centro de datos de SharePoint local
   • Cómo conectar SharePoint Online
   • Cómo conectar Slack
   • Cómo conectar WordPress
   • Conectar Zendesk (lista de entidades permitidas adicional)

Cómo conectar Adobe Experience Manager

Usa el siguiente procedimiento para sincronizar datos de Adobe Experience Manager con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

2. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

3. Un administrador de Adobe Experience Manager debe generar o obtener lo siguiente para integrarlo con Vertex AI Search:

   • Credenciales de servicio de tu instancia de Adobe Experience Manager
   • URL de la instancia de tu sitio de Adobe Experience Manager

Crea un conector de Adobe Experience Manager

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.

Cómo conectar AODocs

Usa el siguiente procedimiento para sincronizar datos de AODocs con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

2. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

3. Un administrador de AODocs debe generar o obtener lo siguiente para integrarlo con Vertex AI Search:

   • ID de instancia (URL de dominio de tu instancia de AODocs)
   • ID de cliente
   • Secreto del cliente

Crea un conector de AODocs

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Cómo obtener resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Cómo conectar Asana

Usa el siguiente procedimiento para sincronizar datos de Asana con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

• Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

• Un administrador de Asana debe generar o obtener el token de acceso personal (PAT) que se indica a continuación para la autenticación. Para obtener más información, consulta Token de acceso personal en la documentación de Asana.

Para invitar a un miembro a un espacio de trabajo de Asana, haz lo siguiente:

1. Accede a la aplicación de Asana con tu cuenta de administrador.

2. Selecciona el proyecto relevante.

3. En el diálogo Compartir visitantes, en Invitar con correo electrónico, haz lo siguiente:

   1. Haga clic en Invite.
   2. Ingresa la dirección de correo electrónico del usuario.
   3. Elige el nivel de permiso como Lector.

Para generar un PAT, haz lo siguiente:

1. Abre la Consola de Asana para desarrolladores.

2. Haz clic en Mis apps.

3. Haz clic en addCrear token.

4. En el diálogo Create new token, completa la información requerida.

5. Haz clic en Create token.

6. Copia el token para usarlo más adelante.

7. Haz clic en Listo.

Crea un conector de nube de Asana

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar tu app y el almacén de datos, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Connect Box

Usa el siguiente procedimiento para sincronizar datos de Box con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Debes tener acceso de administrador a la instancia de Box con la AUA habilitada. Todas las instrucciones de configuración solo se pueden realizar desde la cuenta de administrador.

2. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

3. Lee Configuración con JWT en la documentación de Box para obtener una descripción general de la configuración con capturas de pantalla.

Crea una app de Box

1. Accede a la Consola de desarrolladores de Box con tu cuenta de administrador.
2. Haz clic en Crear app de plataforma.
3. Selecciona Tipo de aplicación como Aplicación personalizada.
4. Ingresa el Nombre de la app.
5. Establece las siguientes propiedades:
   1. Propósito: Integración
   2. Categorías: IA
   3. Sistema externo: Google Cloud Aplicaciones de IA
6. Selecciona Método de autenticación como Autenticación del servidor (con JWT).
7. Haz clic en Crear aplicación.

Configura la app de Box

1. En la consola de desarrolladores de Box, elige la app de la plataforma y, luego, ve a la pestaña Configuración.
2. En la sección Nivel de acceso de la app, selecciona Acceso de la app y de la empresa.

3. En la sección Alcances de la aplicación, selecciona los siguientes alcances:

   1. Lee todos los archivos y carpetas almacenados en Box
   2. Cómo escribir todos los archivos y carpetas almacenados en Box
   3. Administra usuarios
   4. Administra grupos
   5. Administra propiedades empresariales

4. En la sección Funciones avanzadas, selecciona Realizar llamadas a la API con el encabezado como usuario.

5. En la sección Agregar y administrar claves públicas, haz clic en Generar un par de claves pública y privada.

   1. La clave pública se sube automáticamente a la consola con un ID. Este ID se usa cuando se crea una conexión.
   2. Puedes descargar un archivo de configuración con la clave privada y la frase de contraseña. Asegúrate de conservar este archivo para usarlo más adelante.
   3. De manera opcional, para generar tu propia clave, consulta la guía de configuración del par de claves de Box.

6. Haz clic en Guardar cambios.

Autoriza la app de Box

1. En la consola de desarrolladores de Box, elige la app de la plataforma y, luego, ve a la pestaña Autorización.
2. Haz clic en Revisar y enviar.
3. En el diálogo Review app authorization submission, haz clic en Submit.
4. Accede al administrador de apps de la plataforma de administración de Box con tu cuenta de administrador.
5. Elige la app de la plataforma que configuraste.
6. Haz clic en los tres puntos (…) en la fila correspondiente.
7. Selecciona Autorizar app en la lista desplegable.
8. En el diálogo Autorizar app, haz clic en Autorizar para completar el proceso de autorización.

Ten a mano la siguiente información de autenticación de Box:

• ID de la empresa: Obtén este ID en la pestaña Configuración general.
• ID de cliente y Secreto del cliente: Obténlos en la pestaña Configuración en Credenciales de OAuth 2.0.
• Clave privada, ID de clave y Frase de contraseña: Estos parámetros ya se generaron y descargaron en un archivo local desde la pestaña Configuración en Agregar y administrar claves públicas mientras configurabas la app.

Crea un conector de Box

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecen los resultados de la búsqueda después de configurar tu app y el almacén de datos, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Conecta Coda

Usa el siguiente procedimiento para sincronizar datos de Coda con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

2. Un administrador de Coda debe generar o obtener el token de la API de Coda para integrarlo con Vertex AI Search.

Crea un conector de Coda

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.

Conecta Confluence Cloud

Usa el siguiente procedimiento para sincronizar datos de Confluence Cloud con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, puedes elegir la frecuencia con la que el almacén de datos se sincroniza con esa fuente.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Verifica que tienes acceso de administrador a la instancia y al proyecto de Confluence.

2. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

Configura la autenticación y los permisos en Confluence

Asegúrate de tener los detalles de autenticación y el acceso de administrador necesarios a tu instancia de Confluence. Usa las siguientes instrucciones para crear un ID de cliente y un secreto del cliente a través de la consola de Atlassian Developer, configurar los alcances de OAuth 2.0 requeridos, configurar los permisos de los usuarios, recuperar la URL y el ID de tu instancia, configurar roles y autenticar para sincronizar datos entre Confluence Cloud y Vertex AI Search. Para habilitar OAuth 2.0 y obtener el ID y el secreto de cliente, consulta Apps de OAuth 2.0 (3LO) en la documentación de Atlassian Developer. Asegúrate de tener los detalles de autenticación y el acceso de administrador necesarios a tu instancia de Confluence. Usa las siguientes instrucciones para crear un ID de cliente y un secreto del cliente a través de la consola de Atlassian Developer, configurar los alcances de OAuth 2.0 requeridos, configurar los permisos de los usuarios, recuperar la URL y el ID de tu instancia, configurar roles y autenticar para sincronizar datos entre Confluence Cloud y Vertex AI Search. Para habilitar OAuth 2.0 y obtener el ID y el secreto de cliente, consulta Apps de OAuth 2.0 (3LO) en la documentación de Atlassian Developer.

1. Crea una integración de OAuth 2.0 en la Consola de Atlassian Developer:

   1. Accede a la consola de Atlassian Developer.

   2. Haz clic en el ícono de perfil y selecciona Consola de desarrollador.

      

   3. Haz clic en el ícono de perfil y selecciona Consola de desarrollador.

      

   4. Haz clic en Crear y selecciona Integración de OAuth 2.0.

      

      

   5. Ingresa un nombre para la app y haz lo siguiente:

      1. Marca la casilla de verificación de los Términos y Condiciones.

      2. Haz clic en Crear.

         

         

      3. Haz clic en Autorización.

      4. En la tabla Authorization type, selecciona Add para OAuth 2.0 (3LO).

         

         

   6. En el campo URL de devolución de llamada, ingresa https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html.

   7. Haz clic en Guardar cambios.

      

   Si ves la advertencia: Tu app no tiene ninguna API. Agrega APIs a tu app, continúa con el paso 2 en la siguiente sección y completa todos los pasos restantes. De lo contrario, continúa con el paso 4 en esa misma sección.

Para configurar OAuth 2.0 y recuperar las credenciales necesarias para la configuración del conector de Confluence, haz lo siguiente:

1. Habilita OAuth 2.0:

   1. Haz clic en Permisos.

      

      

   2. Ve a la API de Confluence.

   3. Haz clic en Agregar.

   4. Haz clic en Configurar.

   5. Ve a la pestaña Alcances detallados y haz clic en Editar alcances.

      

      

   6. Selecciona los siguientes permisos.

      Cómo ver permisos

      • read:attachment:confluence
      • read:configuration:confluence
      • read:content.metadata:confluence
      • read:content-details:confluence
      • read:group:confluence
      • read:space:confluence
      • read:user:confluence

   7. Confirma que se hayan seleccionado siete permisos y guarda los cambios.

2. Obtén el ID de cliente y el secreto del cliente:

   1. Haz clic en Distribución.

   2. Selecciona Editar.

      

      

   3. Selecciona Uso compartido para habilitar la edición de otros campos.

   4. Completa los campos restantes. Asegúrate de establecer Proveedor en Google y Política de Privacidad en policies.google.com.

   5. Selecciona Sí cuando veas la pregunta "¿Tu app almacena datos personales?".

   6. Selecciona Configuración para copiar tu ID de cliente y tu Secreto del cliente.

      

      

3. Obtén la URL de la instancia:

   1. Ve a atlassian.net y accede con tu cuenta de administrador.
   2. Ve a atlassian.net y accede con tu cuenta de administrador.
   3. Selecciona la app que quieras sincronizar. Por ejemplo, sincroniza la primera app.
   4. Busca la URL de la instancia. Aparece como el subdominio en la barra de direcciones.

4. Obtén el ID de la instancia:

   1. Abre una pestaña nueva, copia la URL de la instancia y agrega /_edge/tenant_info a la URL de la instancia. Por ejemplo, https://<var>YOUR-INSTANCE</var>.atlassian.net/_edge/tenant_info
   2. Abre una pestaña nueva, copia la URL de la instancia y agrega /_edge/tenant_info a la URL de la instancia. Por ejemplo, https://<var>YOUR-INSTANCE</var>.atlassian.net/_edge/tenant_info

   3. Navega al vínculo para encontrar el valor de cloudId. cloudId es el ID de tu instancia.

      

      

Configura permisos y roles

Para establecer la visibilidad del usuario, haz lo siguiente:

1. Haz clic en el ícono de perfil de usuario y ve a Administrar cuenta.

   

2. Navega a Perfil y visibilidad.

   

3. Ve a Contacto y establece Quién puede ver esto como Cualquier persona.

   

Para otorgarle al administrador de Confluence el rol de editor de Discovery Engine en la consola de Google Cloud, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Aplicaciones de IA.
2. Navega a IAM.
3. Busca la cuenta de administrador de Confluence.
4. Otorgar el rol de editor de Discovery Engine al administrador

Para otorgarle a un usuario un rol de administrador en Atlassian, haz lo siguiente:

1. Accede a Atlassian con una cuenta de administrador.

2. Haz clic en el ícono de menú y selecciona tu organización. Como alternativa, puedes ir a admin.atlassian.com.

3. En la página Administrador, haz clic en el producto y selecciona el botón Administrar usuarios.

   

4. Haz clic en Grupos en Administración de usuarios.

5. En la página Grupos, haz lo siguiente:

   1. Haz clic en Crear grupo.
   2. Ingresa un nombre para el grupo.

   

Este grupo recibe los permisos que requiere el conector. Los usuarios que se agregan a este grupo heredan estos permisos.El conector usa este grupo para autenticar y recuperar documentos.

1. En la página del grupo, haz clic en Agregar producto.

   1. Selecciona Administrador de acceso de usuarios como el rol del producto.

   2. Haz clic en Agregar.

      

2. Haz clic en Agregar miembros del grupo para agregar la cuenta de usuario o los miembros del grupo con los que se autentica el conector.

   

Crea un conector de Confluence Cloud

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Cómo conectar Confluence Data Center local

Usa este procedimiento para crear un almacén de datos y una app de búsqueda de Confluence Data Center en Aplicaciones de IA y sincronizar los datos de Confluence locales con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, puedes elegir la frecuencia con la que el almacén de datos se sincroniza con esa fuente.

Antes de comenzar

Antes de configurar la conexión, asegúrate de tener lo siguiente:

1. Conexión de servicio (obligatoria solo para el tipo de destino privado): Configura una conexión de servicio para la transferencia de datos segura.
2. Nombre de usuario y contraseña: Obtén credenciales válidas para la autenticación de tu administrador de Confluence.
3. Opcional para el tipo de destino privado: URL de dominio: Especifica la URL de la instancia de Confluence Data Center.
4. Opcional: Nombre de dominio base: Proporciona el nombre de dominio base para la instancia de Confluence.
5. Opcional: Puerto de destino: Identifica el puerto que se usa para la comunicación con el centro de datos de Confluence.

6. Usa los siguientes lineamientos de configuración para establecer conexiones con Private Service Connect(PSC). Ajusta o agrega recursos según sea necesario. Asegúrate de que el archivo adjunto del servicio de PSC esté configurado correctamente para conectarse a la instancia privada y cumpla con los requisitos de un servicio publicado.

   1. Establece la configuración de red:

      1. Coloca el adjunto de servicio y el balanceador de cargas de PSC en subredes diferentes dentro de la misma red de nube privada virtual.

      2. El sistema de backend debe permanecer cerrado para la red pública por motivos de seguridad. Sin embargo, asegúrate de que pueda aceptar tráfico de las siguientes fuentes:

         • Para los balanceadores de cargas basados en proxy o HTTP(s) (ILB de proxy de L4, ILB de L7), configura el backend para que acepte solicitudes de la subred de proxy en la red de nube privada virtual.

         • Para obtener más información, consulta la documentación Subredes de solo proxy para balanceadores de cargas basados en Envoy.

   2. Ajusta las reglas de firewall:

      1. Reglas de entrada:

         • Permite el tráfico de la subred de conexión del servicio de PSC a la subred del balanceador de cargas interno (ILB).
         • Asegúrate de que el ILB pueda enviar tráfico al backend.
         • Permite que los sondeos de verificación de estado lleguen al backend.

      2. Reglas de salida: Habilita el tráfico de salida de forma predeterminada, a menos que se apliquen reglas de denegación específicas.

7. Consideraciones adicionales: Asegúrate de mantener todos los componentes, incluido el adjunto de servicio de PSC y el balanceador de cargas, en la misma región.

Genera un adjunto de servicio

Sigue estos pasos para generar un archivo adjunto de servicio:

1. Decide el tipo de extremo: Selecciona el extremo Público o Privado.

2. Para el extremo público: Si el tipo de destino del centro de datos de Confluence es público, no es necesario que crees la configuración para el archivo adjunto de servicio. En su lugar, puedes usar tu URL pública en el campo URL del dominio de la consola de Google Cloud cuando crees el conector.

3. Para el extremo Privado:

   1. Usa Private Service Connect (PSC) para habilitar las conexiones desde instancias privadas a Google Cloud.
   2. Crea una red de nube privada virtual y las subredes necesarias.
   3. Crea una instancia de máquina virtual (VM) y, luego, instala el servicio de backend.
   4. Opcional: Configura un sondeo de verificación de estado para supervisar el estado del backend.
   5. Agrega un balanceador de cargas para enrutar el tráfico a la VM o al backend.
   6. Define reglas de firewall para permitir el tráfico entre el extremo de PSC y el backend.
   7. Para publicar el extremo, crea un adjunto de servicio de PSC.

Crea un usuario de Confluence Data Center y configura los permisos

Para permitir que Vertex AI Search obtenga datos de Confluence, debes crear un usuario nuevo con los permisos mínimos necesarios. Sigue estos pasos para crear el usuario y configurar los permisos necesarios.

1. Accede como administrador:

   1. Ve al sitio de tu dominio de Atlassian y abre la instancia de Confluence Data Center.
   2. Ingresa el nombre de usuario y la contraseña de administrador.
   3. Haz clic en Acceder.

2. Crea un usuario nuevo:

   Cuando creas un almacén de datos, debes crear un usuario para obtener datos de la instancia de terceros.

   1. Haz clic en el ícono de configuración.
   2. Selecciona Administración de usuarios.
   3. Si se te solicita, ingresa las credenciales de administrador.
   4. En la página Administración, haz clic en Crear usuario.
   5. Ingresa la dirección de correo electrónico, el nombre completo, el nombre de usuario y la contraseña.
   6. Haz clic en Crear usuario.

3. Asignar un usuario a un grupo:

   1. En la página Administración de Confluence, navega a la pestaña Usuarios y seguridad y haz clic en Grupos.
   2. Haz clic en Agregar grupo. Ingresa un nombre para el grupo y créalo.
   3. En el campo Buscar grupo, ingresa el nombre del grupo para encontrarlo.
   4. Haz clic en el ícono de configuración.
   5. Selecciona la cuenta de perfil y navega a Administración de usuarios.
   6. En la página Usuarios, en Lista de usuarios, busca el usuario recién creado en el campo Buscar usuario.
   7. Haz clic en el usuario para abrir la página Ver usuarios.
   8. Haz clic en Editar grupos para abrir la página Editar grupo de usuarios.
   9. Selecciona la casilla de verificación del grupo de usuarios creado.
   10. Haz clic en Guardar para asignar al usuario al grupo recién creado.

   El usuario agregado se asigna en la sección Miembros del grupo.

4. Configura los permisos de los usuarios:

   1. En la página Administración de Confluence, navega a la pestaña Problemas.
   2. Busca Permisos.
   3. Selecciona Ver permisos globales.
   4. Selecciona Editar permisos.
   5. En la página Editar permisos globales, busca el grupo asignado al usuario y habilita la opción Puede usar.

Configura el espacio de documentación

1. Haz clic en el ícono de Confluence para navegar a la página Panel.
2. Haz clic en Crear espacio.
3. Selecciona Espacio de documentación y haz clic en Siguiente.
4. Ingresa todos los detalles necesarios y haz clic en Crear para crear el espacio de documentación.
5. En Mis espacios, haz clic en el espacio que acabas de crear.
6. Navega a Páginas y abre el menú (tres puntos).
7. Selecciona Restricciones.
8. En el menú desplegable Restricciones, selecciona la opción Visualización y edición restringidas.
9. Busca el grupo y asígnale el permiso puede ver.
10. Haz clic en Aplicar. El usuario se crea con acceso mínimo y se establecen permisos para los espacios. También puedes asignar permisos a los blogs.

Crea un conector de Confluence Data Center local

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.
• Consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Conectar DocuSign

Usa el siguiente procedimiento para sincronizar datos de DocuSign con la Búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar una conexión para el conector de DocuSign, asegúrate de tener las siguientes credenciales para la autenticación:

• Clave de consumidor
• Clave privada
• Nombre de usuario

Genera claves y credenciales de usuario

Crea un usuario en la instancia de DocuSign, asígnale a un grupo y otorga los permisos necesarios para generar la clave de consumidor, la clave privada y el nombre de usuario necesarios para la integración y la autenticación.

1. Registrar un usuario de DocuSign: Si eres un usuario nuevo, sigue los pasos que se indican a continuación para crear una cuenta de desarrollador de DocuSign. Si ya tienes un usuario, ve a la sección para acceder a los detalles de la cuenta.

   1. Ve a la cuenta de desarrollador de DocuSign.

   2. Expande el menú desplegable Cuenta de desarrollador y haz clic en Crear cuenta.

   3. En la página Obtén tu cuenta de desarrollador gratuita, ingresa la información requerida:

      • Nombre
      • Last name (Apellido)
      • Correo electrónico
      • Empresa
      • País
      • Estado de la cuenta de DocuSign (si corresponde)

   4. Haz clic en Comenzar.

   5. Aparecerá la ventana Check your email. Busca un código de verificación en tu correo electrónico, ingrésalo y haz clic en Siguiente.

   6. Aparecerá la ventana Verifica tu número de teléfono celular. Selecciona el código de país, ingresa tu número de celular y haz clic en Send code.

   7. Ingresa el código temporal que recibiste y haz clic en Verificar.

   8. En la ventana Establece tu contraseña, ingresa tu contraseña y haz clic en Siguiente.

   9. El usuario accedió al entorno de zona de pruebas.

2. Accede a los detalles de la cuenta:

   1. Haz clic en el ícono de perfil de usuario y selecciona Mis apps y llaves.

   2. Se muestra el panel Account y la página Apps and keys, en la que se muestran el ID de usuario, el ID de la cuenta y la URL base de la app.

3. Genera apps y claves de integración:

   1. Haz clic en Agregar clave de app y de integración.

   2. En el diálogo Add integration key, ingresa el nombre de la app y haz clic en Create app.

   3. Se redirecciona al usuario a la página de la app. En la sección Authentication, selecciona Yes para la pregunta "Is your application able to securely store a client secret?" y haz clic en Add secret key. Se agrega una clave secreta.

   4. En la sección Integración de servicios, haz clic en Generar RSA.

   5. El diálogo Par de claves RSA muestra el ID del par de claves, la clave pública y la clave privada. Copia ambas, ya que no se volverán a mostrar.

4. Agrega un usuario a producción:

   1. Accede a la instancia de producción de DocuSign.

   2. Haz clic en Administrador.

   3. Navega a Usuarios y grupos > Usuarios.

   4. En la página Asientos y usuarios, en Uso de asientos, haz clic en Asignar un asiento.

   5. En la página Agregar usuario, ingresa la dirección de correo electrónico.

   6. Haz clic en Siguiente.

   7. Completa los campos obligatorios de la sección Información del perfil.

   8. Haz clic en Siguiente.

   9. En la sección Seguridad, agrega el código de acceso.

   10. Haz clic en Siguiente.

   11. En la sección Perfiles y grupos de permisos, selecciona el permiso como Visor.

   12. Haz clic en Agregar usuario.

   13. Se mostrará la página Asientos y usuarios, y el usuario aparecerá en Todos los usuarios.

   14. Abre la cuenta de correo electrónico del usuario y actívala con el correo electrónico de activación de la cuenta.

   15. Haz clic en Activar, ingresa el código de acceso y activa la cuenta.

5. Genera un par de claves RSA:

   1. Navega a Administrador > Integraciones > Apps y claves.

   2. En la página Apps y claves, haz clic en Acciones y elige Editar para un nombre de app existente en la sección Apps y claves de integración.

   3. En la página Detalles de la app, ve a la sección Integración de servicios y haz clic en Generar RSA.

   4. El diálogo Par de claves RSA muestra el ID del par de claves, la clave pública y la clave privada. Copia todos los detalles y haz clic en Cerrar.

   5. Haz clic en el ícono de Perfil y sal de tu cuenta.

6. Accede a la instancia de producción: Accede a la instancia de producción de DocuSign con las credenciales de acceso mínimo del usuario. La opción de menú Administrador no se muestra para la cuenta de usuario con acceso mínimo.

Crea un conector de DocuSign en la nube

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Cómo obtener resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Cómo conectar Dropbox

Usa el siguiente procedimiento para sincronizar datos de Dropbox con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Configura el control de acceso para tu fuente de datos. Para obtener más información, consulta Cómo usar el control de acceso a la fuente de datos.

2. Ten a mano la siguiente información de autenticación de Dropbox. Para obtener información sobre la configuración de estos parámetros, consulta la Guía de OAuth en la documentación de Dropbox.

   • ID de cliente
   • Secreto del cliente

Crea un conector de Dropbox

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar tu app y el almacén de datos, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Cómo conectar Entra ID

Usa el siguiente procedimiento para sincronizar datos de Entra ID con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

2. Para obtener el ID de cliente y el secreto del cliente, haz lo siguiente:

   1. Crea una aplicación de Entra ID:

      1. Accede al centro de administración de Microsoft Entra y haz clic en Solicitud.
      2. En la lista desplegable Application, haz clic en App registrations.
      3. En la página Registros de apps, haz clic en Nuevo registro.
      4. Haz clic en Agregar registro nuevo y haz lo siguiente:
         • Ingresa un nombre para la aplicación.
         • En Tipos de cuentas compatibles, selecciona Cuentas solo en el directorio de la organización.
         • En URI de redireccionamiento, agrega un URI de redireccionamiento web que apunte a https://login.microsoftonline.com/common/oauth2/nativeclient.
      5. Haz clic en Register.

   2. Guarda las credenciales:

      En la ventana de la aplicación registrada, guarda los siguientes valores para usarlos más adelante:

      1. Usa el ID de la aplicación (cliente) para establecer el parámetro ID de cliente.
      2. Usa el ID de directorio (usuario) para establecer el parámetro Azure Tenant.

   3. Crea un secreto del cliente:

      1. Navega a Certificados y secretos y crea un secreto del cliente nuevo:
      2. Haz clic en Nuevo secreto de cliente y especifica la duración requerida.
      3. Guarda el secreto del cliente y copia el valor de la clave para usarlo más adelante.

Configura los permisos de la API de Entra ID

1. En la ventana de la aplicación registrada, haz clic en Permisos de API.

2. En Permisos configurados, selecciona Microsoft Graph y configura el siguiente permiso:

   Ver permisos

   • User.Read.All (Application)

   Si deseas transferir profileCardAttributes, configura los siguientes permisos:

   Ver permisos

   • People.Read.All (Application)
   • PeopleSettings.Read.All (Application)

3. Otorga consentimiento de administrador para todos los permisos agregados. Se requiere el consentimiento de un administrador para usar credenciales de cliente en el flujo de autenticación.

Crea un conector de Entra ID

Prueba el motor de búsqueda

Después de configurar tu motor de búsqueda, prueba sus capacidades. Esto garantiza que se muestren resultados precisos según el acceso del usuario.

1. Habilita la app web:

   1. Ve a la configuración de integración de la app y activa la opción para habilitar la app web.

2. Prueba la app web:

   1. Haz clic en Abrir junto al vínculo de la app web y accede como usuario.

   2. Verifica que los resultados de la búsqueda se restrinjan a los elementos a los que el usuario puede acceder.

Obtén una vista previa de los resultados de la búsqueda de personas

1. En la app de búsqueda, navega a Vista previa y comienza a buscar en la consola cuando uses el IdP de Google.

   • También puedes navegar al vínculo proporcionado y acceder con tu IdP para comenzar a buscar.
   • Los resultados de la búsqueda aparecen como tarjetas de contacto, que muestran detalles del usuario, como nombre, cargo, correo electrónico y foto de perfil.

2. Haz clic en una tarjeta de contacto para ver una página de perfil detallada, que incluye lo siguiente:

   • Nombre
   • Foto de perfil
   • Cargo
   • Departamento
   • Cadena de administración
   • Subordinados directos

3. Si los atributos personalizados (propiedades de la tarjeta de perfil) se ingresan y se vuelven indexables, consultables y recuperables, ocurrirá lo siguiente:

   • La búsqueda por un valor de atributo personalizado solo muestra los perfiles de las personas que contienen esos atributos.
   • Los atributos personalizados aparecen en los resultados de la búsqueda, pero solo se puede acceder a ellos a través de la API, no de la interfaz de usuario de Vertex Search.

Configura el grupo de trabajadores para un IdP que no sea de Google sin SSO

1. Si tus empleados usan un IdP que no es de Google, no tienen SSO con Google o no son clientes de Google Workspace, configura un grupo de personal como se describe en Cómo usar el control de acceso a la fuente de datos para habilitar la búsqueda de empleados.

   El grupo de trabajadores te permite administrar y autenticar usuarios de proveedores de identidad externos, como Azure o Okta, en la consola de Google Cloud.

2. Para configurar tu grupo de personal y habilitar la app web para que los usuarios accedan sin inconvenientes, haz lo siguiente:

   1. Para crear un grupo de personal a nivel de la organización en Google Cloud , sigue el manual de configuración correspondiente:

      1. Configuración de OIDC de Azure
      2. Configuración de SAML de Azure
      3. Configuración de OIDC y Okta
      4. Configuración de Okta y SAML

   2. Configura el grupo de trabajadores en Aplicaciones de IA > Configuración para la región en la que creaste tu app.

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Cómo conectar GitHub

Usa el siguiente procedimiento para sincronizar datos de GitHub con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

2. Un administrador de GitHub debe obtener el token de acceso personal de la instancia de GitHub para integrarlo con la búsqueda de Vertex AI.

Crea un conector de GitHub

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.

Conecta GitLab

Usa el siguiente procedimiento para sincronizar datos de GitLab con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

2. Un administrador de GitLab debe obtener el token de acceso personal de la instancia de GitLab para realizar la integración con la Búsqueda de Vertex AI.

Crea un conector de GitLab

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.

Conecta Jira Cloud

Usa el siguiente procedimiento para sincronizar datos de Jira Cloud con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, puedes elegir la frecuencia con la que el almacén de datos se sincroniza con esa fuente.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

• Configura el control de acceso. Asegúrate de que el control de acceso esté configurado correctamente para tu fuente de datos. Este paso garantiza que solo los usuarios autorizados puedan acceder a los datos y administrarlos. Para obtener más información, consulta la documentación sobre cómo usar el control de acceso a las fuentes de datos.
• Para que los permisos de los usuarios se apliquen correctamente, los usuarios de Jira Cloud deben dar su consentimiento para compartir.
• Asegúrate de tener una cuenta de Atlassian, una instancia de Jira y un proyecto.
• Verifica que tienes acceso de administrador a la instancia y al proyecto de Jira.

Configura la autenticación y los permisos en Jira

Con las instrucciones de las siguientes secciones, asegúrate de tener los detalles de autenticación necesarios y el acceso de administrador a tu instancia de Jira. Crea un ID de cliente y un secreto de cliente a través de Atlassian Developer Console, configura los alcances de OAuth 2.0 necesarios, configura los permisos de los usuarios, recupera la URL y el ID de tu instancia, configura los roles y autentica para sincronizar datos entre Jira Cloud y Vertex AI Search.

Crea un ID de cliente y un secreto del cliente

1. Crea una integración de OAuth 2.0 en la Consola de Atlassian Developer:

   1. Accede a la consola de Atlassian Developer.

   2. Haz clic en el ícono de perfil y selecciona Consola de desarrollador.

      

   3. Haz clic en el ícono de perfil y selecciona Consola de desarrollador.

      

   4. Haz clic en Crear y selecciona Integración de OAuth 2.0.

      

      

   5. Ingresa un nombre para la app y haz lo siguiente:

      1. Marca la casilla de verificación de los Términos y Condiciones.

      2. Haz clic en Crear.

         

         

      3. Haz clic en Autorización.

      4. En la tabla Authorization type, selecciona Add para OAuth 2.0 (3LO).

         

         

   6. En el campo URL de devolución de llamada, ingresa https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html.

   7. Haz clic en Guardar cambios.

      

   Si ves la advertencia: Tu app no tiene ninguna API. Agrega APIs a tu app, continúa con el paso 2 en la siguiente sección y completa todos los pasos restantes. De lo contrario, continúa con el paso 4 en esa misma sección.

1. Habilita OAuth 2.0:

   1. Haz clic en Permisos.

      

   2. Haz clic en Permisos.

      

   3. Ve a la API de Jira.

   4. Haz clic en Agregar.

   5. Haz clic en Configurar.

   6. Ve a la pestaña Permisos clásicos y haz clic en Editar permisos.

      

   7. Selecciona los siguientes permisos:

   8. Ve a la API de Jira.

   9. Haz clic en Agregar.

   10. Haz clic en Configurar.

   11. Ve a la pestaña Permisos clásicos y haz clic en Editar permisos.

       

   12. Selecciona los siguientes permisos:

       Cómo ver permisos

       • read:avatar:jira
       • read:audit-log:jira
       • read:group:jira
       • read:issue-security-level:jira
       • read:issue-security-scheme:jira
       • read:jira-user
       • read:jira-work
       • read:user:jira

   13. Confirma que se hayan seleccionado ocho alcances y, luego, guarda los cambios.

   14. Ve a la pestaña Alcances detallados y haz clic en Editar alcances.

       

   15. Selecciona los siguientes permisos:

       Cómo ver permisos

       • read:issue-security-level:jira
       • read:issue-security-scheme:jira
       • read:group:jira
       • read:user:jira
       • read:avatar:jira
       • read:audit-log:jira

   16. Confirma que se hayan seleccionado seis alcances y, luego, guarda los cambios.

   17. Ve a la pestaña Alcances detallados y haz clic en Editar alcances.

       

   18. Selecciona los siguientes permisos:

       Cómo ver permisos

       • read:issue-security-level:jira
       • read:issue-security-scheme:jira
       • read:group:jira
       • read:user:jira
       • read:avatar:jira
       • read:audit-log:jira

   19. Confirma que se hayan seleccionado seis alcances y, luego, guarda los cambios.

2. Obtén el ID de cliente y el secreto del cliente:

   1. Haz clic en Distribución.

   2. Selecciona Editar y haz lo siguiente:

      

      

      1. Selecciona Uso compartido para habilitar la edición de otros campos.
      2. Completa los campos restantes. Asegúrate de establecer Proveedor en Google y Política de Privacidad en policies.google.com.
      3. Completa los campos restantes. Asegúrate de establecer Proveedor en Google y Política de Privacidad en policies.google.com.
      4. Selecciona Sí cuando veas Does your app store personal data?.

   3. Selecciona Configuración para copiar tu ID de cliente y tu Secreto del cliente.

      

   4. Selecciona Configuración para copiar tu ID de cliente y tu Secreto del cliente.

      

3. Obtén la URL de la instancia:

   1. Ve a atlassian.net y accede con tu cuenta de administrador.
   2. Selecciona la app que quieras sincronizar. Por ejemplo, sincroniza la primera app.
   3. Busca la URL de la instancia, que es el subdominio en la barra de direcciones.

4. Obtén el ID de la instancia:

   1. Abre una pestaña nueva, copia la URL de la instancia y agrega /_edge/tenant_info a la URL de la instancia. Por ejemplo, https://<var>YOUR-INSTANCE</var>.atlassian.net/_edge/tenant_info
   2. Abre una pestaña nueva, copia la URL de la instancia y agrega /_edge/tenant_info a la URL de la instancia. Por ejemplo, https://<var>YOUR-INSTANCE</var>.atlassian.net/_edge/tenant_info

   3. Navega al vínculo para encontrar el valor de cloudId. cloudId es el ID de tu instancia.

      

      

Configura permisos y roles

Para establecer la visibilidad del usuario, haz lo siguiente:

1. Haz clic en el ícono de perfil de usuario y ve a Administrar cuenta.

   

2. Navega a Perfil y visibilidad.

   

3. Ve a Contacto y establece Quién puede ver esto como Cualquier persona.

   

Para otorgarle al administrador de Jira el rol de editor de Discovery Engine en la consola de Google Cloud, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Aplicaciones de IA.
2. Navega a IAM.
3. Busca la cuenta de administrador de Jira.
4. Otorga el rol de editor de Discovery Engine al administrador.

Para otorgarle a un usuario un rol de administrador en Atlassian, haz lo siguiente:

1. Accede a Atlassian con una cuenta de administrador.

2. Haz clic en el ícono de menú y selecciona tu organización. Como alternativa, puedes ir a admin.atlassian.com.

3. En la página Administrador, haz clic en el producto y selecciona el botón Administrar usuarios.

   

4. Haz clic en Grupos en Administración de usuarios.

5. En la página Grupos, haz lo siguiente:

   1. Haz clic en Crear grupo.
   2. Ingresa un nombre para el grupo.

   

Este grupo recibe los permisos que requiere el conector. Los usuarios que se agregan a este grupo heredan estos permisos.El conector usa este grupo para autenticar y recuperar documentos.

1. En la página del grupo, haz clic en Agregar producto.

2. Selecciona Administrador de acceso de usuarios como el rol del producto.

   

3. Selecciona Administrador de productos como los roles del producto.

4. Haz clic en Agregar.

5. Haz clic en Agregar miembros del grupo para agregar una cuenta de usuario o miembros del grupo con los que se autentica el conector.

   

Crea un conector de Jira Cloud

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Conecta Jira Data Center local

Usa este procedimiento para crear un almacén de datos y una app de búsqueda de Jira Data Center en Aplicaciones de IA y sincronizar los datos de Jira locales con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, puedes elegir la frecuencia con la que el almacén de datos se sincroniza con esa fuente.

Antes de comenzar

Antes de configurar la conexión, asegúrate de tener lo siguiente:

1. Conexión de servicio (obligatoria solo para el tipo de destino privado): Configura una conexión de servicio para realizar una transferencia de datos segura.
2. Nombre de usuario y contraseña: Obtén credenciales válidas para la autenticación de tu administrador de Jira.
3. Opcional para el tipo de destino privado: URL de dominio: Especifica la URL de la instancia de Jira Data Center.
4. Opcional: Nombre de dominio base: Proporciona el nombre de dominio base de la instancia de Jira.
5. Opcional: Puerto de destino: Identifica el puerto que se usa para la comunicación con el centro de datos de Jira.

6. Usa los siguientes lineamientos de configuración para establecer conexiones con Private Service Connect(PSC). Ajusta o agrega recursos según sea necesario. Asegúrate de que el archivo adjunto del servicio de PSC esté configurado correctamente para conectarse a la instancia privada y cumpla con los requisitos de un servicio publicado.

   1. Establece la configuración de red:

      1. Coloca el adjunto de servicio y el balanceador de cargas de PSC en subredes diferentes dentro de la misma red de nube privada virtual.

      2. El sistema de backend debe permanecer cerrado para la red pública por motivos de seguridad. Sin embargo, asegúrate de que pueda aceptar tráfico de las siguientes fuentes:

         • Para los balanceadores de cargas basados en proxy o HTTP(s) (ILB de proxy de L4, ILB de L7), configura el backend para que acepte solicitudes de la subred de proxy en la red de nube privada virtual.

         • Para obtener más información, consulta la documentación Subredes de solo proxy para balanceadores de cargas basados en Envoy.

   2. Ajusta las reglas de firewall:

      1. Reglas de entrada:

         • Permite el tráfico de la subred de conexión del servicio de PSC a la subred del balanceador de cargas interno (ILB).
         • Asegúrate de que el ILB pueda enviar tráfico al backend.
         • Permite que los sondeos de verificación de estado lleguen al backend.

      2. Reglas de salida: Habilita el tráfico de salida de forma predeterminada, a menos que se apliquen reglas de denegación específicas.

7. Consideraciones adicionales: Asegúrate de mantener todos los componentes, incluido el adjunto de servicio de PSC y el balanceador de cargas, en la misma región.

Genera un adjunto de servicio

Sigue estos pasos para generar un archivo adjunto de servicio:

1. Decide el tipo de extremo: Selecciona el extremo Público o Privado.

2. Para el extremo público: Si el tipo de destino del centro de datos de Jira es público, no es necesario que crees la configuración para el archivo adjunto de servicio. En su lugar, puedes usar tu URL pública en el campo URL del dominio de la consola de Google Cloud.

3. Para el extremo Privado:

   1. Usa PSC para habilitar las conexiones desde instancias privadas a Google Cloud.
   2. Crea una red de nube privada virtual y las subredes necesarias.
   3. Crea una instancia de máquina virtual (VM) y, luego, instala el servicio de backend.
   4. Opcional: Configura un sondeo de verificación de estado para supervisar el estado del backend.
   5. Agrega un balanceador de cargas para enrutar el tráfico a la VM o al backend.
   6. Define reglas de firewall para permitir el tráfico entre el extremo de PSC y el backend.
   7. Para publicar el extremo, crea un adjunto de servicio de PSC.

Crea un usuario de Jira Data Center y configura los permisos

Para permitir que Vertex AI Search obtenga datos de Jira, debes crear un usuario nuevo con los permisos mínimos necesarios. Sigue estos pasos para crear el usuario y configurar los permisos necesarios.

1. Accede como administrador:

   1. Ve al sitio de tu dominio de Atlassian y abre la instancia de Jira Data Center.
   2. Ingresa el nombre de usuario y la contraseña de administrador.
   3. Haz clic en Acceder.

2. Crea un usuario nuevo:

   Cuando creas un almacén de datos, debes crear un usuario para obtener datos de la instancia de terceros.

   1. Haz clic en el ícono de configuración.
   2. Selecciona Administración de usuarios.
   3. Si se te solicita, ingresa las credenciales de administrador.
   4. En la página Administración, haz clic en Crear usuario.
   5. Ingresa la dirección de correo electrónico, el nombre completo, el nombre de usuario y la contraseña.
   6. Haz clic en Crear usuario.

3. Asignar un usuario a un grupo:

   1. En la página Administración, en Administración de usuarios, haz clic en Grupos.
   2. Para crear un grupo, ingresa un nombre y haz clic en Agregar grupo.
   3. Selecciona el grupo recién creado.
   4. Haz clic en Agregar/quitar usuarios.
   5. Haz clic en el ícono de miembro que se encuentra junto al cuadro Agregar miembros a los grupos seleccionados.
   6. Selecciona el usuario que acabas de crear y haz clic en Guardar la selección.
   7. Haz clic en Agregar usuario seleccionado para ver a los usuarios nuevos en la sección de miembros del grupo.

   Puedes ver que el usuario agregado se asignó en la sección Miembros del grupo.

4. Configura los permisos de los usuarios:

   1. En la página Administración, navega a la pestaña Problemas.
   2. Selecciona Esquemas de permisos.
   3. Haz clic en Agregar esquema de permisos.
   4. Ingresa un nombre para el esquema y haz clic en Agregar.
   5. Selecciona el esquema y haz clic en el ícono de permiso.
   6. Haz clic en Otorgar permiso.
   7. Agrega los siguientes permisos, asígnales al grupo creado anteriormente y haz clic en Otorgar:
      1. Explorar proyectos
      2. Explora el archivo de proyectos.
   8. Agrega este esquema a los proyectos en los que los usuarios del grupo necesiten acceso para ver el proyecto, los problemas, los comentarios, los registros de trabajo y los archivos adjuntos.

Puedes agregar este esquema a los proyectos en los que los usuarios de ese grupo necesiten acceso para ver ese proyecto y los problemas, comentarios, registros de trabajo y archivos adjuntos en él.

Configura el acceso de las aplicaciones

1. En la página Administración, navega a la pestaña Aplicaciones.
2. En la pestaña Aplicaciones, selecciona Acceso a la aplicación.
3. Busca el grupo creado y selecciónalo.
4. Verifica que el grupo aparezca en la lista de acceso.

El usuario se crea con acceso mínimo. Este esquema se agrega a los proyectos. El administrador de Jira puede agregar más miembros a ese grupo o usuarios a ese proyecto.

Crea un conector de Jira Data Center local

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.

Cómo conectar Marketo Cloud

Usa el siguiente procedimiento para sincronizar datos de Marketo Cloud con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, asegúrate de tener las credenciales de autenticación, incluido un ID de cliente y un secreto de cliente.

Genera credenciales de autenticación

1. Crea un usuario administrador de Marketo:

   1. Accede a Marketo con la instancia de usuario administrador.
   2. En la pestaña Página principal, haz clic en Administrador.
   3. Navega a Seguridad > Usuarios y roles y haz clic en Ir a la Consola del administrador.
   4. En la Consola de Adobe, en Vínculos rápidos, haz clic en Agregar usuarios.

   5. En el cuadro de diálogo Agrega usuarios a tu equipo, haz lo siguiente:

      1. Ingresa tu dirección de correo electrónico.
      2. Selecciona la suscripción al producto como Marketo Engage – googledevsandbox.
      3. Haz clic en Guardar.

   6. Regresa a Administrador de Marketo > Seguridad > Usuarios y roles y busca el usuario que acabas de crear.

   7. Selecciona al usuario y haz clic en Editar.

   8. Quita el rol de Usuario estándar y asigna el rol de Administrador.

   9. Haz clic en Guardar.

2. Crea un ID de cliente y una clave secreta de Marketo:

   1. Ve a la instancia de los servicios de autenticación de Marketo.
   2. Ingresa las credenciales de administrador y, luego, haz clic en Continuar.
   3. Haz clic en Administrador.
   4. En el panel Administrador, ve a Seguridad > Usuarios y roles.
   5. Haz clic en Crear usuario de solo API.

   6. En la ventana Create new API only user, haz lo siguiente:

      1. Completa los campos obligatorios:

         • Correo electrónico
         • Nombre
         • Apellido

      2. Selecciona los roles requeridos y haz clic en Create API only user.

   7. Haz clic en Administrador y, luego, navega a Integración > LaunchPoint.

   8. Haz clic en Nuevo > Nuevos servicios.

   9. En la ventana New services, haz lo siguiente:

      1. Ingresa un Nombre visible para la identificación.
      2. En el campo Servicio, selecciona Personalizado.
      3. Ingresa una descripción.
      4. En el campo API only user, selecciona el usuario de API que creaste antes.
      5. Haz clic en Crear. El usuario de la API aparece en la página Servicios instalados.

   10. En la página Servicios instalados, navega a la fila del usuario de la API.

   11. En la columna Detalles, haz clic en Ver detalles para recuperar el ID de cliente y la clave secreta.

Crea un conector de Marketo Cloud

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.

Cómo conectar Microsoft Outlook

Usa el siguiente procedimiento para sincronizar datos de Microsoft Outlook con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

2. Un administrador de Microsoft Outlook debe generar o obtener lo siguiente para integrarlo con Vertex AI Search:

   • ID de cliente
   • Secreto del cliente
   • ID de usuario

3. Configura los siguientes permisos:

   Cómo ver los permisos

   • Calendars.Read
   • Calendars.ReadBasic.All
   • Contacts.Read
   • Mail.Read
   • Mail.ReadBasic
   • Mail.ReadBasic.All
   • User.Read.All
   • User.ReadBasic.All

Crea un conector de Microsoft Outlook

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Cómo obtener resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.

Cómo conectar Microsoft Teams

Usa el siguiente procedimiento para sincronizar datos de Microsoft Teams con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

2. Un administrador de Microsoft Teams debe generar o obtener lo siguiente para la integración con Vertex AI Search:

   • ID de cliente
   • Secreto del cliente
   • ID de usuario

3. Configura los siguientes permisos de Microsoft Graph (aplicación) con el consentimiento de un administrador de Microsoft Teams:

   Cómo ver los permisos

   • TeamSettings.Read.All
   • GroupMember.Read.All
   • User.Read.All
   • Directory.Read.All
   • ChannelSettings.Read.All
   • Chat.ReadBasic.All
   • ChannelMessage.Read.All
   • Chat.Read.All
   • Files.Read.All
   • ChannelMember.Read.All

Crea un conector de Microsoft Teams

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Cómo obtener resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Connect Monday

Usa el siguiente procedimiento para sincronizar los datos del lunes con la Búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, asegúrate de tener la URL del dominio, el acceso de administrador y el token de API.

Para generar la URL de la cuenta y el token de API, haz lo siguiente:

1. Accede a la aplicación de Monday con tu cuenta de administrador.
2. Haz clic en el ícono de Perfil.
3. Selecciona Administración.
4. Navega a la pestaña General y, luego, ingresa el Nombre de la cuenta y la URL de la cuenta.
5. Vuelve al ícono Perfil y selecciona Desarrolladores.
6. En la página Monday developer center, haz clic en Mis tokens de acceso.
7. Haz clic en Mostrar para mostrar el token.
8. Copia el token para usarlo en la autenticación.

Crea un conector de Monday

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.

Cómo conectar Notion

Usa el siguiente procedimiento para sincronizar datos de Notion con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar el conector, haz lo siguiente:

1. Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

2. Un administrador de Notion debe generar o obtener lo siguiente para integrarlo con Vertex AI Search:

   • Token de API de la instancia de Notion
   • ID del lugar de trabajo

3. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

Crea un conector de Notion

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Cómo obtener resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Conectar Okta

Usa el siguiente procedimiento para sincronizar datos de Okta con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar el conector, asegúrate de tener la URL del dominio y el acceso de administrador a la instancia de Okta. Sigue los pasos que se indican a continuación para obtener la URL, el ID de cliente y el token de API de la instancia de Okta.

1. Para obtener la URL de la instancia de Okta, haz lo siguiente:

   1. Accede a la página de acceso de Okta con tus credenciales de administrador.
   2. Haz clic en el ícono de tu perfil o navega directamente a la Consola del administrador. La URL de tu instancia de Okta aparece como el subdominio en la barra de direcciones.

2. Para generar el ID de cliente y el token de API, haz lo siguiente:

   1. Accede a la URL de tu instancia de Okta con tu cuenta de administrador.
   2. Navega al panel Administrador.
   3. Haz clic en el ícono de Aplicaciones y selecciona Aplicaciones.
   4. Haz clic en Crear integración de aplicaciones.
   5. Selecciona OIDC - OpenID Connect.
   6. Selecciona Aplicación web como el tipo de aplicación y, luego, haz clic en Siguiente.
   7. Ingresa un nombre en el campo Nombre de la integración de la app.
   8. Desplázate hasta ver Tareas y selecciona Omitir la asignación del grupo por ahora.
   9. Haz clic en Guardar.
   10. En la ventana Credenciales de cliente, haz clic en Editar.
   11. Selecciona Clave pública / clave privada.
   12. En Clave pública, haz clic en Agregar clave.
   13. Haz clic en Generar nueva clave y, luego, en Listo y Guardar.
   14. Aparecerá un cuadro de diálogo. Haz clic en Guardar.
   15. En Configuración general, haz clic en Editar.
   16. Selecciona Credenciales de cliente y, luego, haz clic en Guardar.

Crea un conector de Okta

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Cómo obtener resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Cómo conectar OneDrive

Usa el siguiente procedimiento para sincronizar datos de OneDrive con la Búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

2. Ten a mano la siguiente información de autenticación de OneDrive:

   1. ID de cliente, secreto del cliente y ID de grupo de usuarios Si deseas obtener información para configurar estos parámetros, consulta la guía de inicio rápido para registrar una aplicación con la plataforma de identidad de Microsoft en la documentación de Microsoft.

   2. Especifica los permisos de acceso. Se requiere un rol de administrador. Para obtener más información, consulta Guía de inicio rápido: Configura una aplicación cliente para acceder a una API web en la documentación de Microsoft.

   3. Configura los siguientes permisos:

      Cómo ver los permisos

      • Files.Read.All (Application)
      • Group.Read.All (Application)
      • User.Read.All (Application)

Crea un conector de OneDrive

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar tu app y el almacén de datos, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Conecta Salesforce

Usa el siguiente procedimiento para sincronizar datos de Salesforce con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

2. Ten a mano la siguiente información de autenticación. Si quieres obtener información para configurar el ID y el secreto de cliente en Salesforce, consulta Configura una app conectada para el flujo de credenciales de cliente de OAuth 2.0 en la documentación de Salesforce.

   • URL de la instancia
   • ID de consumidor
   • Secreto de consumidor

Se aplica la siguiente limitación:

1. Usa un plan empresarial o para desarrolladores. No se admiten cuentas de prueba.
2. Asegúrate de usar Sales Cloud. No se admite Service Cloud.
3. Agrega Google Cloud a la lista de entidades permitidas de CORS de Salesforce. Ve al siguiente paso si ya completaste esta tarea.
   1. Sigue las instrucciones de la documentación de Salesforce para configurar la lista de entidades permitidas de CORS.
   2. Ingresa https://console.cloud.google.com/ como URL de origen y guarda la configuración.

Crea un conector de Salesforce

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Conecta ServiceNow

Usa el siguiente procedimiento para sincronizar datos de ServiceNow con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, asegúrate de tener lo siguiente:

1. Instancia de ServiceNow: Sigue las instrucciones de la documentación de ServiceNow Developer para crear una instancia de ServiceNow.

2. ProyectoGoogle Cloud : Configura un proyecto Google Cloud con una cuenta de administrador capaz de administrar configuraciones a nivel de la organización, lo que garantiza que la organización pueda configurar un grupo de personal.

3. Grupo de trabajadores: Asegúrate de que tu organización esté configurada para administrar un grupo de trabajadores.

Configura ServiceNow

ServiceNow ofrece dos sitios principales:

1. Sitio principal de ServiceNow: Es el sitio de tu instancia de ServiceNow.

   • Administra usuarios, grupos y tareas de administración del sistema.
   • URL: Es la URL de tu instancia de ServiceNow.
   • Accede con tus credenciales de administrador.

2. Sitio para desarrolladores:

   • Configura la base de conocimiento, establece flujos de trabajo y desarrolla aplicaciones personalizadas.
   • URL: https://developer.service-now.com.
   • Accede con tu ID de ServiceNow.

Para crear un extremo de OAuth, haz lo siguiente:

1. Accede a la instancia principal de ServiceNow con privilegios de administrador.

2. Navega a Todo > OAuth del sistema > Registro de aplicaciones.

   

3. Haz clic en Nuevo.

   

4. Selecciona Crear un extremo de la API de OAuth para clientes externos.

   

   

5. Haz clic en Nuevo.

   

6. Selecciona Crear un extremo de la API de OAuth para clientes externos.

   

7. Completa la información requerida:

   1. Nombre: Es un nombre único.
   2. URL de redireccionamiento: Ingresa la URL de redireccionamiento.
   3. URL de redireccionamiento: Ingresa la URL de redireccionamiento.

8. Haz clic en Enviar para crear la credencial.

   

9. Después del envío, haz clic en el nombre para ver el ID de cliente.

   

10. El secreto se enmascara. Haz clic en el ícono de candado junto a él para desenmascarar y ver el secreto cliente.

    

11. Guarda el ID de cliente y el secreto del cliente para usarlos más adelante.

    

Para recuperar las credenciales de la instancia de ServiceNow, haz lo siguiente:

<figure id="servicenow">
<img src="images/servicenow-connector-images/redirect-url.png" alt="select">
<figcaption>
<b>Figure 4.</b> Enter the redirect URL and click the Submit button
</figcaption>
</figure>

1. Después del envío, haz clic en el nombre para ver el ID de cliente.

   

2. El secreto se enmascara. Haz clic en el ícono de candado junto a él para desenmascarar y ver el secreto cliente.

   

3. Guarda el ID de cliente y el secreto del cliente para usarlos más adelante.

   

Para recuperar las credenciales de la instancia de ServiceNow, haz lo siguiente:

1. Ve a developer.service-now.com y haz clic en Administrar la contraseña de la instancia.

   

2. Conserva una copia de la URL, el nombre de usuario y la contraseña de la instancia para usarla cuando sea necesario.

En esta etapa, están disponibles los cinco datos necesarios para configurar un almacén de datos de ServiceNow. Si no tienes problemas con el uso del rol de administrador para extraer datos, continúa con la creación de un almacén de datos.

<figure id="servicenow">
<img src="images/servicenow-connector-images/manage-instance.png" alt="select">
<figcaption>
<b>Figure 8.</b> Click the Manage instance password button
</figcaption>
</figure>

1. Conserva una copia de la URL, el nombre de usuario y la contraseña de la instancia para usarla cuando sea necesario.

En esta etapa, están disponibles los cinco datos necesarios para configurar un almacén de datos de ServiceNow. Si no tienes problemas con el uso del rol de administrador para extraer datos, continúa con la creación de un almacén de datos.

Configura roles y permisos

Otorga el rol de administrador a security_admin para administrar usuarios y roles.

1. Haz clic en el ícono de tu perfil y, luego, selecciona Elevar rol.

   

2. Selecciona security_admin y, luego, haz clic en Actualizar. El rol security_admin ayuda a crear roles y administrar usuarios.

   

1. Usa el rol de administrador: Puedes usar un rol de administrador para extraer datos. Puedes usar el rol de administrador predeterminado configurado con la instancia o crear un usuario nuevo con un rol de administrador con las siguientes instrucciones.

   1. Ve a Todo > Administración de usuarios > Usuarios.

   

   1. Crea un usuario nuevo con un nombre.

   

   1. Habilita Solo acceso a servicios web. Cuando seleccionas Solo acceso al servicio web, creas un usuario no interactivo.

      Usuarios interactivos en comparación con usuarios no interactivos: Los usuarios interactivos pueden acceder a la IU de ServiceNow o al portal de servicios con su nombre de usuario y contraseña. Pueden acceder a una instancia a través de una URL que dirija a una página, un formulario o una lista de la IU. También pueden conectarse con métodos de inicio de sesión único, como la autenticación de resumen o el lenguaje de marcado para confirmaciones de seguridad (SAML). Además, pueden usar sus credenciales para autorizar conexiones SOAP si la configuración de seguridad estricta lo permite y tienen acceso sin restricciones a otras conexiones de API, como WSDL, JSON, XML o XSD.

      Mientras que los usuarios no interactivos solo pueden usar sus credenciales para autorizar conexiones de API, como JSON, SOAP y WSDL. No pueden acceder a la IU de ServiceNow y solo pueden acceder a la instancia a través de protocolos de API.

   2. Después de crear el usuario, selecciónalo en la lista de usuarios.

   

   1. Haz clic en Roles > Editar.

   

   1. Agrega Administrador.
   2. Haz clic en Guardar para agregar una lista de roles al usuario.

   

   1. Agrega admin.
   2. Haz clic en Confirmación de contraseña, genera una contraseña automáticamente y guárdala.

   

2. Rol personalizado (recomendado): Es posible que el uso del rol de administrador no sea adecuado para los equipos o las organizaciones que desean evitar asignar permisos demasiado potentes. Esta opción proporciona un rol con tres permisos específicos que otorgan el acceso requerido.

   1. Ve a Todo > Seguridad del sistema > Usuarios y grupos > Roles.

   

   1. Selecciona Nuevo y, luego, ingresa un nombre.

   

   1. Haz clic en Enviar.

   

   1. Busca el rol creado en la lista.

   

   1. Navega a Contiene roles > Editar.

   

   1. Agrega los siguientes roles al rol recién creado y, luego, haz clic en Guardar.

      • catalog_admin
      • knowledge_admin
      • incident_manager

   

   1. Confirma las actualizaciones.

   

   1. En la siguiente imagen, se muestra el rol personalizado que incluye tres roles:

   

3. Rol personalizado con reglas de ACL: Esta opción requiere roles category_admin y knowledge_admin. Proporciona el conjunto mínimo de permisos.

   1. Ve a Todo > Administración de usuarios > Roles.

      

   2. Haz clic en Nuevo.

      

   3. Proporciona un nombre y haz clic en Enviar.

      

   4. Ve a Seguridad del sistema > Control de acceso (LCA).

      

   5. Haz clic en Nuevo.

      

   6. Repite los siguientes dos pasos hasta que otorgues acceso a todas las tablas requeridas. El conector necesita acceso a estas tablas para que cada entidad se ejecute correctamente.

      1. Usa sys_user_role como ejemplo para ver cómo se otorga el acceso a la tabla.

         

      2. Haz clic en Enviar y selecciona el rol.

      El conector necesita acceso a estas tablas para que cada entidad se ejecute correctamente.

To run successfully, the catalog item entity connector also requires
explicit access to all fields of the `sc_cat_item` table.

Para otorgar y verificar el acceso de la ACL, haz lo siguiente:

1. Para otorgar acceso explícito, crea una regla de LCA nueva y, luego, ingresa sc_cat_item.* de forma manual en el campo Nombre del formulario.

   

2. Verifica que todas las LCA estén actualizadas.

3. Ve a sys_security_acl_role_list.do en la barra de búsqueda.

   

4. Selecciona Rol con el rol que deseas verificar.

   

5. Verifica que todas las LCA requeridas estén asignadas al rol.

Otorga un rol a un usuario

1. Ve a Todo > Administración de usuarios > Usuarios.

   

2. Busca o crea un usuario nuevo.

   

3. Si no hay ningún usuario disponible, ve a Seguridad del sistema > Usuarios y grupos > Usuarios.

   

4. Haz clic en Nuevo.

   

5. Crea una cuenta de servicio nueva en la tabla de usuarios. Asegúrate de hacer clic en Solo acceso a servicios web.

   

6. Desplázate hasta Roles.

   

7. Haz clic en Editar.

   

8. Otorga el rol que creaste y asígnale al usuario. Según el tipo de rol que creaste en el paso anterior, selecciona el adecuado y asígnale al usuario. Haz clic en Guardar.

   

   O

   

9. Visualiza el rol personalizado con la LCA.

   

10. Obtén el nombre de usuario y la contraseña del usuario y haz clic en Establecer contraseña.

    

11. Generar una contraseña automáticamente y conservarla para usarla más adelante

    

    Otorga el rol de administrador a security_admin para administrar usuarios y roles.

12. Haz clic en el ícono de tu perfil y, luego, selecciona Elevar rol.

    

13. Selecciona security_admin y, luego, haz clic en Actualizar. El rol security_admin ayuda a crear roles y administrar usuarios.

    

1. Usa el rol de administrador: Puedes usar un rol de administrador para extraer datos. Puedes usar el rol de administrador predeterminado configurado con la instancia o crear un usuario nuevo con un rol de administrador con las siguientes instrucciones.

   1. Ve a Todo > Administración de usuarios > Usuarios.

   

   1. Crea un usuario nuevo con un nombre.

   

   1. Habilita Solo acceso a servicios web. Cuando seleccionas Solo acceso al servicio web, creas un usuario no interactivo.

      Usuarios interactivos en comparación con usuarios no interactivos: Los usuarios interactivos pueden acceder a la IU de ServiceNow o al portal de servicios con su nombre de usuario y contraseña. Pueden acceder a una instancia a través de una URL que dirija a una página, un formulario o una lista de la IU. También pueden conectarse con métodos de inicio de sesión único, como la autenticación de resumen o el lenguaje de marcado para confirmaciones de seguridad (SAML). Además, pueden usar sus credenciales para autorizar conexiones SOAP si la configuración de seguridad estricta lo permite y tienen acceso sin restricciones a otras conexiones de API, como WSDL, JSON, XML o XSD.

      Mientras que los usuarios no interactivos solo pueden usar sus credenciales para autorizar conexiones de API, como JSON, SOAP y WSDL. No pueden acceder a la IU de ServiceNow y solo pueden acceder a la instancia a través de protocolos de API.

   2. Después de crear el usuario, selecciónalo en la lista de usuarios.

   

   1. Haz clic en Roles > Editar.

   

   1. Agrega Administrador.
   2. Haz clic en Guardar para agregar una lista de roles al usuario.

   

   1. Agrega admin.
   2. Haz clic en Confirmación de contraseña, genera una contraseña automáticamente y guárdala.

   

2. Rol personalizado (recomendado): Es posible que el uso del rol de administrador no sea adecuado para los equipos o las organizaciones que desean evitar asignar permisos demasiado potentes. Esta opción proporciona un rol con tres permisos específicos que otorgan el acceso requerido.

   1. Ve a Todo > Seguridad del sistema > Usuarios y grupos > Roles.

   

   1. Selecciona Nuevo y, luego, ingresa un nombre.

   

   1. Haz clic en Enviar.

   

   1. Busca el rol creado en la lista.

   

   1. Navega a Contiene roles > Editar.

   

   1. Agrega los siguientes roles al rol recién creado y, luego, haz clic en Guardar.

      • catalog_admin
      • knowledge_admin
      • incident_manager

   

   1. Confirma las actualizaciones.

   

   1. En la siguiente imagen, se muestra el rol personalizado que incluye tres roles:

   

3. Rol personalizado con reglas de ACL: Esta opción requiere roles category_admin y knowledge_admin. Proporciona el conjunto mínimo de permisos.

   1. Ve a Todo > Administración de usuarios > Roles.

      

   2. Haz clic en Nuevo.

      

   3. Proporciona un nombre y haz clic en Enviar.

      

   4. Ve a Seguridad del sistema > Control de acceso (LCA).

      

   5. Haz clic en Nuevo.

      

   6. Repite los siguientes dos pasos hasta que otorgues acceso a todas las tablas requeridas. El conector necesita acceso a estas tablas para que cada entidad se ejecute correctamente.

      1. Usa sys_user_role como ejemplo para ver cómo se otorga el acceso a la tabla.

         

      2. Haz clic en Enviar y selecciona el rol.

      El conector necesita acceso a estas tablas para que cada entidad se ejecute correctamente.

To run successfully, the catalog item entity connector also requires
explicit access to all fields of the `sc_cat_item` table.

Para otorgar y verificar el acceso de la ACL, haz lo siguiente:

1. Para otorgar acceso explícito, crea una regla de LCA nueva y, luego, ingresa sc_cat_item.* de forma manual en el campo Nombre del formulario.

   

2. Verifica que todas las LCA estén actualizadas.

3. Ve a sys_security_acl_role_list.do en la barra de búsqueda.

   

4. Selecciona Rol con el rol que deseas verificar.

   

5. Verifica que todas las LCA requeridas estén asignadas al rol.

Otorga un rol a un usuario

1. Ve a Todo > Administración de usuarios > Usuarios.

   

2. Busca o crea un usuario nuevo.

   

3. Si no hay ningún usuario disponible, ve a Seguridad del sistema > Usuarios y grupos > Usuarios.

   

4. Haz clic en Nuevo.

   

5. Crea una cuenta de servicio nueva en la tabla de usuarios. Asegúrate de hacer clic en Solo acceso a servicios web.

   

6. Desplázate hasta Roles.

   

7. Haz clic en Editar.

   

8. Otorga el rol que creaste y asígnale al usuario. Según el tipo de rol que creaste en el paso anterior, selecciona el adecuado y asígnale al usuario. Haz clic en Guardar.

   

   O

   

9. Visualiza el rol personalizado con la LCA.

   

10. Obtén el nombre de usuario y la contraseña del usuario y haz clic en Establecer contraseña.

    

11. Generar una contraseña automáticamente y conservarla para usarla más adelante

    

Crea un conector de ServiceNow

Configura el grupo de trabajadores

El grupo de trabajadores te permite administrar y autenticar usuarios de proveedores de identidad externos, como Azure o Okta, en la consola de Google Cloud. Para configurar tu grupo de personal y habilitar la app web para que los usuarios accedan sin inconvenientes, haz lo siguiente:

1. Para crear un grupo de personal a nivel de la organización en Google Cloud , sigue el manual de configuración adecuado:

   1. Configuración de OIDC de Azure
   2. Configuración de SAML de Azure
   3. Configuración de OIDC y Okta
   4. Configuración de Okta y SAML

2. Configura el grupo de trabajadores en Aplicaciones de IA > Configuración para la región en la que creaste tu app.

Configura el grupo de trabajadores

El grupo de trabajadores te permite administrar y autenticar usuarios de proveedores de identidad externos, como Azure o Okta, en la consola de Google Cloud. Para configurar tu grupo de personal y habilitar la app web para que los usuarios accedan sin inconvenientes, haz lo siguiente:

1. Para crear un grupo de personal a nivel de la organización en Google Cloud , sigue el manual de configuración adecuado:

   1. Configuración de OIDC de Azure
   2. Configuración de SAML de Azure
   3. Configuración de OIDC y Okta
   4. Configuración de Okta y SAML

2. Configura el grupo de trabajadores en Aplicaciones de IA > Configuración para la región en la que creaste tu app.

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Conecta el centro de datos de SharePoint local

En esta sección, se describe el proceso para crear un conector de SharePoint Data Center local.

Sincroniza datos desde el centro de datos de SharePoint local

Usa el siguiente procedimiento para sincronizar datos desde el centro de datos de SharePoint local.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de la fuente con la frecuencia especificada durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Adjunto de servicio (obligatorio solo para el tipo de destino privado): Sigue los pasos que se indican a continuación para generar un archivo adjunto de servicio para la transferencia de datos segura.

   1. Decide el tipo de extremo: Selecciona el extremo Público o Privado.

   2. Para el extremo público: Si el tipo de destino del centro de datos de SharePoint es público, no es necesario que crees la configuración para el archivo adjunto del servicio. En su lugar, puedes usar tu URL pública en el campo URL del dominio de la consola de Google Cloud cuando crees el conector.

   3. Para el extremo Privado:

      1. Usa Private Service Connect (PSC) para habilitar conexiones desde instancias privadas a Google Cloud
      2. Crea una red de nube privada virtual y las subredes necesarias.
      3. Crea una instancia de máquina virtual (VM) y, luego, instala el servicio de backend.
      4. Opcional: Configura una sonda de verificación de estado para supervisar el estado del backend.
      5. Agrega un balanceador de cargas para enrutar el tráfico a la VM o al backend.
      6. Define reglas de firewall para permitir el tráfico entre el extremo de PSC y el backend
      7. Para publicar el extremo, crea un adjunto de servicio de PSC.

2. Nombre de usuario y contraseña: Obtén credenciales válidas para la autenticación de tu administrador de SharePoint.

3. Opcional para el tipo de destino privado: URL de dominio: Conserva la URL de dominio de la instancia de SharePoint Data Center si la instancia está detrás de un proxy o una conexión basada en SSL.

4. Opcional: Nombre de dominio base: Proporciona el nombre de dominio base para la instancia de SharePoint.

5. Opcional: Puerto de destino: Identifica el puerto que se usa para la comunicación con el centro de datos de SharePoint.

6. Usa los siguientes lineamientos de configuración para establecer conexiones con Private Service Connect(PSC). Ajusta o agrega recursos según sea necesario. Asegúrate de que el adjunto de servicio de PSC esté configurado correctamente para conectarse a la instancia privada y cumpla con los requisitos de un servicio publicado.

   1. Establece la configuración de red:

      1. Coloca el adjunto de servicio y el balanceador de cargas de PSC en subredes diferentes dentro de la misma red de nube privada virtual.

      2. El sistema de backend debe permanecer cerrado a la red pública por motivos de seguridad. Sin embargo, asegúrate de que pueda aceptar tráfico de las siguientes fuentes:

         • Para los balanceadores de cargas basados en proxy o HTTP(s) (balanceador de cargas de proxy de L4, balanceador de cargas de L7), configura el backend para que acepte solicitudes de la subred de proxy en la red de nube privada virtual.

         • Para obtener más información, consulta la documentación Subredes de solo proxy para balanceadores de cargas basados en Envoy.

   2. Ajusta las reglas de firewall:

      1. Reglas de entrada:

         • Permite el tráfico de la subred de conexión del servicio de PSC a la subred del balanceador de cargas interno (ILB).
         • Asegúrate de que el ILB pueda enviar tráfico al backend.
         • Permite que los sondeos de verificación de estado lleguen al backend.

      2. Reglas de salida: Habilita el tráfico de salida de forma predeterminada, a menos que se apliquen reglas de denegación específicas.

7. Consideraciones adicionales: Asegúrate de mantener todos los componentes, incluido el adjunto del servicio de PSC y el balanceador de cargas, en la misma región.

Crea un usuario con permisos de acceso mínimos de SharePoint y configura los permisos

Para crear un usuario con permisos de acceso mínimo de SharePoint, obtén un nombre de usuario y una contraseña de un administrador. El administrador debe acceder y seguir estos pasos para crear un usuario nuevo en la instancia de SharePoint Data Center:

1. Haz clic en el menú Inicio y navega a Herramientas administrativas de Windows > Usuarios y computadoras de Active Directory.
2. Inicia la aplicación Usuarios y computadoras de Active Directory.
3. Expande la unidad organizativa y navega al contenedor Usuarios, en el que se agrega el usuario nuevo.
4. Haz clic con el botón derecho en Usuarios y selecciona Nuevo > Usuario.
5. En la ventana New object:User, ingresa los siguientes detalles:
   • Nombre (no uses comas ni puntos)
   • Nombre completo
   • Nombre de acceso del usuario
6. Haz clic en Siguiente.
7. Ingresa y confirma la contraseña y, luego, selecciona una de las siguientes opciones:
   • El usuario no puede cambiar la contraseña
   • La contraseña nunca vence
8. Haz clic en Siguiente y, luego, en Finalizar.
9. Busca el usuario creado en la sección Usuarios, haz doble clic en él y selecciona Propiedades.
10. En la ventana Properties, agrega un correo electrónico para el usuario y haz clic en Apply.

Asigna permisos de acceso mínimos al usuario de SharePoint

1. Navega a la colección de sitios.
2. Haz clic en Configuración (menú del ícono de ajustes).
3. Ve a Permisos del sitio.
4. Selecciona Configuración de permisos avanzados.
5. Busca y selecciona el grupo Visitantes de SiteName (este grupo se crea automáticamente cuando se configura el sitio y tiene acceso de lectura predeterminado).
6. Agrega al usuario al grupo Visitantes de SiteName para otorgarle acceso de solo lectura.

Nota: Este acceso hereda todos los permisos de las listas, bibliotecas, páginas y eventos que tengan permisos de lectura.

Configura la colección de sitios en SharePoint

1. Accede a la consola del administrador de SharePoint con el nombre de usuario y la contraseña del administrador.
2. En la página Administración central, navega a Administración de aplicaciones.
3. Haz clic en Crear colecciones de sitios.
4. En la página Crear colección de sitios, haz lo siguiente:
   • Ingresa los detalles obligatorios en los campos Título y Descripción.
   • En la sección Dirección del sitio web, ingresa el nombre de la URL del sitio.
5. En la sección Administrador principal de la colección de sitios, haz lo siguiente:
   • Haz clic en el botón Explorar junto al campo Nombre de usuario.
   • En el diálogo Seleccionar personas, ingresa el nombre de usuario del administrador y haz clic en el ícono de búsqueda.
   • Selecciona el usuario y haz clic en Aceptar.
6. Aparecerá la página Se creó correctamente el sitio, en la que se mostrará la URL del sitio.
7. Copia la URL y ábrela en una pestaña nueva para acceder al sitio.

Accede con el usuario creado

1. Usa las credenciales del usuario creado para acceder al sitio de SharePoint.
2. Verifica el acceso y los permisos del usuario.

Crea un conector de SharePoint Data Center local

Próximos pasos

• Para conectar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Cómo crear una app de búsqueda.
• Consulta Cómo obtener una vista previa de los resultados de las apps con control de acceso de terceros.

Conecta SharePoint Online

Usa el siguiente procedimiento para sincronizar datos desde SharePoint Online.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

2. Otorga el consentimiento del administrador. Si deseas obtener información para otorgar consentimiento, consulta Otorga consentimiento de administrador en todo el inquilino a una aplicación en la documentación de Microsoft Entra.

3. Prepara la siguiente información de autenticación de Sharepoint Online para usarla durante la configuración:

   1. URL de la instancia. En el formato http://DOMAIN_OR_SERVER/[sites/]WEBSITE, por ejemplo, mydomain.sharepoint.com/sites/sample-site.

   2. La autenticación federada requiere el ID del inquilino y el ID de cliente, mientras que OAuth requiere el ID del inquilino, el ID de cliente y el secreto del cliente. Para registrar la aplicación, selecciona Solo cuentas en este directorio de la organización para el público de acceso y, luego, busca esta información de autenticación. Para obtener más información, consulta la Guía de inicio rápido: Registra una aplicación con la plataforma de identidad de Microsoft en la documentación de Microsoft Entra.

   3. Cuando registres la aplicación, usa https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html como la URL de devolución de llamada web.

4. En la siguiente tabla, se describen los roles que se recomiendan para la configuración y sus limitaciones.

   Cómo ver los roles

   Funciones	Registro de la aplicación cliente	Recupera el contenido de todas las entidades	LCA de recuperación	Cómo recuperar la identidad	Notas
   Administradores del sitio	No	Sí	Sí	Sí
   Administrador de la colección de sitios	No	Sí	Sí	Sí
   Administrador global	Sí	No	Sí	No	Limitación: El administrador global no puede recuperar entidades de identidad, comentarios ni archivos adjuntos.
   Propietario del sitio	No	Sí	Sí	No	Limitación: El propietario del sitio se relaciona con el centro de administración de Microsoft 365 o el centro de administración de Entra, no es específico de SharePoint.
   Administrador de aplicaciones	Sí	N/A	N/A	N/A	El rol de administrador de la aplicación está relacionado con el centro de administración de Microsoft 365 o el centro de administración de Entra. No es específico de Sharepoint.

   Usa este método para obtener un control detallado sobre los permisos de la API de REST de SharePoint, lo que te permite restringir el acceso a los recursos en la cuenta de usuario. Asegúrate de crear un usuario de SharePoint nuevo, lo que podría agregar costos de licencias. Usa el método de token de actualización de OAuth 2.0 para configurar un registro de la aplicación de Entra y habilitar el acceso seguro a SharePoint.

Configura el registro de la aplicación de Entra

Configura un registro de la aplicación de Entra para habilitar el acceso seguro a SharePoint. Elige entre las credenciales federadas para el acceso basado en tokens o el token de actualización de OAuth 2.0 para el control detallado. Sigue estos pasos para configurar el registro de la app, otorgar permisos y establecer la autenticación.

1. Credenciales federadas: Configura credenciales federadas para permitir que Google acceda de forma segura a SharePoint con tokens firmados criptográficamente, lo que evita la necesidad de un principal de usuario real. Para configurar los permisos y otorgar acceso, haz lo siguiente:

   1. Obtén el ID de cliente de la cuenta de servicio:

      1. En la consola de Google Cloud, ve a la página Aplicaciones de IA.
      2. En el menú de navegación, haz clic en Almacenes de datos.
      3. Haz clic en add Crear almacén de datos.
      4. En la página Selecciona una fuente de datos, desplázate o busca SharePoint Online para conectar tu fuente de terceros.
      5. Anota el identificador de asunto. Aún no hagas clic en Continuar. Realiza los siguientes pasos de esta tarea y, luego, completa los pasos en la consola de Google Cloud siguiendo las instrucciones que se indican en Cómo crear un conector de SharePoint Online.

         

   2. Registra la app en Microsoft Entra:

      1. Navega al centro de administración de Microsoft Entra.
      2. En el menú, expande la sección Applications y selecciona App registrations.
      3. En la página Registros de apps, selecciona Nuevo registro.

         

      4. Crea un registro de app en la página Registrar una aplicación:

         • En la sección Tipos de cuentas compatibles, selecciona Cuentas solo en el directorio de la organización.
         • En la sección URI de redireccionamiento, selecciona Web y, luego, ingresa el URI de redireccionamiento.
         • Mantén los demás parámetros de configuración predeterminados y haz clic en Registrar.

           

      5. Anota el ID de cliente y el ID de inquilino.

         

   3. Agrega credenciales federadas:

      1. Ve a Certificados y secretos > Credenciales federadas > Agregar credencial.

         

      2. Usa la siguiente configuración:

         • Situación de credencial federada: Otro emisor
         • Empresa emisora: https://accounts.google.com
         • Identificador de asunto: Usa el valor de Identificador de asunto que anotaste en la consola de Google Cloud en el paso 1.a.v.
         • Nombre: Proporciona un nombre único.

      3. Haz clic en Agregar para otorgar acceso.

         

   4. Establece permisos de API:

      

      1. Agrega y otorga el consentimiento del administrador para los siguientes permisos de Microsoft Graph con el tipo establecido en Aplicación:

         • GroupMember.Read.All: Lee todas las pertenencias a grupos.
         • Sites.FullControl.All: Control total sobre todos los sitios.
         • Sites.Read.All: Lee todos los sitios. Usa Sites.Selected para asignar permisos de sitios específicos en lugar de Sites.FullControl.All. Sites.Selected no se puede configurar directamente a través de la IU. Después de seleccionar Sites.Selected, debes llamar a la API de Microsoft Graph para otorgar explícitamente el rol de control total a la aplicación para los sitios que deseas rastrear.
         • User.Read.All: Lee los perfiles completos de todos los usuarios.

           

      2. Agrega y otorga el consentimiento del administrador para los siguientes permisos de SharePoint con el tipo establecido como Delegado:

         • AllSites.FullControl: Tener control total de todas las colecciones de sitios
         • AllSites.Read: Lee elementos en todas las colecciones de sitios

           

2. Token de actualización de OAuth 2.0: Configura la autenticación de OAuth 2.0 con un secreto de cliente y un token de actualización del usuario de SharePoint para habilitar el control detallado sobre el acceso a la API de SharePoint. Para configurar el registro de apps, agregar un secreto de cliente y asignar permisos de API, haz lo siguiente:

   1. Crea el registro de la app:

      1. Navega al Centro de administración de Entra.

      2. Crea un registro de app:

         • Tipos de cuentas admitidos: Solo cuentas en el directorio de la organización.
         • URI de redireccionamiento: https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.

      3. Anota el ID de cliente y el ID de inquilino.

         

   2. Agrega el secreto del cliente:

      1. Ve a Certificados y secretos > Nuevo secreto de cliente.

         

      2. Anota la cadena secreta.

         

   3. Establece permisos de API:

      1. Agrega y otorga el consentimiento del administrador para los siguientes permisos:

         • GroupMember.Read.All: Lee todas las pertenencias a grupos.
         • Sites.FullControl.All: Control total de todas las colecciones de sitios.
         • User.Read.All: Lee los perfiles completos de todos los usuarios.
         • AllSites.FullControl: Control total sobre todos los sitios.

      2. Usa una cuenta de usuario dedicada con acceso limitado a sitios específicos.

      3. Asegúrate de que la cuenta tenga acceso de propietario a los sitios seleccionados.

Crea un conector de SharePoint Online

Prueba el motor de búsqueda

Después de configurar tu motor de búsqueda, prueba sus capacidades. Esto garantiza que se muestren resultados precisos según el acceso del usuario.

1. Habilita la app web:

   1. Ve a la configuración de integración de la app y activa la opción para habilitar la app web.

2. Prueba la app web:

   1. Haz clic en Abrir junto al vínculo de la app web y accede con un usuario de tu grupo de trabajadores.

   2. Verifica que los resultados de la búsqueda se restrinjan a los elementos a los que el usuario que accedió puede acceder.

Configura el grupo de trabajadores

El grupo de trabajadores te permite administrar y autenticar usuarios de proveedores de identidad externos, como Azure o Okta, en la consola de Google Cloud. Para configurar tu grupo de personal y habilitar la app web para que los usuarios accedan sin inconvenientes, haz lo siguiente:

1. Para crear un grupo de personal a nivel de la organización en Google Cloud , sigue el manual de configuración correspondiente:

   1. Configuración de OIDC de Azure
   2. Configuración de SAML de Azure
   3. Configuración de OIDC y Okta
   4. Configuración de Okta y SAML

2. Configura el grupo de trabajadores en Aplicaciones de IA > Configuración para la región en la que creaste tu app.

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.

Conectar Slack

Usa el siguiente procedimiento para sincronizar datos desde Slack.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

2. Para seguir los pasos que se indican en Cómo configurar tu app de Slack, debes tener los permisos para instalar apps nuevas en tu lugar de trabajo, que se incluyen en el rol de Propietario del lugar de trabajo. Comunícate con tu propietario principal de Workspace para que te asigne como propietario de Workspace.

3. Ten en cuenta que, de forma predeterminada, Slack restringe el rastreo y la sincronización de contenido de canales privados, mensajes grupales y mensajes directos.

Configura la app de Slack

El conector de Slack requiere un token de acceso para poder transferir documentos desde tu espacio de trabajo de Slack. Para obtener un token de acceso que permita a Vertex AI Search transferir documentos desde tu espacio de trabajo de Slack.

Para obtener más información, consulta la Guía de inicio rápido y Cómo obtener y usar rápidamente un token de API de Slack en la documentación de Slack.

Existen dos tipos de tokens diferentes que puedes usar:

• Token de bot
  • Beneficios:
    • No está vinculada a un usuario específico.
    • Puede tener un acceso más seguro a los canales privados de Slack, los mensajes instantáneos (MI) y los mensajes instantáneos para varias personas (MPIM). Los miembros involucrados en esos canales y mensajes pueden invitar al bot.
    • También se puede invitar al bot a canales públicos. Cuando configures el token del bot, puedes agregar el permiso channels:join para que el rastreador intente unirse automáticamente a todos los canales públicos.
  • Limitaciones:
    • Cuando el bot intenta unirse a canales públicos, se envía un mensaje de unión al canal.
• Token de usuario
  • Beneficios:
    • Puede acceder a todos los canales públicos sin necesidad de unirse a ellos previamente.
  • Limitaciones:
    • Se asocia a un usuario específico.
    • Con el token de usuario, los usuarios no pueden rastrear canales privados, IM ni MPIM de los que no forman parte.

Configura el token del bot

En los siguientes pasos, se muestra cómo configurar un token de bot:

1. Accede a Apps de la API de Slack.
2. Haz clic en Create new app.

   

3. Selecciona Desde cero. Esta opción te permite configurar la información, los permisos, la configuración y las funciones de la app.

   

4. Ingresa un nombre para tu app. Todos los usuarios de Slack podrán ver el nombre que selecciones.
5. Selecciona el lugar de trabajo para la integración. Como no puedes cambiar el lugar de trabajo de una app más adelante, asegúrate de seleccionar el correcto.

   

6. Haz clic en Crear aplicación.
7. En la barra lateral, selecciona OAuth y permisos.

   

8. En Bot token scopes, agrega los siguientes permisos obligatorios:

   class="showalways">Ver permisos

   • channels:history
   • channels:read
   • files:read
   • groups:history
   • groups:read
   • im:history
   • im:read
   • mpim:history
   • mpim:read
   • team:read
   • users:read
   • users:read.email
   De forma predeterminada, el bot lee de los canales #general y #random.

   

9. Para permitir que el bot rastree los canales, haz lo siguiente:
   1. En el caso de los canales públicos, realiza una de las siguientes acciones:
      • Invita al bot de forma manual.
      • Otorga el permiso channels:join para permitir que el bot intente unirse automáticamente.
   2. En el caso de los canales privados, invita al bot de forma manual.
10. En la misma página, haz clic en Install to WORKSPACE_NAME.

    

11. Sigue las instrucciones en pantalla para instalar la app y, después de hacerlo, copia y anota el token de OAuth del bot.

    

Configura un token de usuario

En los siguientes pasos, se muestra cómo configurar un token de bot:

1. Accede a Apps de la API de Slack.
2. Haz clic en Create new app.

   

3. Selecciona Desde cero. Esta opción te permite configurar la información, los permisos, la configuración y las funciones de la app.

   

4. Ingresa un nombre para tu app. Todos los usuarios de Slack podrán ver el nombre que selecciones.
5. Selecciona el lugar de trabajo para la integración. Como no puedes cambiar el lugar de trabajo de una app más adelante, asegúrate de seleccionar el correcto.

   

6. Haz clic en Crear aplicación.
7. En la barra lateral, selecciona OAuth y permisos.

   

8. En User token scopes, agrega los siguientes permisos necesarios:

   class="showalways">Ver permisos

   • channels:history
   • channels:read
   • files:read
   • groups:history
   • groups:read
   • im:history
   • im:read
   • mpim:history
   • mpim:read
   • team:read
   • users:read
   • users:read.email

   

9. En la misma página, haz clic en Install to WORKSPACE_NAME.

   

10. Sigue las instrucciones en pantalla para instalar la app y, después de hacerlo, copia y anota el token de OAuth del usuario.

    

Crea un conector de Slack Cloud

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.

Conecta WordPress

Usa el siguiente procedimiento para sincronizar datos de WordPress con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, asegúrate de tener lo siguiente:

• Nombre de usuario y contraseña: Obtén las credenciales del administrador de WordPress.
• URL del sitio: Usa esta URL para crear el almacén de datos.

Crea un usuario de WordPress

Para crear un usuario de WordPress, obtén un nombre de usuario y una contraseña de un administrador. El administrador debe acceder y seguir estos pasos para crear un usuario nuevo en la instancia de WordPress.

1. Accede como administrador:

   1. Navega a tu plataforma de hosting y accede con tus credenciales de administrador para acceder a tu sitio web de WordPress.
   2. Haz clic en el ícono de Sitio web.
   3. Haz clic en Administrador de WordPress para tu sitio.

2. Crea un usuario nuevo:

   1. En la página Administrador de WordPress, navega a la pestaña Usuarios.
   2. Haz clic en Agregar nueva.
   3. Completa todos los detalles obligatorios, incluidos los siguientes:
      • Nombre de usuario
      • Dirección de correo electrónico
      • Opcional: Nombre y apellido
      • Rol
      • Contraseña (si se te solicita)
   4. Haz clic en Agregar usuario nuevo para guardar los cambios.

Crea un conector de WordPress

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.

Conecta Zendesk

Usa el siguiente procedimiento para sincronizar datos de Zendesk con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

1. Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

2. Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

3. Un administrador de Zendesk debe generar o obtener lo siguiente para integrarlo con Vertex AI Search:

   1. Token de acceso Token de API de tu instancia de Zendesk.
   2. Es el URI de la instancia.

Crea un conector de Zendesk

Próximos pasos

• Para conectar tu conector a una app, crea una app y selecciona el conector siguiendo los pasos que se indican en Cómo crear una app de búsqueda.

• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar la app, consulta Obtén resultados de la búsqueda. Si usaste el control de acceso de terceros, consulta Obtén una vista previa de los resultados de las apps con control de acceso de terceros.