DNS Audit Tools (Alpha): 

The DNS audit tools perform a simple audit of both forward and reverse DNS. 

The tool set includes UI, API end points, and a command line interface. The audit results include the DNS as found in the 6connect ProVision database, the results from a resolver, and if there is a conflict in these two pieces of information. 


Accessing the Audit Tools: UI

1) Access the UI version of the Tool by going to the desired block in IPAM Manage, click on the Action Menu (wrench), then select "DNS Audit (Alpha):

This takes you to the DNS Audit page for the block.

2) From there, select the "Audit Forward DNS" or "Audit Reverse DNS" buttons to provide a list of IPs, the Reverse Values, Conflict Status, and Resolved Host(s).

Accessing the Audit Tools: API

Access the tools via the API through the use of:

api/v1/auditDNS/execute.php 
api/v1/auditDNS/getStatus.php

Examples: 
api/v1/api.php?target=auditDNS&action=execute&type=forward&block=209.183.188/28&jobId=1424218758 
api/v1/api.php?target=auditDNS&action=execute&type=reverse&block=209.183.188/28&jobId=1424218758 

Audit DNS - Execute

URLapi/v1/api.php?target=auditDNS&action=execute
DescriptionAudits a DNS CIDR block
Returns

Examples:

SUCCESSFUL:{"success":1,"message":"DNS Lookups Started."}
ERROR:{"success":0, "message":"error message"}
Required Parameters
Name
Type
Example
Description
typeSTRINGforwardType of DNS lookup. Valid values are "forward" or "reverse".
blockSTRING209.183.188/28CIDR of the DNS block to audit
jobIdINTEGER1424218758 Job ID
Example URLapi/v1/api.php?target=auditDNS&action=execute&type=forward&block=209.183.188/28&jobId=1424218758 
api/v1/api.php?target=auditDNS&action=execute&type=reverse&block=209.183.188/28&jobId=1424218758 

Audit DNS - getStatus

URLapi/v1/api.php?target=auditDNS&action=getStatus
DescriptionDisplays the audit results table information
Returns

Examples:

SUCCESSFUL:{"state":"Completed","processName":"audit_reverse_dns.php","message":"Lookup process complete.","percentage":"1","processed":"16","processId":"27483","meta":[{"ip":"209.183.0","reverseDNSRecordHost":"ns1.zayo.com.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.0","reverseDNSRecordHost":"ns2.zayo.com.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.2","reverseDNSRecordHost":"6lyco2.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.3","reverseDNSRecordHost":"6lyco3.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.4","reverseDNSRecordHost":"6lyco4.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.5","reverseDNSRecordHost":"6lyco5.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.6","reverseDNSRecordHost":"6lyco6.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.7","reverseDNSRecordHost":"6lyco7.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.8","reverseDNSRecordHost":"6lyco8.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.9","reverseDNSRecordHost":"6lyco9.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.10","reverseDNSRecordHost":"6lyco10.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.11","reverseDNSRecordHost":"6lyco11.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.12","reverseDNSRecordHost":"6lyco12.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.13","reverseDNSRecordHost":"6lyco13.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.14","reverseDNSRecordHost":"6lyco14.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0},{"ip":"209.183.15","reverseDNSRecordHost":"6lyco15.lycoming.edu.","reverseDNSResolvedHosts":[],"conflict":"Yes","resolutionCount":0}]}
ERROR:{"success":0, "message":"error message"}
Required Parameters
Name
Type
Example
Description
blockSTRING209.183.188/28CIDR of the DNS block to audit
jobIdINTEGER1424218758 Job ID.
Example URL/api/v1/api.php?target=auditDNS&action=getStatus&block=209.183.188/28&jobId=1424218758

Accessing the Audit Tools: CLI

To access the Audit Tools via the command line:

For Forward DNS: "php audit_forward_dns.php -b "  plus the CIDR you wish to audit 

Example: 
php audit_forward_dns.php -b 209.183.188/28 

For Reverse DNS: "php audit_reverse_dns.php -b "  plus the CIDR you wish to audit 

Example: 
php audit_reverse_dns.php -b 209.183.188/28 

Additional Information

DNS Audit Tools: Additional File and Example Information

  • UI: 
    audit_dns.php 

    Example: 
    https://cloud.6connect.com/myinstance/audit_dns.php?block=209.183.188.0/28

  • API: 
    Files: 
    api/v1/auditDNS/execute.php 
    api/v1/auditDNS/getStatus.php 

    Examples: 
    api/v1/api.php?target=auditDNS&action=execute&type=forward&block=209.183.188/28&jobId=1424218758 
    api/v1/api.php?target=auditDNS&action=execute&type=reverse&block=209.183.188/28&jobId=1424218758 

  • Command Line: 
    Files: 
    tools/audit_foward_dns.php tools/audit_reverse_dns.php 

    Examples: 
    php audit_forward_dns.php -b 209.183.188/28 
    php audit_reverse_dns.php -b 209.183.188/28 



  • No labels