SecurityManagementJMXMBean


1   package org.mr.kernel.security.impl.management.jmx;
2   
3   import org.mr.kernel.security.impl.management.*;
4   
5   import javax.jms.JMSSecurityException  ;
6   
7   import org.mr.kernel.security.MantaSecurityException;
8   
9   import java.util.Collection  ;
10  
11  /**
12   * An interface of the managed obect that is used to perform security management actions.
13   *
14   * @author Shirley Sasson
15   * @version 1.0
16   * @since May 22, 2006
17   */
18  public interface SecurityManagementJMXMBean {
19  
20      /**
21       * Creates a new user principal.
22       *
23       * @param authenticationUsername the authentication username
24       * @param authenticationPassword the authentication password
25       * @param newUsername username for new user
26       * @param newUserGroup group of new user
27       * @param newUserPassword password for new user
28       * @param newUserGIDNumber GID for new user
29       * @param newUserUIDNumber UID for new user
30       * @param newUserSurname surname for new user
31       * @param newUserCommonName common name for new user
32       * @throws PrincipalAlreadyExistsException if a user with this username already exists
33       * @throws PrincipalNotFoundException if a group with the name specified in newUserGroup doesn't exist
34       * @throws MantaSecurityException if an error occured
35       * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
36       */
37      public void createUserPrincipal(String   authenticationUsername, String   authenticationPassword, String   newUsername, String   newUserGroup, String   newUserPassword, int newUserGIDNumber, int newUserUIDNumber, String   newUserSurname, String   newUserCommonName) throws PrincipalAlreadyExistsException, PrincipalNotFoundException, MantaSecurityException, JMSSecurityException  ;
38  
39      /**
40       * Creates a new group principal.
41       *
42       * @param authenticationUsername the authentication username
43       * @param authenticationPassword the authentication password
44       * @param newGroupName name of new group
45       * @throws PrincipalAlreadyExistsException if a group with this name already exists
46       * @throws MantaSecurityException if an error occured
47       * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
48       */
49      public void createGroupPrincipal(String   authenticationUsername, String   authenticationPassword, String   newGroupName) throws PrincipalAlreadyExistsException, MantaSecurityException, JMSSecurityException  ;
50  
51      /**
52       * Renames a user principal.
53       *
54       * @param authenticationUsername the authentication username
55       * @param authenticationPassword the authentication password
56       * @param oldUsername username to rename
57       * @param newUsername new username
58       * @throws PrincipalNotFoundException if the username to rename is not found
59       * @throws PrincipalAlreadyExistsException if the new username specified already exists
60       * @throws MantaSecurityException if an error occured
61       * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
62       */
63      public void renameUserPrincipal(String   authenticationUsername, String   authenticationPassword, String   oldUsername, String   newUsername) throws PrincipalNotFoundException, PrincipalAlreadyExistsException, MantaSecurityException, JMSSecurityException  ;
64  
65      /**
66       * Renames a group principal.
67       *
68       * @param authenticationUsername the authentication username
69       * @param authenticationPassword the authentication password
70       * @param oldGroupName name of group to rename
71       * @param newGroupName new group name
72       * @throws PrincipalNotFoundException if the group to rename is not found
73       * @throws PrincipalAlreadyExistsException if the new group name specified already exists
74       * @throws MantaSecurityException if an error occured
75       * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
76       */
77      public void renameGroupPrincipal(String   authenticationUsername, String   authenticationPassword, String   oldGroupName, String   newGroupName) throws PrincipalNotFoundException, PrincipalAlreadyExistsException, MantaSecurityException, JMSSecurityException  ;
78  
79      /**
80       * Sets a group of a user.
81       *
82       * @param authenticationUsername the authentication username
83       * @param authenticationPassword the authentication password
84       * @param username username to set the group for
85       * @param groupName new name of group for user
86       * @throws PrincipalNotFoundException if the user name or the group doesn't exist
87       * @throws MantaSecurityException if an error occured
88       * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
89       */
90      public void setUserGroup(String   authenticationUsername, String   authenticationPassword, String   username, String   groupName) throws PrincipalNotFoundException, MantaSecurityException, JMSSecurityException  ;
91  
92      /**
93       * Sets a password of a user.
94       *
95       * @param authenticationUsername the authentication username
96       * @param authenticationPassword the authentication password
97       * @param username username to set the group for
98       * @param password new password for user
99       * @throws PrincipalNotFoundException if the user doesn't exist
100      * @throws MantaSecurityException if an error occured
101      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
102      */
103     public void setUserPassword(String   authenticationUsername, String   authenticationPassword, String   username, String   password) throws PrincipalNotFoundException, MantaSecurityException, JMSSecurityException  ;
104 
105     /**
106      * Creates a new permission for a user principal.
107      *
108      * @param authenticationUsername the authentication username
109      * @param authenticationPassword the authentication password
110      * @param permissionName name of permission to add
111      * @param permissionParam String parameter for permission
112      * @param username username to add the permission for
113      * @throws PrincipalNotFoundException if username specified isn't found
114      * @throws PermissionAlreadyExistsException is permission to add already exists
115      * @throws MantaSecurityException if an error occured
116      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
117      */
118     public void createPermissionForUser(String   authenticationUsername, String   authenticationPassword, String   permissionName, String   permissionParam, String   username) throws PrincipalNotFoundException, PermissionAlreadyExistsException, MantaSecurityException, JMSSecurityException  ;
119 
120     /**
121      * Creates a new permission for a group principal.
122      *
123      * @param authenticationUsername the authentication username
124      * @param authenticationPassword the authentication password
125      * @param permissionName name of permission to add
126      * @param permissionParam String parameter for permission
127      * @param groupName name of group to add the permission for
128      * @throws PrincipalNotFoundException if group name specified isn't found
129      * @throws PermissionAlreadyExistsException is permission to add already exists
130      * @throws MantaSecurityException if an error occured
131      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
132      */
133     public void createPermissionForGroup(String   authenticationUsername, String   authenticationPassword, String   permissionName, String   permissionParam, String   groupName) throws PrincipalNotFoundException, PermissionAlreadyExistsException, MantaSecurityException, JMSSecurityException  ;
134 
135     /**
136      * Returns the list of all permissions for a specific user principal.
137      *
138      * @param authenticationUsername the authentication username
139      * @param authenticationPassword the authentication password
140      * @param username the username for whom to retrieve the list of permissions
141      * @return a collection of all permissions for a the user specified
142      * @throws PrincipalNotFoundException if the username specified doesn't exist
143      * @throws MantaSecurityException if an error occured
144      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
145      */
146     public Collection   getPermissionsForUser(String   authenticationUsername, String   authenticationPassword, String   username) throws PrincipalNotFoundException, MantaSecurityException, JMSSecurityException  ;
147 
148     /**
149      * Returns the list of all permissions for a specific group principal.
150      *
151      * @param authenticationUsername the authentication username
152      * @param authenticationPassword the authentication password
153      * @param groupName the group for which to retrieve the list of permissions
154      * @return a collection of all permissions for a the group specified
155      * @throws PrincipalNotFoundException if the group specified doesn't exist
156      * @throws MantaSecurityException if an error occured
157      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
158      */
159     public Collection   getPermissionsForGroup(String   authenticationUsername, String   authenticationPassword, String   groupName) throws PrincipalNotFoundException, MantaSecurityException, JMSSecurityException  ;
160 
161     /**
162      * Deletes a user principal.
163      *
164      * @param authenticationUsername the authentication username
165      * @param authenticationPassword the authentication password
166      * @param username the username to delete
167      * @throws PrincipalNotFoundException if this user is not found
168      * @throws MantaSecurityException if an error occured
169      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
170      */
171     public void deleteUser(String   authenticationUsername, String   authenticationPassword, String   username) throws PrincipalNotFoundException, MantaSecurityException, JMSSecurityException  ;
172 
173     /**
174      * Deletes a group principal.
175      *
176      * @param authenticationUsername the authentication username
177      * @param authenticationPassword the authentication password
178      * @param groupName the name of the group to delete
179      * @throws PrincipalNotFoundException if this user is not found
180      * @throws GroupNotEmptyException if the group to delete has users related to it and so cannot be deleted
181      * @throws MantaSecurityException if an error occured
182      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
183      */
184     public void deleteGroup(String   authenticationUsername, String   authenticationPassword, String   groupName) throws PrincipalNotFoundException, GroupNotEmptyException, MantaSecurityException, JMSSecurityException  ;
185 
186     /**
187      * Deletes a permission for user principal.
188      *
189      * @param authenticationUsername the authentication username
190      * @param authenticationPassword the authentication password
191      * @param permissionName the permission to delete
192      * @param permissionParam String permission param
193      * @param username the username for whom the permission relates to
194      * @throws PermissionNotFoundException if this permission is not found
195      * @throws MantaSecurityException if an error occured
196      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
197      */
198     public void deletePermissionForUser(String   authenticationUsername, String   authenticationPassword, String   permissionName, String   permissionParam, String   username) throws PermissionNotFoundException, MantaSecurityException, JMSSecurityException  ;
199 
200     /**
201      * Deletes a permission for group principal.
202      *
203      * @param authenticationUsername the authentication username
204      * @param authenticationPassword the authentication password
205      * @param permissionName the permission to delete
206      * @param permissionParam String permission param
207      * @param groupName the name of the group for which the permission relates to
208      * @throws PermissionNotFoundException if this permission is not found
209      * @throws MantaSecurityException if an error occured
210      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
211      */
212     public void deletePermissionForGroup(String   authenticationUsername, String   authenticationPassword, String   permissionName, String   permissionParam, String   groupName) throws PermissionNotFoundException, MantaSecurityException, JMSSecurityException  ;
213 
214     /**
215      * Creates a new white list entry.
216      *
217      * @param authenticationUsername the authentication username
218      * @param authenticationPassword the authentication password
219      * @param whiteListEntry the white list entry to add
220      * @throws WhiteListEntryAlreadyExistsException if this white list entry already exists
221      * @throws MantaSecurityException if an error occured
222      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
223      */
224     public void createWhiteListEntry(String   authenticationUsername, String   authenticationPassword, String   whiteListEntry) throws WhiteListEntryAlreadyExistsException, MantaSecurityException, JMSSecurityException  ;
225 
226     /**
227      * Deletes a white list entry.
228      *
229      * @param authenticationUsername the authentication username
230      * @param authenticationPassword the authentication password
231      * @param whiteListEntry the white list entry to delete
232      * @throws WhiteListEntryNotFoundException if this white list entry is not found
233      * @throws MantaSecurityException if an error occured
234      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
235      */
236     public void deleteWhiteListEntry(String   authenticationUsername, String   authenticationPassword, String   whiteListEntry) throws WhiteListEntryNotFoundException, MantaSecurityException, JMSSecurityException  ;
237 
238     /**
239      * Returns the list of all users.
240      *
241      * @param authenticationUsername the authentication username
242      * @param authenticationPassword the authentication password
243      * @return a list of all users
244      * @throws MantaSecurityException if an error occured
245      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
246      */
247     public Collection   getUsers(String   authenticationUsername, String   authenticationPassword) throws MantaSecurityException, JMSSecurityException  ;
248 
249     /**
250      * Returns the list of all groups.
251      *
252      * @param authenticationUsername the authentication username
253      * @param authenticationPassword the authentication password
254      * @return a list of all groups
255      * @throws MantaSecurityException if an error occured
256      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
257      */
258     public Collection   getGroups(String   authenticationUsername, String   authenticationPassword) throws MantaSecurityException, JMSSecurityException  ;
259 
260     /**
261      * Returns the list of all white list entries.
262      *
263      * @param authenticationUsername the authentication username
264      * @param authenticationPassword the authentication password
265      * @return a list of all white list entries
266      * @throws MantaSecurityException if an error occured
267      * @throws JMSSecurityException if action is unauthorized for the username specified in authenticationUsername
268      */
269     public Collection   getWhiteList(String   authenticationUsername, String   authenticationPassword) throws MantaSecurityException, JMSSecurityException  ;
270 }
271
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags