com.iplanet.am.sdk
Interface AMGroup

All Superinterfaces:

AMConstants, AMObject

All Known Subinterfaces:

AMAssignableDynamicGroup, AMDynamicGroup, AMStaticGroup

public interface AMGroup

extends AMObject

The AMGroup interface provides methods to manage group

Fields inherited from interface com.iplanet.am.sdk.AMObject

ACTIVE, ACTIVE_VALUE, ASSIGNABLE_DYNAMIC_GROUP, DELETED, DELETED_VALUE, DYNAMIC_GROUP, FILTERED_ROLE, GROUP, GROUP_CONTAINER, GROUP_PROFILE, INACTIVE, INACTIVE_VALUE, MANAGED_ROLE, ORGANIZATION, ORGANIZATIONAL_UNIT, PEOPLE_CONTAINER, POLICY, RESOURCE, ROLE, ROLE_PROFILE, SERVICE, STATIC_GROUP, TEMPLATE, UNDETERMINED_OBJECT_TYPE, UNKNOWN_OBJECT_TYPE, USER

Fields inherited from interface com.iplanet.am.sdk.AMConstants

ADD_MEMBER, ADMIN_GROUPS_ENABLED_ATTR, ADMIN_ROLE_ATTR, ADMINISTRATION_SERVICE, CACHE_ENABLED_DISABLED_KEY, CACHE_MAX_SIZE_KEY, COMPLIANCE_SPECIAL_FILTER_ATTR, COMPLIANCE_USER_DELETION_ATTR, CONTAINER_DEFAULT_TEMPLATE_ROLE, CONTAINER_SUPPORTED_TYPES_ATTRIBUTE, DCT_ATTRIBUTE_LIST_ATTR, DCT_ENABLED_ATTR, DOMAIN_ADMINISTRATORS, DOMAIN_HELP_DESK_ADMINISTRATORS, EMAIL_ATTRIBUTE, FILTER_ATTR_NAME, INET_ADMIN_OBJECT_CLASS, INET_DOMAIN_STATUS_ATTR, INET_DOMAIN_STATUS_ATTRIBUTE, INVALID_USERID_CHARACTERS, OTHER_COSATTR_TYPE, POLICY_COSATTR_TYPE, POLICY_SUFFIX, PRE_POST_PROCESSING_MODULES_ATTR, REMOVE_ATTRIBUTE, REMOVE_MEMBER, REQUIRED_SERVICES_ATTR, ROLE_MANAGED_CONTAINER_DN_ATTRIBUTE, SCOPE_BASE, SCOPE_ONE, SCOPE_SUB, SERVICE_STATUS_ATTRIBUTE, STATIC_GROUP_DN_ATTRIBUTE, SUBSCRIBABLE_ATTRIBUTE, UNIQUE_ATTRIBUTE_LIST_ATTRIBUTE, UNIQUE_MEMBER_ATTRIBUTE, USER_CREATE_NOTIFICATION_LIST, USER_DELETE_NOTIFICATION_LIST, USER_ENCRYPTED_PASSWORD_ATTRIBUTE, USER_ENTRY_PROCESSING_IMPL, USER_MODIFY_NOTIFICATION_LIST, USER_PASSWORD_ATTRIBUTE, USER_SEARCH_RETURN_ATTR, USERID_PASSWORD_VALIDATION_CLASS

Method Summary

void	addNestedGroups(java.util.Set groups) Nests the given group distinguished names in this the group.
java.util.Set	createAssignableDynamicGroups(java.util.Map groups) Creates assignable dynamic groups and initializes their attributes.
java.util.Set	createAssignableDynamicGroups(java.util.Set groupNames) Creates assignable dynamic groups in this group.
java.util.Set	createDynamicGroups(java.util.Map groups) Creates dynamic groups and initializes their attributes.
java.util.Set	createDynamicGroups(java.util.Set groupNames) Creates dynamic groups in this group.
java.util.Set	createStaticGroups(java.util.Map groups) Creates static groups and initializes their attributes.
java.util.Set	createStaticGroups(java.util.Set groupNames) Creates static groups in this group.
void	deleteAssignableDynamicGroups(java.util.Set groupDNs) Deletes assignable dynamic groups in this group.
void	deleteDynamicGroups(java.util.Set groupDNs) Deletes dynamic groups in this group.
void	deleteStaticGroups(java.util.Set groupDNs) Deletes static groups in this group.
java.util.Set	getGroupDNs(int level) Gets the groups in this group.
java.util.Set	getNestedGroupDNs() Returns the groups nested in this group.
long	getNumberOfGroups(int level) Returns number of groups in the group.
long	getNumberOfUsers() Returns number of users in the group.
java.util.Set	getUserAndGroupDNs() Returns the distinguished name of users and nested groups in the group.
java.util.Set	getUserDNs() Returns the distinguished name of users in the group.
void	removeNestedGroups(java.util.Set groups) Removes groups which are nested in this group.
java.util.Set	searchGroups(java.lang.String wildcard, int level) Searches for groups in this group using wildcards.
AMSearchResults	searchGroups(java.lang.String wildcard, java.util.Map avPairs, AMSearchControl searchControl) Searches for groups in this group using wildcards and attribute values.
java.util.Set	searchGroups(java.lang.String wildcard, java.util.Map avPairs, int level) Searches for groups in this group using wildcards and attribute values.
AMSearchResults	searchUsers(AMSearchControl searchControl, java.lang.String avfilter) Searches for users in this group using attribute values.
java.util.Set	searchUsers(java.lang.String wildcard) Searches for users in this group using wildcards and attribute values.
AMSearchResults	searchUsers(java.lang.String wildcard, java.util.Map avPairs, AMSearchControl searchControl) Searches for users in this group using wildcards.

Methods inherited from interface com.iplanet.am.sdk.AMObject

addEventListener, assignPolicies, assignServices, createPolicyTemplate, createPolicyTemplate, createTemplate, createTemplate, delete, delete, getAssignedServices, getAttribute, getAttributeByteArray, getAttributes, getAttributes, getAttributesByteArray, getAttributesByteArray, getAttributesFromDataStore, getAttributesFromDataStore, getDN, getOrganizationDN, getParentDN, getPolicy, getPolicyTemplate, getServiceAttributes, getServiceStatus, getStringAttribute, getTemplate, isExists, modifyService, purge, removeAttributes, removeEventListener, search, setAttributeByteArray, setAttributes, setAttributesByteArray, setServiceStatus, setStringAttribute, store, store, unassignPolicies, unassignServices

Method Detail

getNumberOfUsers

public long getNumberOfUsers()
                      throws AMException,
                             SSOException

Returns number of users in the group.

Returns:

Number of users in the group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token no longer valid.

getUserDNs

public java.util.Set getUserDNs()
                         throws AMException,
                                SSOException

Returns the distinguished name of users in the group.

Returns:

a set of user distinguished names in the group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

getUserAndGroupDNs

public java.util.Set getUserAndGroupDNs()
                                 throws AMException,
                                        SSOException

Returns the distinguished name of users and nested groups in the group.

Returns:

The distinguished name of users and nested groups in the group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

addNestedGroups

public void addNestedGroups(java.util.Set groups)
                     throws AMException,
                            SSOException

Nests the given group distinguished names in this the group. This will effectively make the groups members of this group. And any ACIs set for this group will be inherited by the nested groups and their members.

Parameters:

groups - The set of group distinguished names to be nested in this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

searchUsers

public java.util.Set searchUsers(java.lang.String wildcard)
                          throws AMException,
                                 SSOException

Searches for users in this group using wildcards and attribute values. Wildcards can be specified such as a*, *, *a.

Parameters:

wildcard - wildcard pattern to be used in the search

Returns:

Set of distinguished name of users matching the search

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid

searchUsers

public AMSearchResults searchUsers(java.lang.String wildcard,
                                   java.util.Map avPairs,
                                   AMSearchControl searchControl)
                            throws AMException,
                                   SSOException

Searches for users in this group using wildcards. Wildcards can be specified such as a*, *, *a.

Parameters:

wildcard - wildcard pattern to be used in the search

avPairs - attribute-value pairs to match when searching users

searchControl - specifies the size limit and time limit

Returns:

AMSearchResults which contains a set of distinguished name of Users matching the search.

Throws:

AMException - if there is an internal error in the access management store.

SSOException - if the single sign on token is no longer valid.

searchUsers

public AMSearchResults searchUsers(AMSearchControl searchControl,
                                   java.lang.String avfilter)
                            throws AMException,
                                   SSOException

Searches for users in this group using attribute values. Wildcards such as a*, *, *a can be specified for the attribute values. The distinguished names of users with matching attribute-value pairs will be returned.

Parameters:

searchControl - specifies the search scope to be used, VLV ranges etc.,

avfilter - this attribute-value pairs filter will be logical AND with user search filter.

Returns:

AMSearchResults which contains a set of distinguished names of Users matching the search.

Throws:

AMException - if there is an internal error in the access management Store.

SSOException - if the single sign on token is no longer valid.

createStaticGroups

public java.util.Set createStaticGroups(java.util.Set groupNames)
                                 throws AMException,
                                        SSOException

Creates static groups in this group.

Parameters:

groupNames - The set of static groups' names to be created in this group.

Returns:

set of static group objects created.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

createStaticGroups

public java.util.Set createStaticGroups(java.util.Map groups)
                                 throws AMException,
                                        SSOException

Creates static groups and initializes their attributes.

Parameters:

groups - Map where the key is the name of the static group, and the value is a Map to represent Attribute-Value Pairs

Returns:

Set of group objects created.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

createDynamicGroups

public java.util.Set createDynamicGroups(java.util.Set groupNames)
                                  throws AMException,
                                         SSOException

Creates dynamic groups in this group.

Parameters:

groupNames - The set of dynamic groups' names to be created in this group.

Returns:

Set of dynamic group objects created

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

createDynamicGroups

public java.util.Set createDynamicGroups(java.util.Map groups)
                                  throws AMException,
                                         SSOException

Creates dynamic groups and initializes their attributes.

Parameters:

groups - Map of name of the dynamic group to attribute-value pairs map.

Returns:

Set of dynamic group objects created.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

createAssignableDynamicGroups

public java.util.Set createAssignableDynamicGroups(java.util.Set groupNames)
                                            throws AMException,
                                                   SSOException

Creates assignable dynamic groups in this group.

Parameters:

groupNames - The set of assignable dynamic groups' names to be created in this group.

Returns:

Set of assignable dynamic group objects created.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

createAssignableDynamicGroups

public java.util.Set createAssignableDynamicGroups(java.util.Map groups)
                                            throws AMException,
                                                   SSOException

Creates assignable dynamic groups and initializes their attributes.

Parameters:

groups - Map of name of the assignable dynamic group to attribute-value pairs map;

Returns:

Set of assignable dynamic group objects created.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

getGroupDNs

public java.util.Set getGroupDNs(int level)
                          throws AMException,
                                 SSOException

Gets the groups in this group. It returns groups either at one level or a whole subtree.

Parameters:

level - the level (AMConstants.SCOPE_ONE or AMConstants.SCOPE_SUB) for returning groups.

Returns:

The group distinguished names in this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store or if the level is invalid.

SSOException - if the single sign on token is no longer valid.

getNestedGroupDNs

public java.util.Set getNestedGroupDNs()
                                throws AMException,
                                       SSOException

Returns the groups nested in this group.

Returns:

The group distinguished names nested in this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

removeNestedGroups

public void removeNestedGroups(java.util.Set groups)
                        throws AMException,
                               SSOException

Removes groups which are nested in this group.

Parameters:

groups - The set of user DN's to be removed from the static group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid

getNumberOfGroups

public long getNumberOfGroups(int level)
                       throws AMException,
                              SSOException

Returns number of groups in the group. It returns number of groups either at one level or a whole subtree.

Parameters:

level - the level (AMConstants.SCOPE_ONE or AMConstants.SCOPE_SUB) for returning groups.

Returns:

Number of groups in the group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

deleteStaticGroups

public void deleteStaticGroups(java.util.Set groupDNs)
                        throws AMException,
                               SSOException

Deletes static groups in this group.

Parameters:

groupDNs - The set of static group distinguished names to be deleted from this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

deleteDynamicGroups

public void deleteDynamicGroups(java.util.Set groupDNs)
                         throws AMException,
                                SSOException

Deletes dynamic groups in this group.

Parameters:

groupDNs - The set of dynamic group distinguished names to be deleted from this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid

deleteAssignableDynamicGroups

public void deleteAssignableDynamicGroups(java.util.Set groupDNs)
                                   throws AMException,
                                          SSOException

Deletes assignable dynamic groups in this group.

Parameters:

groupDNs - The set of assignable dynamic group distinguished names to be deleted from this group.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

searchGroups

public java.util.Set searchGroups(java.lang.String wildcard,
                                  int level)
                           throws AMException,
                                  SSOException

Searches for groups in this group using wildcards. Wildcards can be specified such as a*, *, *a.

Parameters:

wildcard - wildcard pattern to be used in the search

level - the search level that needs to be used (AMConstants.SCOPE_ONE or AMConstants.SCOPE_TREE).

Returns:

Set of distinguished name of sub groups matching the search

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

searchGroups

public java.util.Set searchGroups(java.lang.String wildcard,
                                  java.util.Map avPairs,
                                  int level)
                           throws AMException,
                                  SSOException

Searches for groups in this group using wildcards and attribute values. Wildcards can be specified such as a*, *, *a.

Parameters:

wildcard - wildcard pattern to be used in the search

avPairs - attribute-value pairs to match when searching groups

level - the search level that needs to be used (AMConstants.SCOPE_ONE or AMConstants.SCOPE_TREE)

Returns:

Set of distinguished name of groups matching the search

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

searchGroups

public AMSearchResults searchGroups(java.lang.String wildcard,
                                    java.util.Map avPairs,
                                    AMSearchControl searchControl)
                             throws AMException,
                                    SSOException

Searches for groups in this group using wildcards and attribute values. Wildcards can be specified such as a*, *, *a.

Parameters:

wildcard - wildcard pattern to be used in the search

avPairs - attribute-value pairs to match when searching groups

searchControl - specifies the search scope to be used

Returns:

AMSearchResults which contains a set of distinguished name of groups matching the search.

Throws:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.