executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available
soc2-complianceUse quando o usuário pedir para preparar auditorias SOC 2, mapear Critérios de Serviço de Confiança, construir matrizes de controles, coletar evidências de auditoria, realizar análise de lacunas ou avaliar a prontidão para SOC 2 Tipo I versus Tipo II.
Independent GitHub snapshot · Automated classification · Original documentation governs
Preparação para conformidade SOC 2 Tipo I e Tipo II para empresas SaaS. Cobre mapeamento dos Critérios de Serviço de Confiança, geração de matriz de controles, coleta de evidências, análise de lacunas e avaliação de prontidão para auditoria.
SOC 2 (System and Organization Controls 2) é um framework de auditoria desenvolvido pelo AICPA que avalia como uma organização de serviços gerencia os dados de clientes. Aplica-se a qualquer empresa de tecnologia que armazena, processa ou transmite informações de clientes — principalmente SaaS, infraestrutura em nuvem e provedores de serviços gerenciados.
| Aspecto | Tipo I | Tipo II |
|---|---|---|
| Escopo | Design dos controles em um ponto no tempo | Design E eficácia operacional ao longo de um período |
| Duração | Snapshot (data única) | Janela de observação (3-12 meses, tipicamente 6) |
| Evidência | Descrições de controles, políticas | Descrições de controles + evidências operacionais (logs, tickets, capturas de tela) |
| Custo | $20K-$50K (honorários de auditoria) | $30K-$100K+ (honorários de auditoria) |
| Prazo | 1-2 meses (fase de auditoria) | 6-12 meses (observação + auditoria) |
| Melhor Para | Primeira conformidade, necessidade rápida de mercado | Organizações maduras, clientes enterprise |
Avaliação de Lacunas → Remediação → Auditoria Tipo I → Período de Observação → Auditoria Tipo II → Renovação Anual
(4-8 sem) (8-16 sem) (4-6 sem) (6-12 meses) (4-6 sem) (contínuo)
O SOC 2 é organizado em torno de cinco categorias de Critérios de Serviço de Confiança (TSC). Segurança é obrigatória para todo relatório SOC 2; as outras quatro são opcionais e selecionadas com base na necessidade do negócio.
A base de todo relatório SOC 2. Mapeia para os princípios COSO 2013.
| Critério | Domínio | Controles-Chave |
|---|---|---|
| CC1 | Ambiente de Controle | Integridade/ética, supervisão do conselho, estrutura org., competência, accountability |
| CC2 | Comunicação e Informação | Comunicação interna/externa, qualidade da informação |
| CC3 | Avaliação de Riscos | Identificação de riscos, risco de fraude, análise de impacto de mudanças |
| CC4 | Atividades de Monitoramento | Monitoramento contínuo, avaliação de deficiências, ações corretivas |
| CC5 | Atividades de Controle | Políticas/procedimentos, controles tecnológicos, implantação por políticas |
| CC6 | Acesso Lógico e Físico | Provisionamento de acesso, autenticação, criptografia, restrições físicas |
| CC7 | Operações do Sistema | Gestão de vulnerabilidades, detecção de anomalias, resposta a incidentes |
| CC8 | Gestão de Mudanças | Autorização de mudanças, teste, aprovação, mudanças emergenciais |
| CC9 | Mitigação de Riscos | Gestão de riscos de fornecedores/parceiros de negócios |
| Critério | Foco | Controles-Chave |
|---|---|---|
| A1.1 | Gestão de capacidade | Escalamento de infraestrutura, monitoramento de recursos, planejamento de capacidade |
| A1.2 | Operações de recuperação | Procedimentos de backup, recuperação de desastres, teste de BCP |
| A1.3 | Teste de recuperação | Simulações de DR, teste de failover, validação de RTO/RPO |
Selecionar quando: Clientes dependem da sua disponibilidade; você tem SLAs; indisponibilidade causa impacto direto no negócio.
| Critério | Foco | Controles-Chave |
|---|---|---|
| C1.1 | Identificação | Política de classificação de dados, inventário de dados confidenciais |
| C1.2 | Proteção | Criptografia em repouso e em trânsito, DLP, restrições de acesso |
| C1.3 | Descarte | Procedimentos de exclusão segura, sanitização de mídia, aplicação de retenção |
Selecionar quando: Você trata segredos comerciais, dados proprietários ou informações contratualmente confidenciais.
| Critério | Foco | Controles-Chave |
|---|---|---|
| PI1.1 | Precisão | Validação de entrada, verificações de processamento, verificação de saída |
| PI1.2 | Completude | Monitoramento de transações, reconciliação, tratamento de erros |
| PI1.3 | Pontualidade | Monitoramento de SLA, alertas de atraso de processamento, monitoramento de jobs em lote |
| PI1.4 | Autorização | Controles de autorização de processamento, segregação de funções |
Selecionar quando: A precisão dos dados é crítica (processamento financeiro, registros de saúde, plataformas de analytics).
| Critério | Foco | Controles-Chave |
|---|---|---|
| P1 | Aviso | Política de privacidade, aviso de coleta de dados, limitação de propósito |
| P2 | Escolha e Consentimento | Opt-in/opt-out, gestão de consentimento, rastreamento de preferências |
| P3 | Coleta | Coleta mínima, base legal, especificação de propósito |
| P4 | Uso, Retenção, Descarte | Limitação de propósito, cronogramas de retenção, descarte seguro |
| P5 | Acesso | Solicitações de acesso de titulares, direitos de correção |
| P6 | Divulgação e Notificação | Compartilhamento com terceiros, notificação de violações |
| P7 | Qualidade | Verificação de precisão dos dados, mecanismos de correção |
| P8 | Monitoramento e Aplicação | Monitoramento do programa de privacidade, tratamento de reclamações |
Selecionar quando: Você processa PII e os clientes esperam garantia de privacidade (complementa a conformidade LGPD/GDPR).
Uma matriz de controles mapeia cada critério TSC para controles específicos, responsáveis, evidências e procedimentos de teste.
| Campo | Descrição |
|---|---|
| ID do Controle | Identificador único (ex.: SEC-001, AVL-003) |
| Mapeamento TSC | Quais critérios o controle trata (ex.: CC6.1, A1.2) |
| Descrição do Controle | O que o controle faz |
| Tipo de Controle | Preventivo, Detectivo ou Corretivo |
| Responsável | Pessoa/equipe responsável |
| Frequência | Contínua, Diária, Semanal, Mensal, Trimestral, Anual |
| Tipo de Evidência | Captura de tela, Log, Política, Configuração, Ticket |
| Procedimento de Teste | Como o auditor verifica o controle |
{CATEGORIA}-{NÚMERO}
SEC-001 até SEC-NNN → Segurança
AVL-001 até AVL-NNN → Disponibilidade
CON-001 até CON-NNN → Confidencialidade
PRI-001 até PRI-NNN → Integridade do Processamento
PRV-001 até PRV-NNN → Privacidade
control_matrix_builder.py para gerar a matriz de linha de baseExecutar gap_analyzer.py em relação aos controles atuais para identificar:
Para cada lacuna, definir:
| Campo | Descrição |
|---|---|
| ID da Lacuna | Identificador de referência |
| Critério TSC | Critérios afetados |
| Descrição da Lacuna | O que está faltando ou é insuficiente |
| Ação de Remediação | Etapas específicas para fechar a lacuna |
| Responsável | Pessoa responsável pela remediação |
| Prioridade | Crítica / Alta / Média / Baixa |
| Data Alvo | Prazo de conclusão |
| Dependências | Outras lacunas ou projetos que devem ser concluídos primeiro |
| Prioridade | Remediação Alvo |
|---|---|
| Crítica | 2-4 semanas |
| Alta | 4-8 semanas |
| Média | 8-12 semanas |
| Baixa | 12-16 semanas |
| Área de Controle | Evidência Primária | Evidência Secundária |
|---|---|---|
| Gestão de Acesso | Revisões de acesso de usuários, tickets de provisionamento | Matriz de funções, logs de acesso |
| Gestão de Mudanças | Tickets de mudança, registros de aprovação | Logs de implantação, resultados de testes |
| Resposta a Incidentes | Tickets de incidentes, postmortems | Runbooks, registros de escalonamento |
| Gestão de Vulnerabilidades | Relatórios de varredura, registros de patches | Cronogramas de remediação |
| Criptografia | Capturas de tela de configuração, inventário de certificados | Logs de rotação de chaves |
| Backup e Recuperação | Logs de backup, resultados de testes de DR | Medições de tempo de recuperação |
| Monitoramento | Configurações de alertas, capturas de tela de painéis | Agendas de plantão, registros de escalonamento |
| Gestão de Políticas | Políticas assinadas, histórico de versões | Registros de conclusão de treinamento |
| Gestão de Fornecedores | Avaliações de fornecedores, relatórios SOC 2 | Revisões de contratos, registros de risco |
| Área | Abordagem de Automação |
|---|---|
| Revisões de acesso | Integrar IAM com ticketing (gatilhos automáticos de revisão trimestral) |
| Evidências de configuração | Snapshots de infraestrutura-como-código, ferramentas de compliance-as-code |
| Varreduras de vulnerabilidades | Varredura programada com relatórios gerados automaticamente |
| Gestão de mudanças | Trilha de auditoria baseada em Git (commits, PRs, aprovações) |
| Monitoramento de uptime | Painéis de SLA automatizados com dados históricos |
| Verificação de backup | Testes de restauração automatizados com registro de sucesso/falha |
Migrar da coleta de evidências pontual para conformidade contínua:
| Pontuação | Classificação | Significado |
|---|---|---|
| 90-100% | Pronto para Auditoria | Prosseguir com confiança |
| 75-89% | Lacunas Menores | Tratar antes de agendar a auditoria |
| 50-74% | Lacunas Significativas | Remediação obrigatória |
| < 50% | Não Pronto | Construção maior do programa necessária |
| Achado | Causa Raiz | Prevenção |
|---|---|---|
| Revisões de acesso incompletas | Processo manual, sem lembretes | Automatizar gatilhos de revisão trimestral |
| Aprovações de mudanças ausentes | Mudanças emergenciais contornam o processo | Definir procedimento de mudança emergencial com aprovação posterior |
| Varreduras de vulnerabilidades desatualizadas | Scanner mal configurado | Varreduras semanais automatizadas com alertas |
| Política não reconhecida | Sem mecanismo de rastreamento | Fluxo de trabalho anual de assinatura eletrônica |
| Avaliações de fornecedores ausentes | Sem inventário de fornecedores | Manter registro de fornecedores com cronograma de revisão |
Todo fornecedor que acessa, armazena ou processa dados de clientes deve ser avaliado:
| Nível | Acesso a Dados | Frequência de Avaliação | Requisitos |
|---|---|---|---|
| Crítico | Processa/armazena dados de clientes | Anual + monitoramento contínuo | SOC 2 Tipo II, teste de penetração, revisão de segurança |
| Alto | Acessa ambiente do cliente | Anual | SOC 2 Tipo II ou equivalente, questionário |
| Médio | Acesso indireto, ferramentas de suporte | Questionário anual | Certificações de segurança, questionário |
| Baixo | Sem acesso a dados | Questionário bienal | Questionário básico de segurança |
Quando o seu relatório SOC 2 depende de controles em uma suborganização de serviço (ex.: AWS, GCP, Azure):
| Aspecto | Pontual | Contínua |
|---|---|---|
| Coleta de evidências | Manual, antes da auditoria | Automatizada, contínua |
| Monitoramento de controles | Revisão periódica | Painéis em tempo real |
| Detecção de desvio | Encontrado durante a auditoria | Baseado em alertas, imediato |
| Remediação | Reativa | Proativa |
| Preparação para auditoria | Corrida de 4-8 semanas | Sempre pronto |
| Trimestre | Atividades |
|---|---|
| T1 | Avaliação anual de riscos, atualização de políticas, lançamento de reavaliação de fornecedores |
| T2 | Teste interno de controles, remediação de achados |
| T3 | Revisão de prontidão pré-auditoria, verificação de completude de evidências |
| T4 | Auditoria externa, asserção de gestão, distribuição de relatório |
| Anti-Padrão | Por que Falha | Abordagem Melhor |
|---|---|---|
| Conformidade pontual | Controles se degradam entre auditorias; lacunas encontradas durante a auditoria | Implementar monitoramento contínuo e evidências automatizadas |
| Coleta manual de evidências | Demorada, inconsistente, propensa a erros | Automatizar com scripts, IaC e plataformas de compliance |
| Avaliações de fornecedores ausentes | Auditores sinalizam due diligence de fornecedores incompleta | Manter registro de fornecedores com cronograma de avaliação por risco |
| Políticas copiadas | Políticas genéricas não correspondem às operações reais | Adaptar políticas ao ambiente e stack tecnológico reais |
| Segurança de teatro | Controles existem no papel, mas não são seguidos | Verificar eficácia operacional; incorporar controles nos fluxos de trabalho |
| Pular Tipo I | Pular para Tipo II sem prontidão de base | Começar com Tipo I para validar o design dos controles antes da observação |
| Excesso de escopo TSC | Incluir todas as 5 categorias quando apenas Segurança é necessária | Selecionar categorias com base nos requisitos reais de clientes/negócio |
| Tratar auditoria como projeto | Conformidade se degrada após o relatório ser emitido | Incorporar conformidade nas operações diárias e na cultura de engenharia |
Gera uma matriz de controles SOC 2 a partir das categorias TSC selecionadas.
# Gerar matriz de segurança completa em markdown
python scripts/control_matrix_builder.py --categories security --format md
# Gerar matriz para múltiplas categorias como JSON
python scripts/control_matrix_builder.py --categories security,availability,confidentiality --format json
# Todas as categorias, saída CSV
python scripts/control_matrix_builder.py --categories security,availability,confidentiality,processing-integrity,privacy --format csv
Rastreia o status de coleta de evidências por controle.
# Verificar status de evidências de uma matriz de controles
python scripts/evidence_tracker.py --matrix controls.json --status
# Saída JSON para integração
python scripts/evidence_tracker.py --matrix controls.json --status --json
Analisa os controles atuais em relação aos requisitos SOC 2 e identifica lacunas.
# Análise de lacunas Tipo I
python scripts/gap_analyzer.py --controls current_controls.json --type type1
# Análise de lacunas Tipo II (inclui eficácia operacional)
python scripts/gap_analyzer.py --controls current_controls.json --type type2 --json