Registar uma aplicação cliente no Microsoft Entra ID

  • Artigo

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

Registar uma nova aplicação

  1. No portal do Azure, selecione Microsoft Entra ID.
  2. Selecione Registos de aplicações. Screen shot of new app registration window.
  3. Selecione Novo registo.
  4. Em Tipos de conta suportados, 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 Registar.

ID do 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 usar mais tarde.

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 clientes públicos" 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 personalizado. 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 6 meses recomendados no campo Expira . Este novo segredo será válido por seis meses. Você também pode escolher diferentes valores, tais como:

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

Nota

É importante que guarde 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 de permissões da API.

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

  2. Selecione Adicionar uma 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 os 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.

Nota

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 os Serviços de Dados de Saúde do Azure 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.

O seu registo de candidatura está agora concluído.

Próximos passos

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 Integridade 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 Integridade do Azure