|
JAAS Provider Java API Reference 10g (9.0.4.0.0) B10389-01 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Interface UserManager define the APIs for managing users in a realm.
Here are the properties appliacable for a LDAP-based realm.
Property names | Descriptions |
jazn.realm.users.ldap.isExternal | A flag, true or false, to specify whether the users are external to JAZN or not. |
jazn.realm.users.ldap.searchBase# | Set the search base to point to the directory subtree where users will be searched. JAZN locates users with a specified name by searching in the subtree, jazn.realm.users.ldap.searchBase, all the objects defined using the user object class if specified, jazn.realm.users.ldap.objectClass, with attribute, jazn.realm.users.ldap.nameAttribute, matching the search value provided by the client. |
jazn.realm.users.ldap.nameAttribute# | Set this property to the attribute that uniquely identifies the name of the user. |
jazn.realm.users.ldap.objectClass## | Set this property to the name of schema object class that is used to represent a user. |
#these properties should be defined for external users (i.e. when jazn.realm.users.ldap.isExternal is "true")
##optional property, it is useful for further restricting the search of users.
Method Summary | |
RealmUser |
createUser(String name) Create a RealmUser in this realm |
RealmUser |
createUser(String name, String passwd) Create a RealmUser in this realm |
void |
dropUser(String name) Drops user of the specified name from this realm. |
void |
dropUser(String name, boolean cascade) Drops user of the specified name from this realm. |
Realm |
getRealm() Returns the Realm reference that this UserManager belongs to. |
RealmUser |
getUser(String name) Returns the RealmUser with the specified name |
int |
getUserCount() Returns the number of users in this UserManager |
Set |
getUsers() Returns the users in this UserManager |
void |
initialize(Hashtable attributes) Initialize the UserManager if it's not yet intialized. |
void |
refresh() Gives the UserManager a chance to refresh its cache, so updated data will be visible |
void |
setRealm(Realm realm) Set the realm that this UserManager is associated with. |
Method Detail |
public void setRealm(Realm realm) throws JAZNException
realm
- an instance of RealmJAZNException
public void initialize(Hashtable attributes) throws JAZNException
attributes
- a possibly null table of attributes and configuration parameters for initialization.JAZNException
public void refresh()
public Realm getRealm()
public Set getUsers() throws JAZNException
JAZNNamingException
- if a naming Exception is encountered.JAZNException
public int getUserCount() throws JAZNException
JAZNNamingException
- if a naming Exception is encountered.JAZNException
public RealmUser getUser(String name) throws JAZNException
JAZNNamingException
- if a naming Exception is encountered.JAZNException
public RealmUser createUser(String name) throws JAZNException
UnsupportedOperationException
- is thrown if users are not modifiable.JAZNNamingException
- if a naming Exception is encountered.SecurityException
- if the caller does not have permission to invoke this methodJAZNException
public RealmUser createUser(String name, String passwd) throws JAZNException
passwd
- passwordUnsupportedOperationException
- is thrown if users are not modifiable.JAZNNamingException
- if a naming Exception is encountered.SecurityException
- if the caller does not have permission to invoke this methodJAZNException
public void dropUser(String name) throws JAZNException
name
- name of the user to be dropped from the realm.UnsupportedOperationException
- is thrown if users are not modifiable in this realm.JAZNNamingException
- if a naming Exception is encountered.JAZNObjectNotFoundException
- if the user cannot be found in this realm.SecurityException
- if the caller does not have permission to invoke this methodJAZNException
public void dropUser(String name, boolean cascade) throws JAZNException
name
- name of the user to be dropped from the realm.cascade
- if true, the user will be removed from roles who has the user as a memeber, and all policy entries related to the user will be removed as well.UnsupportedOperationException
- is thrown if users are not modifiable in this realm.JAZNNamingException
- if a naming Exception is encountered.JAZNObjectNotFoundException
- if the user cannot be found in this realm.SecurityException
- if the caller does not have permission to invoke this methodJAZNException
|
JAAS Provider Java API Reference 10g (9.0.4.0.0) B10389-01 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |