Documentação

Senhas do projeto

Guarde as chaves que o site precisa, como a do formulário, do mapa ou do e-mail, e os agentes usam sem você colar a senha na conversa.

Onde ficam#

As senhas ficam numa seção das Configurações. Há dois caminhos:

As senhas ficam guardadas neste computador, cifradas pelo sistema (o Windows, o Chaveiro do Mac ou o GNOME Keyring/KWallet no Linux), na pasta de dados do app. No Linux, sem um desses chaveiros o app não salva a senha: veja Problemas comuns. Elas não vão para nenhum servidor do TowerCTL. Se a cifragem do sistema não estiver disponível, o app não salva a senha; ele nunca grava o valor em texto aberto.

Adicionar uma senha#

  1. Em Nome, escreva o nome da variável, por exemplo GOOGLE_MAPS_KEY. O app passa para maiúsculas e troca espaços e hífens por _.
  2. Em Valor, cole a chave. Mostrar e Ocultar alternam a visualização.
  3. Em Vale para, escolha só este projeto ou todos os projetos.
  4. Clique em Salvar senha.

Se um projeto tiver uma senha própria com o mesmo nome de uma senha de todos os projetos, vale a do projeto. Apagar, na lista, remove a senha depois de confirmar.

Importar de um arquivo .env#

Clique em Importar de um .env e escolha o arquivo. As linhas NOME=valor viram senhas deste projeto. Se alguma linha for ignorada, o app diz quantas e por quê, mostrando só os nomes, nunca os valores.

Regras dos nomes#

Como os agentes recebem#

Cada painel do projeto, de agente ou de terminal, recebe as senhas como variáveis de ambiente quando começa. O agente não recebe os valores na conversa: recebe só a lista de nomes e a instrução de ler o valor do ambiente na hora de usar, por exemplo com process.env.GOOGLE_MAPS_KEY.

Os agentes também são instruídos a nunca exibir, registrar ou enviar ao git o valor, e a nunca escrevê-lo no código, em arquivos, na conversa ou na memória.

Painéis já abertos só recebem uma senha nova ou alterada depois de reiniciados com o ↻.

Cuidados#

A instrução é uma regra, não uma tranca

Qualquer programa rodando num painel do projeto consegue ler as variáveis de ambiente. Os agentes são orientados a não mostrar os valores, mas um comando que imprima o ambiente mostraria a senha no terminal.