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:
Table 24.94. 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 |