org.eclipse.higgins.rpps.webservices
Interface RPPSServiceSEI

All Superinterfaces:
Remote
All Known Implementing Classes:
RPPSServiceImpl

public interface RPPSServiceSEI
extends Remote

This is the service endpoint interface for the RPPSServiceweb service. Created 18.01.2007 10:34:54

Author:
Sergei Yakovlev

Method Summary
 org.eclipse.higgins.rpps.core.tobj.CategoryTO addCategory(String userId, String password, org.eclipse.higgins.rpps.core.tobj.CategoryTO category)
           
 org.eclipse.higgins.rpps.core.tobj.CardInformationTO addUrlCardRelation(String userId, String password, String cuid, String url)
           
 org.eclipse.higgins.rpps.core.tobj.ResponseMessage addUserProfile(String userId, String password, org.eclipse.higgins.rpps.core.tobj.UserProfileTO userProfile)
           
 void addUserProfileFromHBX(String userId, String password)
           
 org.eclipse.higgins.rpps.core.tobj.CardInformationTO clearCardCredential(String userId, String password, String cuid)
           
 org.eclipse.higgins.rpps.core.tobj.CardInformationTO clearCardHistory(String userId, String password, String cuid)
           
 void connectionNotify(String userId, String password, String host, String username, boolean success)
          Web service operation Locate the URIICard-type I-Card whose URI matches 'cref'.
 boolean connectionVerify(String userId, String password, String host, String username)
          The RP site invokes this method to verify that user really has an account on the specified site.
 org.eclipse.higgins.rpps.core.tobj.ICardTO createDuplicateICard(String userId, String password, String cardName, String cuid, String pinCode)
           
 String createICardByArrayProperties(String userId, String password, String id, String[] properties)
          Web service operation creating a new card
 String createICardByProperty(String userId, String password, String id, String properties)
          Web service operation creating a new card
 org.eclipse.higgins.rpps.core.tobj.ICardTO createICardByTemplate(String userId, String password, org.eclipse.higgins.rpps.core.tobj.ICardTemplateTO template)
          Web service operation creating a new card
 String createICardFromHBX(String userId, String password, String cardname)
          Web service operation creating a new card for HBX
 void deleteAllICard(String userId, String password)
          Web service operation.
 void deleteCategory(String userId, String password, String categoryId)
           
 void deleteICard(String userId, String password, String cuid)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.CardInformationTO deleteUrlCardRelation(String userId, String password, String cuid, String url)
           
 org.eclipse.higgins.rpps.core.tobj.CardInformationTO deleteUrlsCardRelation(String userId, String password, String cuid, String[] urls)
           
 org.eclipse.higgins.rpps.core.tobj.ResponseMessage deleteUserProfile(String userId, String password)
           
 org.eclipse.higgins.rpps.core.tobj.ICardTO editPinCode(String userId, String password, String cuid, String oldPinCode, String newPinCode)
           
 org.eclipse.higgins.rpps.core.tobj.CardInformationTO getCardInformation(String userId, String password, String cuid)
           
 org.eclipse.higgins.rpps.core.tobj.CategoryTO[] getCategory(String userId, String password)
           
 String getFormFillingScript(String page, String username, String form)
          Gets a form filling script for the specified site&user
 String[] getHBXUIList(String version, String windowsName)
           
 String getHigginsServiceGlobalIName()
          Web service operation.
 String getHtmlScrapingScript(String page)
          Gets an HTML scraping script for the specified site
 org.eclipse.higgins.rpps.core.tobj.ICardTO getICardById(String userId, String password, String cuid)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.ICardTO getICardByIdAndTokenServiceCredential(String userId, String password, String cuid, org.eclipse.higgins.rpps.core.tobj.UITokenServiceCredentialTO userCredintial)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.ICardTemplateTO[] getICardCreationTemplate(String userId, String password)
          Web service operation creating a new card
 org.eclipse.higgins.rpps.core.tobj.ICardTO[] getICards(String userId, String password)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.ICardsAndCategoryTO getICardsAndCategoriesByUser(String userId, String password)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.ICardTemplateTO getPersonalICardCreationTemplate(String userId, String password)
          Return templates for creating personal card
 String[] getRandomWordList(int count)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.TokenResponseTO getTokenByClaims(String sslCert, String claimNameArray, String claimValueArray)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.TokenResponseTO getTokenByUrl(String userId, String password, String policy, String policytype, String sslCert, String url)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.ExtraTokenResponseTO getTokenExtraByUrl(String userId, String password, String policy, String policytype, String sslCert, String url)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.TokenResponseTO getTokenObject(String userId, String password, String policy, String policytype, String sslCert, String[] cuids, String typeofCredential, String[] credentialKey, String[] credentialValue)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.UIResponseTO getUI(String userId, String password, String url, String target, String sslCert, String policytype, String policy)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.UserProfileTO getUserProfile(String userId, String password)
           
 org.eclipse.higgins.rpps.core.tobj.ICardTO[] importICardAsByteArray(String userId, String password, byte[] crd)
          Web service operation.
 void importICardsAsString(String userId, String password, String crd)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.CategoryTO modifyCategory(String userId, String password, org.eclipse.higgins.rpps.core.tobj.CategoryTO category)
           
 org.eclipse.higgins.rpps.core.tobj.UserProfileTO modifyUserProfile(String userId, String password, org.eclipse.higgins.rpps.core.tobj.UserProfileTO userProfile)
           
 org.eclipse.higgins.rpps.core.tobj.ICardTO resetPinCode(String userId, String password, String cuid, String oldPinCode)
           
 void setHtmlScrapingScript(String page, String script)
          Sets an HTML scraping script for the specified site
 org.eclipse.higgins.rpps.core.tobj.ICardTO setPinCode(String userId, String password, String cuid, String pinCode)
           
 String[] testStringArray(String[] strArray)
          Web service operation.
 org.eclipse.higgins.rpps.core.tobj.ICardTO updateICard(String userId, String password, org.eclipse.higgins.rpps.core.tobj.ICardTO icardTO)
          Web service operation
 boolean userIdentifierExists(String userId)
           
 

Method Detail

createICardByProperty

public String createICardByProperty(String userId,
                                    String password,
                                    String id,
                                    String properties)
                             throws RemoteException
Web service operation creating a new card

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
id - the i-card id
properties - the i-card properties
Returns:
a new card cuid
Throws:
RemoteException

createICardByArrayProperties

public String createICardByArrayProperties(String userId,
                                           String password,
                                           String id,
                                           String[] properties)
                                    throws RemoteException
Web service operation creating a new card

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
id - the i-card id
properties - the i-card properties
Returns:
a new card cuid
Throws:
RemoteException

createICardByTemplate

public org.eclipse.higgins.rpps.core.tobj.ICardTO createICardByTemplate(String userId,
                                                                        String password,
                                                                        org.eclipse.higgins.rpps.core.tobj.ICardTemplateTO template)
                                                                 throws RemoteException
Web service operation creating a new card

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
Returns:
a new card cuid
Throws:
RemoteException

createICardFromHBX

public String createICardFromHBX(String userId,
                                 String password,
                                 String cardname)
                          throws RemoteException
Web service operation creating a new card for HBX

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
Returns:
a new card cuid
Throws:
RemoteException

createDuplicateICard

public org.eclipse.higgins.rpps.core.tobj.ICardTO createDuplicateICard(String userId,
                                                                       String password,
                                                                       String cardName,
                                                                       String cuid,
                                                                       String pinCode)
                                                                throws RemoteException
Parameters:
userId - the id to identify the user.
password - the password to identify the user.
cardName - name of new card
cuid - cuid of old card
Returns:
a new card
Throws:
RemoteException

getICardCreationTemplate

public org.eclipse.higgins.rpps.core.tobj.ICardTemplateTO[] getICardCreationTemplate(String userId,
                                                                                     String password)
                                                                              throws RemoteException
Web service operation creating a new card

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
Returns:
a template list
Throws:
RemoteException

connectionNotify

public void connectionNotify(String userId,
                             String password,
                             String host,
                             String username,
                             boolean success)
                      throws RemoteException
Web service operation Locate the URIICard-type I-Card whose URI matches 'cref'. If no such card exists, create it. Find the Digital Subject whose unique identifier is 'cuid'. On the uniqueIdentifier attribute value itself: (1) if 'success' is true, add/update to "now" the the lastVerifiedFromSource metadata property's timestamp and (2) add/update the lastVerifiedAttempt metadata property's timestamp to "now".

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
host - the host name of the RP site where user is verified
username - the user name to login to the RP site
success - the verifying result
Throws:
RemoteException

getFormFillingScript

public String getFormFillingScript(String page,
                                   String username,
                                   String form)
                            throws RemoteException
Gets a form filling script for the specified site&user

Parameters:
page - the page url where user lands on
username - the user name
form - the HTML form name
Returns:
a form filling script
Throws:
RemoteException

getHtmlScrapingScript

public String getHtmlScrapingScript(String page)
                             throws RemoteException
Gets an HTML scraping script for the specified site

Parameters:
page - the page url
Returns:
an HTML scraping script
Throws:
RemoteException

setHtmlScrapingScript

public void setHtmlScrapingScript(String page,
                                  String script)
                           throws RemoteException
Sets an HTML scraping script for the specified site

Parameters:
page - the page url
script - the script body
Throws:
RemoteException

connectionVerify

public boolean connectionVerify(String userId,
                                String password,
                                String host,
                                String username)
                         throws RemoteException
The RP site invokes this method to verify that user really has an account on the specified site.

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
host - The verified site url.
username - The username to login onto verified site.
Returns:
The result of verification process.
Throws:
RemoteException

getUI

public org.eclipse.higgins.rpps.core.tobj.UIResponseTO getUI(String userId,
                                                             String password,
                                                             String url,
                                                             String target,
                                                             String sslCert,
                                                             String policytype,
                                                             String policy)
                                                      throws RemoteException
Web service operation. 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

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
url - the URL to the html page with tag
target -
sslCert - the SSL certificate
policy - the RP Agent's Relying Party Security Policy
Returns:
the UIResponseTO transfer object.
Throws:
RemoteException

getICardByIdAndTokenServiceCredential

public org.eclipse.higgins.rpps.core.tobj.ICardTO getICardByIdAndTokenServiceCredential(String userId,
                                                                                        String password,
                                                                                        String cuid,
                                                                                        org.eclipse.higgins.rpps.core.tobj.UITokenServiceCredentialTO userCredintial)
                                                                                 throws RemoteException
Web service operation. Gets the card list of the specified user.

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
cuid - the card's cuid
userCredintial -
Returns:
the card list
Throws:
RemoteException

getICardById

public org.eclipse.higgins.rpps.core.tobj.ICardTO getICardById(String userId,
                                                               String password,
                                                               String cuid)
                                                        throws RemoteException
Web service operation. Gets the card list of the specified user.

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
cuid - the card's cuid.
Returns:
the card list
Throws:
RemoteException

getICards

public org.eclipse.higgins.rpps.core.tobj.ICardTO[] getICards(String userId,
                                                              String password)
                                                       throws RemoteException
Web service operation. Gets the card list of the specified user.

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
Returns:
the card list
Throws:
RemoteException

getICardsAndCategoriesByUser

public org.eclipse.higgins.rpps.core.tobj.ICardsAndCategoryTO getICardsAndCategoriesByUser(String userId,
                                                                                           String password)
                                                                                    throws RemoteException
Web service operation. Gets the card list and category list of the specified user.

Parameters:
userId -
password -
Returns:
the card and category lists
Throws:
RemoteException

updateICard

public org.eclipse.higgins.rpps.core.tobj.ICardTO updateICard(String userId,
                                                              String password,
                                                              org.eclipse.higgins.rpps.core.tobj.ICardTO icardTO)
                                                       throws RemoteException
Web service operation

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
Throws:
RemoteException

importICardAsByteArray

public org.eclipse.higgins.rpps.core.tobj.ICardTO[] importICardAsByteArray(String userId,
                                                                           String password,
                                                                           byte[] crd)
                                                                    throws RemoteException
Web service operation. Imports card from a file.

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
crd - the card as a byte array.
Returns:
list of cards
Throws:
RemoteException

importICardsAsString

public void importICardsAsString(String userId,
                                 String password,
                                 String crd)
                          throws RemoteException
Web service operation. Imports card from a file.

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
crd - the card as a string.
Returns:
list of cards
Throws:
RemoteException

deleteICard

public void deleteICard(String userId,
                        String password,
                        String cuid)
                 throws RemoteException
Web service operation. Deletes specified card.

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
cuid - the i-card CUID
Throws:
RemoteException

deleteAllICard

public void deleteAllICard(String userId,
                           String password)
                    throws RemoteException
Web service operation. Deletes all user's card.

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
Throws:
RemoteException

getHigginsServiceGlobalIName

public String getHigginsServiceGlobalIName()
                                    throws RemoteException
Web service operation. Gets the global i-name registered to the Higgins service (e.g. "=parity").

Returns:
the global i-name.
Throws:
RemoteException

testStringArray

public String[] testStringArray(String[] strArray)
                         throws RemoteException
Web service operation. The test method that returns inputed string array.

Parameters:
strArray - the string array to be returned.
Returns:
the string array inputed as a parameter.
Throws:
RemoteException

getTokenByClaims

public org.eclipse.higgins.rpps.core.tobj.TokenResponseTO getTokenByClaims(String sslCert,
                                                                           String claimNameArray,
                                                                           String claimValueArray)
                                                                    throws RemoteException
Web service operation. Makes xmlToken usage claim list.

Parameters:
sslCert - the SSL certificate
Returns:
the security token as a String
Throws:
RemoteException

getRandomWordList

public String[] getRandomWordList(int count)
                           throws RemoteException
Web service operation. The method that returns random list of words.

Parameters:
count - Size of list of words
Returns:
the string array.
Throws:
RemoteException

getTokenObject

public org.eclipse.higgins.rpps.core.tobj.TokenResponseTO getTokenObject(String userId,
                                                                         String password,
                                                                         String policy,
                                                                         String policytype,
                                                                         String sslCert,
                                                                         String[] cuids,
                                                                         String typeofCredential,
                                                                         String[] credentialKey,
                                                                         String[] credentialValue)
                                                                  throws RemoteException
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).

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
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 as a String
Throws:
RemoteException

getTokenByUrl

public org.eclipse.higgins.rpps.core.tobj.TokenResponseTO getTokenByUrl(String userId,
                                                                        String password,
                                                                        String policy,
                                                                        String policytype,
                                                                        String sslCert,
                                                                        String url)
                                                                 throws RemoteException
Web service operation. Makes security token usage saved users information

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
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 as a String
Throws:
RemoteException

getTokenExtraByUrl

public org.eclipse.higgins.rpps.core.tobj.ExtraTokenResponseTO getTokenExtraByUrl(String userId,
                                                                                  String password,
                                                                                  String policy,
                                                                                  String policytype,
                                                                                  String sslCert,
                                                                                  String url)
                                                                           throws RemoteException
Web service operation. Makes security token usage saved users information

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
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 as a String with extra card's information
Throws:
RemoteException

getPersonalICardCreationTemplate

public org.eclipse.higgins.rpps.core.tobj.ICardTemplateTO getPersonalICardCreationTemplate(String userId,
                                                                                           String password)
                                                                                    throws RemoteException
Return templates for creating personal card

Parameters:
userId - the id to identify the user.
password - the password to identify the user.
Returns:
a template list
Throws:
RemoteException

getUserProfile

public org.eclipse.higgins.rpps.core.tobj.UserProfileTO getUserProfile(String userId,
                                                                       String password)
                                                                throws RemoteException
Returns:
Throws:
Exception
RemoteException

addUserProfileFromHBX

public void addUserProfileFromHBX(String userId,
                                  String password)
                           throws RemoteException
Throws:
Exception
RemoteException

addUserProfile

public org.eclipse.higgins.rpps.core.tobj.ResponseMessage addUserProfile(String userId,
                                                                         String password,
                                                                         org.eclipse.higgins.rpps.core.tobj.UserProfileTO userProfile)
                                                                  throws RemoteException
Parameters:
userProfile -
Throws:
Exception
RemoteException

deleteUserProfile

public org.eclipse.higgins.rpps.core.tobj.ResponseMessage deleteUserProfile(String userId,
                                                                            String password)
                                                                     throws RemoteException
Throws:
Exception
RemoteException

userIdentifierExists

public boolean userIdentifierExists(String userId)
                             throws RemoteException
Returns:
Throws:
Exception
RemoteException

modifyUserProfile

public org.eclipse.higgins.rpps.core.tobj.UserProfileTO modifyUserProfile(String userId,
                                                                          String password,
                                                                          org.eclipse.higgins.rpps.core.tobj.UserProfileTO userProfile)
                                                                   throws RemoteException
Parameters:
userProfile -
Throws:
Exception
RemoteException

setPinCode

public org.eclipse.higgins.rpps.core.tobj.ICardTO setPinCode(String userId,
                                                             String password,
                                                             String cuid,
                                                             String pinCode)
                                                      throws RemoteException
Parameters:
userId -
password -
cuid -
pinCode -
Returns:
icard
Throws:
RemoteException

resetPinCode

public org.eclipse.higgins.rpps.core.tobj.ICardTO resetPinCode(String userId,
                                                               String password,
                                                               String cuid,
                                                               String oldPinCode)
                                                        throws RemoteException
Parameters:
userId -
password -
cuid -
oldPinCode -
Returns:
icard
Throws:
RemoteException

editPinCode

public org.eclipse.higgins.rpps.core.tobj.ICardTO editPinCode(String userId,
                                                              String password,
                                                              String cuid,
                                                              String oldPinCode,
                                                              String newPinCode)
                                                       throws RemoteException
Throws:
RemoteException

getCategory

public org.eclipse.higgins.rpps.core.tobj.CategoryTO[] getCategory(String userId,
                                                                   String password)
                                                            throws RemoteException
Throws:
RemoteException

addCategory

public org.eclipse.higgins.rpps.core.tobj.CategoryTO addCategory(String userId,
                                                                 String password,
                                                                 org.eclipse.higgins.rpps.core.tobj.CategoryTO category)
                                                          throws RemoteException
Throws:
RemoteException

deleteCategory

public void deleteCategory(String userId,
                           String password,
                           String categoryId)
                    throws RemoteException
Throws:
RemoteException

modifyCategory

public org.eclipse.higgins.rpps.core.tobj.CategoryTO modifyCategory(String userId,
                                                                    String password,
                                                                    org.eclipse.higgins.rpps.core.tobj.CategoryTO category)
                                                             throws RemoteException
Throws:
RemoteException

getCardInformation

public org.eclipse.higgins.rpps.core.tobj.CardInformationTO getCardInformation(String userId,
                                                                               String password,
                                                                               String cuid)
                                                                        throws RemoteException
Throws:
RemoteException

clearCardCredential

public org.eclipse.higgins.rpps.core.tobj.CardInformationTO clearCardCredential(String userId,
                                                                                String password,
                                                                                String cuid)
                                                                         throws RemoteException
Throws:
RemoteException

addUrlCardRelation

public org.eclipse.higgins.rpps.core.tobj.CardInformationTO addUrlCardRelation(String userId,
                                                                               String password,
                                                                               String cuid,
                                                                               String url)
                                                                        throws RemoteException
Throws:
RemoteException

deleteUrlCardRelation

public org.eclipse.higgins.rpps.core.tobj.CardInformationTO deleteUrlCardRelation(String userId,
                                                                                  String password,
                                                                                  String cuid,
                                                                                  String url)
                                                                           throws RemoteException
Throws:
RemoteException

deleteUrlsCardRelation

public org.eclipse.higgins.rpps.core.tobj.CardInformationTO deleteUrlsCardRelation(String userId,
                                                                                   String password,
                                                                                   String cuid,
                                                                                   String[] urls)
                                                                            throws RemoteException
Throws:
RemoteException

clearCardHistory

public org.eclipse.higgins.rpps.core.tobj.CardInformationTO clearCardHistory(String userId,
                                                                             String password,
                                                                             String cuid)
                                                                      throws RemoteException
Throws:
RemoteException

getHBXUIList

public String[] getHBXUIList(String version,
                             String windowsName)
                      throws RemoteException
Throws:
RemoteException