Administrar sua organização

Este guia é para as pessoas que administram uma organização no Team: o proprietário, que a criou, e os administradores. Quem pode fazer o quê está resumido na tabela de funções; esta página mostra como fazer.

Proprietários e administradores precisam de autenticação de dois fatores para ações sensíveis. Configure antes de começar: Configurações → Segurança.

Convidar pessoas

1. Abra Equipe → Membros e selecione Convidar.
2. Informe o endereço de e-mail e escolha uma função: membro, administrador ou auditor. Somente o proprietário pode convidar administradores e auditores.
3. O painel mostra um link de convite. A zn não envia o e-mail: compartilhe o link com a pessoa você mesmo. Ele funciona uma única vez, para aquele endereço de e-mail, por 7 dias, e a pessoa o aceita entrando com esse endereço.

Regras:

• Membros e administradores ocupam um assento, e um convite pendente também. Se todos os assentos estiverem em uso, adicione assentos primeiro (veja abaixo).
• Auditores não ocupam assento. Eles podem ler o log de auditoria e baixar exportações, e nada além disso, e não instalam o zn-gate.
• Uma pessoa pode pertencer a uma única organização por vez.
• Você pode revogar um convite pendente na mesma lista; isso libera o assento imediatamente.

Alterar funções e remover pessoas

• Somente o proprietário altera funções: membro para administrador, administrador de volta para membro, ou qualquer função para auditor e vice-versa. Tornar alguém administrador ou auditor exige autenticação de dois fatores.
• Administradores podem remover membros. Somente o proprietário pode remover administradores e auditores.
• A função do proprietário não pode ser alterada, e o proprietário não pode ser removido.
• Remover alguém encerra imediatamente o acesso dessa pessoa à organização, e os tokens de agente que ela criou deixam de funcionar. As máquinas dela continuam conectadas: revogue também as instalações (veja abaixo) se essas máquinas devem deixar de receber a política e de enviar dados.

Conectar máquinas

As máquinas entram com um token de adesão. Um proprietário ou administrador cria um com Novo token de adesão em Instalações conectadas. Um token de adesão é válido por 7 dias e para um número definido de máquinas (por padrão, o número de assentos). Em seguida, os desenvolvedores executam o comando de adesão em sua máquina: veja Aderir uma máquina.

Instalações conectadas lista cada máquina com seu agente, seus registros de auditoria e a data em que foi vista pela última vez, para que você identifique máquinas desatualizadas ou sem sinal. Revogar impede que uma instalação receba a política e envie dados.

Política

Proprietários e administradores publicam a política em Equipe → Políticas. Cada máquina baixa a política, verifica a assinatura e a aplica; uma política publicada continua válida por 7 dias sem um novo download, então uma máquina que fique offline por um tempo continua aplicando-a. Se duas pessoas publicarem ao mesmo tempo, a segunda é solicitada a recarregar. Detalhes em Política da organização e Comportamento offline.

Cada regra está num de três estados: Não bloqueado (padrão), Avisar (o uso segue, o desenvolvedor recebe um aviso e o registro de auditoria o guarda) ou Bloquear (o uso é interrompido). Escolher Bloquear pede confirmação; Avisar não. As restrições aplicam-se a todos os agentes nas máquinas dos membros: uma regra escrita para um agente vale também para os outros, e as regras de aviso e de bloqueio ignoram a lista de agentes. A lista de agentes só decide a quais agentes é oferecido um novo host. Os usos avisados e bloqueados aparecem em Equipe → Registro de auditoria como Avisado e Bloqueado.

Assentos, pool compartilhado e faturamento

Estes itens são exclusivos do proprietário, e o portal de faturamento solicita ao proprietário a autenticação de dois fatores.

• Assentos: abra Equipe → Cobrança e assentos e selecione Gerenciar assentos no Polar. Você pode ter de 2 a 50 assentos. As alterações de assentos são confirmadas pelo Polar e aparecem no painel após serem aplicadas. Você não pode ficar abaixo dos assentos em uso (membros, administradores e convites pendentes); remova pessoas ou revogue convites primeiro.
• Limite de pagamento por uso (plano mensal): depois que o pool compartilhado de chamadas é usado, as chamadas são interrompidas, a menos que o proprietário defina um limite mensal acima de US$ 0 em Equipe → Cobrança e assentos → Limite de pagamento por uso (até US$ 10.000; alterá-lo exige autenticação de dois fatores). As chamadas além do pool custam US$ 0,10 por 1.000, até esse limite. Reduzir o limite tem efeito imediato. Durante o período de teste, o pool é um limite rígido.
  • O pool e o limite contam meses do calendário (UTC). O uso é informado ao provedor de faturamento a cada hora e cobrado na próxima fatura da assinatura, cujo período começa no dia em que você assinou; assim, uma fatura pode incluir uso de dois meses do calendário.
  • O uso informado após o término de uma assinatura, ou após você mudar do plano mensal para o anual, não é adicionado a uma fatura posterior.
• Créditos da organização (plano anual): as chamadas além do pool usam créditos pré-pagos da organização a US$ 0,10 por 1.000 chamadas (US$ 1 = 10.000 chamadas). Em Equipe → Cobrança e assentos → Créditos da organização, informe um valor a partir de US$ 10 (em dólares inteiros) e conclua o pagamento na página de checkout; os impostos, se houver, são acrescentados ali. Os créditos são adicionados quando o pagamento é confirmado, nunca expiram, e o saldo aparece no mesmo cartão. A compra exige autenticação de dois fatores. Quando os créditos acabam, as chamadas param no pool até o próximo mês ou até você comprar mais.
• Portal de faturamento: o mesmo botão abre o portal de faturamento, onde você também atualiza o cartão, baixa faturas ou cancela a assinatura. O cancelamento tem efeito ao final do período.

Configurações da organização

Em Equipe → Configurações, o proprietário escolhe como as alterações propostas por um agente são aprovadas: confirmadas no agente, sempre aprovadas no painel ou não permitidas (os agentes só podem ler). Alterar essa configuração exige autenticação de dois fatores e um login feito nos últimos 10 minutos. Veja Gerencie sua equipe a partir do seu agente.

Auditoria e evidências

Proprietários, administradores e auditores podem ler Equipe → Registro de auditoria e baixar exportações em Equipe → Evidências: o trilho de auditoria do zn-gate e as verificações na nuvem dos membros, em CSV, JSON ou logs OpenTelemetry. Cada exportação é registrada no log de atividades da organização com sua contagem de linhas e checksum. Veja Exportar o trilho de auditoria e o guia de evidências SOC 2.