login_reply
login_reply is an http
response message to the login
service request.
A login_reply response contains secure token and value (sid) in the http response message body. A UMS client application uses the sid in service requests to identify the client session created by the login service request.
A secure token is an unique id combined with its digital signature
generated by UMS. Each secure token is encoded with base64
encoding.
http://en.wikipedia.org/wiki/Base64
http://tools.ietf.org/html/rfc4648
For
the Simple Messaging API, login_reply sets the sid value in
the message body, and also sets the following extension-header
fields:
ums.service: login_reply
ums.mom: openmq
ums.status: 200
For the XML Messaging API, login_reply includes a SOAP
message in the http response message body. The sid value is set to
the sid attribute of the Service element of the SOAP message header.
login_reply sets the following attributes of the message
header:
<ums:Service
ums:service="login_reply"
ums:mom="openmq"
ums:sid="4-LTgxMDczMTczNQ== "
ums:status="200"/>
For both the Simple
Messaging API and the XML Messaging API, a 200 status code indicates
the login service request was successful. All other status
codes indicate the login service request might not be
successful.
1. Simple Messaging API Example:
The following is a login_reply response message.
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
ums.service:
login_reply
ums.mom: openmq
ums.status: 200
Content-Type:
text/plain;charset=UTF-8
Content-Length: 66
Date: Fri, 29 Aug
2008 22:03:58 GMT
4-LTgxMDczMTczNQ==
2.
XML Messaging API Example:
The following is a login_reply response message that includes a SOAP message with Service element attribute values in the header.
HTTP/1.1 200 OK
Server:
Apache-Coyote/1.1
Accept: text/xml, text/html, image/gif,
image/jpeg, *; q=.2, */*; q=.2
Content-Type:
text/xml;charset=utf-8
Transfer-Encoding: chunked
Date: Sat,
23 Aug 2008 01:21:20 GMT
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<ums:MessageHeader
xmlns:ums="https://mq.dev.java.net/ums" ums:id="1.0"
ums:version="1.1">
<ums:Service
ums:service="login_reply"
ums:sid="4-LTgxMDczMTczNQ=="
ums:status="200"/>
ums:mom="openmq"
</ums:MessageHeader>
</SOAP-ENV:Header>
<SOAP-ENV:Body/>
</SOAP-ENV:Envelope>
Back to UMS protocol page.