Usar OAuth con Uso compartido de recursos de origen cruzado para conectar una aplicación de una sola página

  • Artículo

Puede crear aplicaciones de una sola página (SPA) que usen JavaScript para trabajar con datos de Microsoft Dataverse mediante la API web. Para proporcionar esto, Uso compartido de recursos de origen cruzado (CORS) se habilita de forma que las SPA puedan superar las restricciones de explorador que evitan normalmente las solicitudes que cruzan límites de dominio.

SPA y Directiva de mismo origen

Las SPA dependen de un uso amplio de JavaScript del lado del cliente para crear una sola página dinámica que no necesite cargar nuevas páginas. En su lugar usan las técnicas de programación de Ajax para recuperar datos y otros recursos del servidor. Las SPA funcionan bien cuando los datos y recursos existen en el mismo dominio que la aplicación. Pero para proteger el acceso a los datos y recursos de otros dominios, todos los exploradores modernos aplican una directiva de Mismo origen para evitar que los sitios usen datos y recursos de sitios en un dominio distinto. CORS proporciona una forma de tener acceso a los recursos en otro dominio. Crear un SPA para tener acceso a datos de Dataverse sin CORS no es una opción viable.

Utilizar CORS con Dataverse

El protocolo CORS proporciona una descripción detallada de cómo implementar y usar CORS. Explica todo sobre los diferentes encabezados y las solicitudes de preparación que necesita aplicar para que CORS funcione. La buena noticia es que no necesita convertirse en un experto en CORS para usarla con aplicaciones Dataverse. La parte del lado del servidor se ha realizado para usted y lo único que necesita es saber cómo consumirlo. No necesita comprender el funcionamiento interno de CORS para usarla con aplicaciones Dataverse. En su lugar puede usar la Biblioteca de autenticación de Microsoft para JavaScript (MSAL.js) 2.0 para aplicaciones de una página basadas en explorador, que se ocupará de gran parte de la complejidad de CORS por usted. Dado que los usuarios de Dataverse se autentican con Microsoft Entra ID, MSAL.js es la forma compatible para autenticar usuarios de SPA.

Preparación para usar MSAL.js con una SPA

Para configurar su SPA para que funcione con msal.js deberá:

  1. Registrar su aplicación con el inquilino de Microsoft Entra ID.
  2. Establezca variables de configuración en su SPA con información de ese registro.
    Deberá incluir lo siguiente:
    • La dirección URL de su organización de Dataverse.
    • El identificador del inquilino de Microsoft Entra ID que usa la organización para autenticarse.
    • El identificador del cliente que obtiene al registrar la aplicación.
    • La dirección URL donde se implementará o depurará la SPA durante el desarrollo.

El conjunto de pasos necesarios se describe en Inicio rápido: Registrar y configurar la aplicación SPA para Dataverse con msal.js

Consulte también

Usar OAuth para conectarse a servicios web de Dataverse
Inicio rápido: registrar y configurar una aplicación SPA para Dataverse con msal.js
Inicio rápido: registrar una aplicación en la plataforma de identidad de Microsoft

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).