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 ID do Microsoft Entra 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 estudante, identidades de consumidor (se ele é um locatário do Azure AD B2C) e Registros de aplicativo. 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.
Determinação do tipo de usuários para os quais você criará 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 e de estudante 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:
- Entre no centro de administração do Microsoft Entra como, no mínimo, um Criador de Locatário.
- Verifique o canto superior direito. Se você tiver um locatário, será automaticamente conectado. 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ê pode selecionar o nome da sua conta para abrir um menu no qual você pode alternar entre locatários. Cada locatário tem sua própria ID exclusiva.
Dica
Para localizar a ID do locatário, você pode:
- Posicionar o cursor sobre o nome da sua conta para obter o diretório ou a ID do locatário.
- Selecione Identidade>Visão geral e procure ID do Locatário.
Caso não tenha um locatário associado à sua conta, você verá um GUID abaixo do nome dela. 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 na ID do Microsoft Entra. Se você quiser criar um locatário para testes de aplicativo, consulte criar um ambiente de teste.
Você fornecerá 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.comnão pode ser editado ou excluído. Você pode adicionar um nome de domínio personalizado mais tarde. - País ou 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.