Saltar al contenido

Guía de Conexión de Microsoft SharePoint OAuth

Requisitos Previos

  • Debes tener la versión Vinyl 3.3 o posterior
  • Debes tener una cuenta de Microsoft Azure

Crear un Proveedor de Seguridad OAuth

Aquí creará un proveedor de seguridad OAuth en Vinyl.

  1. Navegue a la sección Proveedores de seguridad del IDE y cree un nuevo proveedor de seguridad usando el botón + Autenticación de origen de datos
  2. Proporcione los siguientes detalles:

    • Nombre - Identifica el proveedor de seguridad y aparece en la URL. Ejemplo: OAuth
    • Tipo - OAuth
    • Habilitado - marque para habilitar este proveedor de seguridad
    • OAuth Grant - Código de autorización
    • Autenticación de cliente OAuth - Básico
    • Autenticación de recursos OAuth - Portador
    • Redireccionamiento en desafío - Verdadero
  3. Haga clic en Guardar

Crear Registro de Aplicación de Microsoft Azure

A continuación, registrará una aplicación en Microsoft Azure y configurará aún más el proveedor de seguridad OAuth en Vinyl.

  1. Navegue hasta portal.azure.com e inicie sesión.
  2. Haga clic en ID de Microsoft Entra

    entraid.png

  3. Vaya a Registros de aplicaciones

  4. Haga clic en Nuevo registro
  5. Asigne un Nombre de la aplicación. Ejemplo: OAuth
  6. En la sección Redireccionamiento URI (opcional):

    • Seleccione Web de la lista Seleccionar una plataforma
    • Ingrese el URI del proveedor de seguridad en la instancia de Vinyl. El formato de la URL de redireccionamiento debe ser https://<Vinyl-Instance>/signin-<Security-Provider-Name>.

    redirecturi.png

  7. Haga clic en Registrarse

  8. Haga clic en Permisos de API
  9. Haga clic en Agregar un permiso
  10. Haga clic en el ficha SharePoint
  11. Seleccione la opción Permisos delegados
  12. Expanda Todos los sitios
  13. Marque para habilitar los siguientes permisos:

    • Administrar todos los sitios
    • Todos los sitios leídos
    • Escribir en todos los sitios
  14. Exand Proyecto bajo permisos

  15. Marque para habilitar ProjectRead y ProjectWrite
  16. Haga clic en el botón Agregar permisos
  17. Haga clic en Descripción general
  18. Haga clic en la pestaña Extremos

    • La pantalla Extremos contiene los valores necesarios durante la configuración de Extremos del proveedor de seguridad en Vinyl.

    endpointconfig_copy.png

  19. Haga clic en Agregar un certificado o secreto en Credenciales del cliente.

  20. Haga clic en + Nuevo secreto de cliente
  21. Ingrese una Descripción
  22. Seleccione una fecha de vencimiento
  23. Haga clic en el botón Agregar

    • El secreto del cliente Valor será necesario para la configuración de credenciales en Vinyl.
  24. Vuelva a los detalles del proveedor en Vinyl.

  25. Haga clic en + Extremos en el panel Enpoints y configure los siguientes extremos:

    • Extremo de autorización: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/authorize/
    • Extremo del token: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/token/
  26. Haga clic en + Credencial:

    • Tipo - Cliente
    • Nombre de usuario - ID de aplicación (cliente) de Microsoft Azure
    • Contraseña - Valor secreto del cliente de Microsoft Azure
  27. Haga clic en Guardar y salga de la ventana emergente.

  28. Haga clic en + Propiedad en el panel Propiedades.
  29. Ingrese la URL en el campo Valor. El valor de la URL debe ser https://<companyname>.sharepoint.com/.default offline_access
  30. Haga clic en Guardar
  31. Cierra la ventana emergente

Vinylconfig.png

Crear una Fuente de Datos de Microsoft SharePoint

Por último, creará una fuente de datos de Microsoft SharePoint en Vinyl e importará los datos de SharePoint.

  1. Navegue hasta IDE
  2. Haga clic en Servidores de datos
  3. Haga clic en el botón + Servidor
  4. Introduzca un nombre en el campo Nombre del servidor. Ejemplo: SharePoint
  5. Seleccione Microsoft SharePoint de la lista Tipo.
  6. En el campo Url, ingrese la ruta completa al directorio de SharePoint de la empresa al que está accediendo. El formato de la URL debe ser https://<companyname>.sharepoint.com/sites/<directory>

    servidor de datos.png

  7. Expanda Configuración de seguridad

  8. Seleccione el proveedor de seguridad OAuth configurado en la lista Proveedor de seguridad
  9. Haga clic en Guardar
  10. Cierra la ventana emergente
  11. Haga clic en Detalles en el panel derecho.
  12. Haga clic en el botón Importar
  13. Siga el flujo de OAuth
  14. Haga clic en la pestaña Vistas
  15. Haga clic en el botón Importar esquema en el esquema que desea importar. Ejemplo: listas
  16. Navegue hasta IDE
  17. Haga clic en Servidores de datos
  18. Haga clic en Detalles en el panel derecho.
  19. Haga clic en el botón Lógica
  20. Haga clic en el icono Resultados del contenido importado para confirmar los datos.