Skip navigation links

oracle.tip.pc.services.identity
Interface BPMProvider

public interface BPMProvider

BPMProvider defines Identity Service Provider Interface

Method Summary

void	authenticateUser(java.lang.String name, java.lang.String password) Authenticates the user in the system.
java.lang.String	getDefaultRealmName() Gets the default realm name
java.util.Set	getGrantedRoles(BPMPrincipal principal, boolean direct) Gets granted roles to principal
java.util.Set	getGrantees(java.lang.String roleName, boolean direct) Gets all grantee for given group/role name
java.util.Map	getObjectAttributes(BPMPrincipal pr) Get object Attributes return map - an attribute map containing the attributes of the object.
java.util.Set	getOwnedRoles(BPMPrincipal principal, boolean direct) Get roles owned by BPMPrincipal
java.util.Set	getOwners(BPMRole role, boolean direct) Gets users who own given role
java.lang.String	getProviderAttributeName(java.lang.Class classifier, java.lang.String attrName) Gets provider attribute name.
ProviderCfg	getProviderCfg() Gets provider config associated with this provider.
java.util.List	getRoles(RoleClassifier roleType) Gets Roles of the specified type.
java.util.List	getUsers() Gets all users
BPMGroup	lookupGroup(java.lang.String name) Looks up BPMGroup in specified realm by role name
BPMRole	lookupRole(java.lang.String name) Looks up BPMRole in specified realm by role name
BPMUser	lookupUser(java.lang.String name) Looks up BPMUser in the scpecified logical realm using the given user name
BPMRole	populateDetails(BPMRole role) Loads BPMRole Details.
BPMUser	populateDetails(BPMUser user) Loads BPMUser Details
java.util.List	searchRoles(RoleClassifier classifier, SearchFilter filter) Searches BPMRole based on the classifier and search filter.
java.util.List	searchRoles(RoleClassifier classifier, java.lang.String attrName, java.lang.String attrValue) Searches BPMRole based on teh classifier and attribute name-value pair.
java.util.List	searchUsers(SearchFilter filter) Searches BPMUsers based on the criteria specified in teh search filter.
java.util.List	searchUsers(java.lang.String attrName, java.lang.String attrValue) Searches BPMUsers with the given attribute name and value pair.

Method Detail

getProviderCfg

public ProviderCfg getProviderCfg()

Gets provider config associated with this provider.

Returns:

config

getDefaultRealmName

public java.lang.String getDefaultRealmName()
                                     throws BPMIdentityException

Gets the default realm name

Returns:

default realm name

Throws:

BPMIdentityException - If exception condition occurs.

lookupUser

public BPMUser lookupUser(java.lang.String name)
                   throws BPMIdentityException,
                          BPMIdentityNotFoundException

Looks up BPMUser in the scpecified logical realm using the given user name

Parameters:

name - user name

Throws:

BPMIdentityException - If exception condition occurs.

BPMIdentityNotFoundException - If user is not found

lookupGroup

public BPMGroup lookupGroup(java.lang.String name)
                     throws BPMIdentityException,
                            BPMIdentityNotFoundException

Looks up BPMGroup in specified realm by role name

Parameters:

name - group name

Throws:

BPMIdentityNotFoundException - If group is not found

BPMIdentityException - If exception condition occurs.

lookupRole

public BPMRole lookupRole(java.lang.String name)
                   throws BPMIdentityException,
                          BPMIdentityNotFoundException

Looks up BPMRole in specified realm by role name

Parameters:

name - a role name

Throws:

BPMIdentityNotFoundException - If role is not found

BPMIdentityException - If exception condition occurs.

getUsers

public java.util.List getUsers()
                        throws BPMIdentityException

Gets all users

Throws:

BPMIdentityException - If exception condition occurs.

getRoles

public java.util.List getRoles(RoleClassifier roleType)
                        throws BPMIdentityException

Gets Roles of the specified type.

Parameters:

roleType - a role classifier

Throws:

BPMIdentityException - If exception condition occurs.

getGrantedRoles

public java.util.Set getGrantedRoles(BPMPrincipal principal,
                                     boolean direct)
                              throws BPMIdentityException

Gets granted roles to principal

Parameters:

principal - a BPMPrincipal object

direct - a boolean flag. if true return direct granted role, else all

Returns:

Set of BPMRole objects

Throws:

BPMIdentityException - If exception condition occurs.

getGrantees

public java.util.Set getGrantees(java.lang.String roleName,
                                 boolean direct)
                          throws BPMIdentityException,
                                 BPMIdentityNotFoundException

Gets all grantee for given group/role name

Parameters:

roleName - a role name

direct - a boolean flag. If true method returns only direct participans, else all.

Returns:

Set of BPMUser objects for given group/role name

Throws:

BPMIdentityException - If exception condition occurs.

BPMIdentityNotFoundException

searchUsers

public java.util.List searchUsers(java.lang.String attrName,
                                  java.lang.String attrValue)
                           throws BPMIdentityException,
                                  BPMUnsupportedAttributeException

Searches BPMUsers with the given attribute name and value pair.

Parameters:

attrName -

attrValue -

Returns:

List of BPMUser found according to search criteria

Throws:

BPMIdentityException - If exception condition occurs.

BPMUnsupportedAttributeException

searchUsers

public java.util.List searchUsers(SearchFilter filter)
                           throws BPMIdentityException,
                                  BPMUnsupportedAttributeException

Searches BPMUsers based on the criteria specified in teh search filter.

Parameters:

filter - a SearchFilter instance.

Returns:

List of BPMUser found according to search criteria

Throws:

BPMIdentityException - If exception condition occurs.

BPMUnsupportedAttributeException

searchRoles

public java.util.List searchRoles(RoleClassifier classifier,
                                  java.lang.String attrName,
                                  java.lang.String attrValue)
                           throws BPMIdentityException,
                                  BPMUnsupportedAttributeException

Searches BPMRole based on teh classifier and attribute name-value pair.

Parameters:

classifier - RoleClassifier

attrName -

attrValue -

Returns:

List of BPMRole found according to search criteria

Throws:

BPMIdentityException - If exception condition occurs.

BPMUnsupportedAttributeException

searchRoles

public java.util.List searchRoles(RoleClassifier classifier,
                                  SearchFilter filter)
                           throws BPMIdentityException,
                                  BPMUnsupportedAttributeException

Searches BPMRole based on the classifier and search filter.

Parameters:

classifier - RoleClassifier

filter - a SearchFilter

Returns:

List of BPMRole found according to search criteria

Throws:

BPMIdentityException - If exception condition occurs.

BPMUnsupportedAttributeException

populateDetails

public BPMRole populateDetails(BPMRole role)
                        throws BPMIdentityException,
                               BPMIdentityNotFoundException

Loads BPMRole Details. These include the various attributes.

Returns:

BPMRole object

Throws:

BPMIdentityException - If exception condition occurs.

BPMIdentityNotFoundException - If role is not found

populateDetails

public BPMUser populateDetails(BPMUser user)
                        throws BPMIdentityException,
                               BPMIdentityNotFoundException

Loads BPMUser Details

Parameters:

user - a BPMUser to populate

Returns:

BPMUser object

Throws:

BPMIdentityException - If exception condition occurs.

BPMIdentityNotFoundException - if role is not found

getOwnedRoles

public java.util.Set getOwnedRoles(BPMPrincipal principal,
                                   boolean direct)
                            throws BPMIdentityException

Get roles owned by BPMPrincipal

Parameters:

principal - The owner principal.

direct - a boolean flag. If true method returns only directly owned roles.

Returns:

a set groups.

Throws:

BPMIdentityException

getOwners

public java.util.Set getOwners(BPMRole role,
                               boolean direct)
                        throws BPMIdentityException

Gets users who own given role

Parameters:

role - The role whose owners are to be found

direct - a boolean flag, if true only direct owners are returned, else all

Returns:

set of BPMUser objects

Throws:

BPMIdentityException - If exception condition occurs.

getObjectAttributes

public java.util.Map getObjectAttributes(BPMPrincipal pr)
                                  throws BPMIdentityException

Get object Attributes return map - an attribute map containing the attributes of the object.

Throws:

BPMIdentityException

authenticateUser

public void authenticateUser(java.lang.String name,
                             java.lang.String password)
                      throws BPMIdentityException,
                             BPMAuthenticationException

Authenticates the user in the system.

Parameters:

name - The name of the user to be authenticated.

password - The password of the user to be authenticated.

Throws:

BPMIdentityException - If exception condition occurs.

BPMAuthenticationException - If the user could not be authenticated or if an exception condition occured during authentication.

getProviderAttributeName

public java.lang.String getProviderAttributeName(java.lang.Class classifier,
                                                 java.lang.String attrName)

Gets provider attribute name. Provider has to map provider specifc attribute names to Identity Service attribute name for all pre-defined attributes

Parameters:

classifier -

attrName -

Returns:

Skip navigation links