Resposta direta
O segredo precisa sair do fluxo e passar a ser referenciado por um cofre ou por variável gerida fora do arquivo. A troca é em três passos: inventariar onde o valor literal aparece, criar a referência no local de armazenamento e só então revogar o valor antigo. A ordem importa. Revogar antes de a referência estar testada derruba a automação; publicar a referência antes de revogar mantém o valor antigo válido. O responsável pelo fluxo e o responsável pelo cofre precisam ser nomeados, porque a maior parte dos vazamentos nasce de cópia em exportação, histórico de versão e chamado de suporte, não do código em si.
- Objetivo
- Orientar implementação
- Formato indicado
- Workshop executivo
- Atualizado em
O que esta página acrescenta: Trata o segredo como ocorrência literal a ser localizada e revogada em ordem definida, não como recomendação genérica de usar cofre.
Valor literal e referência: o que muda no fluxo
Um segredo dentro de um fluxo é qualquer valor que dá acesso a um sistema e está escrito onde o fluxo é montado: senha de banco, chave de API, token de integração, credencial de e-mail. O problema não é o fluxo usar o valor durante a execução. É o valor ficar legível em arquivo, em tela de configuração ou em exportação.
O que resolve é substituir o valor literal por uma referência. O fluxo pede a credencial pelo nome e recebe o conteúdo no momento de rodar. A referência só vale se o local que guarda o valor tiver controle de acesso próprio, registro de quem leu e dono nomeado. Sem esses três, a referência é apenas outro nome para o mesmo problema.
A ordem da troca e quem responde por ela
A troca segue uma ordem fixa. Primeiro inventariar onde o valor literal aparece, incluindo cópias fora do fluxo. Depois publicar a referência e testar a execução com ela. Só então revogar o valor antigo. Revogar antes do teste derruba a automação; publicar a referência e não revogar deixa o valor antigo utilizável por qualquer cópia.
Cada etapa precisa de responsável. O dono do fluxo responde pela substituição e pelo teste. O dono do cofre responde pelo acesso à referência. A rotação da chave é recorrente, então o fluxo precisa aceitar a troca sem edição. Automação que exige abrir o fluxo para atualizar uma senha volta ao ponto de partida na primeira troca.
O que essa substituição não resolve
Guardar por referência não corrige permissão ampla. Uma credencial bem armazenada e com acesso a todos os dados continua sendo risco; o escopo é decisão separada. A medida também não impede que quem tem acesso ao cofre leia o valor, nem que o fluxo imprima a credencial em log ou em mensagem de erro.
Há situações em que a troca não se aplica do mesmo jeito. Plataforma sem mecanismo de referência obriga a manter um passo inicial que busca o segredo e o mantém apenas em memória, com limite claro de exposição. Token emitido a cada execução dispensa cofre permanente, mas exige controle de quem solicita. Em nenhum desses casos a medida dispensa revisão de acesso e teste de interrupção. Ela reduz a superfície de exposição, e é só isso que faz.
Recurso prático
Onde o segredo em texto costuma ficar
- Corpo do fluxo: campos de conexão, scripts embutidos e parâmetros fixos na definição exportada.
- Cópia do fluxo em ambiente de teste, em homologação e na máquina de quem montou a automação.
- Histórico de versão e backup, onde o valor antigo continua legível depois de removido da versão atual.
- Planilha, documento ou quadro usado como apoio para repassar a configuração a outra pessoa.
- Log de execução e mensagem de erro que imprimem a chamada com o cabeçalho de autenticação completo.
- Chamado de suporte, anexo e captura de tela enviados a fornecedor durante a montagem.
- Credencial única compartilhada por várias automações, sem dono identificado por fluxo.
O erro mais comum é apagar o valor da versão atual e considerar o assunto encerrado. Enquanto a chave não for revogada, ela continua válida em qualquer cópia do histórico, do backup ou do chamado de suporte.
Sobre o que está escrito aqui
Conceitos relacionados: segredo em texto · referência a cofre · rotação de chave · histórico de versão do fluxo · variável de ambiente gerida. Exemplos são ilustrativos. Não há cliente, resultado, preço, prazo ou certificação nesta página. Quando o formato indicado é Workshop executivo, ele descreve uma possibilidade de trabalho — a conversa inicial avalia contexto e aderência.
Para continuar
- Governança e controle de automação — Página central do tema
- Acessos de automação: onde identificar o excesso — acessos excessivos
- Acessos de automação: qual modelo de restriçã… — acessos excessivos
Páginas relacionadas
O mesmo problema em outro objetivo
- Segredo em texto no fluxo: onde está e o que verificar — Diagnosticar
- Segredo em texto no fluxo: onde ele aparece e quem responde — Organizar um processo
- Segredo em texto no fluxo: o que cada alternativa protege — Comparar alternativas
- Segredo em texto no fluxo: como medir a exposição — Explicar medição
- Segredo em texto no fluxo: o que exigir na contratação — Orientar avaliação e contratação
Outras leituras em Governança e controle de automação
- Chave de API sem validade: como separar risco de rotina — Critérios para identificar chaves de API sem data de expiração, separar as que sustentam operação crítica e decidir onde agir primeiro.
- Execução sem limite de repetição: onde fixar o teto — Critérios para definir o teto de repetições de uma execução automatizada, onde o contador fica e quem decide ampliar o limite.
- Segregação de função ausente: o que separar na automação — Distribuição de papéis de desenho, aprovação, operação e auditoria, com matriz de incompatibilidades e cálculo de concentração de função.
- Rotina em horário crítico: como definir quando ela pode rodar — Critérios para decidir em que horário uma rotina pode rodar, o que fazer quando ela colide com fechamento e quem responde pela janela.
- Credencial sem rotação: o que comparar antes de decidir — Compara alternativas de controle quando a credencial não pode ser trocada com frequência: o que cada opção reduz, o que fica em aberto e o critério de decisão.