OneNote Integración con Microsoft

Con el conector de OneNote acción de Microsoft, puedes gestionar libretas, secciones y páginas desde tu cuenta de Microsoft 365 directamente en Amazon Quick mediante lenguaje natural. El conector utiliza Microsoft Graph para OneNote las operaciones.

Amazon Quick admite dos métodos de autenticación para Microsoft OneNote. Elija el método que mejor se adapte a los requisitos de seguridad de su organización.

• Aplicación OAuth predeterminada: utiliza una aplicación OAuth AWS gestionada. No se necesitan credenciales adicionales. Los usuarios se autentican directamente con su cuenta de Microsoft 365.

• Aplicación OAuth personalizada: utiliza una aplicación gestionada por el cliente registrada en Microsoft Entra ID. Esta opción le da a tu organización un control total sobre la configuración de OAuth.

Para obtener más información sobre los métodos de autenticación que admite Amazon Quick, consulteMétodos de autenticación.

Antes de empezar

Asegúrese de disponer de lo siguiente antes de configurar la integración.

• Una cuenta Microsoft 365 activa con acceso a las OneNote libretas que quieras usar.

• Para la aplicación OAuth personalizada: acceda al ID de Microsoft Entra (anteriormente Azure Active Directory) para registrar una aplicación y configurar los permisos de Microsoft Graph. OneNote

• Para conocer los requisitos de suscripción a Amazon Quick, consulteConfigurar integraciones en la consola.

Configuración de Microsoft Entra ID

Si utilizas la autenticación por defecto de la aplicación OAuth, omite esta sección y continúa con. Configuración del conector en Amazon Quick

Para la autenticación personalizada de aplicaciones OAuth, registre una aplicación en el centro de administración de Microsoft Entra y configure los permisos de Microsoft Graph para OneNote (por ejemplo Notes.ReadNotes.ReadWrite, o Notes.Read.All según sea necesario). Añade la URL de Amazon Quick callback https://{region}.quicksight.aws.amazon.com/sn/oauthcallback como URI de redireccionamiento. {region}Reemplácela por su AWS región (por ejemplo,us-east-1). Para obtener instrucciones paso a paso, consulte Conceptos básicos de autenticación y autorización en la documentación de Microsoft Graph. Registre el ID de la aplicación (cliente) y el valor secreto del cliente; los necesitará al configurar Amazon Quick.

Configuración del conector en Amazon Quick

Conectarse desde la pestaña Disponible

Si quieres usar la autenticación de la aplicación OAuth predeterminada, puedes conectarte directamente desde la pestaña Disponible sin necesidad de realizar ninguna configuración adicional.

1. En la consola Amazon Quick, selecciona Connectors.

2. En la pestaña Disponible, busque OneNotey seleccione Conectar.

3. Complete el flujo de inicio de sesión de Microsoft y conceda los permisos solicitados.

Para configurar un conector con la aplicación OAuth personalizada, usa la pestaña Crear para tu equipo, tal y como se describe a continuación.

Crea desde la pestaña Crear para tu equipo

1. En la consola Amazon Quick, selecciona Connectors.

2. Selecciona la pestaña Crear para tu equipo.

3. Busca y elige OneNote.

4. Introduzca un nombre para el conector. Si lo desea, elija + Añadir descripción para añadir una descripción.

5. En Tipo de conexión, elija Red pública.

6. Para la configuración de OAuth, elija uno de los siguientes métodos de autenticación y configure los campos obligatorios.

   1. Para la aplicación OAuth predeterminada:

      No se necesitan credenciales adicionales. Elija Siguiente para continuar.

   2. Para la aplicación OAuth personalizada, configura los siguientes campos:

      • URL base (opcional): la URL base de Microsoft Graph. Ejemplo: https://graph.microsoft.com/v1.0

      • ID de cliente: el ID de la aplicación (cliente) del registro de la aplicación Microsoft Entra ID.

      • Cliente OAuth público (opcional): selecciona esta opción si tu aplicación Microsoft Entra ID está configurada como un cliente público (sin secreto de cliente).

      • Secreto de cliente: el valor secreto de cliente del registro de la aplicación Microsoft Entra ID.

      • URL del token: el punto final del token de la plataforma de identidad de Microsoft. Ejemplo: https://login.microsoftonline.com/common/oauth2/v2.0/token

      • URL de autorización: el punto final de autorización de la plataforma de identidad de Microsoft. Ejemplo: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

      • URL de redireccionamiento: Pre-filled con la URL de devolución de llamada rápida de Amazon.

      nota

      Para la autenticación específica del inquilino, sustituya common la URL del token y la URL de autorización por su ID de inquilino de Microsoft Entra ID.

7. Elija Siguiente.

8. Se abre una ventana de inicio de sesión de Microsoft. Revisa los permisos solicitados y selecciona Aceptar.

9. En la página de revisión, revise las acciones disponibles para el conector. Elija Siguiente.

10. En la página de publicación, elija quién puede acceder al conector. Puedes habilitar el acceso para todos los miembros de tu organización o buscar equipos o grupos específicos.

11. Elija Publicar.

Acciones disponibles

Tras configurar el conector, estarán disponibles las acciones OneNote expuestas por él. Para ver el conjunto actual de acciones de tu conector, ve a la vista Acciones disponibles del conector en la consola Amazon Quick.

Gestión y solución de problemas

Para editar, compartir o eliminar el conector, consulteAdministrar las integraciones existentes.

Problemas de autenticación

• Sign-in falla (aplicación OAuth predeterminada o aplicación OAuth personalizada): comprueba que tu cuenta de Microsoft 365 esté activa y que puedas iniciar sesión directamente en la web OneNote . En el caso de la aplicación OAuth personalizada, confirma que el URI de redireccionamiento de tu aplicación Microsoft Entra ID coincide con la URL de devolución de llamada rápida de Amazon.

• Permisos insuficientes: compruebe que los permisos de Microsoft Graph configurados en su aplicación Microsoft Entra ID incluyan los OneNote ámbitos necesarios para las operaciones que desee utilizar y que se haya otorgado el consentimiento del administrador, si es necesario.

• Credenciales de cliente no válidas (aplicación OAuth personalizada): compruebe que el ID de cliente y el secreto del cliente coincidan con los valores de su registro de la aplicación Microsoft Entra ID. Confirma que el secreto del cliente no haya caducado.