Date post: | 30-May-2015 |
Category: |
Technology |
Upload: | men-and-mice |
View: | 250 times |
Download: | 0 times |
Scripting!and!automation!with!the
Men!&!Mice!Suite
©!Men!&!Mice!!www.menandmice.com!
©!Men!&!Mice!!www.menandmice.com!
Agenda
SOAP!interface!
Script!hooks!
QA
©!Men!&!Mice!!www.menandmice.com!
SOAP!interface
Documentation!!
Access
Referencing!objects!(zones,!ranges...)
Filtering
©!Men!&!Mice!!www.menandmice.com!
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
©!Men!&!Mice!!www.menandmice.com!
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>
©!Men!&!Mice!!www.menandmice.com!
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>
©!Men!&!Mice!!www.menandmice.com!
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”
©!Men!&!Mice!!www.menandmice.com!
M&M!SOAP!access!permissions
M&M!access!permissions!are!applied
Necessary!access!bit!in!Tools->Global!Access
©!Men!&!Mice!!www.menandmice.com!
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)
http://kb.menandmice.com
©!Men!&!Mice!!www.menandmice.com!
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}”
©!Men!&!Mice!!www.menandmice.com!
M&M!SOAP!filter!keywords
“:”!-!Properties!(search!pattern!in!one!column)
“!“!-!AND!(just!a!space)
“|”!-!OR
“^”!-!starts!with
“$”!-!ends!with
“!”!-!not
©!Men!&!Mice!!www.menandmice.com!
SOAP!interface!
Script!hooks!
QA
Agenda
©!Men!&!Mice!!www.menandmice.com!
Script!hooks
External!scripts
(ScriptRunner!user!account)
Subnet!monitoring!
Script!scheduler!
©!Men!&!Mice!!www.menandmice.com!
Q&A
Questions?