URL to DNS¶

Table of Contents¶

Release Notes
Overview
- Key Features
Installation
Function - URL to DNS
Rules
Troubleshooting & Support

Release Notes¶

Version	Date	Notes
1.1.1	03/2025	Converted example workflows to python3
1.1.0	10/2020	App Host Support
1.0.0	12/2018	Initial Release

Overview¶

Resilient Circuits Components for ‘fn_url_to_dns’

screenshot: URL-to-DNS-workflow

Resilient Circuits Components for ‘fn_url_to_dns’

Key Features¶

Function parses a URL string and returns the DNS component of the string.
Workflow and rule are triggered off an URL artifact and a DNS artifact is created.

Installation¶

Requirements¶

Resilient platform >= 51.0.0
An App Host or an Integration Server:
- To setup up an App Host see: ibm.biz/res-app-host-setup
- An Integration Server running resilient_circuits>=51.0.0 (if using an Integration Server)
  - To set up an Integration Server see: ibm.biz/res-int-server-guide
  - If using an API key account, minimum required permissions are:
    
    Name
    
    Permissions
    
    Org Data
    
    Read
    
    Function
    
    Read
    
    Edit Incidents
    
    Fields
Proxy supported: No (not needed)

Name	Permissions
Org Data	Read
Function	Read
Edit Incidents	Fields

Install¶

To install or uninstall an App using the App Host see ibm.biz/res-install-app
To install or uninstall an Integration using the Integration Server see the ibm.biz/res-install-int

App Configuration¶

No app.config file settings are needed for this integration.

Function - URL to DNS¶

None

screenshot: fn-url-to-dns

Inputs:

Name	Type	Required	Example	Tooltip
`urltodns_url`	`text`	No	`-`	-

Outputs:

results = {
    {
    "version": "1.0",
    "success": true,
    "reason": "",
    "content": {
      "dns": "www.example.com"
    },
    "raw": "",
    "inputs": {
      "urltodns_url": "https://www.example.com/page.html"
    },
    "metrics": {
      "version": "1.0",
      "package": "fn-url-to-dns",
      "package_version": "1.1.1",
      "host": "li-b6f3814c-2cf7-11b2-a85c-95da948e58bf.ibm.com",
      "execution_time_ms": 2,
      "timestamp": "2025-03-25 17:33:50"
    }
  }
}

Example Pre-Process Script:

inputs.urltodns_url = artifact.value

Example Post-Process Script:

if results.success:
  content = results.get('content')
  dns_name = content.get('dns')

  incident.addArtifact("DNS Name", dns_name, "Created from URL")
else:
  incident.addNote("URL to DNS function failed.")

Rules¶

Rule Name	Object	Workflow Triggered
Example: URL to DNS	artifact	`example_url_to_dns`

The screenshot below shows the provided example rule:

¶

Troubleshooting & Support¶

If using the app with an App Host, see the Resilient System Administrator Guide and the App Host Deployment Guide for troubleshooting procedures. You can find these guides on the IBM Knowledge Center, where you can select which version of the Resilient platform you are using.

If using the app with an integration server, see the Integration Server Guide

For Support¶

This is a IBM Community Provided App. Please search the Community https://ibm.biz/resilientcommunity for assistance.