Início Rápido: configurar um locatário

Para criar aplicativos que usam a plataforma de identidade da Microsoft para gerenciamento de identidade e acesso, você precisa acessar um locatário do Microsoft Entra. É no locatário do Microsoft Entra que você registra e gerencia seus aplicativos, configura o acesso deles aos dados no Microsoft 365 e em outras APIs da Web e habilita recursos como o Acesso Condicional.

Um locatário representa uma organização. É uma instância dedicada do Microsoft Entra ID, que uma organização ou desenvolvedor de aplicativos recebe no início de um relacionamento com a Microsoft. Esse relacionamento pode começar com a inscrição no Azure, no Microsoft Intune ou no Microsoft 365, por exemplo.

Cada locatário do Microsoft Entra é distinto e separado de outros locatários do Microsoft Entra. Ele tem uma representação própria de identidades corporativas e de estudantes, identidades de consumidor (se ele for um locatário do Azure AD B2C) e Registros de aplicativos. Um registro de aplicativo dentro do locatário só pode permitir autenticações de contas no seu locatário ou em todos os locatários.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.

Determinar o tipo de usuários para os quais você criará os aplicativos

Você pode criar um locatário com duas configurações diferentes: força de trabalho ou cliente. O ambiente depende exclusivamente dos tipos de usuários que serão autenticados pelo aplicativo.

Este início rápido aborda dois cenários para o tipo de aplicativo que você deseja criar:

  • Aplicativos e serviços voltados à força de trabalho para contas corporativas e de estudante (Microsoft Entra ID) ou contas Microsoft (como Outlook.com e Live.com)
  • Aplicativos e serviços voltados ao cliente para contas locais e de redes sociais

Contas corporativas, de estudante ou contas pessoais da Microsoft

Para criar um ambiente para contas corporativas, de estudantes ou contas pessoais da Microsoft (MSA), você pode usar um locatário existente do Microsoft Entra ou criar um novo.

Usar um locatário existente do Microsoft Entra

Dica

As etapas neste artigo podem variar ligeiramente com base no portal do qual você começa.

Muitos desenvolvedores já têm locatários por meio de serviços ou assinaturas vinculados a locatários do Microsoft Entra, como assinaturas do Microsoft 365 ou do Azure.

Para verificar o locatário:

  1. Entre no centro de administração do Microsoft Entra como, no mínimo, um Criador de Locatário.
  2. Verifique o canto superior direito. Se você tiver um locatário, você entrará automaticamente. Você verá o nome do locatário diretamente abaixo do nome da sua conta.
    • Posicione o cursor sobre o nome da conta para ver seu nome, o endereço de email, o diretório ou a ID do locatário (um GUID) e um domínio.
    • Se sua conta estiver associada a vários locatários, você poderá selecionar o nome da conta para abrir um menu, no qual poderá alternar entre locatários. Cada locatário tem sua própria ID exclusiva.

Dica

Para localizar a ID do locatário, você poderá:

  • Posicionar o cursor sobre o nome da conta para obter o diretório ou a ID do locatário.
  • Selecionar Identidade>Visão geral e procurar a ID do Locatário.

Caso não tenha um locatário associado à sua conta, você verá um GUID abaixo do nome da conta. Você não poderá fazer ações como registrar aplicativos, até criar um locatário do Microsoft Entra.

Criar um novo locatário do Microsoft Entra

Se você ainda não tiver um locatário do Microsoft Entra ou se quiser criar um novo para desenvolvimento, consulte Criar um novo locatário no Microsoft Entra ID. Se você quiser criar um locatário para testes de aplicativo, consulte criar um ambiente de teste.

Forneça as seguintes informações para criar seu locatário:

  • Tipo de locatário - Escolha entre um locatário do Microsoft Entra e um locatário do Azure AD B2C
  • Nome da organização
  • Domínio inicial: o domínio inicial <domainname>.onmicrosoft.com não pode ser editado ou excluído. Você poderá adicionar um nome de domínio personalizado mais tarde.
  • País/região

Observação

Ao nomear seu locatário, use caracteres alfanuméricos. Caracteres especiais não são permitidos. O nome não pode ultrapassar 256 caracteres.

Contas locais e de redes sociais

Para começar a compilar os aplicativos externos que se conectam em contas locais e de redes sociais, crie um locatário com configurações externas. Para começar, consulte Criar um locatário com configurações externas.

Próximas etapas