Saltar al contenido principal

Ligar o login da organização

O login da organização se liga por serviço e vale a partir da próxima publicação. Nada é registrado no IAM: a aplicação usa o client de login que o Zero já usa na organização — o mesmo do console. Não há client para pedir a ninguém.

Antes de começar​

  • O serviço é uma aplicação web com o endereço público do Zero.
  • A organização tem o IAM ligado ao Zero (é o login que você usa no console).
  • Você pode alterar o serviço no projeto.

Passo a passo​

  1. Ligue a capacidade — pela CLI, pela API ou pelo console, no cartão Recursos do serviço:

    zero services enable organization-iam web

    A resposta mostra o estado, o IAM da organização, o client de login, o endereço de retorno e o próximo passo.

  2. Acompanhe até Entra na próxima publicação:

    zero services capabilities web

    A lista traz as capacidades do serviço, se cada uma está ligada, o estado e o motivo.

  3. Publique:

    zero deploy web

  4. Confira de ponta a ponta:

    zero services doctor organization-iam web

    Cada verificação sai com ✓ ou ✗ e, quando falta algo, quem resolve: a aplicação, o administrador da organização ou a plataforma. Enquanto falta algo, o comando sai com o código 3.

  5. No código, leia quem entrou com nn.auth.user(req) — veja Quem entrou, no código.

Para desligar, zero services disable organization-iam web: o login sai na próxima publicação e, depois dela, as sessões da aplicação são encerradas. Nada é apagado no IAM — a aplicação não tem client lá. Com o QueryMesh ligado, o desligamento é recusado (409 SERVICE_CAPABILITY_REQUIRES_IDENTITY): desligue o QueryMesh primeiro.

Os estados​

EstadoO que significaO que fazer
Desligadaa capacidade não está ligada—
Entra na próxima publicaçãotudo prontozero deploy
Prontaa publicação no ar exige o login—
Falta configurar na organizaçãofalta um passo da plataforma no IAM da organização; o motivo aparece junto, e o login volta sozinho quando o client de login estiver prontopeça ao administrador da plataforma; não é preciso ligar de novo
Sai na próxima publicaçãodesligada, com a publicação no ar ainda exigindo o loginzero deploy

Erros comuns​

SintomaCausaO que fazer
ORGANIZATION_IAM_NOT_CONFIGURED ao ligar (409)a organização não tem IAM ligado ao Zeropeça ao administrador da plataforma para adotar o IAM da organização; depois ligue de novo
SERVICE_CAPABILITY_UNSUPPORTED ao ligar (422)o serviço não é aplicação web, ou não tem endereço públicoligue no serviço web que recebe as pessoas
a aplicação não vê ninguém depois do logina publicação no ar é anterior à capacidadezero deploy e confira com zero services doctor
ORGANIZATION_IAM_NOT_ENABLED no log da aplicaçãoa aplicação rodou sem a capacidade, ou fora do Zeroligue a capacidade e publique
SERVICE_CAPABILITY_REQUIRES_IDENTITY ao desligar (409)o QueryMesh está ligado no serviço, e ele consulta em nome de quem entroudesligue o QueryMesh primeiro: zero services disable querymesh web

Próximos passos​