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.