SCCM Manager 3.0
Web Service API

Der WebService stellt eine direkte Schnittstelle zu SCCM dar und kann von Fremdanwendungen genutzt werden.
Weitere Informationen zur Verwendung der Schnittstelle sind in der API-Referenz unter http://www.smcteam.de/help/sccmmanager/3/api-reference/ zu finden.

Wenn die SOAP-Header-Security eingeschaltet ist, kann der Webservice nur mit einem spezifischen SOAP-Header aufgerufen werden. Dieser wird mittels beiliegender .NET-Klassenbibliothek generiert. Außerdem muss ein passender Token erstellt werden. Im folgenden wird diese Konfiguration anhand eines Beispiels erläutert.

Einbindung in Visual Studio

  1. Konfiguration in der Konfigurationsdatei „web.config“ des Webservices (alternativ über den Web Config Editor im Startmenü):



  2. Generierung einer zufälligen GUID und Erweiterung der Datei „Tokens.xml“ im Verzeichnis „Ressources“ des Webservices:



    Der „AssemblyName“ ist frei wählbar und wird später im Webservice-Log neben dem aufrufenden Benutzer angezeigt.

  3. Einbinden der Webservicereferenz in Visual Studio:



  4. Einbinden der Datei „SCCMWebService.Token.dll“ in Visual Studio:
        

       
  5. Instanziierung des Webservices mit dem Soap Header, die übergebene GUID entspricht der zuvor Definierten aus der Datei „Token.xml“:

    SCCMWebService.SCCMWebService sccmWebService = new SCCMWebService.SCCMWebService();
    sccmWebService.Credentials = CredentialCache.DefaultCredentials;

    string sessionID = sccmWebService.GetSessionID();
    string token = WebServiceToken.Create(sessionID, "7d9ac659-a113-4ad1-846f-da64ac42ca7f");

    sccmWebService.SCCMSoapHeaderValue = new SCCMSoapHeader();
    sccmWebService.SCCMSoapHeaderValue.Token = token;

  6. Der Webservice kann nun benutzt werden.