Configuración de Microsoft Teams

Vista previa pública: la búsqueda federada está en vista previa pública. Esta función está sujeta a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

En esta página se describe cómo configurar la autenticación y los permisos antes de crear el almacén de datos de Microsoft Teams.

Configurar la autenticación y los permisos

Debes configurar la autenticación y los permisos en Microsoft 365, lo cual es fundamental para permitir que Gemini Enterprise acceda a los datos de Microsoft Teams.

Registro de aplicaciones de Entra para el almacén de datos de Microsoft Teams

Antes de crear el almacén de datos de Gemini Enterprise, debes configurar un registro de aplicación de Microsoft Entra para habilitar el acceso seguro a Microsoft Teams.

Para registrar Gemini Enterprise como aplicación OAuth 2.0 en Microsoft Entra, haz lo siguiente:

1. Vaya al centro de administración de Microsoft Entra.
2. En el menú, despliega la sección Entra ID y selecciona Registros de aplicaciones.
3. En la página Registros de aplicaciones, selecciona Añadir Nuevo registro.
4. En la página Registrar una aplicación, crea un registro de aplicación haciendo lo siguiente:
   1. En la sección Nombre, introduce un nombre visible para la aplicación.

      

      Página Registrar una aplicación

   2. En la sección Tipos de cuenta admitidos, selecciona Solo cuentas del directorio de la organización. Esta opción restringe el acceso a los usuarios del tenant de Microsoft Entra de tu organización, lo que es adecuado para una aplicación empresarial.
   3. En la sección URI de redirección, selecciona Web e introduce la siguiente URL como URL de retrollamada web (o URL de redirección):
      • https://vertexaisearch.cloud.google.com/oauth-redirect
   4. Haz clic en Registrarse. Microsoft Entra crea la aplicación y la muestra en la página Todas las aplicaciones.

Crear una configuración de OAuth 2.0

Para crear una conexión mediante el método de autenticación OAuth 2.0, obtén un ID de cliente, un secreto de cliente y un ID de cliente del inquilino en la página de registro de tu aplicación Microsoft Entra siguiendo estos pasos.

Obtener el ID y el secreto de cliente

Para obtener el ID y el secreto de cliente de la aplicación, sigue estos pasos:

1. Vaya al centro de administración de Microsoft Entra.
2. En el menú, despliega la sección Entra ID y selecciona Registros de aplicaciones.
3. En la página Registros de aplicaciones, selecciona Todas las aplicaciones.
4. Abre la aplicación que has creado.
5. En la página de la aplicación, selecciona Certificados y secretos.
6. Haz clic en Añadir Nuevo secreto de cliente.
7. En el cuadro de diálogo Añadir secreto de cliente, haz lo siguiente:
   1. Introduce una descripción del secreto.

      

      Cuadro de diálogo para añadir un secreto de cliente

   2. Selecciona una duración de vencimiento. Te recomendamos que selecciones el valor predeterminado.
   3. Haz clic en Añadir.
8. Copia el secreto de la columna Valor (Client Secret) y el identificador de la columna ID de secreto (Client ID) y guárdalos de forma segura para usarlos más adelante.

Obtener el ID de cliente

Puede encontrar su ID de cliente en el cuadro ID de cliente de la página de descripción general del centro de administración de Microsoft Entra.

Obtener el ID de propietario

Configurar los permisos de Microsoft Graph

Para configurar los permisos de Microsoft Graph necesarios para la aplicación, haz lo siguiente:

1. Vaya al centro de administración de Microsoft Entra.
2. En el menú de navegación, expande la sección Entra ID y selecciona Registros de aplicaciones.
3. En la página Registros de aplicaciones, selecciona Todas las aplicaciones.
4. Abre la aplicación que has creado.
5. En la página de la aplicación, selecciona Permisos de API.
6. Haz clic en Añadir un permiso.
7. En la página Solicitud de permisos de API, selecciona Microsoft Graph y, a continuación, Permisos delegados.

8. Busca y selecciona los siguientes permisos para tu modo de conexión. Asegúrate de que un administrador concede el consentimiento para todos los permisos delegados que se indican en la siguiente tabla. Una vez que se haya concedido el consentimiento, en la columna Estado se mostrará el valor Concedido con una marca de verificación verde (✓).

   Modo de conexión	Permiso	Tipo de permiso	Finalidad
   Búsqueda federada	Chat.Read	Delegado	Permite que la aplicación lea todas las conversaciones.
   	Chat.ReadBasic	Delegado	Permite que la aplicación lea las propiedades básicas de las conversaciones.
   	ChatMessage.Read	Delegado	Permite que la aplicación lea todos los mensajes de chats individuales y de grupo.
   	Channel.ReadBasic.All	Delegado	Permite que la aplicación lea los nombres y las descripciones de los canales.
   	ChannelMessage.Read.All	Delegado	Permite que la aplicación lea los mensajes de los canales del usuario.
   	Team.ReadBasic.All	Delegado	Permite que la aplicación lea los nombres y las descripciones de los equipos.
   	User.Read	Delegado	Permite que la aplicación inicie sesión y lea el perfil de usuario.
   Búsqueda y acciones federadas	Chat.Read	Delegado	Permite que la aplicación lea todas las conversaciones.
   	Chat.ReadBasic	Delegado	Permite que la aplicación lea las propiedades básicas de las conversaciones.
   	ChatMessage.Read	Delegado	Permite que la aplicación lea todos los mensajes de chats individuales y de grupo.
   	Channel.ReadBasic.All	Delegado	Permite que la aplicación lea los nombres y las descripciones de los canales.
   	ChannelMessage.Read.All	Delegado	Permite que la aplicación lea los mensajes de los canales del usuario.
   	Team.ReadBasic.All	Delegado	Permite que la aplicación lea los nombres y las descripciones de los equipos.
   	User.Read	Delegado	Permite que la aplicación inicie sesión y lea el perfil de usuario.
   	ChannelMessage.Send	Delegado	Permite que la aplicación envíe mensajes en cualquier canal.
   	ChatMessage.Send	Delegado	Permite que la aplicación envíe mensajes de chat.

   Nota: Si solo tienes intención de usar el almacén de datos para realizar búsquedas y no para llevar a cabo ninguna acción que modifique el contenido de Microsoft Teams, puedes limitar el ámbito a los permisos de Read.All. Se necesitan otros permisos para acciones que impliquen actualizar contenido en Microsoft Teams.

9. Haz clic en Añadir permisos.

Conceder el consentimiento del administrador para los permisos

Para conceder el consentimiento del administrador para los permisos, sigue estos pasos:

1. Inicia sesión en el centro de administración de Microsoft Entra como administrador global o de aplicaciones.
2. En el menú de navegación, despliega la sección Entra ID y selecciona Registros de aplicaciones.
3. En la página Registros de aplicaciones, selecciona Todas las aplicaciones.
4. Abre la aplicación que has creado.
5. En la página de la aplicación, selecciona Permisos de API.

6. Haz clic en el botón Conceder consentimiento de administrador para.

   

   Conceder consentimiento de administrador

7. Selecciona Sí en el cuadro de diálogo para confirmar la acción de consentimiento.