10. 11. 2016 Sandro Santinato NetEye

Nuova interfaccia SOAP per lo scambio di dati con NetEye

SOAP Interface

Per poter scambiare in modo intuitivo dati tra i vostri sistemi e NetEye, abbiamo introdotto un’interfaccia SOAP nelle API. In questo modo la comunicazione tra NetEye e le vostre applicazioni può avvenire semplicemente attraverso un’interfaccia web. SOAP utilizza messaggi basati su XML, i quali vengono spediti tramite HTTP. Prima di elencare le nuove funzionalità, vorrei darvi alcune informazioni generali per farvi capire meglio le caratteristiche del protocollo SOAP.

Cos’è SOAP?

SOAP è un protocollo per lo scambio di dati tramite HTTP. L’acronimo SOAP sta per “Simple Object Access Protocoll”. Il protocollo usa messaggi basati su XML per scambiare informazioni tra client e server. Applicativi client possono connettersi facilmente con l’interfaccia SOAP e possono così eseguire metodi da remoto. Il fatto che i messaggi sono scritti in XML, rende la comunicazione indipendente dalla piattaforma e dal linguaggio usato.

Funzionalità SOAP disponibili in NetEye

Al momento le funzionalità SOAP disponibili per la comunicazione con NetEye riguardano soprattutto la gestione degli host. Tramite una semplice SOAP call potete richiedere informazioni importanti come per esempio la lista di tutti gli host. Queste informazioni le potete poi utilizzare nei vostri applicativi. Con il network discovery web service potete richiedere informazioni sugli indirizzi IP e sulle interfacce dei vostri switch e router.

Di seguito potete vedere l’esempio di una richiesta SOAP per la creazione di un nuovo host in NetEye tramite la specificazione di diverse informazioni:

<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>

Oltre a questo dovete anche specificare l’URL dell’interfaccia SOAP (solitamente http://neteye/SOAP) e i vostri parametri per il login.

Vi elenco di seguito la lista di tutte le funzioni SOAP che sono attualmente disponibili in NetEye:

  • addHostToHostGroup
  • deleteHost
  • getAllHosts
  • setStatusCoordinates
  • getHostProfile
  • renameHost
  • getAllMonitoringGroups
  • deleteService
  • getSnmpHostInfo
  • getSnmpHostInterfacesInfo

A richiesta possiamo anche aggiungerne altre.

Sandro Santinato

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

Sandro Santinato

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.

Leave a Reply

Your email address will not be published. Required fields are marked *

Archive