Registrar um Aplicativo cliente no Microsoft Entra ID

  • Artigo

Neste artigo, você aprenderá a registrar um aplicativo cliente na ID do Microsoft Entra para acessar os Serviços de Dados de Saúde do Azure. Você pode encontrar mais informações sobre Registrar um aplicativo com a plataforma de identidade da Microsoft.

Registrar um novo aplicativo

  1. No portal do Azure, selecione ID do Microsoft Entra.
  2. Selecione Registros do Aplicativo. Screen shot of new app registration window.
  3. Selecione Novo registro.
  4. Para Tipos de conta com suporte, selecione Contas somente neste diretório da organização. Deixe as outras opções como estão. Screenshot of new registration account options.
  5. Selecione Registrar.

ID de aplicativo (ID do cliente)

Depois de registrar um novo aplicativo, você pode encontrar o ID do aplicativo (cliente) e o ID do diretório (locatário) na opção do menu de visão geral. Anote os valores para uso posterior.

Screenshot of client ID overview panel.

Screenshot of client ID

Configuração de autenticação: confidencial versus pública

Selecione Autenticação para revisar as configurações. O valor padrão para Permitir fluxos de clientes públicos é "Não".

Se você mantiver esse valor padrão, o registro do aplicativo será um aplicativo cliente confidencial e um certificado ou segredo será necessário.

Screenshot of confidential client application.

Se você alterar o valor padrão para "Sim" para a opção "Permitir fluxos de cliente público" na configuração avançada, o registro do aplicativo será um aplicativo cliente público e um certificado ou segredo não será necessário. O valor "Sim" é útil quando você deseja usar o aplicativo cliente em seu aplicativo móvel ou um aplicativo JavaScript onde você não deseja armazenar segredos.

Para ferramentas que exigem uma URL de redirecionamento, selecione Adicionar uma plataforma para configurar a plataforma .

Screenshot of add a platform.

Para Postman, selecione Aplicativos móveis e de desktop. Digite "https://www.getpostman.com/oauth2/callback" na seção URIs de redirecionamento personalizados. Selecione o botão Configurar para salvar a configuração.

Screenshot of configure other services.

Certificados e segredos

Selecione Certificados & Segredos e selecione Novo Segredo do Cliente. Selecione Recomendado 6 meses no campo Expira. Este novo segredo terá validade de seis meses. Você também pode escolher diferentes valores, como:

  • 03 meses
  • 12 meses
  • 24 meses
  • Data de início e data de término personalizadas.

Observação

É importante que você salve o valor secreto, não o ID secreto.

Screenshot of certificates and secrets.

Opcionalmente, você pode carregar um certificado (chave pública) e usar a ID do Certificado, um valor GUID associado ao certificado. Para fins de teste, você pode criar um certificado autoassinado usando ferramentas como a linha de comando do PowerShell e, em seguida, New-SelfSignedCertificateexportar o certificado do repositório de certificados.

Permissões de API

As etapas a seguir são necessárias para o serviço DICOM, mas opcionais para o serviço FHIR. Além disso, as permissões de acesso de usuário ou atribuições de função para os Serviços de Dados de Integridade do Azure são gerenciadas por meio do RBAC. Para obter mais detalhes, visite Configurar o RBAC do Azure para os Serviços de Dados de Saúde do Azure.

  1. Selecione a folha Permissões da API.

    Screenshot of API permission page with Add a permission button highlighted.

  2. Selecione Adicionar permissão.

    Se você estiver usando os Serviços de Dados de Saúde do Azure, adicionará uma permissão ao serviço DICOM pesquisando a API do Azure para DICOM em APIs que minha organização usa.

    Screenshot of Search API permissions page with the APIs my organization uses tab selected.

    O resultado da pesquisa da API do Azure para DICOM só retornará se você já tiver implantado o serviço DICOM no espaço de trabalho.

    Se você estiver fazendo referência a um aplicativo de recurso diferente, selecione seu Registro de Aplicativo de Recursos de API DICOM que você criou anteriormente em APIs minha organização.

  3. Selecione escopos (permissões) que o aplicativo cliente confidencial solicitará em nome de um usuário. Selecione user_impersonation e, em seguida, selecione Adicionar permissões.

    Screenshot of scopes (permissions) that the client application will ask for on behalf of a user.

Observação

Use grant_type de client_credentials ao tentar obter um token de acesso para o serviço FHIR usando ferramentas como Postman ou REST Client. Para obter mais detalhes, visite Access using Postman e Acessando o Azure Health Data Services usando a extensão de cliente REST no Visual Studio Code.

Use grant_type de client_credentials ou authentication_code ao tentar obter um token de acesso para o serviço DICOM. Para obter mais detalhes, visite Usando DICOM com cURL.

Seu registro de inscrição já está concluído.

Próximas etapas

Neste artigo, você aprendeu como registrar um aplicativo cliente na ID do Microsoft Entra. Além disso, você aprendeu como adicionar um segredo e permissões de API aos Serviços de Dados de Saúde do Azure. Para obter mais informações sobre os Serviços de Dados de Saúde do Azure, consulte

Visão geral dos Serviços de Dados de Saúde do Azure