org.eclipse.higgins.rpps.core.impl
Class RppsService

java.lang.Object
  org.eclipse.higgins.rpps.core.impl.RppsService

All Implemented Interfaces:

IRppsService

public class RppsService

extends Object

implements IRppsService

The object used for executing Higgins API and returning the results it produces.

Author:

Sergei Yakovlev, Artem Verkhovets

Nested Class Summary

static class

RppsService.DummyTrustManagerFactory

Field Summary

Fields inherited from interface org.eclipse.higgins.rpps.core.IRppsService

IPasswordCredential, IPinCodeCredential, ITSKerberosV5Credential, ITSSelfIssuedCredential, ITSSelfIssuedNonPinCredential, ITSUsernamePasswordCredential, ITSX509V3Credential, IUsernamePasswordCredential

Constructor Summary

RppsService()

RppsService(String userId, String password)

Method Summary

CategoryTO	addCategory(CategoryTO categoryTO) Creates a new card's category
void	addClaimValuesMRU(String claimType, String claimValue) Adds most recently used record
boolean	addRPEndPointCardRelation(String cuid, RPEndPointTO rpEndPointTO) Methods of storage relation between card and url
boolean	addUrlCardRelation(String cuid, String url) Deprecated.
ResponseMessage	addUserProfile(UserProfileTO userProfile, String password) Creates a new user profile
static void	AllowSelfSignedSSL()
void	authenticate(String userId, String password)
FormatDescriptorTO	checkImportStream(byte[] crd) Checks whether RppsService can recognize data format of the provided input stream.
ICardTO	clearCardCredential(String cuid) Deletes saved authentication card information for specified card
boolean	clearCardHistory(String cuid) Deletes card history of the specified card on all URLs unless it is checked as "Use Always".
static void	ConfigureCache(String configurationBase, String configurationFile)
ICardTO	createDuplicateICard(String cardName, String cuid, String pinCode) Creates duplicate of personal card only with new card's name
ICardTO	createICard(ICardTemplateTO template) Creates a new card by template
String	createICardFromHBX(String cardname) Deprecated.
void	deleteAllICard() Deletes all user's card.
boolean	deleteCardHistoryRecord(String cuid, RPEndPointTO rpEndPointTO) Delete specified record of card history.
boolean	deleteCardHistoryRecord(String cuid, String url) Deprecated.
void	deleteCategory(String categoryId) Delete the card's category
ICardUpdateResponseTO	deleteICard(String cuid) Deletes specified card.
void	deleteOldPassword()
boolean	deleteRPEndPointCardRelation(String cuid, RPEndPointTO rpEndPointTO)
boolean	deleteRPEndPointsCardsRelations(String cuid)
boolean	deleteUrlCardRelation(String cuid, String url) Deprecated.
boolean	deleteUrlsCardsRelations(String cuid) Deprecated.
ResponseMessage	deleteUserProfile() Deletes user profile
ICardTO	editPinCode(String cuid, String oldPinCode, String newPinCode)
byte[]	exportICards(String formatID, String[] cards, UITokenServiceCredentialTO credential)
CardUsageTO[]	getCardHistory(String cuid, int startFrom, int size, String orderBy, String orderDirection)
CardUsageTO[]	getCardHistoryLog(String cuid, int startFrom, int size, String orderBy, String orderDirection)
CardInformationTO	getCardInformation(String cuid, int size)
CategoryTO[]	getCategory()
MapTO[]	getClaimValuesMRU()
CallbackHandler	getHandler()
String	getHigginsServiceGlobalIName() Gets the global i-name registered to the Higgins service (e.g.
ICardTO	getICardByCUID(String cuid) Gets a card by CUID.
ICardTO	getICardByCUIDAndTokenServiceCredential(String cuid, UITokenServiceCredentialTO tokenCredential) Gets a card by CUID and Credential.
UIResponseCardTO	getICardClaims(String cuid, String policy, String typeofCredential, String[] credentialKey, String[] credentialValue) Deprecated.
UIResponseCardTO	getICardClaims(String cuid, String policy, String typeofCredential, String[] credentialKey, String[] credentialValue, RPEndPointTO rpEndPointTO)
ICardTemplateTO[]	getICardCreationTemplate() Return templates for creating cards
org.eclipse.higgins.icard.ICardTemplate[]	getICardCreationTemplateByProvider(String extID)
ICardTemplateTO	getICardCreationTemplateByTUID(String tuid) Return templates for creating cards
org.eclipse.higgins.icard.ICardTemplate	getICardCreationTemplateByTUID(org.eclipse.higgins.icard.TUID tuid) Return templates for creating cards
ICardsAndCategoryTO	getICardsAndCategoriesByUser() Gets the card and category lists of the specified user.
ICardTO[]	getICardsByCUIDs(String[] cuids) Gets cards by CUIDs array.
ICardTO[]	getICardsByFormat(String formatID)
ICardResponseTO	getICardsByUser() Gets the card list of the specified user.
static IRppsService	getInstance() Creates an RppsService object.
static IRppsService	getInstance(String userId, String password) Creates an RppsService object.
FormatDescriptorTO[]	getOutputFormats()
TokenResponseTO	getTokenByClaims(String sslCert, String[] claimName, String[] claimValue) Web service operation.
TokenResponseTO	getTokenByRPEndPoint(String policy, String policytype, String sslCert, RPEndPointTO rpEndPointTO) Web service operation.
TokenResponseTO	getTokenByUrl(String policy, String policytype, String sslCert, String url) Deprecated.
ExtraTokenResponseTO	getTokenExtraByRPEndPoint(String policy, String policytype, String sslCert, RPEndPointTO rpEndPointTO) Web service operation.
ExtraTokenResponseTO	getTokenExtraByUrl(String policy, String policytype, String sslCert, String url) Deprecated.
TokenResponseTO	getTokenObject(String policy, String policytype, String sslCert, String[] cuids, String typeofCredential, String[] credentialKey, String[] credentialValue) Deprecated.
TokenResponseTO	getTokenObject(String policy, String policytype, String sslCert, String[] cuids, String typeofCredential, String[] credentialKey, String[] credentialValue, RPEndPointTO rpEndPointTO) Web service operation.
UIResponseTO	getUserInterface(RPEndPointTO rpEndPointTO, String target, String sslCert, String policytype, String policy) This method takes as input a policy---for example, one that has been retrieved from the Relying Party Agent (called here the 'Requester')---as well as a description of the Requester.
UIResponseTO	getUserInterface(String url, String target, String sslCert, String policytype, String policy) Deprecated.
UserProfileTO	getUserProfile()
ICardResponseTO	importICards(byte[] crd) Imports card from a file.
ICardResponseTO	importICards(byte[] crd, String formatID, UITokenServiceCredentialTO credential) Imports card from a file.
ResponseMessage	modifyCategories(CategoryTO[] categoriesTO)
CategoryTO	modifyCategory(CategoryTO categoryTO)
UserProfileTO	modifyUserProfile(UserProfileTO userProfile) Update user profile
void	removeClaimValuesMRU(String claimType, String claimValue)
ICardTO	resetPinCode(String cuid, String oldPinCode)
static String	resolveUserIdentifier(String privateSelectorINumber)
boolean	setCardCredential(String cuid, UITokenServiceCredentialTO tokenCredential)
void	setHandler(CallbackHandler handler)
void	setNewPrivateUserPassword(String newPassword)
ICardTO	setPinCode(String cuid, String pinCode)
ICardUpdateResponseTO[]	updateClaimsAcrossCards(String[] claimTypes, String[] claimValues, ICardUpdateTO[] cardUpdate) Update claim across cards.
ICardTO	updateICard(ICardTO icardTO) Update card.
ICardUpdateResponseTO[]	updateICards(ICardTO[] icardTOList) Update card.
boolean	userIdentifierExists(String userIdentifier) Checks availability of user profile by userIdentifier

Methods inherited from class java.lang.Object

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

Constructor Detail

RppsService

public RppsService()

RppsService

public RppsService(String userId,
                   String password)
            throws AccessException

Method Detail

AllowSelfSignedSSL

public static void AllowSelfSignedSSL()

ConfigureCache

public static void ConfigureCache(String configurationBase,
                                  String configurationFile)

getInstance

public static IRppsService getInstance()

Creates an RppsService object.

Returns:

the RppsService object

getInstance

public static IRppsService getInstance(String userId,
                                       String password)
                                throws AccessException

Creates an RppsService object.

Returns:

the RppsService object

Throws:

AccessException

resolveUserIdentifier

public static String resolveUserIdentifier(String privateSelectorINumber)

Parameters:

privateSelectorINumber -

Returns:

userIdentifer

addCategory

public CategoryTO addCategory(CategoryTO categoryTO)
                       throws RppsException

Creates a new card's category

Specified by:

addCategory in interface IRppsService

Parameters:

categoryTO - the card category information

Returns:

Returns saved card category object

Throws:

RppsException

addClaimValuesMRU

public void addClaimValuesMRU(String claimType,
                              String claimValue)
                       throws RppsException

Adds most recently used record

Specified by:

addClaimValuesMRU in interface IRppsService

Parameters:

claimType - claim's type

claimValue - claim's value

Throws:

RppsException

addUrlCardRelation

public boolean addUrlCardRelation(String cuid,
                                  String url)
                           throws RppsException,
                                  org.eclipse.higgins.userprofile.UserProfileException

Deprecated.

Methods of storage relation between card and url

Specified by:

addUrlCardRelation in interface IRppsService

Parameters:

cuid -

url -

Returns:

Throws:

RppsException

org.eclipse.higgins.userprofile.UserProfileException

addRPEndPointCardRelation

public boolean addRPEndPointCardRelation(String cuid,
                                         RPEndPointTO rpEndPointTO)
                                  throws RppsException,
                                         org.eclipse.higgins.userprofile.UserProfileException

Methods of storage relation between card and url

Specified by:

addRPEndPointCardRelation in interface IRppsService

Parameters:

cuid -

Returns:

Throws:

RppsException

org.eclipse.higgins.userprofile.UserProfileException

addUserProfile

public ResponseMessage addUserProfile(UserProfileTO userProfile,
                                      String password)
                               throws RppsException

Creates a new user profile

Specified by:

addUserProfile in interface IRppsService

Parameters:

password - the password to identify the user.

userProfile - the userProfile profile information as UserProfileTO

Returns:

Returns ResponseMessage with code field equals 0 if profile was added. Otherwise returns ResponseMessage with error code or throws an RemoteException

Throws:

RppsException

authenticate

public void authenticate(String userId,
                         String password)
                  throws AccessException

Throws:

AccessException

checkImportStream

public FormatDescriptorTO checkImportStream(byte[] crd)
                                     throws RppsException

Checks whether RppsService can recognize data format of the provided input stream. Some formats require authentication information in order to process input data. This method should be used prior to actual attempt to import data from the input stream in order to retrieve an information about data format and required authentication data to process the data successfully.

Specified by:

checkImportStream in interface IRppsService

Parameters:

crd - context of file as byte array

Returns:

the information about input stream data format if it was recognized successfully and null otherwise.

Throws:

RppsException

clearCardCredential

public ICardTO clearCardCredential(String cuid)
                            throws RppsException

Deletes saved authentication card information for specified card

Specified by:

clearCardCredential in interface IRppsService

Parameters:

cuid - the icard's CUID

Returns:

Returns updated card object

Throws:

RppsException

clearCardHistory

public boolean clearCardHistory(String cuid)
                         throws RppsException

Deletes card history of the specified card on all URLs unless it is checked as "Use Always".

Specified by:

clearCardHistory in interface IRppsService

Parameters:

cuid - the icard's CUID

Returns:

Returns true if card history was cleared. Otherwise false

Throws:

RppsException

createDuplicateICard

public ICardTO createDuplicateICard(String cardName,
                                    String cuid,
                                    String pinCode)
                             throws RppsException

Creates duplicate of personal card only with new card's name

Specified by:

createDuplicateICard in interface IRppsService

Parameters:

cardName - new card's name

cuid - the old icard's cuid

pinCode - pinCode for retrieve claims of personal card if that is pin protected. Otherwise null

Returns:

Returns updated card object

Throws:

RppsException

createICard

public ICardTO createICard(ICardTemplateTO template)
                    throws RppsException

Creates a new card by template

Specified by:

createICard in interface IRppsService

Parameters:

template - the icard's template

Returns:

a new card object

Throws:

RemoteException

RppsException

createICardFromHBX

public String createICardFromHBX(String cardname)
                          throws RppsException

Deprecated.

Creates a new card for HBX

Specified by:

createICardFromHBX in interface IRppsService

Parameters:

cardname - the card's name

Returns:

a new card's cuid

Throws:

RppsException

deleteAllICard

public void deleteAllICard()
                    throws RppsException

Deletes all user's card.

Specified by:

deleteAllICard in interface IRppsService

Throws:

RppsException

deleteCardHistoryRecord

public boolean deleteCardHistoryRecord(String cuid,
                                       String url)
                                throws RppsException

Deprecated.

Delete specified record of card history.

Specified by:

deleteCardHistoryRecord in interface IRppsService

Parameters:

cuid - the icard's CUID

url - url of site which will be deleted from card history

Returns:

Returns true if card history record was deleted. Otherwise false

Throws:

RppsException

deleteCardHistoryRecord

public boolean deleteCardHistoryRecord(String cuid,
                                       RPEndPointTO rpEndPointTO)
                                throws RppsException

Delete specified record of card history.

Specified by:

deleteCardHistoryRecord in interface IRppsService

Parameters:

cuid - the icard's CUID

Returns:

Returns true if card history record was deleted. Otherwise false

Throws:

RppsException

deleteCategory

public void deleteCategory(String categoryId)
                    throws RppsException

Delete the card's category

Specified by:

deleteCategory in interface IRppsService

Parameters:

categoryId - category identifier

Throws:

RppsException

deleteICard

public ICardUpdateResponseTO deleteICard(String cuid)
                                  throws RppsException

Deletes specified card.

Specified by:

deleteICard in interface IRppsService

Parameters:

cuid - the icard's CUID

Returns:

Throws:

RppsException

deleteOldPassword

public void deleteOldPassword()
                       throws org.eclipse.higgins.userprofile.UserProfileException

Specified by:

deleteOldPassword in interface IRppsService

Throws:

org.eclipse.higgins.userprofile.UserProfileException

deleteRPEndPointCardRelation

public boolean deleteRPEndPointCardRelation(String cuid,
                                            RPEndPointTO rpEndPointTO)
                                     throws RppsException

Specified by:

deleteRPEndPointCardRelation in interface IRppsService

Throws:

RppsException

deleteUrlCardRelation

public boolean deleteUrlCardRelation(String cuid,
                                     String url)
                              throws RppsException

Deprecated.

Specified by:

deleteUrlCardRelation in interface IRppsService

Parameters:

cuid -

url -

Returns:

Throws:

RppsException

deleteUrlsCardsRelations

public boolean deleteUrlsCardsRelations(String cuid)
                                 throws RppsException

Deprecated.

Specified by:

deleteUrlsCardsRelations in interface IRppsService

Parameters:

cuid -

Returns:

Throws:

RppsException

deleteRPEndPointsCardsRelations

public boolean deleteRPEndPointsCardsRelations(String cuid)
                                        throws RppsException

Specified by:

deleteRPEndPointsCardsRelations in interface IRppsService

Throws:

RppsException

deleteUserProfile

public ResponseMessage deleteUserProfile()
                                  throws RppsException

Deletes user profile

Specified by:

deleteUserProfile in interface IRppsService

Throws:

RppsException

editPinCode

public ICardTO editPinCode(String cuid,
                           String oldPinCode,
                           String newPinCode)
                    throws RppsException

Specified by:

editPinCode in interface IRppsService

Throws:

RppsException

exportICards

public byte[] exportICards(String formatID,
                           String[] cards,
                           UITokenServiceCredentialTO credential)
                    throws RppsException

Specified by:

exportICards in interface IRppsService

Throws:

RppsException

getCardHistory

public CardUsageTO[] getCardHistory(String cuid,
                                    int startFrom,
                                    int size,
                                    String orderBy,
                                    String orderDirection)

Specified by:

getCardHistory in interface IRppsService

getCardHistoryLog

public CardUsageTO[] getCardHistoryLog(String cuid,
                                       int startFrom,
                                       int size,
                                       String orderBy,
                                       String orderDirection)

getCardInformation

public CardInformationTO getCardInformation(String cuid,
                                            int size)
                                     throws RppsException

Specified by:

getCardInformation in interface IRppsService

Parameters:

cuid -

Returns:

Throws:

RppsException

getCategory

public CategoryTO[] getCategory()
                         throws RppsException

Specified by:

getCategory in interface IRppsService

Returns:

Throws:

RppsException

getClaimValuesMRU

public MapTO[] getClaimValuesMRU()
                          throws RppsException

Specified by:

getClaimValuesMRU in interface IRppsService

Throws:

RppsException

getHandler

public CallbackHandler getHandler()

getHigginsServiceGlobalIName

public String getHigginsServiceGlobalIName()

Gets the global i-name registered to the Higgins service (e.g. "=parity").

Specified by:

getHigginsServiceGlobalIName in interface IRppsService

Returns:

the global i-name.

getICardByCUID

public ICardTO getICardByCUID(String cuid)
                       throws RppsException

Gets a card by CUID.

Specified by:

getICardByCUID in interface IRppsService

Parameters:

cuid - the card CUID.

Returns:

the card transfer object.

Throws:

RppsException

getICardByCUIDAndTokenServiceCredential

public ICardTO getICardByCUIDAndTokenServiceCredential(String cuid,
                                                       UITokenServiceCredentialTO tokenCredential)
                                                throws RppsException,
                                                       org.eclipse.higgins.icard.provider.cardspace.common.STSFaultException

Gets a card by CUID and Credential.

Specified by:

getICardByCUIDAndTokenServiceCredential in interface IRppsService

Parameters:

cuid - the card CUID.

tokenCredential - the tokenCredential transfer object

Returns:

the card transfer object.

Throws:

RppsException

org.eclipse.higgins.icard.provider.cardspace.common.STSFaultException

getICardClaims

public UIResponseCardTO getICardClaims(String cuid,
                                       String policy,
                                       String typeofCredential,
                                       String[] credentialKey,
                                       String[] credentialValue)
                                throws RppsException

Deprecated.

Specified by:

getICardClaims in interface IRppsService

Parameters:

cuid -

policy -

typeofCredential -

credentialKey -

credentialValue -

Returns:

Throws:

RppsException

getICardClaims

public UIResponseCardTO getICardClaims(String cuid,
                                       String policy,
                                       String typeofCredential,
                                       String[] credentialKey,
                                       String[] credentialValue,
                                       RPEndPointTO rpEndPointTO)
                                throws RppsException

Specified by:

getICardClaims in interface IRppsService

Throws:

RppsException

getICardCreationTemplate

public ICardTemplateTO[] getICardCreationTemplate()

Return templates for creating cards

Specified by:

getICardCreationTemplate in interface IRppsService

Returns:

a template list

getICardCreationTemplateByProvider

public org.eclipse.higgins.icard.ICardTemplate[] getICardCreationTemplateByProvider(String extID)
                                                                             throws RppsException

Specified by:

getICardCreationTemplateByProvider in interface IRppsService

Throws:

RppsException

getICardCreationTemplateByTUID

public ICardTemplateTO getICardCreationTemplateByTUID(String tuid)
                                               throws RppsException

Return templates for creating cards

Returns:

a template list

Throws:

RppsException

getICardCreationTemplateByTUID

public org.eclipse.higgins.icard.ICardTemplate getICardCreationTemplateByTUID(org.eclipse.higgins.icard.TUID tuid)
                                                                       throws org.eclipse.higgins.icard.CardException

Return templates for creating cards

Returns:

a template list

Throws:

org.eclipse.higgins.icard.CardException

getICardsAndCategoriesByUser

public ICardsAndCategoryTO getICardsAndCategoriesByUser()
                                                 throws RppsException

Gets the card and category lists of the specified user.

Specified by:

getICardsAndCategoriesByUser in interface IRppsService

Returns:

the card list

Throws:

RppsException

getICardsByCUIDs

public ICardTO[] getICardsByCUIDs(String[] cuids)

Gets cards by CUIDs array.

Specified by:

getICardsByCUIDs in interface IRppsService

Parameters:

cuids - the card CUIDs.

Returns:

list of cards transfer object.

getICardsByFormat

public ICardTO[] getICardsByFormat(String formatID)
                            throws RppsException

Specified by:

getICardsByFormat in interface IRppsService

Throws:

RppsException

getICardsByUser

public ICardResponseTO getICardsByUser()

Gets the card list of the specified user.

Specified by:

getICardsByUser in interface IRppsService

Returns:

the card list

getOutputFormats

public FormatDescriptorTO[] getOutputFormats()
                                      throws RppsException

Specified by:

getOutputFormats in interface IRppsService

Throws:

RppsException

getTokenByClaims

public TokenResponseTO getTokenByClaims(String sslCert,
                                        String[] claimName,
                                        String[] claimValue)
                                 throws RppsException

Web service operation. Makes xmlToken usage claim list.

Specified by:

getTokenByClaims in interface IRppsService

Parameters:

sslCert - the SSL certificate

Returns:

the security token transfer object

Throws:

RppsException

getTokenByUrl

public TokenResponseTO getTokenByUrl(String policy,
                                     String policytype,
                                     String sslCert,
                                     String url)
                              throws RppsException

Deprecated.

Web service operation. Makes security token usage saved users information

Specified by:

getTokenByUrl in interface IRppsService

Parameters:

policy - the RP Agent's Relying Party Security Policy

policytype - the RP Security Policy type

sslCert - the SSL certificate

url - the url of site which needs token

Returns:

the security token transfer object

Throws:

RemoteException

RppsException

getTokenByRPEndPoint

public TokenResponseTO getTokenByRPEndPoint(String policy,
                                            String policytype,
                                            String sslCert,
                                            RPEndPointTO rpEndPointTO)
                                     throws RppsException

Web service operation. Makes security token usage saved users information

Specified by:

getTokenByRPEndPoint in interface IRppsService

Parameters:

policy - the RP Agent's Relying Party Security Policy

policytype - the RP Security Policy type

sslCert - the SSL certificate

Returns:

the security token transfer object

Throws:

RemoteException

RppsException

getTokenExtraByRPEndPoint

public ExtraTokenResponseTO getTokenExtraByRPEndPoint(String policy,
                                                      String policytype,
                                                      String sslCert,
                                                      RPEndPointTO rpEndPointTO)
                                               throws RppsException

Web service operation. Makes security token usage saved users information

Specified by:

getTokenExtraByRPEndPoint in interface IRppsService

Parameters:

policy - the RP Agent's Relying Party Security Policy

policytype - the RP Security Policy type

sslCert - the SSL certificate

Returns:

the security token transfer object

Throws:

RemoteException

RppsException

getTokenExtraByUrl

public ExtraTokenResponseTO getTokenExtraByUrl(String policy,
                                               String policytype,
                                               String sslCert,
                                               String url)
                                        throws RppsException

Deprecated.

Web service operation. Makes security token usage saved users information

Specified by:

getTokenExtraByUrl in interface IRppsService

Parameters:

policy - the RP Agent's Relying Party Security Policy

policytype - the RP Security Policy type

sslCert - the SSL certificate

url - the url of site which needs token

Returns:

the security token transfer object

Throws:

RemoteException

RppsException

getTokenObject

public TokenResponseTO getTokenObject(String policy,
                                      String policytype,
                                      String sslCert,
                                      String[] cuids,
                                      String typeofCredential,
                                      String[] credentialKey,
                                      String[] credentialValue,
                                      RPEndPointTO rpEndPointTO)
                               throws RppsException

Web service operation. Given the Relying Party Agent (aka 'Requester')'s policy, identity information about the requester, and the set of one or more selections that the user has just made in the ISS Web UI (see userInterfaceRequest), AND presuming that the protocol involved in interacting with the RPA requires a security token, request the token that corresponds to the user's selection(s).

Specified by:

getTokenObject in interface IRppsService

Parameters:

policy - the RP Agent's Relying Party Security Policy

policytype - the RP Security Policy type

sslCert - the SSL certificate

cuids - the user-selected subset of the UIDs (handles) contained in the UserInterfaceResponse object returned from an earlier invocation of 'userInterfaceRequest'

typeofCredential - the type of selected credential

credentialKey - the names of fields of selected credential

credentialValue - the value of fields of selected credential

Returns:

the security token transfer object

Throws:

RemoteException

RppsException

getTokenObject

public TokenResponseTO getTokenObject(String policy,
                                      String policytype,
                                      String sslCert,
                                      String[] cuids,
                                      String typeofCredential,
                                      String[] credentialKey,
                                      String[] credentialValue)
                               throws RppsException

Deprecated.

Web service operation. Given the Relying Party Agent (aka 'Requester')'s policy, identity information about the requester, and the set of one or more selections that the user has just made in the ISS Web UI (see userInterfaceRequest), AND presuming that the protocol involved in interacting with the RPA requires a security token, request the token that corresponds to the user's selection(s).

Specified by:

getTokenObject in interface IRppsService

Parameters:

policy - the RP Agent's Relying Party Security Policy

policytype - the RP Security Policy type

sslCert - the SSL certificate

cuids - the user-selected subset of the UIDs (handles) contained in the UserInterfaceResponse object returned from an earlier invocation of 'userInterfaceRequest'

typeofCredential - the type of selected credential

credentialKey - the names of fields of selected credential

credentialValue - the value of fields of selected credential

Returns:

the security token transfer object

Throws:

RemoteException

RppsException

getUserInterface

public UIResponseTO getUserInterface(RPEndPointTO rpEndPointTO,
                                     String target,
                                     String sslCert,
                                     String policytype,
                                     String policy)
                              throws RppsException

This method takes as input a policy---for example, one that has been retrieved from the Relying Party Agent (called here the 'Requester')---as well as a description of the Requester. The UserInterfaceResponse object should contain all information necessary to display both (a) a user interface which shares the same card metaphor, sequences of experiences and decision points (the ceremony) of CardSpace and (b) other interface paradigms to be developed in the future

Specified by:

getUserInterface in interface IRppsService

Parameters:

target -

sslCert - the SSL certificate

policy - the RP Agent's Relying Party Security Policy

Returns:

the UIResponseTO transfer object.

Throws:

RemoteException

RppsException

getUserInterface

public UIResponseTO getUserInterface(String url,
                                     String target,
                                     String sslCert,
                                     String policytype,
                                     String policy)
                              throws RppsException

Deprecated.

This method takes as input a policy---for example, one that has been retrieved from the Relying Party Agent (called here the 'Requester')---as well as a description of the Requester. The UserInterfaceResponse object should contain all information necessary to display both (a) a user interface which shares the same card metaphor, sequences of experiences and decision points (the ceremony) of CardSpace and (b) other interface paradigms to be developed in the future

Specified by:

getUserInterface in interface IRppsService

Parameters:

url - the URL to the html page with