トークンの使用
トークンを取得すると、要求にトークンを含めることによって、それをSpectrum™ Technology PlatformWeb サービスに対する認証に使用できます。Authorization HTTP ヘッダとして、または Cookie HTTP ヘッダとしての 2 つの方法でこれを実行できます。
注: 1 つのトークンで実行可能な Web サービス要求数に上限はありませんが、有効期限があるトークンを要求した場合、トークンはいずれ失効します。セッション トークンの場合は、操作がない状態が 30 分間続くと無効になります。
Authorization ヘッダにおけるトークンの使用
トークンを HTTP Authorization ヘッダで使用するには、次のフォーマットを使用します。
Authorization: Bearer Token例を次に示します。
HTTP/1.1
POST http://MySpectrumServer:8080/soap/ValidateAddress
Host: MySpectrumServer:8080
Authorization: Bearer eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-woセッション トークンの場合は、セッション識別子も、Cookie ヘッダに次の形式で指定する必要があります。
Cookie: SESSION=SessionID例を次に示します。
HTTP/1.1
POST http://MySpectrumServer:8080/soap/ValidateAddress
Host: MySpectrumServer:8080
Authorization: Bearer eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-wo
Cookie: SESSION=fff96e54-1615-4192-96c1-ea2f133ec6eb注: クッキー名 SESSION はすべて大文字で記述する必要があります。
Cookie ヘッダにおけるトークンの使用
Authorization ヘッダよりもクッキーを使用する方が容易であれば、トークンを Cookie ヘッダに次の形式で指定できます。
Cookie: spectrum.authentication.token=Token例を次に示します。
HTTP/1.1
POST http://MySpectrumServer:8080/soap/ValidateAddress
Host: MySpectrumServer:8080
Cookie: spectrum.authentication.token=eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-woセッション トークンの場合は、セッション識別子も、Cookie ヘッダに次の形式で指定する必要があります。
Cookie: SESSION=SessionID注: クッキー名 SESSION はすべて大文字で記述する必要があります。
例を次に示します。
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