Censys v2
This Integration is part of the Censys Pack.#
Supported versions
Available on Cortex XSOAR (versions 6.0.0 and later) and Cortex XSIAM.
Built on the industry’s most comprehensive Internet Map, the Censys Platform delivers unmatched visibility into global internet assets, adversary infrastructure, and evolving threats. This integration was integrated and tested with version 2.0 of Censys.
Some changes have been made that might affect your existing content. If you are upgrading from a previous of this integration, see Breaking Changes.
Configure Censys v2 in Cortex#
| Parameter | Description | Required |
|---|---|---|
| Server URL | The URL of the Censys API server. | True |
| API Token | Personal Access Token from Censys Platform | True |
| Organization ID | The unique identifier for your Censys organization. | True |
| Trust any certificate (not secure) | False | |
| Use system proxy settings | False | |
| Determine IP score by labels (for paid subscribers) | Censys API provides reputation data exclusively to paid subscribers. When set to True, the integration will use labels to determine the IP score. | False |
| IP Malicious labels | Used only when `Determine IP score by labels` is set. Labels to classify IP as Malicious. Input can be an array or comma-separated values. | False |
| IP Suspicious labels | Used when `Determine IP score by labels` is set. Labels to classify IP as Suspicious. Input can be an array or comma-separated values. | False |
| Malicious labels threshold | Determines the minimum number of labels returned that are classified as malicious for IP. | False |
| Suspicious labels threshold | Determines the minimum number of labels returned that are classified as suspicious for IP. | False |
| Source Reliability | Reliability of the source providing the intelligence data. |
Commands#
You can execute these commands from the CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.
cen-view#
Returns detailed information for an IP address or SHA256 within the specified index.
Base Command#
cen-view
Input#
| Argument Name | Description | Required |
|---|---|---|
| query | The IP address of the requested host. | Required |
| index | The index from which to retrieve data. Possible values are: ipv4, certificates. | Required |
Context Output#
| Path | Type | Description |
|---|---|---|
| Censys.View.autonomous_system.asn | Number | The autonomous system number (ASN) that the host is in. |
| Censys.View.autonomous_system.bgp_prefix | String | The autonomous system's CIDR. |
| Censys.View.autonomous_system.country_code | String | The autonomous system's two-letter, ISO 3166-1 alpha-2 country code (e.g., US, CN, GB, RU). |
| Censys.View.autonomous_system.description | String | A brief description of the autonomous system. |
| Censys.View.autonomous_system.name | String | The friendly name of the autonomous system. |
| Censys.View.dns.names | String | DNS Names. |
| Censys.View.ip | String | The host’s IP address. |
| Censys.View.location.continent | String | The continent of the host's detected location (e.g., North America, Europe, Asia, South America, Africa, Oceania). |
| Censys.View.location.coordinates | Unknown | The estimated coordinates of the host's detected location. |
| Censys.View.location.country | String | The name of the country of the host's detected location. |
| Censys.View.location.country_code | String | The two-letter ISO 3166-1 alpha-2 country code of the host's detected location (e.g., US, CN, GB, RU). |
| Censys.View.location.postal_code | String | The postal code (if applicable) of the host's detected location. |
| Censys.View.location.timezone | String | The IANA time zone database name of the host's detected location. |
| Censys.View.services.dns | Unknown | DNS information. |
| Censys.View.services.port | Number | The port the service was reached at. |
| Censys.View.services.protocol | String | The name of the service on the port. This is typically the L7 protocol (e.g., “HTTP”); however, in the case that a more specific HTTP-based protocol is found (e.g., Kubernetes or Prometheus), the field will show that. This field indicates where protocol-specific data will be located. |
| Censys.View.services.transport_protocol | String | The transport protocol (known in OSI model as L4) used to contact this service (i.e., UDP or TCP). |
| Censys.View.services.banner | String | The banner as a part of the protocol scan. That field will be nested in the protocol-specific data under the service_name field. |
| Censys.View.services.cert | Unknown | A subset of the parsed details of the certificate, including the issuer, subject, fingerprint, names, public keys, and signature. |
| Censys.View.fingerprint_sha256 | String | The SHA2-256 digest over the DER encoding of the certificate. |
| Censys.View.fingerprint_md5 | String | The MD5 digest over the DER encoding of the certificate. |
| Censys.View.fingerprint_sha1 | String | The SHA1 digest over the DER encoding of the certificate. |
| Censys.View.fingerprint_sha256 | String | The SHA2-256 digest over the DER encoding of the certificate. |
| Censys.View.parsed.issuer.common_name | String | Common name. |
| Censys.View.parsed.issuer.country | String | Country name. |
| Censys.View.parsed.issuer.organization | String | Organization name. |
| Censys.View.parsed.issuer_dn | String | Information about the certificate authority that issued the certificate. |
| Censys.View.parsed.serial_number | String | The issuer-specific identifier of the certificate. |
| Censys.View.parsed.signature.signature_algorithm.name | String | Name of signature algorithm, e.g., SHA1-RSA or ECDSA-SHA512. Unknown algorithms get an integer ID. |
| Censys.View.parsed.signature.signature_algorithm.oid | String | The object identifier of the signature algorithm, in dotted-decimal notation. |
| Censys.View.parsed.subject.common_name | String | Common name. |
| Censys.View.parsed.subject.country | String | Country name. |
| Censys.View.parsed.subject.locality | String | Locality name. |
| Censys.View.parsed.subject.organization | String | The name of the organization to which the certificate was issued, if available. |
| Censys.View.parsed.subject.province | String | State of province name. |
| Censys.View.parsed.subject_dn | String | Information about the entity that was issued the certificate. |
| Censys.View.parsed.subject_key_info.fingerprint_sha256 | String | The SHA2-256 digest calculated over the certificate's DER encoding. |
| Censys.View.parsed.subject_key_info.key_algorithm.name | String | Name of public key type, e.g., RSA or ECDSA. |
| IP.Address | String | IP address. |
| IP.ASN | String | The autonomous system name for the IP address, for example: "AS8948". |
| IP.Geo.Location | String | The geolocation where the IP address is located, in the format: latitude:longitude. |
| IP.Geo.Country | String | The country in which the IP address is located. |
| IP.Geo.Description | String | Additional information about the location. |
| IP.ASOwner | String | The autonomous system owner of the IP. |
| DBotScore.Indicator | String | The indicator that was tested. |
| DBotScore.Type | String | The indicator type. |
| DBotScore.Vendor | String | The vendor used to calculate the score. |
| DBotScore.Score | Number | The actual score. |
Command example#
!cen-view index=ipv4 query=8.8.8.8
Context Example#
cen-search#
Return previews of hosts matching a specified search query or a list of certificates that match the given query.
Base Command#
cen-search
Input#
| Argument Name | Description | Required |
|---|---|---|
| query | Query used to search for hosts with matching attributes. Uses the Censys Search Language. | Required |
| page_size | The maximum number of hits to return in each response (minimum of 0, maximum of 100). (Applies for the host search.). Default is 50. | Optional |
| limit | The number of results to return. Default is 50. | Optional |
| index | The index from which to retrieve data. Possible values are: ipv4, certificates. | Required |
| fields | The fields to return. (Applies for the certificates search.). | Optional |
Context Output#
| Path | Type | Description |
|---|---|---|
| Censys.Search.autonomous_system.asn | Number | The autonomous system number (ASN) that the host is in. |
| Censys.Search.autonomous_system.bgp_prefix | String | The autonomous system's CIDR. |
| Censys.Search.autonomous_system.country_code | String | The autonomous system's two-letter, ISO 3166-1 alpha-2 country code (e.g., US, CN, GB, RU). |
| Censys.Search.autonomous_system.description | String | A brief description of the autonomous system. |
| Censys.Search.autonomous_system.name | String | The friendly name of the autonomous system. |
| Censys.Search.ip | String | The host’s IP address. |
| Censys.Search.location.continent | String | The continent of the host's detected location (e.g., North America, Europe, Asia, South America, Africa, Oceania). |
| Censys.Search.location.coordinates | Unknown | The estimated coordinates of the host's detected location. |
| Censys.Search.location.country | String | The country of the host's detected location. |
| Censys.Search.location.country_code | String | The two-letter ISO 3166-1 alpha-2 country code of the host's detected location (e.g., US, CN, GB, RU). |
| Censys.Search.location.timezone | String | The IANA time zone database name of the host's detected location. |
| Censys.Search.services.port | Number | The port the service was reached at. |
| Censys.Search.services.protocol | String | The name of the service on the port. This is typically the L7 protocol (e.g., “HTTP”); however, in case a more specific HTTP-based protocol is found (e.g., Kubernetes or Prometheus), the field will show that. This field indicates where protocol-specific data will be located. |
| Censys.Search.services.transport_protocol | String | The transport protocol (known in OSI model as L4) used to contact this service (i.e., UDP or TCP). |
| Censys.Search.fingerprint_sha256 | String | SHA 256 fingerprint. |
| Censys.Search.parsed.issuer.organization | Unknown | The organization name. |
| Censys.Search.names | Unknown | Common names for the entity. |
| Censys.Search.parsed.subject_dn | String | Distinguished name of the entity that the certificate belongs to. |
| Censys.Search.parsed.validity_period.not_after | Date | Timestamp of when the certificate expires. Time zone is UTC. |
| Censys.Search.parsed.validity_period.not_before | Date | Timestamp of when the certificate is first valid. Time zone is UTC. |
| Censys.Search.parsed.issuer_dn | String | Distinguished name of the entity that has signed and issued the certificate. |
| Censys.Search.parsed.subject.common_name | String | Common name(s) from the certificate subject. |
| Censys.Search.parsed.signature.self_signed | Boolean | Whether the certificate is self-signed. |
| Censys.Search.valid_to | String | Timestamp of when the certificate is valid to. |
| Censys.Search.self_signed | Boolean | Whether the certificate is self-signed. |
Command example#
!cen-search index=certificates query="cert.parsed.issuer.common_name: \"Let's Encrypt\"" limit=1
Context Example#
Human Readable Output#
Search results for query "cert.parsed.issuer.common_name: "Let's Encrypt""#
Issuer Issuer DN SHA256 Subject DN Validity not after Validity not before Let's Encrypt C=US, ST=Let's Encrypt, O=Let's Encrypt, CN=Let's Encrypt Authority X3 0003da4aee3b252097bfc7f871ab6fbe3e08eb94c34ff5cea91aaa29248d3c8b C=AU, ST=Some-State, O=Internet Widgits Pty Ltd 2026-04-15T00:50:59Z 2025-04-15T00:50:59Z
Command example#
!cen-search index=ipv4 query="host.services.protocol:HTTP" limit=1
Context Example#
domain#
Return all related IPs as relationships.
Base Command#
domain
Input#
| Argument Name | Description | Required |
|---|---|---|
| domain | A comma-separated list of domains to check. | Required |
| port | A comma-separated list of ports associated with the domain. Default is 80,443. | Optional |
Context Output#
| Path | Type | Description |
|---|---|---|
| Censys.Domain.location.postal_code | String | The postal code of the location associated with the domain. |
| Censys.Domain.location.province | String | The province name of the location associated with the domain. |
| Censys.Domain.location.country_code | String | The country code of the location associated with the domain. |
| Censys.Domain.location.timezone | String | The time zone of the location associated with the domain. |
| Censys.Domain.location.country | String | The country name of the location associated with the domain. |
| Censys.Domain.location.coordinates.longitude | Number | The longitude coordinate of the location associated with the domain. |
| Censys.Domain.location.coordinates.latitude | Number | The latitude coordinate of the location associated with the domain. |
| Censys.Domain.location.continent | String | The continent name of the location associated with the domain. |
| Censys.Domain.location.city | String | The city name of the location associated with the domain. |
| Censys.Domain.autonomous_system.country_code | String | The country code of the autonomous system associated with the domain. |
| Censys.Domain.autonomous_system.asn | Number | The Autonomous System Number (ASN) associated with the domain. |
| Censys.Domain.autonomous_system.name | String | The name of the autonomous system associated with the domain. |
| Censys.Domain.autonomous_system.bgp_prefix | String | The BGP prefix of the autonomous system associated with the domain. |
| Censys.Domain.autonomous_system.description | String | The description of the autonomous system associated with the domain. |
| Censys.Domain.services.transport_protocol | String | The transport protocol used by the service associated with the domain. |
| Censys.Domain.services.port | Number | The port number associated with the service associated with the domain. |
| Censys.Domain.services.protocol | String | The name of the service associated with the domain. |
| Censys.Domain.services.cert | String | The SSL/TLS certificate associated with the service associated with the domain. |
| Censys.Domain.ip | String | The IP address associated with the domain. |
| Censys.Domain.dns.reverse_dns.names | String | The reverse DNS names associated with the domain. |
| Censys.Domain.hostname | String | The hostname of the web property associated with the domain. |
| Censys.Domain.port | Number | The port number of the web property associated with the domain. |
| Censys.Domain.labels.value | String | Labels associated with the web property. |
| Censys.Domain.threats.name | String | Threat names associated with the web property. |
| Censys.Domain.vulns.id | String | Vulnerability IDs associated with the web property. |
| Censys.Domain.vulns.cvss | Number | CVSS scores for vulnerabilities associated with the web property. |
| Censys.Domain.vulns.severity | String | Severity levels for vulnerabilities associated with the web property. |
| Censys.Domain.software.vendor | String | Software vendors detected on the web property. |
| Censys.Domain.software.product | String | Software products detected on the web property. |
| Censys.Domain.software.version | String | Software versions detected on the web property. |
| Censys.Domain.cert.fingerprint_sha256 | String | SHA-256 fingerprint of the certificate associated with the web property. |
| Censys.Domain.cert.parsed.subject_dn | String | Subject DN of the certificate associated with the web property. |
| Censys.Domain.cert.parsed.issuer_dn | String | Issuer DN of the certificate associated with the web property. |
| Censys.Domain.tls.version_selected | String | TLS version selected for the web property. |
| Censys.Domain.tls.cipher_selected | String | Cipher suite selected for the web property. |
| Censys.Domain.endpoints.endpoint_type | String | Endpoint types associated with the web property. |
| Censys.Domain.endpoints.path | String | Endpoint paths associated with the web property. |
| Censys.Domain.jarm.fingerprint | String | JARM fingerprint of the web property. |
| Censys.Domain.scan_time | String | Scan time for the web property. |
| Domain.Name | string | The domain. |
| Domain.Relationships.EntityA | string | The domain name. |
| Domain.Relationships.EntityAType | string | The entity type. |
| Domain.Relationships.EntityB | string | The entity B. |
| Domain.Relationships.EntityBType | string | The entity B type. |
| Domain.Relationships.Relationship | string | The relationship type. |
| DBotScore.Indicator | unknown | The indicator that was tested. |
| DBotScore.Type | unknown | The indicator type. |
| DBotScore.Score | unknown | The actual score. |
| DBotScore.Vendor | unknown | The vendor used to calculate the score. |
Command example#
!domain domain=amazon.com,google.com
Context Example#
Human Readable Output#
Censys results for Domain amazon.com#
Enriched Web Property Data#
Hostname Port Scan Time Endpoint Types Endpoint Paths Labels Threat Names Vulns Names Vendors Products Versions sha256 Subject DN Issuer DN Common Names Not Before Not After amazon.com 443 2026-03-10T07:52:06Z HTTP / WEB_SERVER, HTTPS OUTDATED_SOFTWARE CVE-2024-11111 f5 nginx 1.18.0 0000000000000000000000000000000000000000000000000000000000000001 CN=example.com C=US, O=Let's Encrypt, CN=R11 example.com 2025-01-03T04:11:45Z 2025-04-03T04:11:44Z Information for IP 8.8.8.8#
ASN Network Protocols Routing Whois Last Updated 15169 GOOGLE - Google LLC 53/DNS, 443/UNKNOWN, 443/HTTP, 853/UNKNOWN 8.8.8.0/24 2023-12-28T00:00:00Z
Command example#
!cen-view index=certificates query=9d3b51a6b80daf76e074730f19dc01e643ca0c3127d8f48be64cf3302f6622cc limit=1
Context Example#
Human Readable Output#
Information for certificate#
Added At Browser Trust Modified At SHA 256 Validated At 1970-01-01T00:00:00Z nss: Invalid,
microsoft: Valid,
apple: Valid,
chrome: Invalid2024-01-23T12:12:35Z 9d3b51a6b80daf76e074730f19dc01e643ca0c3127d8f48be64cf3302f6622cc 2023-09-09T05:55:46Z
cen-search#
Returns previews of hosts matching a specified search query, or a list of certificates that match the given query.
Base Command#
cen-search
Input#
| Argument Name | Description | Required |
|---|---|---|
| query | Query used to search for hosts with matching attributes. Uses the Censys Search Language. | Required |
| page_size | The maximum number of hits to return in each response (minimum of 0, maximum of 100). Default is 50. (Applies for the host search.) | Optional |
| limit | The number of results to return. Default is 50. | Optional |
| index | The index from which to retrieve data. Possible values are: ipv4, certificates. | Required |
| fields | The fields to return. (Applies for the certificates search). | Optional |
| page | The page to return. (Applies for the certificates search). Default is 1. | Optional |
Context Output#
| Path | Type | Description |
|---|---|---|
| Censys.Search.autonomous_system.asn | Number | The autonomous system number (ASN) that the host is in. |
| Censys.Search.autonomous_system.bgp_prefix | String | The autonomous system's CIDR. |
| Censys.Search.autonomous_system.country_code | String | he autonomous system's two-letter, ISO 3166-1 alpha-2 country code (e.g., US, CN, GB, RU). |
| Censys.Search.autonomous_system.description | String | A brief description of the autonomous system. |
| Censys.Search.autonomous_system.name | String | The friendly name of the autonomous system. |
| Censys.Search.ip | String | The host’s IP address. |
| Censys.Search.location.continent | String | The continent of the host's detected location (e.g., North America, Europe, Asia, South America, Africa, Oceania). |
| Censys.Search.location.coordinates | Unknown | The estimated coordinates of the host's detected location. |
| Censys.Search.location.country | String | The country of the host's detected location. |
| Censys.Search.location.country_code | String | The two-letter ISO 3166-1 alpha-2 country code of the host's detected location (e.g., US, CN, GB, RU). |
| Censys.Search.location.registered_country | String | The host's registered country. |
| Censys.Search.location.registered_country_code | String | The registered country's two-letter, ISO 3166-1 alpha-2 country code (e.g., US, CN, GB, RU). |
| Censys.Search.location.timezone | String | The IANA time zone database name of the host's detected location. |
| Censys.Search.services.port | Number | The port the service was reached at. |
| Censys.Search.services.service_name | String | The name of the service on the port. This is typically the L7 protocol (e.g., “HTTP”); however, in the case that a more specific HTTP-based protocol is found (e.g., Kubernetes or Prometheus), the field will show that. This field indicates where protocol-specific data will be located. |
| Censys.Search.services.transport_protocol | String | The transport protocol (known in OSI model as L4) used to contact this service (i.e., UDP or TCP). |
| Censys.Search.parsed.fingerprint_sha256 | String | SHA 256 fingerprint. |
| Censys.Search.parsed.issuer.organization | Unknown | The organization name. |
| Censys.Search.parsed.names | Unknown | Common names for the entity. |
| Censys.Search.parsed.subject_dn | String | Distinguished name of the entity that the certificate belongs to. |
| Censys.Search.parsed.validity.end | Date | Timestamp of when the certificate expires. Time zone is UTC. |
| Censys.Search.parsed.validity.start | Date | Timestamp of when the certificate is first valid. Time zone is UTC. |
| Censys.Search.parsed.issuer_dn | String | Distinguished name of the entity that has signed and issued the certificate. |
Command Example#
!cen-search index=certificates query="parsed.issuer.common_name: \"Let's Encrypt\"" limit=1
Context Example#
Human Readable Output#
Search results for query "parsed.issuer.common_name: "Let's Encrypt""#
Issuer Issuer DN Names SHA256 Subject DN Validity organization: Let's Encrypt C=US, O=Let's Encrypt, CN=Let's Encrypt Authority X3 *.45g4rg43g4fr3434g.gb.net,
45g4rg43g4fr3434g.gb.netf3ade17dffcadd9532aeb2514f10d66e22941393725aa65366ac286df9b442ec CN=45g4rg43g4fr3434g.gb.net start: 2020-10-12T14:46:11Z
end: 2021-01-10T14:46:11Z
ip#
Runs reputation on IPs.
Base Command#
ip
Input#
| Argument Name | Description | Required |
|---|---|---|
| ip | IP address or a list of IP addresses to assess reputation. | Required |
Context Output#
| Path | Type | Description |
|---|---|---|
| Censys.IP.services.port | Number | The port number associated with the service running on the IP. |
| Censys.IP.services.transport_protocol | String | The transport protocol used by the service running on the IP. |
| Censys.IP.services.protocol | String | The name of the service running on the IP. |
| Censys.IP.services.cert | String | The SSL/TLS certificate associated with the service running on the IP. |
| Censys.IP.labels | String | Labels associated with the IP address (with premium access only). |
| Censys.IP.dns.reverse_dns.names | String | Reverse DNS names associated with the IP address. |
| Censys.IP.autonomous_system.country_code | String | The country code of the autonomous system associated with the IP address. |
| Censys.IP.autonomous_system.description | String | Description of the autonomous system associated with the IP address. |
| Censys.IP.autonomous_system.name | String | Name of the autonomous system associated with the IP address. |
| Censys.IP.autonomous_system.bgp_prefix | String | BGP prefix of the autonomous system associated with the IP address. |
| Censys.IP.autonomous_system.asn | Number | Autonomous System Number (ASN) of the autonomous system associated with the IP address. |
| Censys.IP.ip | String | The IP address. |
| Censys.IP.location.country | String | Country name of the location associated with the IP address. |
| Censys.IP.location.timezone | String | Time zone of the location associated with the IP address. |
| Censys.IP.location.province | String | Province name of the location associated with the IP address. |
| Censys.IP.location.coordinates.latitude | Number | Latitude coordinate of the location associated with the IP address. |
| Censys.IP.location.coordinates.longitude | Number | Longitude coordinate of the location associated with the IP address. |
| Censys.IP.location.continent | String | Continent name of the location associated with the IP address. |
| Censys.IP.location.postal_code | String | Postal code of the location associated with the IP address. |
| Censys.IP.location.city | String | City name of the location associated with the IP address. |
| Censys.IP.location.country_code | String | Country code of the location associated with the IP address. |
| Censys.IP.service_count | Number | The total number of services running on the IP address. |
| Censys.IP.services.labels.value | String | Labels associated with services running on the IP address. |
| Censys.IP.services.threats.name | String | Threat names associated with services running on the IP address. |
| Censys.IP.services.vulns | String | Vulnerabilities associated with services running on the IP address. |
| Censys.IP.services.scan_time | String | Scan time for services running on the IP address. |
| Censys.IP.dns.names | String | DNS names associated with the IP address. |
| Censys.IP.dns.forward_dns.names | String | Forward DNS names associated with the IP address. |
| Censys.IP.whois.network.name | String | WHOIS network name associated with the IP address. |
| Censys.IP.whois.network.cidrs | String | WHOIS network CIDR blocks associated with the IP address. |
| IP.Address | unknown | The IP address. |
| IP.ASN | unknown | The IP ASN. |
| IP.Geo.Country | unknown | The IP country. |
| IP.Geo.Location | unknown | The IP location. |
| IP.UpdatedDate | unknown | The IP last update. |
| IP.Port | unknown | The IP port. |
| DBotScore.Indicator | unknown | The indicator that was tested. |
| DBotScore.Type | unknown | The indicator type. |
| DBotScore.Score | Number | The actual score. |
| DBotScore.Reliability | String | Reliability of the source providing the intelligence data. |
| DBotScore.Vendor | unknown | The vendor used to calculate the score. |
Command example#
!ip ip=8.8.8.8,8.8.4.4
Context Example#
Human Readable Output#
Censys results for IP: 8.8.8.8#
Enriched Host Data#
IP Labels Service Count Service Ports Service Protocols Service Transport Protocols Reverse DNS Names Autonomous System Name Autonomous System ASN City Province Postal Code Country Country Code Continent Latitude Longitude 8.8.8.8 database, email, file-sharing, iot, login-page 4 53, 443, 443, 853 DNS, HTTP, UNKNOWN, UNKNOWN UDP, TCP, QUIC, TCP dns.google 15169 Mountain View California 94043 United States US North America 37.4056 -122.0775
cen-host-history-list#
Retrieve the event history for a host (IP address).
Base Command#
cen-host-history-list
Input#
| Argument Name | Description | Required |
|---|---|---|
| host_id | Specify the IP address of a host. | Required |
| start_time | Specify the start time of the host timeline. Supported date formats: 2 minutes, 2 hours, 2 days, 2 weeks, 2 months, 2 years, yyyy-mm-dd, yyyy-mm-ddTHH:MM:SSZ. For example: 01 Jan 2026, 01 Jan 2026 04:45:33, 2026-01-10T14:05:44Z. | Required |
| end_time | Specify the end time of the host timeline. Supported date formats: 2 minutes, 2 hours, 2 days, 2 weeks, 2 months, 2 years, yyyy-mm-dd, yyyy-mm-ddTHH:MM:SSZ. For example: 01 Jan 2026, 01 Jan 2026 04:45:33, 2026-01-10T14:05:44Z. | Required |
Context Output#
| Path | Type | Description |
|---|---|---|
| Censys.HostEventHistory.ip | String | The IP address of the host. |
| Censys.HostEventHistory.total_events | Number | The total number of events associated with the host. |
| Censys.HostEventHistory.partial_data | Boolean | Whether the data is partial or not. |
| Censys.HostEventHistory.events.resource.service_scanned.scan.scan_time | Date | The timestamp when the service scan was performed. |
| Censys.HostEventHistory.events.resource.service_scanned.scan.ip | String | The IP address of the scanned service. |
| Censys.HostEventHistory.events.resource.service_scanned.scan.port | Number | The port number of the scanned service. |
| Censys.HostEventHistory.events.resource.service_scanned.scan.protocol | String | The protocol used by the scanned service. |
| Censys.HostEventHistory.events.resource.service_scanned.scan.transport_protocol | String | The transport protocol used during the service scan. |
| Censys.HostEventHistory.events.resource.service_scanned.scan.is_success | Boolean | Whether the service scan was successful or not. |
| Censys.HostEventHistory.events.resource.service_scanned.scan.mysql.error_code | Number | The MySQL error code returned during the scan. |
| Censys.HostEventHistory.events.resource.service_scanned.scan.mysql.error_id | String | The MySQL error identifier returned during the scan. |
| Censys.HostEventHistory.events.resource.service_scanned.scan.mysql.error_message | String | The MySQL error message returned during the scan. |
| Censys.HostEventHistory.events.resource.forward_dns_resolved.name | String | The domain name resolved from the forward DNS lookup. |
| Censys.HostEventHistory.events.resource.forward_dns_resolved.resolve_time | String | The timestamp when the forward DNS resolution occurred. |
| Censys.HostEventHistory.events.resource.jarm_scanned.diff.additionalProp.new | String | The new value in the JARM scan difference. |
| Censys.HostEventHistory.events.resource.jarm_scanned.diff.additionalProp.old | String | The old value in the JARM scan difference. |
| Censys.HostEventHistory.events.resource.jarm_scanned.scan.cipher_and_version_fingerprint | String | The cipher and version fingerprint from the JARM scan. |
| Censys.HostEventHistory.events.resource.jarm_scanned.scan.fingerprint | String | The JARM fingerprint of the scanned service. |
| Censys.HostEventHistory.events.resource.jarm_scanned.scan.hostname | String | The hostname used in the JARM scan. |
| Censys.HostEventHistory.events.resource.jarm_scanned.scan.ip | String | The IP address scanned by JARM. |
| Censys.HostEventHistory.events.resource.jarm_scanned.scan.is_success | Boolean | Whether the JARM scan was successful or not. |
| Censys.HostEventHistory.events.resource.jarm_scanned.scan.port | Number | The port number scanned by JARM. |
| Censys.HostEventHistory.events.resource.jarm_scanned.scan.scan_time | String | The timestamp when the JARM scan was performed. |
| Censys.HostEventHistory.events.resource.jarm_scanned.scan.tls_extensions_sha256 | String | The SHA-256 hash of the TLS extensions from the JARM scan. |
| Censys.HostEventHistory.events.resource.jarm_scanned.scan.transport_protocol | String | The transport protocol used during the JARM scan. |
| Censys.HostEventHistory.events.resource.location_updated.location.city | String | The city where the host is located. |
| Censys.HostEventHistory.events.resource.location_updated.location.continent | String | The continent where the host is located. |
| Censys.HostEventHistory.events.resource.location_updated.location.coordinates.latitude | Number | The latitude coordinate of the host location. |
| Censys.HostEventHistory.events.resource.location_updated.location.coordinates.longitude | Number | The longitude coordinate of the host location. |
| Censys.HostEventHistory.events.resource.location_updated.location.country | String | The country where the host is located. |
| Censys.HostEventHistory.events.resource.location_updated.location.country_code | String | The country code where the host is located. |
| Censys.HostEventHistory.events.resource.location_updated.location.postal_code | String | The postal code of the host location. |
| Censys.HostEventHistory.events.resource.location_updated.location.province | String | The province or state where the host is located. |
| Censys.HostEventHistory.events.resource.location_updated.location.registered_country | String | The registered country of the host. |
| Censys.HostEventHistory.events.resource.location_updated.location.registered_country_code | String | The registered country code of the host. |
| Censys.HostEventHistory.events.resource.location_updated.location.timezone | String | The timezone of the host location. |
| Censys.HostEventHistory.events.resource.reverse_dns_resolved.names | String | The domain names resolved from the reverse DNS lookup. |
| Censys.HostEventHistory.events.resource.reverse_dns_resolved.resolve_time | String | The timestamp when the reverse DNS resolution occurred. |
| Censys.HostEventHistory.events.resource.route_updated.diff.additionalProp.new | String | The new value in the route update difference. |
| Censys.HostEventHistory.events.resource.route_updated.diff.additionalProp.old | String | The old value in the route update difference. |
| Censys.HostEventHistory.events.resource.route_updated.route.asn | Number | The Autonomous System Number of the route. |
| Censys.HostEventHistory.events.resource.route_updated.route.bgp_prefix | String | The BGP prefix of the route. |
| Censys.HostEventHistory.events.resource.route_updated.route.country_code | String | The country code associated with the route. |
| Censys.HostEventHistory.events.resource.route_updated.route.description | String | The description of the route. |
| Censys.HostEventHistory.events.resource.route_updated.route.name | String | The name of the route. |
| Censys.HostEventHistory.events.resource.route_updated.route.organization | String | The organization associated with the route. |
| Censys.HostEventHistory.events.resource.whois_updated.diff.additionalProp.new | String | The new value in the WHOIS update difference. |
| Censys.HostEventHistory.events.resource.whois_updated.diff.additionalProp.old | String | The old value in the WHOIS update difference. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.network.allocation_type | String | The allocation type of the network in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.network.cidrs | String | The CIDR blocks of the network in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.network.created | String | The creation timestamp of the network in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.network.handle | String | The handle identifier of the network in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.network.name | String | The name of the network in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.network.updated | String | The last update timestamp of the network in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.abuse_contacts.email | String | The email address of the abuse contact in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.abuse_contacts.handle | String | The handle identifier of the abuse contact in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.abuse_contacts.name | String | The name of the abuse contact in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.address | String | The address of the organization in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.admin_contacts.email | String | The email address of the admin contact in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.admin_contacts.handle | String | The handle identifier of the admin contact in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.admin_contacts.name | String | The name of the admin contact in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.city | String | The city of the organization in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.country | String | The country of the organization in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.handle | String | The handle identifier of the organization in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.name | String | The name of the organization in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.postal_code | String | The postal code of the organization in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.state | String | The state or province of the organization in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.street | String | The street address of the organization in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.tech_contacts.email | String | The email address of the technical contact in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.tech_contacts.handle | String | The handle identifier of the technical contact in WHOIS data. |
| Censys.HostEventHistory.events.resource.whois_updated.whois.organization.tech_contacts.name | String | The name of the technical contact in WHOIS data. |
| Censys.HostEventHistory.extensions | String | The extensions associated with the host event history. |
Command example#
!cen-host-history-list host_id=0.0.0.1 start_time="1 week" end_time="1 day"
Context Example#
Human Readable Output#
Successfully retrieved 8 event(s) for host 0.0.0.1#
Host History Events#
Event Time Resource Type Resource Details Link to Censys 2026-03-01T10:00:00.000Z service_scanned 443/TCP/https View historical host on Censys platform 2026-03-01T09:00:00.000Z reverse_dns_resolved example.com View historical host on Censys platform 2026-03-01T08:00:00.000Z endpoint_scanned 8080/http View historical host on Censys platform 2026-03-01T07:00:00.000Z forward_dns_resolved test.example.com View historical host on Censys platform 2026-03-01T06:00:00.000Z jarm_scanned 443/0000000000000000000000000000000000000000000000000000000000001 View historical host on Censys platform 2026-03-01T05:00:00.000Z location_updated San Francisco/United States View historical host on Censys platform 2026-03-01T04:00:00.000Z route_updated 15169/Google LLC View historical host on Censys platform 2026-03-01T03:00:00.000Z whois_updated Example Organization View historical host on Censys platform
cen-rescan#
Initiate a live rescan for a known host service at a specific IP and port (ip:port) or hostname and port (hostname:port).
Base Command#
cen-rescan
Input#
| Argument Name | Description | Required |
|---|---|---|
| ioc_type | Specify the type of IOC. Possible values are: Service, Web Property. Default is Service. | Required |
| ioc_value | Specify the value of IOC. | Required |
| port | Specify the port number associated with the IOC. Default is 443. | Required |
| protocol | Specify the service protocol. Note: This argument is required only if the IOC type is Service. | Optional |
| transport_protocol | Specify the transport protocol. Note: This argument is required only if the IOC type is Service. Possible values are: Unknown, TCP, UDP, ICMP, QUIC. Default is Unknown. | Optional |
Context Output#
| Path | Type | Description |
|---|---|---|
| Censys.Rescan.scan_id | String | The unique identifier for the rescan operation. |
| Censys.Rescan.status | String | The status of the rescan (initiated, in_progress, completed, failed). |
| Censys.Rescan.is_completed | Boolean | Whether the rescan has completed. |
| Censys.Rescan.enrichment_data.ip | String | The IP address of the rescanned host. |
| Censys.Rescan.enrichment_data.service_count | Number | The total number of services detected on the host. |
| Censys.Rescan.enrichment_data.labels | String | Labels associated with the host. |
| Censys.Rescan.enrichment_data.location.continent | String | The continent of the host's detected location. |
| Censys.Rescan.enrichment_data.location.country | String | The name of the country of the host's detected location. |
| Censys.Rescan.enrichment_data.location.country_code | String | The two-letter ISO 3166-1 alpha-2 country code of the host's detected location. |
| Censys.Rescan.enrichment_data.location.city | String | The city of the host's detected location. |
| Censys.Rescan.enrichment_data.location.province | String | The province or state of the host's detected location. |
| Censys.Rescan.enrichment_data.location.postal_code | String | The postal code of the host's detected location. |
| Censys.Rescan.enrichment_data.location.timezone | String | The timezone of the host's detected location. |
| Censys.Rescan.enrichment_data.location.coordinates.latitude | Number | The latitude of the host's detected location. |
| Censys.Rescan.enrichment_data.location.coordinates.longitude | Number | The longitude of the host's detected location. |
| Censys.Rescan.enrichment_data.autonomous_system.asn | Number | The autonomous system number (ASN) that the host is in. |
| Censys.Rescan.enrichment_data.autonomous_system.description | String | A brief description of the autonomous system. |
| Censys.Rescan.enrichment_data.autonomous_system.bgp_prefix | String | The autonomous system's CIDR. |
| Censys.Rescan.enrichment_data.autonomous_system.name | String | The friendly name of the autonomous system. |
| Censys.Rescan.enrichment_data.autonomous_system.country_code | String | The autonomous system's two-letter, ISO 3166-1 alpha-2 country code. |
| Censys.Rescan.enrichment_data.whois.network.handle | String | The WHOIS network handle identifier. |
| Censys.Rescan.enrichment_data.whois.network.name | String | The WHOIS network name. |
| Censys.Rescan.enrichment_data.whois.network.cidrs | String | The WHOIS network CIDRs. |
| Censys.Rescan.enrichment_data.whois.network.created | Date | The creation date of the WHOIS network record. |
| Censys.Rescan.enrichment_data.whois.network.updated | Date | The last update date of the WHOIS network record. |
| Censys.Rescan.enrichment_data.whois.organization.handle | String | The WHOIS organization handle identifier. |
| Censys.Rescan.enrichment_data.whois.organization.name | String | The WHOIS organization name. |
| Censys.Rescan.enrichment_data.whois.organization.address | String | The WHOIS organization address. |
| Censys.Rescan.enrichment_data.whois.organization.abuse_contacts | String | The WHOIS organization abuse contacts. |
| Censys.Rescan.enrichment_data.whois.organization.admin_contacts | String | The WHOIS organization admin contacts. |
| Censys.Rescan.enrichment_data.services | String | List of services detected on the host. |
| Censys.Rescan.enrichment_data.services.port | Number | The port the service was reached at. |
| Censys.Rescan.enrichment_data.services.protocol | String | The name of the service on the port. |
| Censys.Rescan.enrichment_data.services.transport_protocol | String | The transport protocol used to contact this service. |
| Censys.Rescan.enrichment_data.services.software | String | Software identified on the service. |
| Censys.Rescan.enrichment_data.services.software.source | String | The source of the software identification. |
| Censys.Rescan.enrichment_data.services.software.confidence | Number | The confidence level of the software identification. |
| Censys.Rescan.enrichment_data.services.software.part | String | The part classification of the software in CPE format. |
| Censys.Rescan.enrichment_data.services.software.vendor | String | The vendor of the identified software. |
| Censys.Rescan.enrichment_data.services.software.product | String | The product name of the identified software. |
| Censys.Rescan.enrichment_data.services.labels | String | Labels associated with the service. |
| Censys.Rescan.enrichment_data.services.labels.value | String | The value of the service label. |
| Censys.Rescan.enrichment_data.services.threats | String | Threats detected on the service. |
| Censys.Rescan.enrichment_data.services.vulns | String | Vulnerabilities detected on the service. |
| Censys.Rescan.enrichment_data.services.ip | String | The IP address of the service. |
| Censys.Rescan.enrichment_data.services.scan_time | Date | The time when the service was scanned. |
| Censys.Rescan.enrichment_data.services.banner | String | The banner returned by the service. |
| Censys.Rescan.enrichment_data.services.banner_hash_sha256 | String | The SHA-256 hash of the service banner. |
| Censys.Rescan.enrichment_data.services.banner_hex | String | The hexadecimal representation of the service banner. |
| Censys.Rescan.enrichment_data.dns.reverse_dns.resolve_time | Date | The time when reverse DNS was resolved. |
| Censys.Rescan.enrichment_data.dns.names | String | DNS names associated with the host. |
| Censys.Rescan.enrichment_data.dns.forward_dns.names | String | Forward DNS names for the host. |
| Censys.Rescan.enrichment_data.dns.reverse_dns.names | String | Reverse DNS names for the host. |
| IP.Address | String | The IP address. |
| IP.ASN | String | The autonomous system name for the IP address, for example: "AS8948". |
| IP.Geo.Location | String | The geolocation where the IP address is located, in the format: latitude:longitude. |
| IP.Geo.Country | String | The country in which the IP address is located. |
| IP.Geo.Description | String | Additional information about the location. |
| IP.ASOwner | String | The autonomous system owner of the IP. |
| IP.Port | String | Ports that are associated with the IP. |
| IP.Malicious.Vendor | String | The vendor reporting the IP address as malicious. |
| IP.Malicious.Description | String | A description explaining why the IP address was reported as malicious. |
| Domain.Name | String | The domain name, for example: "google.com". |
| Domain.Malicious.Vendor | String | The vendor reporting the domain as malicious. |
| Domain.Malicious.Description | String | A description explaining why the domain was reported as malicious. |
| DBotScore.Indicator | String | The indicator that was tested. |
| DBotScore.Type | String | The indicator type. |
| DBotScore.Vendor | String | The vendor used to calculate the score. |
| DBotScore.Score | Number | The actual score. |
| DBotScore.Reliability | String | Reliability of the source providing the intelligence data. |
Command example#
!cen-rescan ioc_type="Service" ioc_value="0.0.0.1" port="443" protocol="HTTPS" transport_protocol="TCP"
Context Example#
Human Readable Output#
Scan completed successfully for 0.0.0.1:443#
Enriched Host Data#
IP Labels Service Count Service Ports Service Protocols Service Transport Protocols Service Labels Service Vulns Service Threats Service Scan Times DNS Names Forward DNS Names Reverse DNS Names Network Name CIDRs Autonomous System Name Autonomous System ASN City Province Postal Code Country Country Code Continent Latitude Longitude 0.0.0.1 CLOUD_PROVIDER, WEB_SERVER 3 22 SSH tcp REMOTE_ACCESS CVE-2023-12345, CVE-2023-67890 BRUTE_FORCE_ATTACK 2026-02-02T00:46:23Z example.com, www.example.com example.com, www.example.com, mail.example.com host.example.com EXAMPLE LIMITED 0.0.0.1/24 EXAMPLE-AS-AP Example.Co.LTD 12345 Seoul Seoul 03141 South Korea KR Asia 37.566 126.9784
cen-related-infrastructure-list#
Initiate a CensEye (Related Infrastructure) pivot analysis job for a Host, Web Property, or SHA256 Certificate.
Base Command#
cen-related-infrastructure-list
Input#
| Argument Name | Description | Required |
|---|---|---|
| ioc_type | Specify the type of IOC. Possible values are: Host, Web Property, Certificate. Default is Host. | Required |
| ioc_value | Specify the value of IOC. Note: For Web Property IOC type, include the port in the format hostname:port (e.g., example.com:443). | Required |
Context Output#
| Path | Type | Description |
|---|---|---|
| Censys.RelatedInfrastructure.job_id | String | The unique identifier for the related infrastructure job. |
| Censys.RelatedInfrastructure.pivot_data.count | Number | The count of related infrastructure entries for this pivot. |
| Censys.RelatedInfrastructure.pivot_data.field_value_pairs.field | String | The field name of the pivot. |
| Censys.RelatedInfrastructure.pivot_data.field_value_pairs.value | String | The value of the pivot field. |
| Censys.RelatedInfrastructure.status | String | The status of the job (initiated, in_progress, completed, failed). |
| Censys.RelatedInfrastructure.is_completed | Boolean | Whether the job has completed. |
| Censys.RelatedInfrastructure.ioc_value | String | The value of the IOC. |
Command example#
!cen-related-infrastructure-list ioc_type="Host" ioc_value="0.0.0.1"
Context Example#
Human Readable Output#
Job completed successfully for 0.0.0.1#
4 Pivots Data#
Key Value Count See results in Censys host.services.banner_hash_sha256 0000000000000000000000000000000000000000000000000000000000000001 5395 View Pivot Information on Censys platform host.services.endpoints.banner_hash_sha256 0000000000000000000000000000000000000000000000000000000000000001 5395 View Pivot Information on Censys platform host.services.endpoints.http.headers.key
host.services.endpoints.http.headers.valueContent-Type
text/plain36216 View Pivot Information on Censys platform host.services.endpoints.http.headers.key
host.services.endpoints.http.headers.valueConnection
close123620 View Pivot Information on Censys platform