Verwenden eines Tokens

Sobald Sie ein Token abgerufen haben, können Sie es zur Authentifizierung auf einem Spectrum™ Technology Platform-Webservice verwenden. Nehmen Sie das Token hierfür in die Anforderung auf. Dafür stehen Ihnen zwei Möglichkeiten zur Verfügung: als HTTP-Header Autorisierung oder als HTTP-Header Cookie.

Anmerkung: Die Anzahl der Webservice-Anforderungen, die Sie mit einem Token senden können, unterliegt keinen Begrenzungen. Wenn Sie jedoch ein Token mit Ablauf angefordert haben, läuft das Token nach einer bestimmten Zeit ab. Wenn es sich bei dem Token um ein Sitzungstoken handelt, wird es nach 30 Minuten der Inaktivität ungültig.

Verwendung des Tokens in einem Autorisierungsheader

Verwenden Sie das Token im HTTP-Header Autorisierung gemäß dem folgenden Format:

Authorization: Bearer Token

Beispiel:

HTTP/1.1

POST http://MySpectrumServer:8080/soap/ValidateAddress
Host: MySpectrumServer:8080
Authorization: Bearer eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-wo

Wenn es sich bei dem Token um ein Sitzungstoken handelt, müssen Sie auch die Sitzungskennung im Header Cookie im folgenden Format angeben:

Cookie: SESSION=SessionID

Beispiel:

HTTP/1.1

POST http://MySpectrumServer:8080/soap/ValidateAddress
Host: MySpectrumServer:8080
Authorization: Bearer eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-wo
Cookie: SESSION=fff96e54-1615-4192-96c1-ea2f133ec6eb
Anmerkung: Der Cookie-Name SESSION muss in Großbuchstaben angegeben werden.

Verwendung des Tokens in einem Cookie-Header

Wenn Sie aus Vereinfachungsgründen statt eines Cookie-Headers einen Autorisierungsheader verwenden, können Sie das Token im folgenden Format im Cookie-Header angeben:

Cookie: spectrum.authentication.token=Token

Beispiel:

HTTP/1.1

POST http://MySpectrumServer:8080/soap/ValidateAddress
Host: MySpectrumServer:8080
Cookie: spectrum.authentication.token=eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-wo

Wenn es sich bei dem Token um ein Sitzungstoken handelt, müssen Sie auch die Sitzungskennung im Header Cookie im folgenden Format angeben:

Cookie: SESSION=SessionID
Anmerkung: Der Cookie-Name SESSION muss in Großbuchstaben angegeben werden.

Beispiel:

HTTP/1.1

POST http://MySpectrumServer:8080/soap/ValidateAddress
Host: MySpectrumServer:8080
Cookie: spectrum.authentication.token=eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-wo
Cookie: SESSION=fff96e54-1615-4192-96c1-ea2f133ec6eb