Segurança
O Archyl implementa múltiplas medidas de segurança para proteger seus dados de arquitetura e análise de código. Este guia explica nossas práticas de segurança e como configurar o acesso seguro.
Proteção de Dados
Criptografia
| Tipo | Proteção |
|---|---|
| Em Trânsito | Todas as conexões usam criptografia TLS 1.3 |
| Em Repouso | Dados criptografados usando AES-256 |
| Chaves API | Hash e salt antes do armazenamento |
Isolamento de Dados
- Os dados de cada organização são totalmente isolados
- Sem acesso a dados entre organizações
- Controle de acesso baseado em papéis dentro das organizações
Segurança de Autenticação
Integração OAuth
O Archyl usa OAuth para autenticação com provedores Git:
- Sem credenciais armazenadas: Nunca armazenamos suas senhas do Git
- Permissões mínimas: Apenas acesso de leitura ao repositório é solicitado
- Baseado em tokens: Tokens OAuth com escopo limitado
- Revogável: Desconecte a qualquer momento nas configurações do provedor
Provedores Suportados
| Provedor | OAuth | Tokens de Acesso |
|---|---|---|
| GitHub | Sim | Sim |
| GitLab | Sim | Sim |
| Bitbucket | Sim | Sim |
| GitHub Enterprise | - | Sim |
| GitLab Auto-hospedado | - | Sim |
| Azure DevOps | - | Sim |
| Gitea | - | Sim |
Gerenciamento de Sessão JWT
- Tokens de acesso de curta duração (24 horas)
- Cookies HTTP-only seguros
- Atualização automática de tokens
- Invalidação de sessão no logout
Repositórios Privados
Usando Repositórios Privados
O Archyl suporta totalmente repositórios privados:
- Autenticação OAuth: Concede acesso somente leitura aos seus repos
- Provedores auto-hospedados: Use tokens de acesso pessoal
- Acesso seletivo: Você escolhe quais repos conectar
O que Acessamos
Ao analisar um repositório:
- Estrutura e caminhos de arquivos
- Conteúdo do código (apenas durante a análise)
- Arquivos de configuração
O que Não Armazenamos
- Código-fonte (apenas metadados e arquitetura descoberta)
- Credenciais do Git
- Tokens OAuth são criptografados e com escopo limitado
Segurança da Análise de IA
Como Funciona a Descoberta com IA
Durante a descoberta com IA:
- O código é enviado ao provedor de IA configurado
- Apenas a estrutura do código é analisada
- Os resultados requerem sua aprovação
- Nenhum código é armazenado permanentemente
Controle de Acesso
Papéis da Organização
| Papel | Capacidades |
|---|---|
| Proprietário | Controle total, gerenciamento de faturamento |
| Administrador | Gerenciamento de equipe e projetos |
| Editor | Criar e modificar arquitetura |
| Visualizador | Acesso somente leitura |
Acesso Baseado em Equipes
- Membros são convidados no nível da equipe
- Papéis diferentes por equipe
- Acesso ao projeto controlado pela participação na equipe
Permissões de Chaves API
- Permissões somente leitura ou leitura-escrita
- Limitadas a operações específicas
- Suporte a datas de expiração
- Trilha de auditoria de uso de chaves
Conformidade
Tratamento de Dados
- Tratamento de dados em conformidade com GDPR
- Exclusão de dados mediante solicitação
- Exporte seus dados a qualquer momento
- Nenhum dado vendido a terceiros
Infraestrutura
- Hospedado em infraestrutura de nuvem segura
- Auditorias de segurança regulares
- Varredura automatizada de vulnerabilidades
- Procedimentos de resposta a incidentes
Melhores Práticas de Segurança
Para Sua Organização
- Use acesso baseado em equipes: Não compartilhe credenciais
- Ative MFA: Proteja suas contas de provedores Git
- Rotacione chaves API: Troque as chaves periodicamente
- Audite o acesso: Revise a participação na equipe regularmente
Para Descoberta com IA
- Revise antes de aprovar: Verifique os elementos descobertos
- Use Ollama para código sensível: Mantenha a análise local
- Limite o escopo da descoberta: Analise apenas os caminhos necessários
- Exclua arquivos sensíveis: Configure padrões de exclusão
Para Compartilhamento
- Defina datas de expiração: Não crie links permanentes desnecessariamente
- Revise links compartilhados: Audite periodicamente os compartilhamentos ativos
- Use acesso por equipe: Prefira participação na equipe em vez de links de compartilhamento para uso interno
Reportando Problemas de Segurança
Se você descobrir uma vulnerabilidade de segurança:
- Não divulgue publicamente
- Envie email para security@archyl.com
- Inclua etapas detalhadas de reprodução
- Responderemos em até 24 horas
Próximos Passos
- Colaboração em Equipe - Configurar acesso da equipe
- Autenticação - Acesso seguro à API
- Descoberta com IA - Configurar provedores de IA