Scripting and automation with the Men & Mice Suite

Scripting!and!automation!with!the

Men!&!Mice!Suite

©!Men!&!Mice!!www.menandmice.com!


Agenda

SOAP!interface!

Script!hooks!

QA


SOAP!interface

Documentation!!

Access

Referencing!objects!(zones,!ranges...)

Filtering


M&M!SOAP!interface!overview

M&M Web Interface / SOAP interface

Script or EXE

XML

M&M Central

1231/tcp

80/443/tcp

M&M protocol

Windows DNS

Windows DHCP

M&M DNS/DHCP ApplianceLinux/Unix DNS

Linux/Unix DHCP

M&M Caching Appliance

M&M protocol

4151/tcp

1337/tcp


M&M!SOAP!XML!call!GetDNSZones

<?xml version='1.0' encoding='utf-8'?><soap:Envelope xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:soap='http://schemas.xmlsoap.org/soap/envelope/'> <soap:Body> <GetDNSZones xmlns='http://menandmice.com/webservices/'> <filter>name:!arpa.$ type:Master</filter> <sortBy>name</sortBy> <sortOrder>Ascending</sortOrder> <offset>0</offset> <limit>150</limit> <session>X0o4PX6Ec0rUNqZcXArA</session> </GetDNSZones> </soap:Body></soap:Envelope>

http://www.w3.org/2001/XMLSchema-instance'

http://www.w3.org/2001/XMLSchema-instance'

http://www.w3.org/2001/XMLSchema'

http://www.w3.org/2001/XMLSchema'

http://schemas.xmlsoap.org/soap/envelope/'




http://menandmice.com/webservices/'

http://menandmice.com/webservices/'


M&M!SOAP!XML!response!GetDNSZones

<?xml version="1.0" encoding="utf-8" ?><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">! <soap:Body>! ! <GetDNSZonesResponse xmlns="http://menandmice.com/webservices/">! ! ! <dnsZones>! ! ! ! <dnsZone>! ! ! ! ! <ref>{#4-#1}</ref>! ! ! ! ! <name>example.com.</name>! ! ! ! ! <dynamic>0</dynamic>! ! ! ! ! <adIntegrated>0</adIntegrated>! ! ! ! ! <dnsViewRef>{#5-#1}</dnsViewRef>! ! ! ! ! <authority>dns.example.com.</authority>! ! ! ! ! <type>Master</type>! ! ! ! ! <dnssecSigned>0</dnssecSigned>! ! ! ! ! <kskIDs />! ! ! ! ! <zskIDs />! ! ! ! ! <customProperties />! ! ! ! </dnsZone>! ! ! </dnsZones>! ! ! <totalResults>1</totalResults>! ! </GetDNSZonesResponse>! </soap:Body></soap:Envelope>

http://schemas.xmlsoap.org/soap/envelope/

http://schemas.xmlsoap.org/soap/envelope/

http://www.w3.org/2001/XMLSchema-instance

http://www.w3.org/2001/XMLSchema-instance

http://www.w3.org/2001/XMLSchema




http://menandmice.com/webservices/

http://menandmice.com/webservices/


M&M!SOAP!Documentation

Online!documentation!(also!User!Guide!and!other!documentation!available):

http://docs.menandmice.com!

Knowledge!base:

http://kb.menandmice.com

M&M!Central!built-in!SOAP!docs:

search!in!the!KB!for:!“soap!documentation”

http://docs.menandmice.com

http://docs.menandmice.com




M&M!SOAP!access!permissions

M&M!access!permissions!are!applied

Necessary!access!bit!in!Tools->Global!Access


M&M!SOAP!client!access

Create!a!SOAP!client!manually!(or!use!some!library,!e.g.!for!Perl!SOAP::Lite!

Use!the!WSDL!URL!to!create!a!proxy!(e.g.!C#!or!Java)

Use!our!SOAP!wrapper!scripts!for!Python!(uses!Suds)!or!Powershell!(!uses!New-

WebServiceProxy)





M&M!SOAP!referencing!objects

1.Human!friendly!version:

[[servername:]viewname:]zonenameExample:

Zone:!example.com.

DNS!Server:!dns.example.com.

on!a!Microsoft!DNS!(=no!view):

“dns.example.com.::example.com.”

2.Machine!friendly!version

“{#objType-#ID in DB}”!Example:

“{#4-#1}”


M&M!SOAP!filter!keywords

“:”!-!Properties!(search!pattern!in!one!column)

“!“!-!AND!(just!a!space)

“|”!-!OR

“^”!-!starts!with

“$”!-!ends!with

“!”!-!not


SOAP!interface!

Script!hooks!

QA

Agenda


Script!hooks

External!scripts

(ScriptRunner!user!account)

Subnet!monitoring!

Script!scheduler!


Q&A

Questions?

Scripting and automation with the Men & Mice Suite

Technology

Transcript of Scripting and automation with the Men & Mice Suite