Skip to content

viz - Visualization

The viz subcommand generates graph visualizations from discovered asset relationships.

Synopsis

amass viz [options]

Output Formats

Flag Format Description
-d3 D3.js HTML Interactive browser visualization
-dot DOT/Graphviz Graph description language
-gexf Gephi GEXF Gephi graph format

Options

Target Selection

Flag Description Example
-d Domain names (comma-separated) -d example.com
-df File containing domain names -df domains.txt
-since Include assets after date -since "01/02 15:04:05 2006 MST"

Output Options

Flag Description
-o Output directory
-oA Output file prefix
-dir Data directory path

Examples

D3.js Interactive Visualization

amass viz -d3 -d example.com -o /output

Creates an interactive HTML file viewable in any browser:

/output/
└── example.com_d3.html

Graphviz DOT Format

amass viz -dot -d example.com -o /output

Output can be rendered with Graphviz:

dot -Tpng example.com.dot -o graph.png
dot -Tsvg example.com.dot -o graph.svg

Gephi GEXF Format

amass viz -gexf -d example.com -o /output

Import into Gephi for advanced analysis.

Multiple Formats

amass viz -d3 -dot -gexf -d example.com -oA network_map

Creates: 

network_map.html
network_map.dot
network_map.gexf

Time-Bounded Visualization

amass viz -d3 -d example.com -since "06/01 00:00:00 2024 UTC" -o /output

Graph Structure

flowchart TB
    subgraph Nodes["Node Types"]
        FQDN[FQDN]
        IP[IP Address]
        NET[Netblock]
        ASN[ASN]
        ORG[Organization]
        CERT[Certificate]
    end

    subgraph Edges["Edge Types"]
        RES[resolves_to]
        BELONGS[belongs_to]
        MEMBER[member_of]
        OWNED[owned_by]
        PROTECTS[protected_by]
    end

    FQDN -->|resolves_to| IP
    IP -->|belongs_to| NET
    NET -->|member_of| ASN
    ASN -->|owned_by| ORG
    FQDN -->|protected_by| CERT

Visualization Workflow

flowchart LR
    ENUM[amass enum] --> DB[(Graph Database)]
    DB --> VIZ[amass viz]
    VIZ --> D3[D3 HTML]
    VIZ --> DOT[DOT File]
    VIZ --> GEXF[GEXF File]
    D3 --> BROWSER[Browser]
    DOT --> GRAPHVIZ[Graphviz]
    GEXF --> GEPHI[Gephi]

See Also

  • enum - Discover assets
  • subs - Subdomain analysis
  • assoc - Association analysis