> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Configurações e segurança
> Configure definições operacionais e tome decisões sobre os dados do agente.
Use as Configurações para valores operacionais específicos de implantação e substituições de janela de contexto do modelo. Inspecione o esquema de configurações antes de alterar um valor pela API ou CLI.
## Alterar uma configuração da organização
1. Acesse **Administração → Configurações**, localize o grupo de configurações e leia sua descrição e fonte atual.
2. Altere o valor e salve.
3. Para janelas de contexto de modelos, adicione ou atualize a substituição do modelo e confirme o limite efetivo.
4. Verifique novamente as sessões e métricas que dependem do valor alterado.
```bash theme={null}
fp settings list
fp settings schema
fp settings set --value
fp settings set alerts.email_default_recipients \
--json-value '["oncall@example.com"]'
```
Execute `fp settings set --help` para o tipo de valor e as flags de confirmação usadas pela CLI instalada.
## Escolhas sobre tratamento de dados
Conectar o CLI do Failproof AI envia transcrições por padrão, pois rastreamentos e auditorias dependem do conteúdo delas. Use `--no-transcripts` quando prompts, conteúdos de arquivos ou entradas de terminal precisam permanecer locais; a atividade de hooks e as decisões de políticas ainda podem ser reportadas.
As credenciais de ingestão local são armazenadas separadamente das configurações do daemon não secretas e gravadas com permissões restritivas. As chaves de API ainda devem ser gerenciadas como segredos de produção.
## Referência de configurações da organização
Todas as configurações editáveis pelo dashboard têm escopo de organização. O comportamento em toda a implantação permanece como configuração do ambiente do servidor.
| Chave | Padrão | Finalidade |
| --------------------------------- | ---------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `allowed_sign_ins` | `[]` | Restringe membros existentes a e-mails exatos ou `*@domínio`; uma lista vazia significa nenhuma restrição adicional. |
| `session_ttl_secs` | `86400` | Tempo de vida da sessão no dashboard; o intervalo aceito é de 60 segundos a 30 dias. |
| `otp_ttl_secs` | `600` | Tempo de vida do OTP e magic link; o intervalo aceito é de 60 a 1800 segundos. |
| `alerts.email_default_recipients` | `[]` | Destinatários padrão quando um canal de e-mail de alerta não os substitui. |
| `alerts.slack_default_webhook` | vazio | URL padrão do webhook de entrada do Slack. |
| `alerts.webhook_default_url` | vazio | URL padrão de webhook JSON genérico. |
| `alerts.webhook_signing_secret` | vazio | Chave HMAC-SHA256 usada para o cabeçalho `X-AgentEye-Signature`; leituras são mascaradas. |
| `alerts.enabled_channels` | e-mail, Slack, webhook | Tipos de canais em nível de organização que as regras de alerta podem despachar. |
| `default_user_permissions` | `standard` | Conjunto de permissões pré-selecionado para novos convites. |
`allowed_sign_ins` é um filtro, não uma concessão: a pessoa já deve ser membro da organização. Use uma lista vazia para permitir todos os membros; o valor simples `*` é rejeitado. As URLs de alerta devem usar HTTPS, exceto para endereços de loopback em desenvolvimento.
## Lista de verificação de segurança
* Use HTTPS para conexões com a nuvem.
* Restrinja as chaves ao menor conjunto de permissões possível.
* Separe os ambientes de produção e não produção.
* Revise as configurações de transcrição e redação antes da implantação.
* Audite alterações de usuários, chaves e organizações.
* Teste os requisitos de backup, retenção e resposta a incidentes para sua implantação.
Desativar a captura de transcrições altera o que auditorias e investigações podem comprovar. Registre a decisão e suas limitações esperadas.