4D Doc Center : WEB SERVICE AUTHENTICATE

Home

4D v14.3

WEB SERVICE AUTHENTICATE


WEB SERVICE AUTHENTICATE ( Name ; Kennwort {; AuthMethode} {; *} )

Parameter	Typ	Beschreibung
Name	String	Benutzername
Kennwort	String	Benutzerkennwort
AuthMethode	Lange Ganzzahl	Authentifizierungsmethode 0 oder weggelassen = nicht spezifiziert, 1 = BASIC, 2 = DIGEST
*	Operator	Mit *: Authentifizierung über Proxy

Beschreibung

Der Befehl WEB SERVICE AUTHENTICATE fragt für den Web Service die Authentifizierung der Client Anwendung ab (einfache Authentifizierung). Die Methoden BASIC und DIGEST, sowie das Vorhandensein eines Proxy 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 WEB SERVICE CALL an den Web Service gesendet wird. Zuerst müssen Sie jedoch den Befehl WEB SERVICE AUTHENTICATE aufrufen.

Der optionale Parameter AuthMethode gibt an, welche Authentifizierungsmethode für den nächsten Aufruf des Befehls WEB SERVICE CALL 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.

Mit dem optionalen Parameter * geben Sie an, dass die Authentifizierungsinformation an einen HTTP Proxy gesendet werden soll.
Diese Konfiguration muss bei einem Proxy integriert werden, der die Authentifizierung zwischen dem Web Service Client und dem Web Service selbst erfordert. Ist der Web Service selbst authentifiziert, ist eine doppelte Authentifizierung erforderlich (siehe Beispiel).

Standardmäßig werden die Angaben zur Authentifizierung nach jeder Anfrage auf Null zurückgesetzt. Deshalb müssen Sie vor dem Aufrufen von WEB SERVICE CALL immer zuerst den Befehl WEB SERVICE AUTHENTICATE verwenden. Mit einer Option des Befehls WEB SERVICE SET OPTION können Sie die Angaben jedoch eine bestimmte Zeitspanne beibehalten. In diesem Fall müssen Sie nicht vor jedem Aufrufen von WEB SERVICE CALL den Befehl WEB SERVICE AUTHENTICATE ausführen.

Schlägt die Authentifizierung fehl, gibt der SOAP Server einen Fehler zurück, den Sie über die Funktion WEB SERVICE Get info herausfinden können.

Beispiel

Authentifizierung mit einen Web Service, der hinter einem Proxy liegt:

  // Authentifizierung für Web Service im DIGEST Modus

 WEB SERVICE AUTHENTICATE("SoapUser";"123";2)

  // Authentifizierung für Proxy im Standardmodus

 WEB SERVICE AUTHENTICATE("ProxyUser";"456";*)

 WEB SERVICE CALL(...)