Configurar la colección Postman para Servicio de crédito medioambiental (versión preliminar)

  • Artículo

Cumbre Técnica de mayo 2024 de Microsoft Cloud for Sustainability

Importante

Algunas o todas estas funciones están disponibles como parte de una versión preliminar. El contenido y la funcionalidad están sujetos a cambios. Puede acceder al entorno de prueba del Servicio de crédito medioambiental (versión preliminar) para una prueba de 30 días. Para usar el Servicio de crédito medioambiental (Vista previa) en un entorno de producción, complete el Formulario de registro del Servicio de crédito medioambiental (Vista previa).

Puede copiar la colección Postman y cambiar los parámetros según sea necesario.

Servicio de crédito medioambiental incorporado (versión preliminar) como una aplicación propia en su inquilino de Microsoft Entra ID

Para autenticarse con el Servicio de crédito medioambiental (versión preliminar), los usuarios de su directorio deben presentar un token de autenticación, en particular, un token web JSON, con algunas notificaciones requeridas. Estos reclamos ayudarán al Servicio de crédito medioambiental (vista previa) a identificar el acceso proporcionado a un usuario.

Nota

Debido a que el Servicio de crédito medioambiental (versión preliminar) es una aplicación propia de Microsoft, no puede eliminarla de su arrendatario después de implementarla.

  1. Verifique que tenga acceso para implementar el Servicio de crédito medioambiental (versión preliminar) en su arrendatario.

    Vaya a Azure Portal > Microsoft Entra ID > Configuración de usuario y verifique la propiedad Los usuarios pueden registrar aplicaciones. Si está configurado en No, comuníquese con uno de los administradores de inquilinos de Microsoft Entra ID para configurar el Servicio de crédito medioambiental(versión preliminar) en su inquilino.

  2. También puede necesitar este permiso para registrar cualquier cliente o aplicación web en su arrendatario, según el escenario aplicable para su equipo.

  3. Siga los pasos en Conectarse con el Microsoft Entra ID PowerShell para el módulo Graph. Estos pasos configurarán el módulo Microsoft Entra ID PowerShell y se conectarán con su Microsoft Entra ID inquilino mediante una identidad que tenga los permisos especificados en el primer paso.

  4. Para implementar el Servicio de crédito medioambiental (versión preliminar) en su arrendatario, utilice este comando de PowerShell y especifique su módulo Microsoft Entra ID PowerShell:

       New-AzureADServicePrincipal -AppId "b9b0ac19-f710-429d-b58e-dc3f73a330a9" -DisplayName "Environmental Credit Service"

  5. Después de implementar el Servicio de crédito medioambiental (versión preliminar) en su arrendatario, vaya a Azure Portal > Microsoft Entra ID > Aplicaciones empresariales > Elija aplicaciones de Microsoft para el tipo de aplicación (y Aplicar). Busque Servicio de crédito medioambiental (versión preliminar) para visualizar la aplicación empresarial implementada.

Configurar la colección de Postman

Para configurar la colección Postman para Servicio de crédito medioambiental (versión preliminar), siga este paso único para cada inquilino de Microsoft Entra ID que utilice que interactuaría con Servicio de crédito medioambiental (versión preliminar):

  1. Registre una aplicación de cliente pública en el inquilino navegando a Azure Portal > Microsoft Entra ID > Registros de aplicaciones > Nuevo registro. Introduzca los siguientes valores:

    • Nombre: Proporcione un nombre válido para el usuario.
    • Tipos de cuenta admitidos: elija la opción Cuentas en este directorio organizacional solamente, porque la aplicación no autenticará cuentas de usuario fuera de este inquilino.
    • En este caso, no se espera ningún URI de redirección .

  2. Seleccione Autenticación. En Configuración avanzada, esrablezca Tratar la aplicación como cliente público. en Sí. Guarda los cambios. Las aplicaciones de cliente público permiten a los usuarios autenticarse mediante flujos de trabajo móviles o de escritorio y recopilar contraseñas de texto sin formato mediante un flujo de trabajo de credenciales de contraseña del propietario del recurso.

  3. Seleccione la sección Manifiesto. En el editor JSON, busque la propiedad accessTokenAcceptedVersion y establezca su valor en 2. Seleccione Guardar para aplicar los cambios.

  4. En este escenario, el cliente público intenta usar el token del usuario que inició sesión para acceder a las API del Servicio de crédito medioambiental (versión preliminar). La aplicación debe solicitar el permiso delegado Application.ReadWrite tal como lo expone la aplicación empresarial Servicio de crédito medioambiental (versión preliminar) registrada en la sección de requisitos previos:

    1. Vaya a la aplicación registrada, seleccione Permisos de API y luego seleccione Agregar un permiso.
    2. Seleccione la pestaña API que usa mi organización y busque la aplicación empresarial Servicio de crédito medioambiental (versión preliminar) que se implementó en el arrendatario durante los pasos de requisitos previos.
    3. Seleccione Permisos delegados. Los permisos delegados requieren el consentimiento del usuario por única vez para indicar que la aplicación puede usar su token para acceder al recurso requerido. Debido a que este escenario implica un flujo de trabajo no interactivo, el inquilino Administrador debe otorgar el consentimiento por adelantado para los permisos delegados necesarios.

Después de configurar los permisos delegados, puede solicitar token de acceso de forma no interactiva utilizando los detalles proporcionados en Solicitud de autorización.

El valor de la propiedad de alcance en la solicitud token de acceso debe ser igual al ámbito Application.ReadWrite: https://ecs.mcfs.microsoft.com/Application.ReadWrite. La llamada para el token punto de conexión se puede iniciar antes de acceder a cualquier API del Servicio de crédito medioambiental (Vista previa).

Una vez que la autenticación esté funcionando, actualice las siguientes variables de colección de Postman:

  1. Establezca las variables de ID de cliente en la propiedad de ID de aplicación de las aplicaciones de cliente públicas registradas en los respectivos inquilinos de Microsoft Entra ID, como se describe en los pasos anteriores.

  2. Actualice el nombre de usuario (correo electrónico) y la contraseña según sea necesario para las variables disponibles en la colección Postman.

Consultar también

Descripción general del Servicio de crédito medioambiental (versión preliminar)
Glosario del Servicio de crédito medioambiental (versión preliminar)
Descripción general de la referencia de la API para el Servicio de crédito medioambiental (versión preliminar)