View a markdown version of this page

Integración de OneDrive acciones de Microsoft - Amazon Quick
Antes de empezarConfigurar Microsoft EntraConfigurar la integración en Amazon QuickAcciones disponiblesAdministre y solucione problemas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Integración de OneDrive acciones de Microsoft

Utilice el conector de OneDrive acciones de Microsoft para gestionar OneDrive archivos, carpetas y libros de Excel directamente en Amazon Quick mediante lenguaje natural.

La configuración de esta integración consta de dos pasos. En primer lugar, se registra una aplicación en Microsoft Entra y se configuran sus permisos. A continuación, crea la integración en Amazon Quick y la conecta a la aplicación Entra. Para obtener información sobre los métodos de autenticación que admite Amazon Quick, consulteMétodos de autenticación.

Antes de empezar

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

Configurar Microsoft Entra

Antes de configurar Amazon Quick, cree un registro de aplicación en Microsoft Entra. Complete todos los pasos siguientes en Entra antes de pasar a la consola Amazon Quick.

Para obtener más información sobre los registros de aplicaciones, consulte Registrar una aplicación con la plataforma de identidad de Microsoft en la documentación de Microsoft.

Registre la aplicación

  1. Abre el centro de administración de Microsoft Entra.

  2. En el panel de navegación de la izquierda, selecciona Entra ID y, a continuación, selecciona Registros de aplicaciones.

  3. Selecciona Nuevo registro.

  4. En Nombre, introduzca un nombre descriptivo para la integración.

  5. Para los tipos de cuentas compatibles, selecciona Cuentas únicamente en este directorio organizativo.

  6. Para el URI de redireccionamiento, selecciona Web e ingresahttps://{region}.quicksight.aws.amazon.com/sn/oauthcallback. {region}Sustitúyala por la AWS región en la que está desplegada la instancia de Amazon Quick.

  7. Elija Registro.

  8. En la página de información general, copie el ID de la aplicación (cliente) y el ID del directorio (inquilino). Necesitas estos valores para la configuración de Amazon Quick.

Cree un secreto de cliente

Amazon Quick necesita un secreto de cliente para autenticarse con Microsoft Entra. Este secreto actúa como contraseña para el registro de la aplicación.

  1. En el registro de la aplicación, selecciona Certificados y secretos.

  2. Selecciona Nuevo secreto de cliente.

  3. Introduce una descripción y elige un período de caducidad.

  4. Elija Añadir.

  5. Copia el valor inmediatamente. Este valor solo se muestra una vez.

importante

Copie el valor secreto, no el identificador secreto. El valor es la cadena más larga que se utiliza para la autenticación.

Configure los permisos de la API

Esta integración utiliza permisos delegados, que permiten a la aplicación actuar en nombre de un usuario que ha iniciado sesión. Para obtener más información, consulte Descripción general de los permisos de Microsoft Graph en la documentación de Microsoft.

  1. En el registro de la aplicación, selecciona los permisos de la API.

  2. Selecciona Añadir un permiso y, a continuación, Microsoft Graph.

  3. Elige Permisos delegados y añade los permisos de la siguiente tabla.

  4. Elija Otorgar el consentimiento del administrador a [nombre de su inquilino] para aprobar los permisos.

Agrega lo siguiente como permisos delegados en tu registro de la aplicación Entra. Para obtener la referencia completa de permisos, consulte la referencia de permisos de Microsoft Graph en la documentación de Microsoft.

OneDrive integración de acciones: permisos delegados
Permiso Description (Descripción)
Files.ReadWrite Permite que la aplicación lea, cree, actualice y elimine los archivos del usuario que ha iniciado sesión.
User.Read.All Permite que la aplicación lea el conjunto completo de propiedades del perfil de todos los usuarios de la organización en nombre del usuario que ha iniciado sesión.
offline_access Permite que la aplicación actualice los tokens de acceso sin necesidad de que el usuario vuelva a iniciar sesión. Esto reduce la frecuencia con la que los usuarios deben volver a autenticarse.

Registre sus credenciales

Antes de salir del centro de administración de Microsoft Entra, confirme que tiene los siguientes valores. Los necesitas para la configuración de Amazon Quick.

Credenciales requeridas de Microsoft Entra
Valor ¿Dónde encontrarlo
ID de aplicación (cliente) Página de descripción general del registro de la aplicación
ID de directorio (inquilino) Página de información general sobre el registro de aplicaciones
Valor del secreto de cliente Página de certificados y secretos

Configurar la integración en Amazon Quick

Tras completar la configuración de Entra, cree la integración en Amazon Quick.

  1. En la consola Amazon Quick, selecciona Integraciones.

  2. Selecciona Microsoft OneDrive y pulsa el botón Añadir (más «+»).

  3. Seleccione la pestaña Acciones.

  4. Selecciona Realizar acciones en Microsoft OneDrive.

  5. Complete los detalles de la integración:

    • Nombre: nombre descriptivo de OneDrive la integración.

    • Descripción (opcional): propósito de la integración.

  6. Complete la configuración de conexión:

    • URL base: https://graph.microsoft.com/v1.0

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

    • Secreto de cliente: valor secreto de cliente que aparece al registrarse en la aplicación Entra.

    • URL del token: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

    • URL de autenticación: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize

    • URL de redireccionamiento — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  7. Seleccione Crear y continuar.

  8. Elige los usuarios con los que compartir la integración.

  9. Elija Siguiente.

Acciones disponibles

Tras configurar la integración, estarán disponibles las siguientes acciones.

Acciones OneDrive disponibles de Microsoft
Categoría Action Description (Descripción)
Drive y artículos ¡Obtén Drive Recupera las propiedades y relaciones de un disco.
Unidad y objetos Artículo de la lista Obtenga todos los artículos que contiene la unidad.
Unidad y objetos Obtener elemento Consigue un objeto contenido en la unidad.
Unidad y objetos Crear carpeta Crea una nueva carpeta en la unidad del usuario.
Unidad y artículos Actualizar elemento Actualiza los metadatos de un archivo o una carpeta.
Unidad y elementos Eliminar elemento Eliminar un archivo o carpeta. Mueve el artículo a la papelera de reciclaje.
Conduce y objetos Enumere las carpetas secundarias Devuelve una colección de elementos de los elementos secundarios de una carpeta.
Unidad de disco y objetos Copiar artículo Cree una copia de un archivo o carpeta en otra ubicación.
Unidad y artículos Incorporación de permisos Envía una invitación para compartir un archivo o una carpeta.
Unidad y artículos Cargar archivo Cargue un archivo nuevo o actualice un archivo existente. Admite archivos de hasta 250 MB.
Libros de Excel Listar hojas Recupera una lista de objetos de la hoja de cálculo.
Libros de Excel Añadir hoja Agregue una nueva hoja de trabajo al libro de trabajo.
Libros de Excel Lea la hoja Recupera las propiedades de un objeto de hoja de trabajo.
Libros de Excel Hoja de actualización Actualice las propiedades de un objeto de hoja de trabajo.
Libros de Excel Eliminar hoja Elimine la hoja de trabajo del libro de trabajo.
Libros de Excel Lea Cell Obtenga el valor de una sola celda por número de fila y columna.
Libros de Excel Escribe Cell Establezca el valor de una sola celda por número de fila y columna.
Libros de Excel Rango de lectura Obtenga los valores de un rango.
Libros de Excel Rango de escritura Actualiza los valores de un rango.
Libros de Excel Rango claro Borra los valores del rango, el formato, el relleno y el borde.
Libros de Excel Eliminar rango Elimine las celdas asociadas al rango.
Libros de Excel Obtenga un rango usado Obtenga el rango más pequeño que abarque las celdas con un valor o un formato.

Administre y solucione problemas

Para editar, compartir o eliminar tu integración, consultaAdministrar las integraciones existentes.

Problemas de autenticación

  • Registro incorrecto de la aplicación: compruebe que el registro de la aplicación en Microsoft Entra incluye los permisos de API necesarios y que se ha otorgado el consentimiento del administrador.

  • Secreto de cliente caducado: comprueba si el secreto de cliente ha caducado en Certificados y secretos y genera uno nuevo si es necesario.

  • URI de redireccionamiento incorrecto: compruebe que el URI de redireccionamiento en Microsoft Entra coincidahttps://{region}.quicksight.aws.amazon.com/sn/oauthcallback.

Mensajes de error comunes

  • Access denied. You do not have permission to perform this action— El usuario autenticado no tiene los permisos necesarios. Póngase en contacto con su administrador para verificar y conceder los permisos adecuados.

  • AADSTS50020: User account from identity provider does not exist in tenant— La cuenta de usuario no está configurada en el inquilino Microsoft Entra correcto. Comprueba que existe una cuenta de usuario en el inquilino que coincida con el ID del directorio (inquilino) que aparece en el registro de la aplicación.