cloud-topology-mapping

Especialista em Mapeamento de Recursos Cloud, Ambientes Híbridos e Grafos de Ativos Multi-Cloud utilizando Cartography, CloudMapper, Resoto, Steampipe, Azure Resource Graph, AWS Systems Manager Explor

SKILL.md

GitHub

☁️ Mapeamento de Topologia Cloud, Ambientes Híbridos e Grafos de Ativos Multi-Cloud

Esta skill orienta a inteligência artificial a atuar como Especialista em Mapeamento de Topologia e Governança de Recursos em Nuvem, integrando dados de inventário de ativos da AWS, Microsoft Azure, Google Cloud Platform (GCP) e ambientes on-premise em bancos de dados relacionais e grafos para análise de segurança, custos e dependências de infraestrutura.


🛰️ 1. Arquitetura de Mapeamento de Recursos Cloud

O mapeamento de nuvem moderno consolida APIs de múltiplos provedores em interfaces de consulta unificadas (SQL ou Grafos Cypher):

flowchart TD
    subgraph CloudProviders["Provedores de Nuvem & On-Premise"]
        AWS["AWS (IAM, EC2, S3, RDS, VPC)"]
        AZURE["Azure (Resource Groups, VMs, VNets, Entra ID)"]
        GCP["GCP (Projects, GKE, Cloud SQL, IAM)"]
        K8S["Kubernetes Clusters"]
    end

    subgraph CollectionEngines["Mecanismos de Mapeamento & Coleta"]
        CARTOGRAPHY["Cartography (Lyft) -> Neo4j Graph"]
        STEAMPIPE["Steampipe (SQL Engine via Postgres FDW)"]
        RESOTO["Resoto / Fix Inventory (Asset Graph & Metrics)"]
        CLOUDMAPPER["CloudMapper (Duo Labs / Visual VPC Maps)"]
    end

    subgraph NativeCloudAssetAPIs["APIs Nativas de Inventário"]
        ARG["Azure Resource Graph (KQL)"]
        AWS_SSM["AWS Systems Manager Explorer"]
        GCP_CAI["GCP Cloud Asset Inventory"]
    end

    CloudProviders --> CollectionEngines
    CloudProviders --> NativeCloudAssetAPIs

    CARTOGRAPHY --> NEO4J[("Neo4j Graph Database")]
    STEAMPIPE --> SQL_QUERIES["Consultas SQL / Relatórios de Conformidade"]
    ARG --> AZURE_PORTAL["Workbooks & Dashboards"]

🛠️ 2. Ferramentas Especialistas de Mapeamento de Nuvem

1. Cartography (Lyft)

  • Conceito: Ferramenta de auditoria e consolidação de recursos baseada em Python que varre APIs de nuvem (AWS, Azure, GCP, GitHub, Okta, Kubernetes) e constrói um grafo de relacionamento detalhado no Neo4j.
  • Execução CLI de Sincronização:
cartography --neo4j-uri bolt://localhost:7687 --neo4j-user neo4j --neo4j-password-env-var NEO4J_PASSWORD
  • Exemplo de Consulta Cypher para identificar instâncias EC2 expostas diretamente à Internet com permissões de administração IAM:
MATCH (i:EC2Instance)-[:MEMBER_OF_EC2_SECURITY_GROUP]->(sg:EC2SecurityGroup)<-[:ALLOWS]-(rule:IpRule)
WHERE rule.fromport <= 22 AND rule.toport >= 22 AND rule.cidr = '0.0.0.0/0'
MATCH (i)-[:ATTACHED_IAM_ROLE]->(role:AWSPrincipal)-[:POLICY]->(p:AWSPolicy)
WHERE p.name = 'AdministratorAccess'
RETURN i.id, i.publicdnsname, sg.id, role.name

2. Steampipe (Zero-ETL SQL Engine for Cloud Assets)

  • Conceito: Utilitário CLI e servidor SQL que expõe APIs de nuvem e ferramentas de software como tabelas relacionais PostgreSQL através de Foreign Data Wrappers (FDW). Permite executar consultas SQL diretas, joins entre diferentes provedores e verificações de conformidade CIS.
  • Consultas SQL Multi-Cloud:
# Iniciar console interativo
steampipe query
-- Identificar todos os buckets S3 públicos na AWS e containers Blob no Azure
SELECT
  'AWS' AS provider,
  name AS asset_name,
  region AS location,
  block_public_acls,
  block_public_policy
FROM
  aws_s3_bucket
WHERE
  block_public_acls = false OR block_public_policy = false

UNION ALL

SELECT
  'Azure' AS provider,
  name AS asset_name,
  location,
  false AS block_public_acls,
  false AS block_public_policy
FROM
  azure_storage_container
WHERE
  public_access <> 'None';

3. Resoto / Fix Inventory

  • Conceito: Inventário de infraestrutura multi-cloud focado em grafos, permitindo limpeza de recursos órfãos, automação de tagging e monitoramento de drift de configurações em AWS, GCP, Azure, DigitalOcean e Kubernetes.

4. CloudMapper (Duo Security)

  • Conceito: Utilitário focado em análise visual de topologias de rede AWS (VPCs, Subnets, Gateways, Route Tables e Security Groups). Gera relatórios HTML interativos e diagramas visuais de tráfego de rede e roteamento.
python cloudmapper.py collect --account my-aws-account
python cloudmapper.py prepare --account my-aws-account
python cloudmapper.py webserver --port 8000

5. Azure Resource Graph (ARG) & KQL

  • Conceito: Serviço de gerenciamento do Azure que oferece exploração de recursos em grande escala em dezenas de assinaturas utilizando o Kusto Query Language (KQL) com tempos de resposta sub-segundo.
  • Exemplo de Consulta KQL:
Resources
| where type == "microsoft.compute/virtualmachines"
| project name, resourceGroup, subscriptionId, location, properties.hardwareProfile.vmSize
| join kind=leftouter (
    ResourceContainers
    | where type == "microsoft.resources/subscriptions"
    | project subscriptionId, subscriptionName = name
) on subscriptionId
| project name, resourceGroup, subscriptionName, location, vmSize

6. AWS Systems Manager (SSM) Explorer & Inventory

  • Conceito: Dashboard centralizado e mecanismo de coleta de inventário da AWS que consolida metadados de instâncias EC2, sistemas operacionais instalados, pacotes de software, patches e status de conformidade em múltiplas contas e regiões da AWS.

7. GCP Cloud Asset Inventory

  • Conceito: Serviço de inventário nativo do Google Cloud que mantém histórico de 5 semanas de metadados de recursos e políticas de IAM, permitindo buscas em tempo real e exportação contínua para BigQuery.
# Buscar todas as instâncias Compute Engine ativas em uma organização GCP
gcloud asset search-all-resources \
  --scope='organizations/123456789012' \
  --asset-types='compute.googleapis.com/Instance' \
  --format='table(name, location, state)'

📊 3. Matriz de Integração de Mapeamento Cloud

Objetivo de Mapeamento Ferramenta Recomendada Formato de Saída / Consulta
Grafo de Relação IAM + Rede + Ativos Cartography Grafo Neo4j / Cypher Queries
Auditoria e Joins Multi-Cloud via SQL Steampipe PostgreSQL SQL / JSON / CSV
Visualização de Topologias VPC AWS CloudMapper Diagrama Web Interativo / SVG
Inventário Rápido em Escala Azure Azure Resource Graph KQL (Kusto) / Portal Azure
Auditoria Contínua & Histórico GCP GCP Cloud Asset Inventory BigQuery Tables / PubSub Feeds
Detecção de Recursos Órfãos/Custos Resoto (Fix Inventory) Resoto Shell / Python SDK

🎯 4. Boas Práticas

  • Acesso Somente-Leitura (Least Privilege Read-Only): Crie Service Principals, IAM Roles e Contas de Serviço com permissões exclusivas de leitura (SecurityAudit, Viewer, Reader) para as ferramentas de mapeamento.
  • Agendamento Periódico de Snapshots: Execute sincronizações de inventário (via Cartography ou Steampipe) em horários agendados para capturar o histórico e tendências de crescimento da infraestrutura.
  • Alinhamento com Tags Estruturadas: Garanta que todos os recursos mapeados contenham tags obrigatórias (Environment, Owner, CostCenter, Service) para permitir filtragem precisa no grafo.