Previous Topic: loginServiceNext Topic: Implement loginServiceManaged in Java


loginServiceManaged

The following parameters apply to the loginServiceManaged method:

Parameter

Type

Description

policy

String

(Required) Identifies the policy, which must be must be in plain text.

encrypted_policy

String

(Required) Identifies the digital signature of the policy code, encrypted with the policyholder’s private key. It is in BASE64 text format.

Description

Performs the user authentication by locating the policy through the plain text policy code, finding the policyholder’s public key associated with the policy, decrypting the encrypted policy code, matching decrypted content with the policy code, and finally, opening a session with a back-end server. The returned session ID (SID) can be used for subsequent web services method invocations. Proxy contact specified in the policy is responsible for all subsequent web service activities initiated. All function group security and data partition are enforced for the proxy contact defined in the policy.

It is also important to note that the encrypted_policy parameter is in the BASE64 text format, and it is necessary to perform proper conversion from the binary format. The SID should be freed with logout(). A SID may expire if it is not used before a timeout elapses.

Returns

The following is returned:

Parameter

Type

Description

SID

String

Identifies the unique session ID (SID) to use for all other Web Services calls. It is in plain text format.