Iniciar sessão de utilizadores na aplicação macOS de exemplo utilizando autenticação nativa

Aplica-se a: Inquilinos externos (saiba mais)

Este guia mostra como executar um aplicativo de exemplo do macOS que demonstra cenários de inscrição e entrada usando o Microsoft Entra External ID.

Neste artigo, você aprenderá a:

• Habilite fluxos de autenticação nativa e de cliente público.
• Atualize um exemplo de aplicativo nativo do macOS para usar seus próprios detalhes de locatário externo.
• Execute e teste o aplicativo macOS nativo de exemplo.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se ainda não tiver uma, crie uma conta gratuitamente

• Essa conta do Azure deve ter permissões para gerenciar aplicativos. Qualquer uma das seguintes funções do Microsoft Entra inclui as permissões necessárias:

  • Administrador de aplicativos
  • Programador de Aplicações

• Um locatário externo Se não tiver, crie um novo locatário externo no centro de administração do Microsoft Entra.

• Se ainda não o fez, Registe uma aplicação no centro de administração do Microsoft Entra. Certifique-se de:

  • Registre a ID do aplicativo (cliente) e a ID do diretório (locatário) para uso posterior.
  • Conceda consentimento de administrador para o aplicativo.

• Se ainda não o fez, crie um fluxo de utilizadores no centro de administração do Microsoft Entra

• Associar o registro do aplicativo ao fluxo de usuários

• Xcode

Habilitar fluxos de autenticação nativa e de cliente público

Para especificar que este aplicativo é um cliente público e pode usar autenticação nativa, habilite o cliente público e os fluxos de autenticação nativa:

1. Na página de registros de aplicativos, selecione o registro do aplicativo para o qual você deseja habilitar fluxos de autenticação nativa e de cliente público.
2. Em Gerir, selecione Autenticação.
3. Em Configurações avançadas, permita fluxos de clientes públicos:
   1. Para Habilite os seguintes fluxos móveis e de desktop selecione Sim.
   2. Para Ativar autenticação nativa, selecione Sim.
4. Selecione o botão Salvar.

Clonar aplicativo macOS de exemplo

1. Abra o Terminal e navegue até um diretório onde deseja manter o código.

2. Clone o aplicativo macOS do GitHub executando o seguinte comando:

   git clone https://github.com/Azure-Samples/ms-identity-ciam-native-auth-macos-sample.git
   

3. Navegue até o diretório onde o repositório foi clonado:

   cd ms-identity-ciam-native-auth-macos-sample
   

Configurar o aplicativo macOS de exemplo

1. No Xcode, abra o projeto NativeAuthSampleAppMacOS.xcodeproj.

2. Abra o arquivo NativeAuthSampleAppMacOS/Configuration.swift.

3. Encontre o espaço reservado:

   • Enter_the_Application_Id_Here e substitua-o pelo ID da aplicação (cliente) da aplicação que registaste anteriormente.
   • Enter_the_Tenant_Subdomain_Here e substitua-o pelo subdomínio Directory (locatário). Por exemplo, se o domínio principal do inquilino for contoso.onmicrosoft.com, use contoso. Se não tiver o subdomínio do locatário, descubra como ler os detalhes do locatário.

Executar e testar o aplicativo macOS de exemplo

Para criar e executar seu código, selecione Executar no menu Product no Xcode. Após uma compilação bem-sucedida, o Xcode iniciará o aplicativo de exemplo no simulador.

Este guia testa o uso de e-mail e senha. Insira um endereço de e-mail e uma palavra-passe válidos, selecione Registare inicie a tela de envio de código:

Depois de inserir seu endereço de e-mail na tela anterior, o aplicativo enviará um código de verificação para ele. Depois de enviar o código recebido, o aplicativo leva você de volta para a tela anterior e automaticamente faz login.

Ative o início de sessão com um alias ou nome de utilizador

Pode permitir que os utilizadores que iniciam sessão com um endereço de e-mail e palavra-passe também iniciem sessão com um nome de utilizador e palavra-passe. O nome de utilizador, também chamado de identificador alternativo de entrada, pode ser um ID de cliente, número de conta ou outro identificador que escolha usar como nome de utilizador.

Pode atribuir nomes de utilizador manualmente à conta de utilizador através do centro de administração do Microsoft Entra ou automatizá-lo na sua aplicação através da API Microsoft Graph.

Use os passos no artigo Iniciar sessão com um alias ou nome de utilizador para permitir que os seus utilizadores iniciem sessão usando um nome de utilizador na aplicação:

1. Ativar o nome de utilizador no início de sessão.
2. Crie utilizadores com nome de utilizador no centro de administração ou atualize utilizadores existentes adicionando um nome de utilizador. Alternativamente, pode também automatizar a criação e atualização de utilizadores na sua aplicação usando a Microsoft Graph API.

Próximos passos

• Tutorial: Prepare seu aplicativo iOS/macOS para autenticação nativa.