Compartilhar via

Registrar um Aplicativo cliente no Microsoft Entra ID

  • Artigo

Neste artigo, você aprenderá a 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 na plataforma de identidade da Microsoft.

Registrar um novo aplicativo

  1. No portal do Azure, selecione Microsoft Entra ID.
  2. Selecione Registros do Aplicativo. Captura de tela da janela de registro de novo aplicativo.
  3. Selecione Novo registro.
  4. Para Tipos de conta com suporte, selecione Somente contas neste diretório da organização. Deixe as outras opções como estão. Captura de tela das novas opções de conta de registro.
  5. Selecione Registrar.

ID de aplicativo (ID do cliente)

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

Captura de tela do painel de visão geral da ID do cliente.

Captura de tela da ID do cliente

Configuração de autenticação: confidencial vs. pública

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

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

Captura de tela do aplicativo cliente confidencial.

Se você alterar o valor padrão para "Sim" na opção "Permitir fluxos de cliente público' nas configurações avançadas, o registro do aplicativo se torna um aplicativo cliente público e um certificado ou segredo não é necessário. O valor "Sim" é útil quando você deseja usar o aplicativo cliente em seu aplicativo móvel ou em um aplicativo JavaScript em que não deseja armazenar nenhum segredo.

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

Captura de tela da adição de uma plataforma.

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

Captura de tela da configuração de outros serviços.

Certificados e segredos

Selecione Certificados e Segredos e selecione Novo Segredo do Cliente. Selecione Recomendado 6 meses no campo Expira. Esse novo segredo será válido por seis meses. Você também pode escolher valores diferentes, 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 do segredo, não a ID do segredo.

Captura de tela de certificados e segredos.

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 New-SelfSignedCertificate e, em seguida, exportar o certificado do armazenamento de certificados.

Permissões da 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 do usuário ou as atribuições de função para os Serviços de Dados de Saúde 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.

    Captura de tela da página de permissão da API com o botão Adicionar uma permissão realçado.

  2. Selecione Adicionar permissão.

    Se você estiver usando os Serviços de Dados de Saúde do Azure, adicione uma permissão ao serviço DICOM pesquisando por API do Azure para DICOM em APIs usadas pela minha organização.

    Captura de tela da página de permissões da API de pesquisa com a guia APIs usadas pela minha organização selecionada.

    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 se referindo a um aplicativo de recurso diferente, selecione o Registro do Aplicativo de Recurso DICOM que você criou anteriormente em APIs da minha organização.

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

    Captura de tela dos escopos (permissões) que o aplicativo cliente solicitará em nome de um usuário.

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 Cliente REST. Para obter mais detalhes, visite Acesso usando o Postman e Acesso aos Serviços de Dados de Saúde do Azure usando a extensão 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 registro do seu aplicativo está concluído.

Próximas etapas

Neste artigo, você aprendeu a registrar um aplicativo cliente no Microsoft Entra ID. Além disso, você aprendeu a 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