Saltar al contenido

Guía de conexión OAuth de Microsoft SharePoint para Jitterbit App Builder

Requisitos previos

  • Debe tener una cuenta de Microsoft Azure.

Crear un proveedor de seguridad OAuth

Cree un proveedor de seguridad OAuth en App Builder antes de configurar el registro de la aplicación de Azure.

  1. Vaya a IDE > Proveedores de Seguridad.

  2. Haga clic en + Autenticación de Fuente de Datos. Se abre la página Proveedor. Proporcione los siguientes detalles:

    • En Configuraciones:

      • Nombre: Identifica el proveedor de seguridad y aparece en la URL. Ejemplo: OAuth
      • Tipo: OAuth
      • Habilitado: Seleccione para habilitar este proveedor de seguridad.

    • En Autenticación:

      • Concesión OAuth: Código de Autorización
      • Autenticación de Cliente OAuth: Básica
      • Autenticación de Recurso OAuth: Portador

    • En Iniciar Sesión:

      • Redirigir en Desafío: Verdadero

  3. Haga clic en Guardar.

Crear un registro de aplicación de Microsoft Azure

Registre una aplicación en Microsoft Azure para obtener las credenciales necesarias para completar la configuración del proveedor de seguridad OAuth. Para obtener una visión general del proceso de registro, consulte la guía de Microsoft Guía rápida: Registrar una aplicación.

  1. Vaya al portal de Azure e inicie sesión.

  2. Haga clic en Microsoft Entra ID.

  3. Navegue a Registros de aplicaciones y haga clic en Nuevo registro.

  4. Ingrese un Nombre de Aplicación. Ejemplo: OAuth

  5. En URI de Redirección (opcional):

    • Seleccione Web de la lista de plataformas.
    • Ingrese la URI para el proveedor de seguridad: https://<App-Builder-Instance>/signin-<Security-Provider-Name>

  6. Haga clic en Registrar.

  7. Haga clic en Permisos de API, luego haga clic en Agregar un permiso.

  8. Haga clic en el mosaico de SharePoint y seleccione Permisos Delegados.

  9. Expanda AllSites y habilite los siguientes permisos:

    • AllSites Manage
    • AllSites Read
    • AllSites Write

  10. Expande Project y habilita ProjectRead y ProjectWrite.

  11. Haz clic en Add permissions.

  12. Haz clic en Overview. Toma nota de los siguientes valores; los necesitarás al configurar App Builder:

    • Directory (tenant) ID: Usado en las URL de autorización y de token.
    • Application (client) ID: Usado como el nombre de usuario de las credenciales.

    Para ayuda para localizar estos valores, consulta Cómo encontrar tu ID de inquilino de Microsoft Entra.

  13. En Client credentials, haz clic en Add a certificate or secret.

  14. Haz clic en + New client secret, ingresa una Description, selecciona una fecha de expiración y haz clic en Add.

  15. Copia el Value del secreto del cliente inmediatamente; solo se muestra una vez y se necesita como la contraseña de las credenciales en App Builder.

  16. Regresa a App Builder y abre el proveedor de seguridad creado anteriormente.

  17. En el panel de Endpoints, haz clic en + Endpoints y configura lo siguiente, sustituyendo tu Directory (tenant) ID:

    • Authorization Endpoint: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/authorize/
    • Token Endpoint: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/token/

  18. Haz clic en + Credential y proporciona lo siguiente:

    • Type: Client
    • User Name: Application (client) ID de Azure
    • Password: Valor del secreto del cliente de Azure

  19. Haz clic en Save.

  20. En el panel de Properties, haz clic en + Property e ingresa lo siguiente en el campo Value:

    https://<companyname>.sharepoint.com/.default offline_access

  21. Haz clic en Save.

Create a Microsoft SharePoint datasource

  1. Ve a IDE > Data Servers.

  2. En el panel de Data Servers, haz clic en + Server. Se abre el diálogo de Server. Ingresa la siguiente información:

    • Server Name: Ingresa un nombre. Ejemplo: SharePoint
    • Type: Microsoft SharePoint
    • Url: Ruta completa al directorio de SharePoint de la empresa. Ejemplo: https://<companyname>.sharepoint.com/sites/<directory>

  3. Expande Configuraciones de Seguridad y selecciona el proveedor de seguridad OAuth de la lista Proveedor de Seguridad.

  4. Haz clic en Guardar.

  5. En el panel Servidores de Datos, selecciona el servidor que acabas de crear. Aparece un mosaico en el panel derecho. Haz doble clic en el mosaico o haz clic en el ícono para ver opciones avanzadas.

  6. En Capa de Almacenamiento de Datos, haz clic en Importar y completa el flujo de OAuth cuando se te solicite. Se abre el cuadro de diálogo Importar Esquema.

  7. Haz clic en la pestaña Vistas, localiza el esquema a importar (por ejemplo, Listas), y luego haz clic en Importar Esquema.

  8. Sal del cuadro de diálogo Importar Esquema.

  9. En Capa de Lógica Empresarial, haz clic en Lógica. Se abre la página Reglas por Tabla.

  10. En el panel Tablas, localiza el esquema que importaste. Haz clic en el ícono Resultados para confirmar los datos.