Skip to content
🚀 EDDI 6.5.0

19 provedores LLM, bases de conhecimento que rastreiam o seu site e leem os seus arquivos, e conversas que acompanham as versões compatíveis do agenteNovidades

Cloud Gerenciada Começar
Todas as integrações
Identidade e segurança${vault:}

Secrets Vault

Um cofre de segredos integrado com criptografia de envelope. A configuração referencia os segredos como ${vault:keyName}, e o valor nunca chega às configurações de agentes, às exportações nem aos logs.

O que você recebe

  • Referências ${vault:keyName} na configuração de LLM, chamadas HTTP, MCP e RAG
  • Criptografia de envelope AES-256-GCM com uma chave de dados por tenant
  • Permissões por agente: quais agentes podem usar qual segredo
  • Segredos removidos das exportações de configuração e redigidos nos logs

Como funciona no EDDI

  1. Defina a chave mestra do cofre (EDDI_VAULT_MASTER_KEY). O instalador gera uma para você. Sem uma chave, o cofre fica desativado.
  2. Guarde um segredo com PUT /secretstore/secrets/{tenantId}/{keyName} ou pelo Manager.
  3. Referencie-o na configuração como ${vault:keyName}.
  4. O EDDI resolve a referência em tempo de execução. O texto puro não é armazenado na memória da conversa.
  5. Restrinja allowedAgents aos agentes que precisam do segredo. A verificação roda quando um agente é implantado.

Configuração

Extraída da documentação do EDDI. Marcadores como your-agent-id devem ser substituídos pelos seus próprios valores.

Store a secretGuardar um segredo. A resposta nunca devolve o valor.
curl -X PUT http://localhost:7070/secretstore/secrets/default/openai-key \
  -H "Content-Type: application/json" \
  -d '{"value":"sk-your-key","description":"OpenAI key"}'
langchain.json (reference it, never paste it)Referenciar o segredo pelo nome a partir de uma tarefa de LLM.
{
  "tasks": [{
    "actions": ["send_message"],
    "id": "simpleChat",
    "type": "openai",
    "description": "Simple chat",
    "parameters": {
      "apiKey": "${vault:openai-key}",
      "modelName": "your-model-id",
      "systemMessage": "You are a helpful assistant",
      "addToOutput": "true"
    }
  }]
}
Grant one secret to specific agentsMudar quem pode usar um segredo sem tocar no valor dele.
curl -X PUT "$EDDI/secretstore/secrets/default/openai-key/grant" \
  -H 'Content-Type: application/json' \
  -d '{"allowedAgents": ["0123456789abcdef01234567", "89abcdef0123456789abcdef"]}'

Governança

  • As permissões são aplicadas no momento da implantação por padrão: um agente que referencia um segredo para o qual não tem permissão não é implantado.
  • Uma referência ao cofre que chega por dados da conversa, como a entrada do usuário ou a resposta de um modelo, é recusada em vez de resolvida.
  • O texto puro é redigido no registro da requisição, na pré-visualização da aprovação e na linha do log de requisições.
  • Os endpoints do cofre ficam atrás do papel eddi-admin quando a autenticação está ativada.

Bom saber

  • O EDDI não tem cliente nativo de HashiCorp Vault, AWS ou Azure. No Kubernetes, o External Secrets Operator pode sincronizar o Secret do Kubernetes eddi-secrets (que guarda a chave mestra do cofre) a partir do HashiCorp Vault, do AWS Secrets Manager ou do Azure Key Vault. Os segredos individuais continuam no cofre do EDDI.
  • Se a chave mestra for perdida, os segredos criptografados serão irrecuperáveis. Faça backup dela.

Integrações relacionadas

A configuração e o comportamento desta página seguem a documentação do EDDI, verificada em 2026-10-14. Nomes de campos e valores padrão podem mudar entre versões, portanto confirme-os na documentação da sua versão.