Version 11.2 (Geändert)
AUTHENTICATE WEB SERVICE (Name; Kennwort{; AuthMethod})
| Parameter | Typ | Beschreibung | |
| Name | String | Benutzername | |
| Kennwort | String | Benutzerkennwort | |
| AuthMethod | Lange Ganzzahl | Authentifizierungsmethode | |
| 0 = nicht definiert, 1 = BASIC, 2 = DIGEST |
Beschreibung
Der Befehl AUTHENTICATE WEB SERVICE fragt für den Web Service die Authentifizierung der Client Anwendung ab (einfache Authentifizierung). Die Methoden BASIC und DIGEST werden unterstützt. Weitere Informationen dazu finden Sie im Abschnitt Sicherheit der Verbindung.
Die Parameter Name und Kennwort übergeben die erforderliche Information zur Identifikation (Benutzername und Kennwort). Diese Angaben werden verschlüsselt und in der HTTP Anfrage hinzugefügt, welche über den Befehl CALL WEB SERVICE an den Web Service gesendet wird. Zuerst müssen Sie jedoch den Befehl AUTHENTICATE WEB SERVICE aufrufen.
Der optionale Parameter AuthMethode gibt an, welche Authenti-fizierungsmethode für den nächsten Aufruf des Befehls CALL WEB SER-VICE verwendet wird. Es gibt folgende Werte:
2 = Verwende die DIGEST Authentifizierungsmethode
1 = Verwende die BASIC Authentifizierungsmethode
0 (oder Parameter nicht angegeben) = Verwende die am besten geeignete Methode. In diesem Fall sendet 4D eine zusätzliche Anfrage, um die Authentifizierungsmethode abzuklären.
Standardmäßig werden die Angaben zur Authentifizierung nach jeder Anfrage auf Null zurückgesetzt. Deshalb müssen Sie vor dem Aufrufen von CALL WEB SERVICE immer zuerst den Befehl AUTHENTICATE WEB SERVICE verwenden. Mit einer Option des Befehls SET WEB OPTION SERVICE können Sie die Angaben jedoch eine bestimmte Zeitspanne beibehalten. In diesem Fall müssen Sie nicht vor jedem Aufrufen von CALL WEB SERVICE den Befehl AUTHENTICATE WEB SERVICE ausführen.
Schlägt die Authentifizierung fehl, gibt der SOAP Server einen Fehler zurück, den Sie über die Funktion Get Web Service error info herausfinden können.
Referenz
CALL WEB SERVICE, Get Web Service error info.