Compartir a través de

Obtener un token de Microsoft Entra y usarlo para enviar eventos a un centro de eventos

  • Artículo

Consulte Autenticación desde una aplicación para obtener información general sobre cómo obtener un token de Microsoft Entra.

En este artículo se proporciona un ejemplo de cómo obtener un token de Microsoft Entra que puede usar para enviar y recibir eventos de un espacio de nombres de Event Hubs. Usa la herramienta Postman con fines de prueba.

Requisitos previos

Registro de la aplicación con Microsoft Entra ID

El primer paso es registrar la aplicación con el inquilino de Microsoft Entra y anotar los valores del identificador de inquilino, el identificador de cliente y el secreto de cliente. Estos valores se usan más recientes al probar la API REST mediante la herramienta Postman.

  1. Inicie sesión en Azure Portal.

  2. En la barra de búsqueda, busque Microsoft Entra ID y selecciónelo en la lista desplegable.

  3. En la página Microsoft Entra ID, seleccione el vínculo Registros de aplicaciones en el menú de la izquierda y, a continuación, seleccione + Nuevo registro en la barra de herramientas.

    Captura de pantalla que muestra la página Registros de aplicaciones con el vínculo Nuevo registro seleccionado.

  4. Escriba un nombre para la aplicación y seleccione Registrar.

    Captura de pantalla que muestra la página Registrar aplicación.

  5. En la página principal de la aplicación, anote los valores de Id. de aplicación (cliente) e Id. de directorio (inquilino). Estos valores se usan para obtener un token de Microsoft Entra ID.

    Captura de pantalla que muestra la página principal con el identificador de cliente y el identificador de inquilino resaltados.

  6. Ahora, seleccione Certificados & secretos en el menú izquierdo y seleccione + Nuevo secreto de cliente.

    Captura de pantalla que muestra la página Certificados & secretos.

  7. Escriba una descripción, seleccione cuándo expirará el secreto y seleccione Agregar.

    Captura de pantalla que muestra la descripción, seleccione hora de expiración y el botón Agregar.

  8. Seleccione el botón Copiar situado junto al valor secreto de la lista Secretos de cliente para copiar el valor en el Portapapeles. Péguelo en algún lugar. Lo usará más adelante para obtener un token de Microsoft Entra ID.

    Captura de pantalla que muestra el botón secreto de cliente.

Adición de una aplicación al rol Remitente de datos de Event Hubs

En este ejemplo, solo se envía mensajería al centro de eventos, por lo que se agrega la aplicación al rol remitente de datos Azure Event Hubs.

  1. En la página Espacio de nombres de Event Hubs, seleccione Control de acceso en el menú de la izquierda y, a continuación, seleccione Agregar en el icono Agregar una asignación de roles.

    Captura de pantalla que muestra la página Access Control.

  2. En la página Agregar asignación de roles, seleccione Azure Event Hubs Remitente de datos para Rol y seleccione la aplicación (en este ejemplo, ServiceBusRestClientApp) para la entidad de servicio.

    Captura de pantalla que muestra la adición de la aplicación al rol Azure Event Hubs Remitente de datos.

  3. Seleccione Guardar en la página Agregar asignación de roles para guardar la asignación de roles.

Uso de Postman para obtener el token de Microsoft Entra

  1. Inicie Postman.

  2. Para el método , seleccione GET.

  3. En el URI, escriba https://login.microsoftonline.com/<TENANT ID>/oauth2/token. Reemplace por <TENANT ID> el valor del identificador de inquilino que copió anteriormente.

  4. En la pestaña Encabezados , agregue la clave Content-Type y application/x-www-form-urlencoded para el valor .

    Captura de pantalla que muestra el encabezado content-type.

  5. Cambie a la pestaña Cuerpo y agregue las siguientes claves y valores.

    1. Seleccione form-data.

    2. Agregue grant_type clave y escriba client_credentials para el valor.

    3. Agregue client_id la clave y pegue el valor del identificador de cliente que anotó anteriormente.

    4. Agregue client_secret la clave y pegue el valor del secreto de cliente que anotó anteriormente.

    5. Agregue resource clave y escriba https://eventhubs.azure.net para el valor.

      Captura de pantalla que muestra el cuerpo de la solicitud.

  6. Seleccione Enviar para enviar la solicitud para obtener el token. Verá el token en el resultado. Guarde el token (excepto las comillas dobles). La usará más adelante.

    Captura de pantalla que muestra el token de acceso de Microsoft Entra.

Envío de un evento al centro de eventos

  1. En Postman, abra una nueva pestaña.

  2. Seleccione POST para el método .

  3. Escriba el URI en el formato siguiente: https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Reemplace por <EVENT HUBS NAMESPACE NAME> el nombre del espacio de nombres de Event Hubs. Reemplace <QUEUE NAME> por el nombre de la cola.

  4. En la pestaña Encabezados , agregue los dos encabezados siguientes.

    1. Agregue Authorization la clave y el valor para él en el siguiente formato: Bearer <TOKEN from Microsoft Entra ID>. Al copiar o pegar el token, no copie las comillas dobles envolventes.

    2. Agregue Content-Type la clave y application/atom+xml;type=entry;charset=utf-8 como valor para él.

      Captura de pantalla de la pestaña Encabezados resaltada en el centro de eventos.

  5. En la pestaña Cuerpo , seleccione raw para el tipo de datos y escriba This is a message o cualquier mensaje para el cuerpo.

    Captura de pantalla del evento de prueba en la vista Cuerpo sin formato en el centro de eventos.

  6. Seleccione Enviar para enviar el mensaje a la cola. Verá el estado como Created con el código 201 como se muestra en la imagen siguiente.

    Captura de pantalla que muestra el estado correcto.

  7. En la página del espacio de nombres de la Azure Portal, puede ver que los mensajes se publican en la cola.

    Captura de pantalla que muestra los mensajes que se publican en la cola.

Consulte también

Vea los artículos siguientes: