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

Acessos, o que são e quando criar um à mão

Entenda o que é um Acesso, a diferença entre um acesso do catálogo e um criado à mão, e o que fica em cada aba da página do acesso.

Open in the panel

Um Acesso é a ficha que ensina o 4Keyless a entrar num sistema: em quais endereços ele protege a conexão, por onde a pessoa entra e quais dados de acesso (senha, certificado, código 2FA) o login usa. Ao fim deste artigo você vai saber ler a lista de Acessos, distinguir um acesso que veio pronto do catálogo de um criado à mão, e onde mexer em cada coisa.

Importante

o Acesso é uma configuração, não o sistema em si. O tribunal, o portal ou o serviço continuam onde sempre estiveram. O Acesso só diz ao 4Keyless como chegar até eles em nome de um titular.

Esta tela faz parte da visão completa do painel. Na visão simplificada do gestor, a consulta equivalente fica em Sistemas. Veja Painel do gestor ou painel completo.

O que um Acesso guarda

ParteO que é
DestinosOnde a pessoa entra: um nome e um endereço, por exemplo "1º grau" e o endereço da página de login. Um acesso pode ter vários destinos que usam os mesmos dados de acesso
DomíniosOs endereços que o 4Keyless protege. São o que ele reconhece no caminho para saber que aquela conexão pertence a este acesso. Não é o que a pessoa digita: para isso servem os destinos
CredenciaisOs dados de acesso que o login exige de cada titular
Regras de loginComo o 4Keyless preenche o login. É configurado pelo time técnico ou vem pronto do catálogo

Tipos de acesso

O tipo é escolhido na criação e não muda depois.

Tipo na telaQuando é usado
Web AppSistema usado pelo navegador, como portais de tribunais e de órgãos públicos. É o caso mais comum
REST API e GraphQLServiço usado por programas e agentes de IA, sem tela
MCPServidor de ferramentas para agentes de IA
IdPPágina central de login usada por vários sistemas (o "entrar com" de um provedor de identidade). Ele não é destino de ninguém: só cuida do login dos outros acessos

Acesso do catálogo x acesso criado à mão

A maioria dos acessos nasce do Marketplace: você instala um modelo pronto e o 4Keyless cria o acesso já configurado. Veja Catálogo de sistemas prontos e atualizações.

Um acesso instalado do catálogo aparece com a etiqueta Gerenciado. Nele:

  • domínios, destinos, regras de login e a configuração da aba Segurança seguem a versão do modelo e aparecem só para leitura;
  • o nome, o local da conexão padrão e a chave de ativo continuam sendo seus;
  • quando o catálogo publica uma versão nova, você atualiza com um clique, pelo Marketplace.

Se precisar mudar algo que é só leitura, use Criar uma cópia editável. A cópia assume no lugar do acesso gerenciado, com a mesma política, e o gerenciado fica inativo. A partir daí a cópia é sua e para de receber as atualizações do catálogo.

Crie um acesso à mão só quando o sistema não existe no catálogo e o time técnico vai configurar o login. Se for o caso, você também pode pedir um modelo novo pelo próprio Marketplace.

A lista de Acessos

  1. No menu, em Configuração, abra Acessos.
  2. Use Buscar por nome para achar um acesso pelo nome. A busca ignora acentos.
  3. No filtro ao lado, escolha Todos, Ocultar gerenciados ou Só gerenciados. O painel lembra a sua escolha na próxima visita.
lista de Acessos com a busca por nome, o filtro de gerenciados e um acesso com a etiqueta Gerenciado

Cada linha mostra o nome e o tipo, até três destinos, o Status e três botões: editar, copiar e excluir. O botão de copiar faz coisas diferentes conforme o acesso:

  • Acesso criado à mão: duplica o acesso inteiro e abre a cópia.
  • Acesso gerenciado: pergunta se você quer criar uma cópia editável, como explicado acima.

Excluir também depende do tipo, e o painel avisa antes de confirmar:

  • Acesso gerenciado: desinstala o modelo. O acesso e a política criada na instalação saem juntos.
  • Cópia de um gerenciado: descarta as suas mudanças. O gerenciado continua instalado e inativo; ative-o para voltar a usar a versão do catálogo.
  • Acesso criado à mão: apaga o acesso.

Criar um acesso à mão

  1. Na lista de Acessos, clique em Novo acesso.
  2. Preencha o Nome e escolha o Tipo.
  3. Em Destinos, informe pelo menos um destino com nome e endereço.
  4. Em Domínios, digite um endereço e clique em +. É obrigatório ter pelo menos um.
  5. Clique em Criar. O painel abre a página do acesso recém-criado.
janela Novo acesso com nome, tipo Web App selecionado, um destino e um domínio preenchidos

O acesso ainda não entra em nada sozinho: falta o time técnico configurar o login, cadastrar os dados de acesso dos titulares e criar uma política que libere o acesso para um grupo.

A página do acesso

Clique no nome de um acesso para abrir a página dele. No topo aparecem o tipo, se está ativo e, quando for o caso, a etiqueta Gerenciado. Abaixo ficam as abas:

página de um acesso Web App na aba Configuração, com os cartões Identidade, Domínios monitorados e Destinos
AbaO que tem
ConfiguraçãoNome, Proxy de saída padrão (o local da conexão usado por este acesso; em geral fica em Automático (padrão da conta)), a chave de ativo, Domínios monitorados e Destinos. Os botões Salvar e Excluir ficam no fim
SegurançaProteções do login, como a pausa automática quando o login falha várias vezes seguidas, para o sistema não bloquear a conta do titular. Configurada pelo time técnico. Não aparece em acessos MCP
ScriptsAs regras que preenchem o login. Configuradas pelo time técnico ou pelo suporte
OperaçõesTarefas automáticas que o 4Keyless executa neste sistema, como uma consulta. Cada operação tem o botão Executar. Veja Execuções
FerramentasSó em acessos MCP: as ferramentas que o servidor oferece
SkillsInstruções para agentes de IA operarem este sistema
APISó em REST API e GraphQL: a descrição técnica do serviço
CredenciaisOs dados de acesso que valem para este sistema, agrupados por titular. Gerenciar todas leva para Credenciais

Quem pode fazer isso

Criar, editar, copiar e excluir acessos é para os papéis Operador, Gestor e Admin. Quem tem papel Visualizador ou Financeiro vê a lista e as páginas, sem os botões.

Se algo der errado

  • O botão Criar não habilita. Falta um destino com nome e endereço, ou pelo menos um domínio.
  • Aviso "Outro acesso cobre os mesmos domínios, agora". Dois acessos ativos protegem o mesmo endereço e só um deles é usado. Acontece, por exemplo, quando você reativa um acesso gerenciado que já tinha uma cópia. Desative um dos dois.
  • Os campos de domínio e destino estão travados. O acesso é gerenciado pelo catálogo. Crie uma cópia editável, se realmente precisar mudar.
  • O limite do plano foi atingido. O número de acessos ativos depende do plano. Veja Plano, limites e cobrança.

Related articles