Saltar al contenido

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

Requisitos previos

  • Debes tener una cuenta de Microsoft Azure.

Crear un proveedor de seguridad OAuth

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

  1. Ve a IDE > Security Providers.

  2. Haz clic en + Security Provider. Se abre la página Provider. Proporciona los siguientes detalles:

    • En Settings:

      • Name: Identifica el proveedor de seguridad y aparece en la URL. Ejemplo: OAuth
      • Type: OAuth
      • Enabled: Selecciona para habilitar este proveedor de seguridad.

    • En Authentication:

      • OAuth Grant: Authorization Code
      • OAuth Client Authentication: Basic
      • OAuth Resource Authentication: Bearer

    • En Sign In:

      • Redirect on Challenge: True

  3. Haz clic en Save.

Crear un registro de aplicación en Microsoft Azure

Registra una aplicación en Microsoft Azure para obtener las credenciales necesarias para completar la configuración del proveedor de seguridad OAuth. Para obtener una descripción general del proceso de registro, consulta la guía Inicio rápido: Registrar una aplicación de Microsoft.

  1. Ve al portal de Azure e inicia sesión.

  2. Haz clic en Microsoft Entra ID.

  3. Ve a App registrations y haz clic en New registration.

  4. Introduce un App Name. Ejemplo: OAuth

  5. En Redirect URI (optional):

    • Selecciona Web de la lista de plataformas.
    • Introduce la URI del proveedor de seguridad: https://<App-Builder-Instance>/signin-<Security-Provider-Name>

  6. Haz clic en Register.

  7. Haz clic en API permissions y luego en Add a permission.

  8. Haz clic en el mosaico SharePoint y selecciona Delegated permissions.

  9. Expande AllSites y habilita 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. Ten en cuenta los siguientes valores — los necesitarás al configurar App Builder:

    • Directory (tenant) ID: Se utiliza en las URLs de autorización y punto final de token.
    • Application (client) ID: Se utiliza como nombre de usuario de la credencial.

    Para obtener 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, introduce una Description, selecciona una fecha de vencimiento y haz clic en Add.

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

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

  17. En el panel 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 de cliente de Azure

  19. Haz clic en Save.

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

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

  21. Haz clic en Save.

Crear una fuente de datos de Microsoft SharePoint

  1. Ve a IDE > Data Servers.

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

    • Server Name: Introduce 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 Security Settings y selecciona el proveedor de seguridad OAuth de la lista Security Provider.

  4. Haz clic en Save.

  5. En el panel Data Servers, 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 icono para ver las opciones avanzadas.

  6. En Data Storage Layer, haz clic en Import y completa el flujo de OAuth cuando se te solicite. Se abre el diálogo Import Schema.

  7. Haz clic en la pestaña Views, localiza el esquema a importar (por ejemplo, Lists) y luego haz clic en Import Schema.

  8. Cierra el diálogo Import Schema.

  9. En Business Logic Layer, haz clic en Logic. Se abre la página Rules by Table.

  10. En el panel Tables, localiza el esquema que importaste. Haz clic en el icono Results para confirmar los datos.