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
| Dado | O que é mantido | Por quanto tempo |
|---|---|---|
| Conta | E-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 acesso | Só um hash com chave de cada código de 6 dígitos; válido por 10 minutos, 5 tentativas | Apagados depois de um dia |
| Sessões | Um 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 | — |
| Convites | O e-mail convidado, o papel, quem convidou e quando, e um hash SHA-256 do token do link — nunca o link | Enquanto o workspace existir |
| Dados da organização | Razã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 faturas | Enquanto o workspace existir |
| Decisões | Rascunhos e toda versão publicada (os schemas) | Até você apagar a decisão |
| API keys | Um hash SHA-256 da key, um prefixo mascarado, nome, ambiente e datas — nunca a própria key | Até o workspace ser apagado |
| Chaves de provedor (BYOK) | A chave criptografada com AES-256-GCM e seus 4 últimos caracteres | Até você removê-la |
| Segredos do workspace | Cada valor criptografado com AES-256-GCM, com seus 4 últimos caracteres | Até você apagá-lo |
| Segredo de assinatura | Criptografado; depois de uma rotação, o anterior também, por 24 horas | Enquanto o workspace existir |
| Execuções | Sempre: 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 ligado | A sua retenção de logs (abaixo) |
| Entregas de destinos | Status, 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 reenviadas | 30 dias |
| Registros de idempotência | Um hash da requisição e a resposta que ela devolveu | 24 horas |
| Contadores de uso | Número de decisões cobráveis por hora | Cerca de 400 dias, para cobrança |
| Cobrança | IDs 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 à Dcision | Enquanto 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
contextda decisão, comodecision_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 oinputque 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— estoreOutput, 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
storeInputestoreOutputestã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/executionsdevolve 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 com403 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 FORBIDDENcomdetails.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-Keypara que retries não dupliquem uma decisão — veja Idempotência. - Registre
execution_ideX-Request-IDem vez do estado quando precisar rastrear uma decisão. - Verifique o
Dcision-Signatureem 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.
Jurídico
CLI
A linha de comando dcision — salve uma API key, rode decisões, liste templates, crie e valide decision schemas offline — com códigos de saída para scripts e CI.
Changelog
Notas de versão da Dcision — v1.9 modo sombra e GPT-Live; v1.8 arquivos; v1.7 engine OpenAI; v1.6 mover sub-workspaces; v1.5 prompts de 32k; v1.4 parceiros; v1.3 execuções; v1.0 construtor; v0.1 lançamento.