|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
The Initial Framework interface is used by the client to initiate the authentication with the Framework. This interface shall be implemented by a Framework. The initiateAuthentication() and the initiateAuthenticationWithVersion() methods shall be implemented.
Method Summary | |
org.csapi.jr.se.fw.AuthDomain |
initiateAuthentication(org.csapi.jr.se.fw.AuthDomain clientDomain,
java.lang.String authType)
Deprecated. |
org.csapi.jr.se.fw.AuthDomain |
initiateAuthenticationWithVersion(org.csapi.jr.se.fw.AuthDomain clientDomain,
java.lang.String authType,
java.lang.String frameworkVersion)
This method is invoked by the client to start the process of authentication with the framework, and request the use of a specific authentication method using the new method with support for backward compatibility in the framework. |
Method Detail |
public org.csapi.jr.se.fw.AuthDomain initiateAuthentication(org.csapi.jr.se.fw.AuthDomain clientDomain, java.lang.String authType) throws CommonException, InvalidDomainIdException, InvalidInterfaceTypeException, InvalidAuthTypeException, PlatformException
clientDomain
- This identifies the client domain to the framework, and provides a reference to the domain's authentication interface. structure TpAuthDomain { domainID: TpDomainID; authInterface: IpInterfaceRef; };
The domainID parameter is an identifier either for a client application (that is TpClientAppID) or for an enterprise operator (that is TpEntOpID), or for an instance of a service for which a client application has signed a service agreement (that is TpServiceInstanceID), or for a service supplier (that is TpServiceSupplierID). It is used to identify the client domain to the framework, (see authenticate() on IpAPILevelAuthentication). If the framework does not recognise the domainID, the framework returns an error code (P_INVALID_DOMAIN_ID).
The authInterface parameter is a reference to call the authentication interface of the client. The type of this interface is defined by the authType parameter. If the interface reference is not of the correct type, the framework returns an error code (P_INVALID_INTERFACE_TYPE).authType
- This identifies the type of authentication mechanism requested by the client. It provides operators and clients with the opportunity to use an alternative to the API level Authentication interface, for example an implementation specific authentication mechanism like CORBA Security, using the IpAuthentication interface, or Operator specific Authentication interfaces. OSA API level Authentication is the default authentication mechanism (P_OSA_AUTHENTICATION). If P_OSA_AUTHENTICATION is selected, then the clientDomain and fwDomain authInterface parameters are references to interfaces of type Ip(Client)APILevelAuthentication. If P_AUTHENTICATION is selected, the fwDomain authInterface parameter references to interfaces of type IpAuthentication which is used when an underlying distribution technology authentication mechanism is used.
CommonException
- Defines the structure of the exception class which is applicable to all methods.
InvalidDomainIdException
- Invalid client ID
InvalidInterfaceTypeException
- The interface reference supplied by the client is the wrong type.
InvalidAuthTypeException
- Invalid type of authentication mechanism
PlatformException
- The implementation detected an internal (for example, communication) errorpublic org.csapi.jr.se.fw.AuthDomain initiateAuthenticationWithVersion(org.csapi.jr.se.fw.AuthDomain clientDomain, java.lang.String authType, java.lang.String frameworkVersion) throws CommonException, InvalidDomainIdException, InvalidInterfaceTypeException, InvalidAuthTypeException, InvalidVersionException, PlatformException
clientDomain
- This identifies the client domain to the framework, and provides a reference to the domain's authentication interface. structure TpAuthDomain { domainID: TpDomainID; authInterface: IpInterfaceRef; };
The domainID parameter is an identifier either for a client application (that is TpClientAppID) or for an enterprise operator (that is TpEntOpID), or for an instance of a service for which a client application has signed a service agreement (that is TpServiceInstanceID), or for a service supplier (that is TpServiceSupplierID). It is used to identify the client domain to the framework, (see challenge() on IpAPILevelAuthentication). If the framework does not recognise the domainID, the framework returns an error code (P_INVALID_DOMAIN_ID).
The authInterface parameter is a reference to call the authentication interface of the client. The type of this interface is defined by the authType parameter. If the interface reference is not of the correct type, the framework returns an error code (P_INVALID_INTERFACE_TYPE).authType
- This identifies the type of authentication mechanism requested by the client. It provides operators and clients with the opportunity to use an alternative to the API level Authentication interface, for example an implementation specific authentication mechanism like CORBA Security, using the IpAuthentication interface, or Operator specific Authentication interfaces. OSA API level Authentication is the default authentication mechanism (P_OSA_AUTHENTICATION). If P_OSA_AUTHENTICATION is selected, then the clientDomain and fwDomain authInterface parameters are references to interfaces of type Ip(Client)APILevelAuthentication. If P_AUTHENTICATION is selected, the fwDomain authInterface parameter references to interfaces of type IpAuthentication that is used when an underlying distribution technology authentication mechanism is used.frameworkVersion
- This identifies the version of the Framework implemented in the client. The TpVersion is a String containing the version number. Valid version numbers are defined in the respective framework specification.
CommonException
- Defines the structure of the exception class which is applicable to all methods.
InvalidDomainIdException
- Invalid client ID
InvalidInterfaceTypeException
- The interface reference supplied by the client is the wrong type.
InvalidAuthTypeException
- Invalid type of authentication mechanism
InvalidVersionException
- An invalid version is specified.
PlatformException
- The implementation detected an internal (for example, communication) error
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |