Segurança e dados

O que a Dcision guarda e por quanto tempo, para onde vai o seu estado — destinos incluídos —, como chaves, segredos e senhas são protegidos, papéis e isolamento de workspace, e como manter dados sensíveis de fora.

O que a Dcision guarda

DadoO que é mantidoPor quanto tempo
ContaE-mail, nome, avatar (do Google, quando você entra com ele), idioma e — só se você definir uma — um hash da senha (scrypt)Enquanto a conta existir
Códigos de acessoSó um hash com chave de cada código de 6 dígitos; válido por 10 minutos, 5 tentativasApagados depois de um dia
SessõesUm token assinado no seu navegador, válido por 30 dias. A Dcision só guarda o horário do seu último Sair de todos os dispositivos ou troca de senha—
ConvitesO e-mail convidado, o papel, quem convidou e quando, e um hash SHA-256 do token do link — nunca o linkEnquanto o workspace existir
Dados da organizaçãoRazão social, identificação fiscal, e-mail de cobrança, país, endereço e site — também salvos no seu cliente Stripe para as faturasEnquanto o workspace existir
DecisõesRascunhos e toda versão publicada (os schemas)Até você apagar a decisão
API keysUm hash SHA-256 da key, um prefixo mascarado, nome, ambiente e datas — nunca a própria keyAté o workspace ser apagado
Chaves de provedor (BYOK)A chave criptografada com AES-256-GCM e seus 4 últimos caracteresAté você removê-la
Segredos do workspaceCada valor criptografado com AES-256-GCM, com seus 4 últimos caracteresAté você apagá-lo
Segredo de assinaturaCriptografado; depois de uma rotação, o anterior também, por 24 horasEnquanto o workspace existir
ExecuçõesSempre: decisão, versão, origem, status, erro, ação e motivo, latência, tokens de entrada e de saída, custo estimado, modelo, request ID e as entradas de destino da execução. O estado só se storeInput estiver ligado; respostas, confiança, níveis ponderados, composites e distribuições só se storeOutput estiver ligadoA sua retenção de logs (abaixo)
Entregas de destinosStatus, tentativas, o código de status do receptor, latência e os primeiros 1.024 caracteres da resposta dele, e uma prévia mascarada da requisição — nunca o seu corpo. A requisição completa fica guardada criptografada até dar certo, e para entregas que falharam, para que possam ser reenviadas30 dias
Registros de idempotênciaUm hash da requisição e a resposta que ela devolveu24 horas
Contadores de usoNúmero de decisões cobráveis por horaCerca de 400 dias, para cobrança
CobrançaIDs de cliente e de assinatura no Stripe, plano, status e datas do ciclo. Os dados do cartão são tratados pelo Stripe e nunca chegam à DcisionEnquanto o workspace existir

Para onde vai o seu estado

Para responder a uma decisão, a Dcision envia ao provedor do engine:

  • o estado — todos os seus campos, incluindo campos que o schema não declara — e o context da decisão, como decision_context;
  • as instruções das perguntas, as opções, os níveis e os critérios, como texto ou JSON;
  • o nome do modelo.

Pesos dos composites, políticas e configurações ficam na Dcision: eles são aplicados depois que o engine responde.

Destinos podem enviar dados adiante depois da decisão — só para onde você configurar:

  • Webhooks e workflows enviam as respostas, a ação e os params que você mapear — nunca o estado em si.
  • Requisições de API enviam o que a sua URL, os seus headers e o seu template de corpo contiverem.
  • Agentes recebem o estado inteiro como input; destinos de LLM enviam o estado — ou o input que você definir — ao seu provedor de modelo, com a sua chave.
  • Respostas fixas e funções são devolvidas a quem chamou; nada sai da Dcision.

Veja Segurança e limites dos destinos.

Com a chave de engine da Dcision, a chamada vai direto para a API da TypeSafe (Jev) na conta da Dcision; a TypeSafe declara que o Jev não é treinado com requisições ou respostas de clientes — veja os seus documentos legais. Com a sua própria chave, ela vai para o provedor que você escolheu, na sua conta e sob os termos dele — a OpenAI para a OpenAI Decisions, o seu próprio servidor para o Laya. Veja Engines e BYOK. O OpenAI Decisions na chave da Dcision vai para a API da OpenAI na conta da Dcision.

Arquivos no estado (Entradas): documentos que a Dcision consegue processar são lidos dentro da Dcision e nunca saem dela. Áudio, imagens para o Jev ou o Laya, e arquivos que a Dcision não consegue processar são enviados à OpenAI, com a chave OpenAI do workspace, para serem transcritos, descritos ou lidos. Imagens para a OpenAI Decisions vão junto com a chamada ao engine. O log de execução guarda o nome, o tipo, o tamanho e os primeiros 4.000 caracteres do texto de cada arquivo — nunca o arquivo. Quando o workspace não tem chave OpenAI, é usada a chave da própria Dcision — e a OpenAI passa a ser subprocessadora da Dcision; veja a Política de Privacidade.

A Dcision não escreve o seu estado nem as suas chaves nos logs da aplicação.

Retenção e exclusão

  • Execuções são apagadas depois do menor entre a retenção do seu plano (Genesis 7 dias, Developer 14, Growth 30, Enterprise 365) e a configuração Retenção do log de execuções do workspace.
  • Apagar uma decisão apaga as suas versões e execuções imediatamente.
  • Registros de idempotência expiram depois de 24 horas, quaisquer que sejam as configurações de armazenamento da decisão.
  • Revogar uma API key a desativa na hora; o registro com hash fica para o seu histórico.
  • Regenerar uma API key a revoga e emite um novo segredo com o mesmo nome e ambiente num só passo — nunca há um momento com duas keys ativas ou nenhuma.
  • Entregas de destinos são apagadas 30 dias depois de criadas, qualquer que seja a retenção de logs — também quando a decisão delas foi apagada.
  • Apagar um workspace (o Proprietário pode) apaga as suas decisões, versões, execuções, API keys, convites, segredos e entregas. O cliente Stripe é mantido, para que as faturas anteriores continuem disponíveis.
  • Sair de todos os dispositivos, em Conta, encerra de uma vez todas as sessões da sua conta.

Mantenha dados sensíveis de fora

  • Desligue storeInput — e storeOutput, se as respostas também forem sensíveis — nas decisões que recebem dados pessoais. Veja Configurações da decisão.
  • Envie só o que a decisão precisa: campos não declarados são repassados ao engine. Isso também deixa as respostas mais precisas — veja Escrevendo boas perguntas.
  • Mantenha dados pessoais fora das instruções, opções e context: eles fazem parte do schema, são guardados em cada versão e enviados em cada chamada.
  • Substitua identificadores diretos (nomes, e-mails, números de documentos) pelos seus próprios IDs quando eles não mudam a resposta.
  • Encurte a Retenção do log de execuções em Configurações.
  • Mapeie nos params de destino só o que cada receptor precisa: as entradas de destino — params de funções incluídos — são mantidas com a execução mesmo quando storeInput e storeOutput estão desligados.

Controle de acesso

  • Isolamento de workspace. Toda consulta é restrita a um workspace. Uma API key resolve exatamente um workspace e só pode rodar as decisões desse workspace — qualquer outra coisa é 404 DECISION_NOT_FOUND — e só listar as execuções desse workspace.
  • Entradas ficam no app. GET /v1/executions devolve respostas, ações e métricas, mas nunca o estado guardado: as entradas, que podem conter dados pessoais, só são mostradas aos membros do workspace no app.
  • Keys e sessões são separadas. API keys só funcionam na API pública (/v1); os endpoints do app as recusam com 403 FORBIDDEN, e um token de sessão não é aceito em /v1.
  • Acesso. Google, um código de 6 dígitos por e-mail ou uma senha opcional: pelo menos 10 caracteres com letras e números, nunca o seu e-mail nem uma senha comum, guardada como hash scrypt. Senhas erradas bloqueiam o acesso por senha por 15 minutos depois de 5 tentativas, e a resposta é a mesma para um e-mail desconhecido. Definir ou trocar uma senha envia um e-mail para você, e trocá-la encerra as suas outras sessões.
  • Sessões. Um token assinado num cookie httpOnly, nunca exposto ao JavaScript do navegador, válido por 30 dias. Sair de todos os dispositivos revoga todos.
  • Papéis. Todo membro é Proprietário, Admin, Membro ou Leitor. Leitores leem; Membros constroem, publicam e rodam decisões, API keys e destinos; Admins também gerenciam pessoas, configurações, chaves de provedor e segredos; só o Proprietário gerencia a cobrança, transfere a propriedade e apaga o workspace. Recusas respondem 403 FORBIDDEN. Veja Time, papéis e conta.
  • Acesso ao workspace. Toda requisição do app é checada contra a sua participação no workspace; um workspace do qual você não faz parte responde 403 FORBIDDEN com details.reason = "workspace_access".

Checklist de integração segura

  • Chame a API a partir do seu backend via HTTPS; nunca exponha uma API key num navegador, num app mobile ou num repositório.
  • Use uma key por serviço e revogue as keys que você não usa mais. Use keys de teste para staging e CI.
  • Envie um Idempotency-Key para que retries não dupliquem uma decisão — veja Idempotência.
  • Registre execution_id e X-Request-ID em vez do estado quando precisar rastrear uma decisão.
  • Verifique o Dcision-Signature em todo webhook, workflow, agente e requisição de API que você receber da Dcision, rejeite timestamps antigos e deduplique pelo ID da entrega — veja Webhooks.
  • Guarde tokens e URLs secretas em segredos do workspace e referencie-os como {{secrets.NAME}} — nunca os digite na URL, nos headers ou no corpo de um destino.
  • Mantenha os eventos livemode: false — keys de teste e o Playground — fora dos sistemas de produção.

Uso responsável

A Dcision devolve probabilidades, não certezas. Para decisões com consequências sobre pessoas — crédito, emprego, moradia, saúde, questões jurídicas — use-a para triar e rotear, mantenha uma pessoa no circuito (por exemplo, com escalate) e revise os resultados regularmente.

Nesta página