Variáveis de ambiente fornecem um jeito seguro de gerenciar valores de configuração e secrets através de seus workflows, incluindo chaves de API e outros dados sensíveis que seus workflows precisam acessar. Elas mantêm secrets fora de suas definições de workflow enquanto fazem-os disponíveis durante execução.
Tipos de Variáveis
Variáveis de ambiente no ZippyVendas funcionam em dois níveis:
- Variáveis de Ambiente Pessoais: Privadas para sua conta, apenas você pode vê-las e usá-las
- Variáveis de Ambiente de Workspace: Compartilhadas através do workspace inteiro, disponíveis para todos os membros do time
Variáveis de ambiente de workspace têm precedência sobre as pessoais quando há um conflito de nome.
Configurando Variáveis de Ambiente
Navegue para Configurações para configurar suas variáveis de ambiente:
Das configurações do seu workspace, você pode criar e gerenciar ambas variáveis de ambiente pessoais e em nível de workspace. Variáveis pessoais são privadas para sua conta, enquanto variáveis de workspace são compartilhadas com todos os membros do time.
Tornando Variáveis com Escopo de Workspace
Use o toggle de escopo de workspace para disponibilizar variáveis para todo seu time:
Quando você habilita escopo de workspace, a variável se torna disponível a todos os membros do workspace e pode ser usada em qualquer workflow dentro desse workspace.
Visão de Variáveis de Workspace
Uma vez que você tem variáveis com escopo de workspace, elas aparecem em sua lista de variáveis de ambiente:
Usando Variáveis em Workflows
Para referenciar variáveis de ambiente em seus workflows, use a notação {{}}. Quando você digita {{ em qualquer campo de entrada, um dropdown aparecerá mostrando ambas suas variáveis de ambiente pessoais e em nível de workspace. Simplesmente selecione a variável que você quer usar.
Como Variáveis São Resolvidas
Variáveis de workspace sempre têm precedência sobre variáveis pessoais, independentemente de quem roda o workflow.
Quando nenhuma variável de workspace existe para uma chave, variáveis pessoais são usadas:
- Execuções manuais (UI): Suas variáveis pessoais
- Execuções automatizadas (API, webhook, schedule, deployed chat): Variáveis pessoais do dono do workflow
Variáveis pessoais são melhores para testes. Use variáveis de workspace para workflows de produção.
Melhores Práticas de Segurança
Para Dados Sensíveis
- Armazene chaves de API, tokens e senhas como variáveis de ambiente em vez de hardcodá-los
- Use variáveis de workspace para recursos compartilhados que múltiplos membros do time precisam
- Mantenha credenciais pessoais em variáveis pessoais
Nomeação de Variável
- Use nomes descritivos:
DATABASE_URLem vez deDB - Siga convenções de nomeação consistentes através de seu time
- Considere prefixos para evitar conflitos:
PROD_API_KEY,DEV_API_KEY
Controle de Acesso
- Variáveis de ambiente de workspace respeitam permissões de workspace
- Apenas usuários com acesso de escrita ou superior podem criar/modificar variáveis de workspace
- Variáveis pessoais são sempre privadas ao usuário individual