Skip to content
4Keyless Help Center
This help center is currently in Portuguese. The English version is coming soon.

Códigos 2FA guardados no cofre

Guarde a chave do código de verificação em duas etapas de um titular e libere o código para a equipe copiar pelo 4Keyless Desktop.

Open in the panel

Muitos sistemas pedem, além da senha ou do certificado, um código de 6 dígitos que muda a cada poucos segundos: a verificação em duas etapas (2FA). Em vez de depender do celular do titular, você guarda no 4Keyless a chave que gera esses códigos. Ao fim deste artigo você vai saber cadastrar essa chave e liberar o código para a equipe.

O código gerado pode ser usado de duas formas:

FormaComo funciona
No login automáticoQuando o acesso está preparado para isso (em geral, os do catálogo), o 4Keyless gera o código e preenche sozinho durante o login. A pessoa não vê o código
Pelo cofre, no 4Keyless DesktopA pessoa abre a aba Códigos do Desktop e copia o código para colar na página. Só copia: o Desktop não digita o código por ela

As duas formas usam a mesma chave cadastrada. O que muda é a liberação.

Passo 1: cadastrar a chave do código

Você precisa do QR Code ou da chave de texto que o sistema mostra quando alguém ativa a verificação em duas etapas. Peça ao titular, ou ative a verificação junto com ele.

  1. No menu, em Configuração, abra Credenciais.
  2. Clique em Nova credencial.
  3. Em Grupo, escolha o titular.
  4. Dê um Nome, por exemplo totp_tribunal. Se o acesso veio do catálogo, use o nome que ele pede em Credenciais necessárias.
  5. Em Tipo, escolha TOTP (2FA).
  6. Em Escopo, escolha:
    • Sistema específico: o código é indicado para aquele acesso. No Desktop, a linha mostra Use em e o nome do acesso, como orientação: o Desktop não confere a página, então o código pode ser copiado mesmo assim;
    • Global (todos os sistemas): a linha mostra Qualquer site.
  7. Escolha como informar a chave:
    • QR Code: envie uma imagem do QR Code. O painel lê a chave e mostra Secret extraído;
    • Inserir manualmente: cole o Token TOTP (Base32) e confira Dígitos e Período (s). Os padrões, 6 dígitos e 30 segundos, servem para a maioria dos sistemas.
  8. Clique em Criar.
janela Nova credencial com o tipo TOTP (2FA), a opção QR Code e a mensagem de chave extraída

Na visão simplificada do gestor, o mesmo cadastro é feito na janela do titular, em Titulares. Veja Cadastrar um titular.

Importante

depois de salva, a chave não aparece em nenhuma tela. Nem o painel mostra o código: quem vê um código consegue entrar com ele.

Passo 2: liberar o código pelo cofre

Para a equipe copiar o código no Desktop, é preciso uma permissão de acesso direto, separada das políticas comuns.

  1. No menu, em Governança, abra Acesso direto.
  2. Clique em Nova permissao.
  3. Preencha o Nome da política.
  4. Em Grupos de agentes, escolha quem vai usar o código.
  5. Em Titulares, escolha os titulares.
  6. Em O que esta permissão entrega, marque Códigos 2FA. Marque também Certificados se a mesma equipe vai assinar com o certificado desses titulares no 4Keyless Desktop. Aparecem em Titulares os titulares que têm o que a permissão entrega: qualquer código 2FA, quando Códigos 2FA está marcado, ou um certificado de escopo Global, quando Certificados está marcado.
  7. Em Modo, escolha Permitir para o código sair na hora, ou Perguntar para cada uso esperar uma aprovação em Notificações (conforme o plano).
  8. Se quiser limitar prazo, dias ou horários, use a aba Agenda.
  9. Clique em Criar.
janela Nova permissao com um grupo de agentes, um titular e a opção Códigos 2FA marcada em O que esta permissão entrega

Na visão simplificada do gestor, a tela Desktop tem as mesmas opções de O que esta permissão entrega, então o gestor também libera códigos 2FA. Essa é a única configuração necessária: não é preciso criar política de proxy.

Como a equipe usa

A pessoa liberada abre o 4Keyless Desktop e vai à aba Códigos. O código fica escondido até o clique em Copiar; depois aparecem os dígitos, com a contagem do tempo e Código copiado. A pessoa cola o código no campo da página. Veja Copiar um código 2FA pelo Desktop.

Acompanhar o uso

Cada uso fica registrado, sem o código. Em Registro de acessos, filtre Tipo de requisição por Códigos 2FA. As linhas dizem se o código foi copiado ou recusado. As cópias feitas no Desktop aparecem como Código 2FA copiado no Desktop, sem página, porque o Desktop não sabe em qual página o código será colado. No detalhe da linha, Cliente mostra Desktop.

Quem pode fazer isso

Cadastrar códigos e criar permissões é para os papéis Operador, Gestor e Admin.

Se algo der errado

  • QR Code não encontrado na imagem. Envie uma imagem mais nítida, só com o QR Code, ou use Inserir manualmente.
  • QR Code não é um TOTP válido (esperado otpauth://totp/...). A imagem não é de um código de verificação em duas etapas.
  • O código gerado é recusado pelo sistema. Confira se a chave é a atual: se alguém reativou a verificação em duas etapas no sistema, a chave mudou e precisa ser cadastrada de novo. Confira também Dígitos e Período (s).
  • Nova permissao está desabilitado. Falta um grupo de agentes, ou nenhum titular tem um código 2FA ou um certificado de escopo Global. Cadastre o código do titular e tente de novo.
  • A pessoa não vê o código no Desktop. Confira se ela entrou no Desktop com a própria conta (chaves de robôs não veem a aba), se ela está num grupo da permissão, se a permissão está ativa e se Códigos 2FA está marcado para o titular certo.

Related articles