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

public 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

public 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

public 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

public 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.