Die folgenden Authentifizierungsmethoden werden für das Konsumieren von Webservices unterstützt:
-
Authentifzierung mit API Key (nur unterstützt in Kombination mit Azure Relay): Ein dedizierter API Key erstellt auf der ECS Core Management Site wird für die Authentifizierung verwendet. Der API Key muss für das Konsumieren auf einen Windows Benutzer oder Windows-Benutzergruppe erstellt worden sein.
-
Basic Authentifizierung (empfohlen mit HTTPS): Windows Basic Authentication wird zur Authentifizierung verwendet.
-
Windows Authentifizierung (NTLM): Der lokale Windows Benutzer mit seinen Credentials wird zur Authentifizierung verwendet. Das ermöglicht, dass sich der Webservice-Ersteller von jeder Maschine im Active Directory verbinden kann, vorausgesetzt der Account wird auf dem ECS Core Server erkannt.
NTLM kann nur verwendet werden zur Authentifizierung, wenn dies die Client-Anwendung unterstützt.
Die Verbindungseinstellungen für einen Webservice Aufruf werden hier beispielhaft anhand des Postman REST Clients erläutert. Diese Einstellungen können zum Beispiel übertragen werden für REST Service Aufrufe in einer Workflowanwendung (z.B. Flow, Nintex).
Verbindungseinstellungen mit API Key (nur unterstützt mit Azure Relay)
Webservice Methode: POST
Webservice URL: https://[Service Bus Name].servicebus.windows.net/ecs/ws/custom/[Webservice Name]/[Name der Webservice Operation]
Beispiel: https://theobald-proxyservices.servicebus.windows.net/ecs/ws/custom/SAPCustomerWebservice/CustomerGet
Authorization
Type: No Auth
Headers
Authorization: APIKEY [In ECS Core erstellter API Key]
Accept: application/json (XML nicht unterstützt)
Content-Type: application/json (XML nicht unterstützt)
Params: Skalare Eingabeparameter (nur erforderlich, wenn der Webservice solche Parameter enthält; werden automatisch zur URL hinzugefügt)
Body: Listenartige Eingabeparameter oder Eingabestrukturen (nur erforderlich, wenn der Webservice solche Parameter enthält)
Verbindungseinstellungen mit Basic Authentifizierung
Webservice Methode: POST
Webservice URL: http(s)://[ECS Core Server]:[ECS Core Services Site port (Standard 8080)]/wsd/[Webservice Name]/[Name der Webservice Operation]
Beispiel: http://52.88.254.77:8080/wsd/SAPCustomerWebservice/CustomerGet
Authorization
Type: Basic Auth
Username: Windows Benutzername (unterstützt mit Domäne)
Password: Windows Passwort
Headers
Authorization: Basic Schlüssel (Automatisch generiert)
Accept: application/json (XML nicht unterstützt)
Content-Type: application/json (XML nicht unterstützt)
Params: Skalare Eingabeparameter (nur erforderlich, wenn der Webservice solche Parameter enthält; werden automatisch zur URL hinzugefügt)
Body: Listenartige Eingabeparameter oder Eingabestrukturen (nur erforderlich, wenn der Webservice solche Parameter enthält)
Verbindungseinstellungen mit Windows Authentifizierung (NTLM)
Webservice Methode: POST
Webservice URL: http(s)://[lokaler ECS Core Server]:[ECS Core Services Site port (Standard 8080)]/wsd/[Webservice Name]/[Name der Webservice Operation]
Beispiel: http://localhost:8080/wsd/SAPCustomerWebservice/CustomerGet
Authorization
Type: NTLM Authentication
Username: Windows Benutzername
Password: Windows Passwort
Domain (Optional): Domänen-Name
Headers
Authorization: NTLM Schlüssel (Automatisch generiert)
Accept: application/json (XML nicht unterstützt)
Content-Type: application/json (XML nicht unterstützt)
Params: Skalare Eingabeparameter (nur erforderlich, wenn der Webservice solche Parameter enthält; werden automatisch zur URL hinzugefügt)
Body: Listenartige Eingabeparameter oder Eingabestrukturen (nur erforderlich, wenn der Webservice solche Parameter enthält)
