Name
uddi_get_authToken — Obtain authentication token.
Syntax
<uddi_get_authToken generic="1.0" xmlns="urn:uddi-org:api" userID="someLoginName" cred="someCredential"> </uddi_get_authToken>
Description
The uddi_get_authToken
message is used to obtain an authentication token. Authentication
tokens are opaque values that are required for all other publisher
API calls. This message is not required for UDDI-enabled servers
that have an external mechanism defined for users to get an
authentication token. This API is provided for implementations that
do not have some other method of obtaining an authentication token
or certificate, or that choose to use password-based
authentication.
Attributes & Children
userID
This required attribute argument is the identifier that an authorized entity was assigned by a UDDI-enabled server. Each UDDI-enabled server provides a way for entities to obtain userids and passwords that are valid only at that server.
cred
This required attribute argument is the password or credential that is associated with the entity.
Return Types
uddi_get_authToken
returns an authToken
message containing a valid authInfo
element usable in subsequent
calls requiring an authInfo
value.
Errors
If an error occurs in processing this message, the server
returns a dispositionReport
structure in a SOAP Fault. The following error information will be
relevant:
Table24.95.Errors signalled by uddi_get_authToken
Error Code | Description |
---|---|
E_unknownUser | signifies that the UDDI-enabled server that received the request does not recognize the userID and/or password argument values passed as credentials |