Segurança e privacidade
Como gerenciar chaves, o que evitar enviar e os limites deste serviço.
Gerenciamento de chaves
- As chaves são exibidas por inteiro uma única vez. Armazene-as em um gerenciador de segredos ou em uma variável de ambiente.
- Use uma chave por serviço ou máquina para que a revogação seja pontual.
- A revogação entra em vigor imediatamente.
- Nunca coloque uma chave em JavaScript do lado do cliente, em um binário de aplicativo móvel ou em um repositório público. Tudo o que é distribuído a um usuário é público.
- Se uma chave vazar, revogue-a primeiro e investigue depois.
O que evitar enviar
Este é um gateway de terceiros que fica entre você e o provedor de origem. Trate-o como um processador externo:
- Não envie dados que você esteja contratualmente proibido de compartilhar com um subprocessador.
- Não envie dados regulados — prontuários médicos, números de cartões de pagamento ou identificadores governamentais — sem uma base legal para isso.
- Oculte segredos antes de enviar logs ou arquivos de configuração a um modelo. Agentes que leem arquivos inteiros lerão sem hesitar seu
.env.
Injeção de prompt
Qualquer conteúdo que o modelo lê pode tentar dar instruções a ele — páginas da web, arquivos, resultados de ferramentas e comentários em issues. As consequências decorrem do que o modelo pode *fazer*, portanto, limite essas ações:
- Atribua às ferramentas de banco de dados uma função somente de leitura.
- Restrinja o escopo dos tokens de API ao mínimo necessário.
- Exija aprovação humana para ações irreversíveis.
- Nunca
evala saída do modelo nem execute SQL gerado em uma conexão com permissão de escrita.
Transporte
Todo o tráfego usa HTTPS. Rejeite HTTP sem criptografia na configuração do seu cliente; uma URL base de http:// enviaria sua chave em texto claro.
Não recomendamos fixar o certificado ao nosso nome de host — mudanças na infraestrutura interromperiam o funcionamento do seu cliente sem aviso. A validação padrão por CA é o nível adequado.