Whois¶

This package contains one function which provides enrichment information about a domains WHOIS information. Takes in an input of an IP address or URL and then queries for WHOIS info related to this input. Results are saved in a rich text note.

Table of Contents¶

app.config settings:
Function Inputs:
Function Output:
Pre-Process Script:
Post-Process Script:
Rules

History¶

Version	Date	Comment
1.0.3	03/2025	Converted example workflows to python3
1.0.2	Example rule support for DNS names, IP addresses and data presentation changes
1.0.1	App Host support added

note created workflow

app.config settings:¶

If you wish to use the integration with a proxy, this will need to be set in the app.config, otherwise no config values are needed.

whois_https_proxy=https://0.0.0.0:3128/

Function Inputs:¶

Function Name	Type	Required	Example
`whois_query`	`String`	Yes	`'https://www.ibm.com'`

Function Output:¶

results = {
    'inputs': {'whois_query': 'https://www.ibm.com'},
    'success': True,
    'domain_details': {'creation_date': '03/19/1986',
                    'expiration_date': '03/20/2019',
                    'last_updated': '09/18/2018',
                    'name': 'ibm.com',
                    'name_servers': ['ns1-206.akam.net',
                                     'usc3.akam.net',
                                     'eur5.akam.net',
                                     'asia3.akam.net',
                                     'usc2.akam.net',
                                     'usw2.akam.net',
                                     'ns1-99.akam.net',
                                     'eur2.akam.net'],
                    'registrar': 'CSC Corporate Domains, Inc.'},
    'domain_details_keys': ['name',
                         'registrar',
                         'creation_date',
                         'expiration_date',
                         'last_updated',
                         'name_servers'],
    'domain_details_values': ['ibm.com',
                           'CSC Corporate Domains, Inc.',
                           '03/19/1986',
                           '03/20/2019',
                           '09/18/2018',
                           ['ns1-206.akam.net',
                            'usc3.akam.net',
                            'eur5.akam.net',
                            'asia3.akam.net',
                            'usc2.akam.net',
                            'usw2.akam.net',
                            'ns1-99.akam.net',
                            'eur2.akam.net']]
 }

Pre-Process Script:¶

inputs.whois_query = artifact.value

Post-Process Script:¶

This example adds a Note to the Incident.

def expand_list(list_value, separator=", "):
  if not isinstance(list_value, list):
    return list_value
  else:
    return separator.join(list_value)


if results["success"]:
  # We have results
  noteText = """Whois Query ran against input <b>{0}</b><br> Results found: <br>""".format(results.inputs["whois_query"])

  for keyval in zip(results.domain_details_keys,results.domain_details_values):
    if keyval[0] in ['status']:
      expanded_list = expand_list(keyval[1], separator="<br>")
    else:
      expanded_list = expand_list(keyval[1])

    noteText += """<br><b> {0}</b> : {1} """.format(keyval[0].capitalize(), expanded_list)
else:
  noteText = """Whois Query ran against input <b>{0}</b><br> No results found""".format(results.inputs["whois_query"])
incident.addNote(helper.createRichText(noteText))

Rules¶

Rule Name	Object Type	Workflow Triggered
Run Whois Query Against Artifact	`Artifact`	`Example: Whois Query Against Artifact`