GitHub Skill

pivot-on-ioc

Explore GTI relationships for an IOC to discover related entities. Use to expand investigation by finding connected domains, IPs, files, or threat actors. Takes an IOC and relationship types to query.

dandye☆ 89 Étoiles du dépôt23 Forks du dépôt

Voir la source ↗Installation

Installation

Suivez les instructions du dépôt pour votre agent. Consultez les fichiers et dépendances avant l’installation.

Voir la source ↗Guides

Instructions

Pivot on IOC Skill

Explore relationships connected to an IOC within Google Threat Intelligence (GTI) to discover related entities for investigation expansion.

Inputs

IOC_VALUE - The indicator value to pivot from
IOC_TYPE - The type: "IP Address", "Domain", "File Hash", "URL", or "Collection"
RELATIONSHIP_NAMES - List of relationships to query (see table below)

Available Relationships by IOC Type

IOC Type	Common Relationships
IP Address	`communicating_files`, `downloaded_files`, `referrer_files`, `resolutions`
Domain	`resolutions`, `communicating_files`, `downloaded_files`, `subdomains`, `siblings`
File Hash	`contacted_domains`, `contacted_ips`, `contacted_urls`, `dropped_files`, `embedded_domains`
URL	`communicating_files`, `downloaded_files`, `last_serving_ip_address`
Collection	`malware_families`, `attack_techniques`, `threat_actors`, `indicators`

Workflow

Step 1: Select GTI Tool

Based on IOC_TYPE:

IOC Type	Tool
IP Address	`gti-mcp.get_entities_related_to_an_ip_address`
Domain	`gti-mcp.get_entities_related_to_a_domain`
File Hash	`gti-mcp.get_entities_related_to_a_file`
URL	`gti-mcp.get_entities_related_to_an_url`
Collection	`gti-mcp.get_entities_related_to_a_collection`

Step 2: Query Each Relationship

For each relationship in RELATIONSHIP_NAMES:

[selected_tool](
    identifier=IOC_VALUE,
    relationship_name=relationship
)

Store results keyed by relationship name.

Required Outputs

After completing this skill, you MUST report these outputs:

Output	Description
`RELATED_ENTITIES`	Dictionary of entities found per relationship
`EXPANDED_IOCS`	Flattened list of all discovered IOCs (IPs, domains, hashes)
`THREAT_CONTEXT`	Threat actor/campaign context if found during pivoting
`PIVOT_STATUS`	Success/failure status of the pivoting

Example Usage

File Hash Investigation:

IOC_VALUE: "abcdef123456..."
IOC_TYPE: "File Hash"
RELATIONSHIP_NAMES: ["contacted_domains", "contacted_ips", "dropped_files"]

Domain Investigation:

IOC_VALUE: "suspicious-domain.com"
IOC_TYPE: "Domain"
RELATIONSHIP_NAMES: ["resolutions", "communicating_files", "subdomains"]

Exemples

Consultez les exemples du dépôt source.

Voir la source ↗

Historique source

Date d’indexation: 2026-03-11
Mise à jour de l’index: 2026-03-11
Branch: main

Les dates concernent ce répertoire. Consultez le dépôt pour l’historique du code.

GitHub ↗

chat Comments (0)

chat_bubble_outline

No comments yet. Be the first to share your thoughts!