setHTTPBasicAuthentication()
Die Systemfunktion 'serviceLib.setHTTPBasicAuthentication()' stellt eine einfache HTTP-Header-Authentifizierung mit 64–Bit-Verschlüsselung bereit.
Die HTTP-Basisauthentifizierung ist ein Transportschichtprotokoll, das beim Aufruf eines Web-Service über HTTP verwendet wird. Das Schlüssel/Wert-Paar im
HTTP-Anforderungsheader besteht aus den folgenden Komponenten:
- Dem Schlüssel "Authorization"
- Dem Wert, einer Zeichenfolge aus "Basic" + base64Encrypt(Benutzer-ID:Kennwort).
Die Funktion 'serviceLib.setHTTPBasicAuthentication()' ist für die folgende Untergruppe von mit EGL geniertem Code verfügbar:
- Java™-Programme und -Services
- z/OS CICS-COBOL-Programme und -Services
Ausführliche Informationen zur CICS-Konfiguration finden Sie unter 'Implementierung eines Web-Service-Anforderers für CICS'.
Syntax
serviceLib.setHTTPBasicAuthentication(Variable Service | Interface in,
BenutzerID STRING in,
Kennwort STRING in)
oder
serviceLib.setHTTPBasicAuthentication(
BenutzerID STRING in,
Kennwort STRING in)
- Variable
- Eine optionale Variable, die Ihr Code für den Zugriff auf den Service verwendet. Bei dieser Variablen handelt es sich um eine Service- oder Schnittstellenvariable. EGL löst eine Ausnahmebedingung vom Typ ServiceBindingException aus, wenn Variable keine Web-Service-Variable ist. Zum Festlegen der Standardwerte für UserID (Benutzer-ID) und Password (Kennwort) für alle Services verwenden Sie die zweite Syntax.
- BenutzerID
- Die ID, die Sie für den Zugriff auf den Service verwenden.
- Kennwort
- Das Kennwort, das Sie für den Zugriff auf den Service verwenden.
Beispiel
Das folgende Beispiel zeigt die Funktion 'setHTTPBasicAuthentication()' im Kontext:
try
serviceLib.setHTTPBasicAuthentication(userID,password); // Standardwert für alle Services festlegen
serviceLib.setHTTPBasicAuthentication(accountServices, //funktioniert nur für 'accountServices' und überschreibt Standardwert
userID, password);
onException(sbe ServiceBindingException)
sysLib.setError(sbe.message);
end
Kompatibilität
| Plattform | Problem |
|---|---|
| COBOL-Generierung | Die Funktion 'setHTTPBasicAuthentication()' wird nur für z/OS CICS unterstützt. |