Dop2Mop

Coletor OpenGraph para BloodHound que mapeia caminhos de ataque de infraestrutura DevOps para MLOps, coletando recursos de pipelines CI/CD, service principals e plataformas de ML para análise de movimento lateral.

Agradecimentos

• SpecterOps pelo BloodHound e OpenGraph

Visão Geral

O Dop2Mop coleta dados de plataformas DevOps e MLOps para identificar caminhos de ataque que permitem movimento lateral de pipelines CI/CD para infraestrutura de treinamento de machine learning. Ele gera JSON OpenGraph compatível com BloodHound para visualização e análise.

Plataformas Suportadas

Limites de Confiança Mapeados

O Dop2Mop modela os cinco limites críticos de confiança identificados na pesquisa:

1. TB1: Code Repository to CI/CD Pipeline - Gatilho automático de pipelines a partir de commits de código
2. TB2: Service Principal Authentication - Credenciais NHI usadas por pipelines para acessar plataformas ML
3. TB3: Container Artifact Trust - Confiança implícita em imagens de contêiner de registros internos
4. TB4: Job Definition Execution - Plataformas ML executando definições de job sem validação
5. TB5: Code Deserialization - Desserialização insegura de conjuntos de dados (pickle, joblib)

Instalação```bash

git clone https://github.com/h4wkst3r/dop2mop.git cd dop2mop pip install -r requirements.txt pip install -e .

Ingestão no BloodHound

1. Abra o BloodHound CE (v8.0+)
2. Navegue até Administration → File Ingest
3. Faça upload do arquivo JSON gerado
4. Consulte com Cypher:```cypher // Azure DevOps to Azure ML Lateral Movement MATCH p=(repo)-[:TriggersPipeline]->(pipeline)-[:UsesServiceConnection]->(svcconn)-[:AuthenticatesAs]->(workspace)-[:CodeExecution]->(compute) RETURN p

// Container Image Poisoning (Supply Chain Attack) MATCH p=(workflow)-[:CanPoisonImage]->(image)<-[:PullsImage]-(job) RETURN p

// OIDC/Federated Identity Abuse (confirmed edges) MATCH p=(workflow)-[:OIDCTrust]->(oidc)-[:CanAssumeRole]->(role)-[:SubmitsJob]->(job) RETURN p

// OIDC abuse including inferred paths MATCH p=(workflow)-[:OIDCTrust]->(oidc)-[:InferredCanAssumeRole]->(role) RETURN p

// Dataset Poisoning via Pickle Deserialization MATCH p=(workflow)-[:CanPoisonDataset]->(dataset)<-[:LoadsDataset]-(job) RETURN p

// Find repos with weak/no branch protection (TB1 exploitable) MATCH (repo)-[:BypassesProtection]->(repo) RETURN repo.name, repo.default_branch

// Find overprivileged SageMaker IAM roles MATCH (role:IAMRole) WHERE role.is_admin = true OR role.has_s3_full_access = true RETURN role.name, role.attached_policies

// Find SageMaker notebooks with root + internet access MATCH (nb:SMNotebook) WHERE nb.root_access = 'Enabled' AND nb.direct_internet_access = 'Enabled' RETURN nb.name, nb.status

// Find self-hosted ADO agent pools MATCH (agent:ADOAgent) WHERE agent.is_hosted = false RETURN agent.name, agent.pool_type

Dop2Mop verifica estes locais em ordem:

1. Caminho especificado por --config
2. dop2mop.yaml / dop2mop.yml / .dop2mop.yaml no diretório atual
3. ~/.dop2mop.yaml

Nota: dop2mop.yaml está em .gitignore para evitar o commit acidental de credenciais. O arquivo de exemplo (dop2mop.yaml.example) é seguro para comitar.

Veja dop2mop.yaml.example para todas as opções disponíveis com comentários.

Ordem de prioridade: argumentos CLI > arquivo de configuração > variáveis de ambiente.

Validação de Credenciais

Teste as credenciais antes de executar uma coleta completa:```bash

Validate all configured collectors

dop2mop collect --validate -v

Validate specific collectors

dop2mop collect --validate --collectors github,sagemaker -v

Referência da CLI

Visão Geral dos Comandos```

dop2mop [options]

Commands: collect Collect data from DevOps/MLOps platforms demo Generate demo data with attack scenarios

Opções Gerais

Opções do GitHub

Opções do Azure DevOps

Opções do Azure ML

Opções do AWS SageMaker

Coletores Disponíveis

dop2mop demo

Gerar dados de demonstração mostrando os quatro cenários de ataque da pesquisa.```bash dop2mop demo [OPTIONS]

Exemplos de Uso da CLI

Coleção Básica```bash

Collect from all configured platforms (uses environment variables)

dop2mop collect -o output.json

Use a config file

dop2mop collect --config dop2mop.yaml -o output.json -v

Validate credentials first, then collect

dop2mop collect --validate -o output.json -v

Collect with verbose logging

dop2mop collect -o output.json -v

Collect with debug logging

dop2mop collect -o output.json --debug

Collect and compress to ZIP

dop2mop collect -o output.json --zip

Limit collection size

dop2mop collect --max-items 100 -o output.json

Skip secret enumeration

dop2mop collect --no-secrets -o output.json

Coleção de Múltiplas Plataformas```bash

GitHub + SageMaker

dop2mop collect --collectors github,sagemaker -o output.json -v

GitHub + Azure DevOps

dop2mop collect --collectors github,ado -o output.json -v

Azure DevOps + Azure ML (full Azure stack)

dop2mop collect --collectors ado,azureml -o azure.json -v

All collectors explicitly

dop2mop collect --collectors github,ado,azureml,sagemaker -o full.json -v

Exemplos de Coleção do Azure DevOps```bash

Using environment variables

export AZURE_DEVOPS_TOKEN="your-pat" export AZURE_DEVOPS_ORG="your-org" dop2mop collect --collectors AzureDevOpsCollector -o ado.json -v

Using command-line arguments (PAT)

dop2mop collect --collectors AzureDevOpsCollector
--azure-devops-token your-pat
--azure-devops-org your-org
-o ado.json -v

Using access token (Bearer auth)

dop2mop collect --collectors AzureDevOpsCollector
--azure-devops-access-token eyJ0...
--azure-devops-org your-org
-o ado.json -v

Nota: Prioridade de autenticação do Azure ML: token de acesso > principal de serviço > DefaultAzureCredential (az login). Tokens de acesso podem ser obtidos via az account get-access-token --resource https://management.azure.com/.

Exemplos de Coleções AWS SageMaker```bash

Using AWS profile (environment variable)

export AWS_PROFILE="your-profile" dop2mop collect --collectors SageMakerCollector -o sagemaker.json -v

Using AWS profile (command-line)

dop2mop collect --collectors SageMakerCollector
--aws-profile your-profile
-o sagemaker.json -v

Using access keys

dop2mop collect --collectors SageMakerCollector
--aws-access-key-id AKIAXXXXXXXXXXXXXXXX
--aws-secret-access-key xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
--aws-region us-east-1
-o sagemaker.json -v

Different AWS region

dop2mop collect --collectors SageMakerCollector
--aws-profile your-profile
--aws-region us-west-2
-o sagemaker.json -v

Variáveis de Ambiente

Todas as opções de linha de comando podem ser definidas por variáveis de ambiente:

Prioridade: argumentos CLI > arquivo de configuração > variáveis de ambiente.

Tipos de Nó

Nós de DevOps

Nós de MLOps

Nós de Identidade

Nós de Artefato

Tipos de Aresta

Arestas de Caminho de Ataque

Arestas Inferidas

Estas arestas são criadas por análise heurística quando dados explícitos de API não estão disponíveis (ex.: ARNs de funções armazenados em segredos). Usam tipos de aresta distintos para que possa filtrá-las nas consultas do BloodHound.

Arestas Estruturais

Consultas de Exemplo

Consulte queries/dop2mop_queries.cypher para exemplos completos de consultas.

Ícones Personalizados

O Dop2Mop inclui um arquivo de ícones pré-configurado para tipos de nó personalizados do BloodHound em data/custom_icons.json.

Enviando Ícones para o BloodHound

Opção 1: API Explorer (Mais Fácil)

1. Abra o BloodHound CE e vá em Settings → API Explorer
2. Encontre POST /api/v2/custom-nodes
3. Clique "Try it out"
4. Cole o conteúdo de custom_icons.json
5. Clique "Execute"

Opção 2: Autenticação HMAC (Recomendado para Automação)

Primeiro, crie um token de API no BloodHound:

1. Vá em Settings → Administration → Manage Users
2. Clique no seu usuário → Create Token
3. Salve o Token ID e o Token Key

Em seguida, use este script Python para enviar:

Opção 3: Bearer Token (Teste Rápido)

Obtenha um JWT da aba Network do DevTools do seu navegador enquanto estiver logado no BloodHound:```bash curl -X POST http://localhost:8080/api/v2/custom-nodes
-H "Authorization: Bearer eyJ..."
-H "Content-Type: application/json"
-d @custom_icons.json

Usando Coletores Individuais```python

from dop2mop import CollectorConfig, GitHubCollector, SageMakerCollector from dop2mop.graph import OpenGraphBuilder

Create shared builder

builder = OpenGraphBuilder(source_kind="MLOpsBase")

Configure

config = CollectorConfig( github_token="ghp_xxx", github_org="myorg", aws_profile="default", )

Run individual collectors

github = GitHubCollector(config, builder) github.collect()

sagemaker = SageMakerCollector(config, builder) sagemaker.collect()

Save combined output

builder.save("combined.json")

Resolução de Problemas

Valide Primeiro

Sempre comece com a validação de credenciais para detectar problemas de autenticação precocemente.```bash dop2mop collect --validate --collectors github,sm -v

Problemas Comuns

"Coletor GitHub não configurado, ignorando"

• Certifique-se de que as variáveis de ambiente GITHUB_TOKEN e GITHUB_ORG estão definidas, ou passe --github-token e --github-org

"Coletor Azure ML não configurado, ignorando"

• Certifique-se de que AZURE_SUBSCRIPTION_ID e AZURE_TENANT_ID estão definidas
• Execute az login se estiver usando DefaultAzureCredential
• Alternativamente, passe --azure-access-token com um token válido de az account get-access-token

"Coletor SageMaker não configurado, ignorando"

• Defina AWS_PROFILE ou ambos AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY
• Certifique-se de que as credenciais tenham permissões de leitura do SageMaker

Proteção de branch retorna 403

• A API do GitHub requer acesso de administrador para ler regras de proteção de branch
• Tokens não administradores ignorarão a coleta de proteção de branch (relatado no resumo)

Limitação de taxa (erros 429)

• Dop2Mop tenta novamente automaticamente com backoff exponencial em respostas de limite de taxa
• Para grandes organizações, use --max-items para reduzir chamadas de API
• Limites de taxa do GitHub: 5.000 solicitações/hora para usuários autenticados

Nenhum resultado no console Cypher do BloodHound

• Certifique-se de que as consultas retornem nós completos (RETURN a, b) e não propriedades (RETURN a.name, b.name)
• O console Cypher do BloodHound é para visualização de grafos, não dados tabulares
• Use o Neo4j Browser (localhost:7474) para consultas baseadas em propriedades

Filtrando arestas inferidas vs. coletadas

• Arestas inferidas usam tipos distintos (por exemplo, InferredCanAssumeRole em vez de CanAssumeRole)
• Consulte apenas arestas confirmadas: MATCH p=()-[:CanAssumeRole]->() RETURN p
• Consulte arestas inferidas: MATCH p=()-[:InferredCanAssumeRole]->() RETURN p

Licença

Licença MIT - Consulte LICENSE para detalhes.