Crear una aplicación OAuth de Microsoft para OpenConnector

Usa un registro de aplicación de Microsoft Entra cuando OpenConnector necesite conectar proveedores de Microsoft Graph como Outlook, OneDrive o Excel.

Servicios de OpenConnector

El valor tenant es el segmento de inquilino de la plataforma de identidad de Microsoft que se usa en las URL de autorización y token. Los valores comunes son common, organizations, consumers o un ID de inquilino específico.

Requisitos previos

• Un runtime de OpenConnector en ejecución.
• Acceso al centro de administración de Microsoft Entra o a los registros de aplicaciones de Azure.
• Permiso para registrar una aplicación y crear un secreto de cliente.
• El origen de OpenConnector que los usuarios abren en el navegador, como http://localhost:3000 o https://connect.example.com.

Paso 1: Configurar la URL de callback de OpenConnector

Construye la URL de callback añadiendo /oauth/callback a tu origen de OpenConnector. Para pruebas locales, usa http://localhost:3000/oauth/callback. Para una implementación pública, configura OOMOL_CONNECT_ORIGIN, reinicia OpenConnector y usa la URL de callback pública, como https://connect.example.com/oauth/callback.

Paso 2: Registrar una aplicación de Microsoft

En Microsoft Entra admin center:

1. Abre Registros de aplicaciones.
2. Crea un nuevo registro.
3. Elige el tipo de cuenta compatible que coincida con tus usuarios.
4. Añade una URI de redirección Web con la URL de callback exacta de OpenConnector.
5. Registra la aplicación.
6. Abre Certificados y secretos y crea un secreto de cliente.
7. Abre Permisos de API y añade los permisos delegados de Microsoft Graph que requiera el servicio de OpenConnector.

La guía oficial de Microsoft es Registrar una aplicación con la plataforma de identidad de Microsoft. Microsoft también documenta que la URI de redirección enviada en la solicitud de autenticación debe coincidir con una URI de redirección registrada en el flujo de código de autorización.

Paso 3: Copiar los valores del cliente

Copia el valor del secreto de cliente cuando se cree. Microsoft no volverá a mostrar el valor completo del secreto más adelante.

Paso 4: Guardar el cliente en OpenConnector

Los proveedores de Microsoft de OpenConnector requieren el valor adicional tenant. Usa una versión de la consola de OpenConnector que muestre el campo tenant en el formulario de cliente OAuth antes de seguir esta guía.

1. Abre la consola web de OpenConnector, como http://localhost:3000.
2. Abre Providers y selecciona Outlook, OneDrive o Excel.
3. Elige Configure OAuth Client o Edit OAuth Client.
4. Pega el ID de cliente de la aplicación de Microsoft y el valor del secreto de cliente.
5. Rellena Tenant con common, organizations, consumers o tu ID de inquilino.
6. Elige Save OAuth Client.

Repite estos pasos para one_drive o excel al configurar esos servicios.

Paso 5: Conectar y probar

Después de guardar la configuración del cliente OAuth, elige Conectar en la página del proveedor de Microsoft. Inicia sesión con la cuenta de Microsoft, aprueba el consentimiento, vuelve a OpenConnector y confirma que la página del proveedor muestra la cuenta como conectada.

Consulta los detalles de las acciones de la consola antes de ejecutar acciones de Microsoft Graph. Elige una acción de lectura presente en tu versión del catálogo, como outlook.list_messages cuando esté disponible.

Solución de problemas