org.apache.juddi.api.impl

Class UDDISecurityImpl

java.lang.Object

org.apache.juddi.api.impl.AuthenticatedService

org.apache.juddi.api.impl.UDDISecurityImpl

All Implemented Interfaces:

Remote, UDDISecurityPortType

public class UDDISecurityImpl
extends AuthenticatedService
implements UDDISecurityPortType

This class implements the UDDI Security Service and basically handles all authentication requests for jUDDI. These authentication requests are routed to the appropriately configured authenticator for validation, then persisted in the database until they either expire or are discarded.

Author:

Jeff Faath (and many others)

Field Summary

Fields

Modifier and Type	Field and Description
static String	AUTH_TOKEN_PREFIX

Fields inherited from class org.apache.juddi.api.impl.AuthenticatedService

AUTHTOKEN_ACTIVE, AUTHTOKEN_RETIRED, baseUrl, baseUrlSSL, ctx, df, UTF8

Constructor Summary

Constructors

Modifier	Constructor and Description
	UDDISecurityImpl()
protected	UDDISecurityImpl(WebServiceContext ctx) used for unit tests only

Method Summary

Modifier and Type	Method and Description
void	discardAuthToken(DiscardAuthToken body) The discard_authToken API call is used to inform a node that the passed authentication token is to be discarded, effectively ending the session.
AuthToken	getAuthToken(GetAuthToken body) The get_authToken API call is used to obtain an authentication token.
AuthToken	getAuthToken(String publisherId)

Methods inherited from class org.apache.juddi.api.impl.AuthenticatedService

getEntityPublisher, getNode, getRequestorsIPAddress, setContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

AUTH_TOKEN_PREFIX

public static final String AUTH_TOKEN_PREFIX

See Also:

Constant Field Values

Constructor Detail

UDDISecurityImpl

public UDDISecurityImpl()

UDDISecurityImpl

protected UDDISecurityImpl(WebServiceContext ctx)

used for unit tests only

Parameters:

ctx -

Method Detail

discardAuthToken

public void discardAuthToken(DiscardAuthToken body)
                      throws DispositionReportFaultMessage

Description copied from interface: UDDISecurityPortType

The discard_authToken API call is used to inform a node that the passed authentication token is to be discarded, effectively ending the session.

Specified by:

discardAuthToken in interface UDDISecurityPortType

Parameters:

body - · authInfo: This required argument is an element that contains an authentication token. Authentication tokens are obtained using the get_authToken API call. Discarding an expired authToken is processed and reported as a success condition.

Throws:

DispositionReportFaultMessage - Upon successful completion, an empty message is returned. See section 4.8 Success and Error Reporting. If an error occurs in processing this API call, a dispositionReport structure will be returned to the caller in a SOAP Fault.

getAuthToken

public AuthToken getAuthToken(GetAuthToken body)
                       throws DispositionReportFaultMessage

Description copied from interface: UDDISecurityPortType

The get_authToken API call is used to obtain an authentication token. An authToken element MAY be required when using the API calls defined in Section 5.1 Inquiry API Set, Section 5.2 Publication API Set, Section 5.4 Custody and Ownership Transfer API Set, and Section 5.5 Subscription API Set.

Specified by:

getAuthToken in interface UDDISecurityPortType

Parameters:

body -

· userID: This required attribute argument is the user identifier that an individual authorized user was assigned by a UDDI node. Nodes SHOULD provide a means for individuals to obtain a userID and password credentials that will be valid at the given node.

· cred: This required attribute argument is the password or credential that is associated with the user.

Returns:

returns org.uddi.api_v3.AuthToken Upon successful completion this API call returns an authToken structure that contains a valid authInfo element that can be used in subsequent calls to API calls that require an authInfo value. The authToken message has the form: The authToken structure contains a single authInfo element that represents a token that is to be passed back in API calls that require one. This structure is always returned as a synchronous response to the get_authToken message.

Throws:

DispositionReportFaultMessage -

If an error occurs in processing this API call, a dispositionReport element will be returned to the caller within a SOAP Fault. In addition to the errors common to all APIs, the following error information is relevant here:

· E_unknownUser: Signifies that the UDDI node that received the request does not accept the userID and/or cred argument values passed as valid credentials.

getAuthToken

public AuthToken getAuthToken(String publisherId)
                       throws DispositionReportFaultMessage

Throws:

DispositionReportFaultMessage