Silk Central-Daten sind gegen unberechtigten Zugriff geschützt. Bevor der Zugriff auf Daten erlaubt wird, müssen Anmeldeinformationen vorgelegt werden. Dies gilt nicht nur für die Arbeit mit dem HTML-Front-End, sondern auch für die Kommunikation mit Silk Central über SOAP- oder REST-API-Aufrufe.
Der erste Schritt beim Abfragen von Daten oder beim Ändern der Konfigurationseinstellungen von Silk Central besteht daher in der Authentifizierung. War die Authentifizierung erfolgreich, wird eine Benutzersitzung generiert, die die Ausführung der nachfolgenden Operationen im Kontext dieser Anmeldung erlaubt.
Wenn über einen Webbrowser auf Silk Central zugegriffen wird, sind die Sitzungsinformationen für den Benutzer nicht sichtbar. Der Browser verwaltet Sitzungsinformationen über Cookies. Im Gegensatz zum Zugriff auf Silk Central über HTML müssen SOAP-Aufrufe diese Sitzungsinformationen manuell verwalten.
Micro Focus empfiehlt die Authentifizierung über ein Webdienst-Token. Ein Webdienst-Token können Sie auf der Seite Benutzereinstellungen der Silk Central-Benutzeroberfläche generieren. Um auf diese Seite zuzugreifen, zeigen Sie mit dem Mauszeiger auf den Benutzernamen im Menü Silk Central und wählen Sie Benutzereinstellungen.
Sie können auch den SOAP-Aufruf logonUser oder den REST-API-Aufruf login zur Authentifizierung verwenden. Der Methodenaufruf gibt eine Sitzungs-ID zurück, die zur Identifizierung der auf dem Server generierten Sitzung und zugleich als Schlüssel für den Zugriff auf Silk Central im Kontext dieser Sitzung dient.
Jeder nachfolgende API-Aufruf, für den eine Authentifizierung erforderlich ist, übernimmt ein Webdienst-Token oder eine Sitzungs-ID als Parameter, prüft deren Gültigkeit und wird im Kontext der entsprechenden Sitzung ausgeführt.
Silk Central-Sitzungen, die über Webdienste generiert werden, können nicht explizit beendet werden. Sie enden stattdessen automatisch, wenn sie für einen bestimmten Zeitraum nicht benutzt werden. Nachdem eine Sitzung durch ein Timeout auf dem Server beendet wurde, lösen nachfolgende SOAP-Aufrufe beim Versuch, auf die Sitzung zuzugreifen, eine Ausnahme aus.
Eine Demo-Anwendung können Sie in Silk Central unter herunterladen. In diesem Demoprojekt wird der tests-Webdienst von Silk Central verwendet, damit Sie die Webdienst-Schnittstelle kennenlernen.
string webServiceToken = "e39a0b5b-45db-42db-84b2-b85028d954d5"; Project[] projects = sccentities.getProjects(webServiceToken);
long sessionID = systemService.logonUser("admin", "admin");
Project[] projects = sccentities.getProjects(sessionID);