CIRCL Passive DNS Operation
The web format of this guide reflects the most current release. Guides for older iterations are available in PDF format.
Integration Details
ThreatQuotient provides the following details for this integration:
Current Integration Version | 1.0.0 |
Compatible with ThreatQ Versions | >= 4.57.2 |
Support Tier | ThreatQ Supported |
Introduction
The CIRCL Passive DNS operation for ThreatQ allows users to query the CIRCL Passive DNS database for selected indicators in the ThreatQ Threat Library.
The operation provides the following action:
- Query CIRCL Passive DNS - queries the Query CIRCL Passive DNS database for FQDN and IP Address indicator sub-types.
The operation is compatible with the following indicator types:
- FQDN
- IP Address
Installation
This integration can be installed in the My Integration section of your ThreatQ instance. See the Adding an Integration topic for more details.
Configuration
ThreatQuotient does not issue API keys for third-party vendors. Contact the specific vendor to obtain API keys and other integration-related credentials.
To configure the integration:
- Navigate to your integrations management page in ThreatQ.
- Select the Operation option from the Type dropdown (optional).
- Click on the integration entry to open its details page.
- Enter the following parameters under the Configuration tab:
Parameter Description Hostname/IP Address of the CIRCL server The hostname or IP address of the Circl instance. The system default is for the cloud offering: global.cloud.Circl.com. Communication Port Optional - Enter the user port used for communication with CIRCL. User Token Your User Token for authentication. Use HTTP Enable this option to use HTTP protocol when connecting to CIRCL. Verify SSL Enable this option to verify the SSL when connecting to CIRCL. - Review any additional settings, make any changes if needed, and click on Save.
- Click on the toggle switch, located above the Additional Information section, to enable it.
Actions
The operation provides the following action:
Action | Description | Object Type | Object Subtype |
---|---|---|---|
Query CIRCL Passive DNS | Query Passive DNS database for the selected indicators. | Indicators | FQDN, IP Address |
Query CIRCL Passive DNS
The Query CIRCL Passive DNS action queries the database for for FQDN and IP Address indicator sub-types.
GET https://<Circl Host>/pdns/query/<indicators>
Sample Response:
{
"count": 6,
"origin": "https://www.circl.lu/pdns/",
"time_first": 1496995637,
"rrtype": "A",
"rrname": "www.threatq.com",
"rdata": "104.196.175.197",
"time_last": 1499951111
}{
"count": 3,
"origin": "https://www.circl.lu/pdns/",
"time_first": 1495523983,
"rrtype": "NS",
"rrname": "threatsketch.com",
"rdata": "dns04.gpn.register.com",
"time_last": 1495533768
}{
"count": 3,
"origin": "https://www.circl.lu/pdns/",
"time_first": 1495523983,
"rrtype": "NS",
"rrname": "threatsketch.com",
"rdata": "dns01.gpn.register.com",
"time_last": 1495533768
}{
"count": 3,
"origin": "https://www.circl.lu/pdns/",
"time_first": 1495523983,
"rrtype": "NS",
"rrname": "threatsketch.com",
"rdata": "dns02.gpn.register.com",
"time_last": 1495533768
}{
"count": 3,
"origin": "https://www.circl.lu/pdns/",
"time_first": 1495523983,
"rrtype": "NS",
"rrname": "threatsketch.com",
"rdata": "dns05.gpn.register.com",
"time_last": 1495533768
}{
"count": 3,
"origin": "https://www.circl.lu/pdns/",
"time_first": 1495523983,
"rrtype": "NS",
"rrname": "threatsketch.com",
"rdata": "dns03.gpn.register.com",
"time_last": 1495533768
}{
"count": 5,
"origin": "https://www.circl.lu/pdns/",
"time_first": 1495523983,
"rrtype": "A",
"rrname": "threatsketch.com",
"rdata": "104.196.175.197",
"time_last": 1495533768
}
ThreatQuotient provides the following default mapping for this feed:
Feed Data Path | ThreatQ Entity | ThreatQ Object Type or Attribute Key | Published Date | Examples |
---|---|---|---|---|
response.rrtype | Indicator | indicator.name.Resource Type | NA | A |
response.rrdata | Indicator | attribute.name.Resource Data | NA | 123.321.156.90 |
Change Log
- Version 1.0.0
- Initial release
PDF Guides
Document | ThreatQ Version |
---|---|
CIRCL Passive DNS Operation Guide v1.0.0 | 4.57.2 or Greater |