10. 11. 2016
Sandro Santinato
NetEye
Einfacher Datenaustausch: Neue SOAP-Schnittstelle in NetEye API
Kürzlich haben wir eine SOAP Schnittstelle in die aktuelle NetEye API integriert, um Ihnen eine einfache Möglichkeit zu bieten Daten zwischen Ihren Systemen und NetEye auszutauschen. Die Kommunikation mit in-house entwickelten Applikationen oder jenen von Drittanbietern, ist nun über eine Web-Schnittstelle möglich. SOAP verwendet XML-basierte Nachrichten, welche über HTTP gesendet werden. Bevor ich nun zu den neuen Funktionen komme, hier ein paar generelle Informationen zu SOAP.
Was ist SOAP?
SOAP ist ein Netzwerkprotokoll für den Austausch von Daten über HTTP. Die Abkürzung SOAP steht für „Simple Object Access Protocol“. Das Protokoll nutzt XML-basierte Nachrichten um Informationen zwischen Client und Server auszutauschen. Client Applikationen können sich ganz einfach mit der SOAP Schnittstelle verbinden und remote Methoden ausführen. Dadurch, dass die Nachrichten in XML geschrieben sind, wird eine Plattform- und Sprach-Unabhängigkeit erreicht, es gibt also keine Kompatibilitätsprobleme.
Verfügbare SOAP Funktionen in NetEye
Die zurzeit verfügbaren SOAP Funktionen für die Kommunikation mit NetEye, betreffen vor allem den Umgang mit Hosts. Sie können wichtige Informationen wie z.B. die Liste aller Hosts, mittels eines SOAP Calls abrufen. Diese Information können Sie dann in der von Ihnen gewünschten Anwendung verwenden. Über den Network Discovery Webservice können Sie Informationen zu IP Adressen und Schnittstellen Ihrer Switches und Router abfragen.
Hier sehen Sie das Beispiel eines SOAP Calls, für die Erstellung eines neuen Hosts in NetEye durch die Spezifizierung verschiedener Informationen:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:net="http://localhost/NetEye/SOAP/Monitoring/Host"> <soapenv:Header/> <soapenv:Body> <net:addHost> <hostname>DNS_Server</hostname> <alias>DNS_Server</alias> <address>10.120.10.11</address> <hosttemplate_id>2</hosttemplate_id> <os>Windows</os> <hostprofile_id>1</hostprofile_id> <hostextinfo_id>1</hostextinfo_id> <host_escalation_id>1</host_escalation_id> <service_escalation_id>1</service_escalation_id> <status>1</status> <comment>Some additional information about the host</comment> </net:addHost> </soapenv:Body> </soapenv:Envelope>
Zusätzlich müssen Sie die URL der SOAP Schnittstelle, welche üblicherweise so aussieht http://neteye/SOAP , und Ihre Login-Parameter anführen.
Hier sehen Sie die Liste aller, aktuell verfügbaren SOAP Funktionen:
- addHostToHostGroup
- deleteHost
- getAllHosts
- setStatusCoordinates
- getHostProfile
- renameHost
- getAllMonitoringGroups
- deleteService
- getSnmpHostInfo
- getSnmpHostInterfacesInfo
Auf Nachfrage können wir gerne weitere SOAP Funktionen hinzufügen.
Sandro Santinato
Developer at Würth Phoenix
Hi, my name is Sandro and I am the youngest member of the Neteye team. I graduated in 2013 in Applied Computer Science at the Free University of Bolzano but I started working as software engineer at Würth-Phoenix already in May 2012. My main competence is the development and improvement of the “Real User Experience” solution.For me computer programming is not just work, but i like scripting and creating my own software also in my free time. Already as a child I was amazed by computers and their technology. So at the age of 12 I bought the book “C for dummies” and started learning programming on my own 🙂 Later on I discovered the open-source world and I started loving it from the first moment.In my free time I also like mountain biking, hiking, and of course playing the trombone in various music bands.
Author
Latest posts by Sandro Santinato
15. 11. 2017
Downloads / Release Notes, NetEye
Updated Package neteye-ocsng-2.1.2_neteye1.0.2-1 (for NetEye 3.11 + 3.10 + 3.9)