View a markdown version of this page

Integración de SharePoint 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 SharePoint acciones de Microsoft

Utilice el conector de SharePoint acciones de Microsoft para gestionar listas, elementos, archivos 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

Microsoft Graph admite dos tipos de permisos para esta integración. Los permisos delegados permiten que la aplicación actúe en nombre de un usuario que ha iniciado sesión. Los permisos de la aplicación permiten que la aplicación funcione sin que un usuario haya 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 API.

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

  3. Elija Permisos delegados o Permisos de aplicación según su método de autenticación y añada los permisos de la tabla correspondiente que aparece a continuación.

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

Para la autenticación de usuarios (permisos delegados):

Añada lo siguiente como permisos delegados en el 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.

SharePoint 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.
Sites.ReadWrite.All Permite a la aplicación editar o eliminar documentos y elementos de listas en todas las colecciones de sitios 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.

Para la autenticación de servicios (permisos de aplicaciones):

Añada lo siguiente como permisos de aplicación en el registro de su aplicación Entra.

SharePoint integración de acciones: permisos de aplicaciones
Permiso Description (Descripción)
Sites.ReadWrite.All Permite a la aplicación crear, leer, actualizar y eliminar documentos y elementos de listas en todas las colecciones de sitios sin necesidad de que un usuario inicie sesión.
importante

Con la autenticación de servicio, todas las acciones se ejecutan como la cuenta de servicio. Cualquier usuario con acceso a esta integración puede realizar acciones en todas las colecciones de sitios a las que puede acceder la cuenta de servicio. Defina los permisos de las aplicaciones de forma adecuada a los requisitos de seguridad de su organización.

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 SharePoint y pulsa el botón Añadir (más «+»).

  3. Seleccione la pestaña Acciones.

  4. Selecciona Realizar acciones en Microsoft SharePoint.

  5. Complete los detalles de la integración:

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

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

  6. Elija el tipo de conexión y rellene la configuración de conexión:

    1. Para la autenticación de usuario (OAuth), configure los siguientes campos:

      • 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

    2. Para la autenticación del servicio, configure los siguientes campos:

      • 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

      • Alcance: .default

  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 SharePoint disponibles de Microsoft
Categoría Action Description (Descripción)
Listas y elementos Ver artículos Obtenga la colección de artículos de una lista.
Listas y artículos Obtener elemento Devuelve los metadatos de un elemento de una lista.
Listas y elementos Obtenga la lista Devuelve los metadatos de una lista.
Listas y elementos Actualizar elemento Actualice las propiedades de un elemento de la lista.
Listas y elementos Eliminar elemento Elimina un elemento de una lista.
Archivos Cargar archivo Cargue un archivo nuevo o actualice un archivo existente. Admite archivos de hasta 250 MB.
Archivos Busque elementos de Site Drive Busque en la jerarquía de elementos que coincidan con una consulta.
Libros de trabajo 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.
Cuadernos de Excel Escribe Cell Establezca el valor de una sola celda por número de fila y columna.
Libros de trabajo 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 trabajo de Excel Rango claro Borra los valores del rango, el formato, el relleno y el borde.
Libros de trabajo de Excel Eliminar rango Elimine las celdas asociadas al rango.
Libros de Excel Get Used Range 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.