EASP API 7.7.0

net.juniper.smgt.ent.im
Interface Managers

All Known Subinterfaces:
Access, Enterprise, Folder, Retailer, Site, Subscriber

public interface Managers

This interface defines methods that a Manager with Manager.ADMINISTER privileges can invoke in order to manage other Managers. These operations always occur in the context of the object that implements this interface.

For example, calling the addManager method on an Enterprise instance will add an existing Manager to the set of Managers that can control that Enterprise. Within that Enterprise, the newly added manager will be able to perform the types of operations defined by his set of privileges (see the Manager documentation for an explanation of privileges). Outside that Enterprise, the newly added manager will not be able to perform any operations.


Method Summary
 Manager addManager(String managerId, String password, String[] privileges)
          Adds a new Manager to the set of Managers that control the object implementing this Managers interface.
 void delManager(String managerId)
          Remove a manager from the set of Managers that control the object implementing this Managers interface.
 Manager getManager(String managerId)
          Returns the Manager with the specified login ID.
 PersistentIterator getManagers()
          Returns an iterator over the set of Managers that control the object implementing this Managers interface.
 

Method Detail

addManager

Manager addManager(String managerId,
                   String password,
                   String[] privileges)
                   throws CommunicationException,
                          DuplicateNameException,
                          UnknownIdentityException,
                          AccessControlException
Adds a new Manager to the set of Managers that control the object implementing this Managers interface. See Manager.setPrivileges(java.lang.String[]) for a definition of the privileges parameter. The Manager is added to relevant group entries in the directory. A group entry is an LDAP entry that contains all the Managers with a specific permission and control over a specific Enterprise, Site, or Access.

Parameters:
managerId - The login ID of the manager. This is the part of the principal (i.e. the optionally qualified login ID) that precedes the "@" character.
password - The password of the manager.
privileges - The privileges of the manage.
Returns:
net.juniper.smgt.ent.im.Manager
Throws:
CommunicationException - Thrown if there is a problem accessing the directory.
UnknownIdentityException - Thrown if a group entry for one of the privilges of the new manager is missing from the directory.
DuplicateNameException - Thrown if there is already a manager with the given name.
AccessControlException - Thrown if the currently bound manager (i.e. the manager that is invoking this method) does not have Manager.ADMINISTER privileges.

delManager

void delManager(String managerId)
                throws CommunicationException,
                       UnknownIdentityException,
                       AccessControlException
Remove a manager from the set of Managers that control the object implementing this Managers interface.

Parameters:
managerId - The login ID of the manager. This is the part of the principal (i.e. the optionally qualified login ID) that precedes the "@" character.
Throws:
CommunicationException - Thrown if there is a problem accessing the directory.
UnknownIdentityException - Thrown if there is no manager with the given name.
AccessControlException - Thrown if the currently bound manager (i.e. the manager that is invoking this method) does not have Manager.ADMINISTER privileges, or if the currently bound manager tries to delete himself

getManager

Manager getManager(String managerId)
                   throws CommunicationException,
                          UnknownIdentityException,
                          AccessControlException
Returns the Manager with the specified login ID.

Parameters:
managerId - The login ID of the manager. This is the part of the principal (i.e. the optionally qualified login ID) that precedes the "@" character.
Returns:
The requested Manager.
Throws:
CommunicationException - Thrown if there is a problem accessing the directory.
UnknownIdentityException - Thrown if there is no manager with the given name.
AccessControlException - Thrown if the currently bound manager (i.e. the manager that is invoking this method) does not have Manager.ADMINISTER privileges.

getManagers

PersistentIterator getManagers()
                               throws AccessControlException,
                                      CommunicationException
Returns an iterator over the set of Managers that control the object implementing this Managers interface.

Returns:
An iterator over a set of Managers.
Throws:
CommunicationException - Thrown if there is a problem accessing the directory.
AccessControlException - Thrown if the currently bound manager (i.e. the manager that is invoking this method) does not have Manager.ADMINISTER privileges.

EASP API 7.7.0