Registro de una aplicación cliente en Azure Active Directory

En este artículo, aprenderá a registrar una aplicación cliente en Azure Active Directory (Azure AD) para acceder a Azure Health Data Services. Puede encontrar más información sobre el registro de una aplicación con el Plataforma de identidad de Microsoft.

Registro de una nueva aplicación

  1. En Azure Portal, seleccione Azure Active Directory.
  2. Seleccione App registrations (Registros de aplicaciones). Captura de pantalla de la nueva ventana de registro de aplicaciones.
  3. Seleccione Nuevo registro.
  4. En Tipos de cuenta admitidos, seleccione Solo cuentas en este directorio de la organización. Deje las demás opciones tal como están. Captura de pantalla de las nuevas opciones de la cuenta de registro.
  5. Seleccione Registrar.

Identificador de aplicación (id. del cliente)

Después de registrar una nueva aplicación, puede encontrar el identificador de la aplicación (cliente) y el identificador de directorio (inquilino) en la opción de menú de información general. Anote los valores para usarlos más adelante.

Captura de pantalla del panel de información general del identificador de cliente.

Captura de pantalla del identificador de cliente

Configuración de autenticación: confidencial frente a pública

Seleccione Autenticación para revisar la configuración. El valor predeterminado de Permitir flujos de cliente públicos es "No".

Si mantiene este valor predeterminado, el registro de la aplicación es una aplicación cliente confidencial y se requiere un certificado o secreto.

Captura de pantalla de la aplicación cliente confidencial.

Si cambia el valor predeterminado a "Sí" para la opción "Permitir flujos de cliente públicos" en la configuración avanzada, el registro de la aplicación es una aplicación cliente pública y no es necesario un certificado o secreto. El valor "Sí" es útil cuando desea usar la aplicación cliente en la aplicación móvil o una aplicación javaScript donde no desea almacenar ningún secreto.

Para las herramientas que requieren una dirección URL de redireccionamiento, seleccione Agregar una plataforma para configurar la plataforma.

Captura de pantalla de la adición de una plataforma.

En Postman, seleccione Aplicaciones móviles y de escritorio. Escriba "https://www.getpostman.com/oauth2/callback" en la sección URI de redirección personalizados . Seleccione el botón Configurar para guardar la configuración.

Captura de pantalla de la configuración de otros servicios.

Certificados y secretos

Seleccione Secretos de certificados & y nuevo secreto de cliente. Seleccione Recommended 6 months (Recomendado 6 meses) en el campo Expira. Este nuevo secreto será válido durante seis meses. También puede elegir valores diferentes, como:

  • 03 meses
  • 12 meses
  • 24 meses
  • Fecha de inicio y fecha de finalización personalizadas.

Nota

Es importante guardar el valor del secreto, no el identificador del secreto.

Captura de pantalla de certificados y secretos.

Opcionalmente, puede cargar un certificado (clave pública) y usar el identificador de certificado, un valor GUID asociado al certificado. Con fines de prueba, puede crear un certificado autofirmado mediante herramientas como la línea de comandos de PowerShell y, a continuación, New-SelfSignedCertificateexportar el certificado desde el almacén de certificados.

Permisos de API

Los pasos siguientes son necesarios para el servicio DICOM, pero opcional para el servicio FHIR. Además, los permisos de acceso de usuario o las asignaciones de roles para Azure Health Data Services se administran mediante RBAC. Para más información, visite Configuración de RBAC de Azure para Azure Health Data Services.

  1. Seleccione la hoja Permisos de API.

    Captura de pantalla de la página de permisos de API con el botón Agregar un permiso resaltado.

  2. Seleccione Agregar un permiso.

    Si usa Azure Health Data Services, agregará un permiso al servicio DICOM mediante la búsqueda de la API de Azure para DICOM en API que usa mi organización .

    Captura de pantalla de la página de permisos de Search API con las API que mi organización usa la pestaña seleccionada.

    La búsqueda de "Azure API for DICOM" solo devolverá resultados si ya ha implementado el servicio DICOM en el área de trabajo.

    Si hace referencia a otra aplicación de recursos, seleccione el registro de la aplicación de recursos de la API de DICOM que ha creado antes en API usadas en mi organización.

  3. Seleccione los ámbitos (permisos) que la aplicación cliente confidencial solicitará en nombre del usuario. Seleccione user_impersonation y después Agregar permisos.

    Captura de pantalla de los ámbitos (permisos) que la aplicación cliente solicitará en nombre de un usuario.

Nota

Use grant_type de client_credentials al intentar obtener un token de acceso para el servicio FHIR mediante herramientas como Postman o cliente REST. Para más información, visite Acceso mediante Postman y Acceso a Azure Health Data Services mediante la extensión de cliente REST en Visual Studio Code.

Use grant_type de client_credentials o authentication_code al intentar obtener un token de acceso para el servicio DICOM. Para obtener más información, visite Uso de DICOM con cURL.

El registro de la aplicación ya está completo.

Pasos siguientes

En este artículo, ha aprendido a registrar una aplicación cliente en Azure AD. Además, ha aprendido a agregar un secreto y permisos de API a Azure Health Data Services. Para más información sobre Azure Health Data Services, consulte