Pular para o conteúdo principal
Versão: 0.4 · atual

Gerenciar usuários e funções

Guia de instruçõesRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Administrador de entidade
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

O que uma pessoa pode fazer no Excubius depende da função que ela tem em cada entidade. Você gerencia o acesso em Settings › Users and roles, para a entidade escolhida no seletor e tudo o que está abaixo dela. Este guia mostra como convidar pessoas, atribuir e remover funções, mapear grupos do diretório e desativar contas.

Antes de começar​

  • Você precisa da função Entity admin no ramo que gerencia. A página mostra apenas as pessoas, as funções e os convites dos ramos que você administra.
  • A entrada com o Microsoft Entra ID ou o Google está configurada. Não há senha para distribuir. Consulte Configurar provedores de entrada.
  • As pessoas aparecem nas listas depois da primeira entrada. Para dar acesso a alguém que nunca entrou, convide essa pessoa.

As funções e os limites para atribuí-las​

Uma função é atribuída em uma entidade e se aplica a essa entidade e a tudo o que está abaixo dela. Em qualquer entidade, a função efetiva de uma pessoa é a mais alta encontrada ali e nas entidades ancestrais, contando as funções da própria pessoa e as dos grupos do diretório dela.

FunçãoPode
Viewer (Visualizador)Ler painéis, alertas e detalhes de recursos; alterar as próprias configurações
Operator (Operador)Tudo o que um visualizador pode, além de confirmar, silenciar, atribuir e resolver alertas, criar itens do Jira e iniciar janelas de manutenção
EditorTudo o que um operador pode, além de alterar verificações e limites e aceitar riscos de segurança
Entity admin (Administrador de entidade)Tudo o que um editor pode, além de gerenciar as entidades, os recursos, as credenciais, os usuários, as funções, os convites, o registro, os canais do Slack e a página de status do ramo
Super admin (Superadministrador)Tudo, em qualquer lugar, incluindo as configurações da instância e do servidor

Ao atribuir uma função:

  • Você só a atribui em entidades em que é Entity admin, na própria entidade ou em uma ancestral.
  • Você nunca atribui uma função acima da sua nessa entidade. Um administrador de entidade pode tornar outra pessoa administrador de entidade, mas não superadministrador.
  • Somente um superadministrador atribui Super admin, e somente na entidade raiz.
  • O último superadministrador não pode ser removido.

Convidar alguém​

  1. Abra Settings › Users and roles e escolha a entidade no seletor, por exemplo Veredas Ltda..
  2. Selecione a guia Invitations e depois Invite someone.
  3. Digite o endereço de E-mail, a Entity e a Role, por exemplo bo.diaz@ciguapa.example, Veredas Ltda. › Production e Operator.
  4. Em Valid for (days), mantenha 7 ou digite um valor de 1 a 90.
  5. Selecione Create invitation. O Invitation link aparece.
  6. Selecione Copy e envie o link para a pessoa pelo canal habitual. O Excubius não envia e-mails.

O link é exibido apenas uma vez: o Excubius armazena uma impressão digital dele, não o próprio link. A pessoa o abre, entra com a conta desse endereço e recebe a função imediatamente. Até lá, o convite aparece em Pending invitations, com a data de vencimento.

Para cancelar um convite que não foi usado, selecione o ícone de lixeira ao lado dele, Revoke the invitation for esse endereço.

Atribuir uma função a uma pessoa​

Use isto para alguém que já entrou pelo menos uma vez.

  1. Em Settings › Users and roles, selecione a guia Role assignments.
  2. Em Give a role, defina To como A person e escolha a pessoa em Person.
  3. Escolha a Entity e a Role. A lista nunca oferece uma função acima da sua nessa entidade.
  4. Selecione Give role.

A função se aplica a partir da próxima solicitação da pessoa.

Atribuir uma função a um grupo do diretório​

Plano

As funções para grupos do diretório fazem parte do plano Enterprise. A opção aparece quando o recurso access.directory_groups está ativado.

Os membros de um grupo do Microsoft Entra ID recebem a função por meio dos grupos no token de entrada deles. O registro de aplicativo deve enviar a declaração de grupos; consulte Registrar o Excubius no Microsoft Entra ID.

  1. No Microsoft Entra admin center, copie o Object ID do grupo.
  2. Em Settings › Users and roles, selecione a guia Role assignments.
  3. Em Give a role, defina To como A directory group.
  4. Em Group, digite entra: seguido do ID de objeto, por exemplo entra:3f2b9c41-7d5e-4a8b-9c6d-1e2f3a4b5c6d. Os nomes de grupo não funcionam.
  5. Escolha a Entity e a Role e selecione Give role.

Os membros recebem a função a partir da próxima entrada. A guia People mostra essa função com via group.

Alteração no diretórioQuando entra em vigor no Excubius
Alguém entra no grupoNa próxima entrada da pessoa
Alguém sai do grupoNa próxima entrada da pessoa. Uma sessão dura até 14 dias sem nova entrada, por isso, para cortar o acesso imediatamente, desative também a pessoa
A pessoa pertence a mais de 200 gruposO Entra ID não envia nenhum grupo, e a pessoa não recebe nenhuma função por meio de grupos. Use Groups assigned to the application ou atribua a função diretamente à pessoa

Alterar ou remover uma função​

Uma pessoa ou um grupo tem uma atribuição de função por entidade.

  1. Em Settings › Users and roles, selecione a guia Role assignments.
  2. Encontre a atribuição e selecione o ícone de remoção ao lado dela, Remove the role of essa pessoa ou esse grupo.
  3. Para alterar a função, atribua a nova como descrito acima.

A remoção de uma função entra em vigor na próxima solicitação da pessoa. Uma função que veio de um registro por domínio permitido não é devolvida na próxima entrada.

Desativar uma pessoa​

A desativação encerra o acesso de uma pessoa na próxima solicitação dela, sem excluir a conta nem o histórico.

  1. Em Settings › Users and roles, selecione a guia People e encontre a pessoa. Pesquise por nome ou endereço se a lista for longa.
  2. Na coluna Active, desative a pessoa.

Para restaurar o acesso, ative Active novamente. Ninguém pode desativar a si mesmo. Você só pode desativar pessoas cujas funções estejam todas dentro dos ramos que você administra e não sejam superiores à sua.

Uma pessoa desativada que tenta entrar vê que a conta está desativada e que um administrador precisa ativá-la novamente.