KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > mr > kernel > security > impl > management > jmx > 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 JavaDoc;
6
7 import org.mr.kernel.security.MantaSecurityException;
8
9 import java.util.Collection JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc newUsername, String JavaDoc newUserGroup, String JavaDoc newUserPassword, int newUserGIDNumber, int newUserUIDNumber, String JavaDoc newUserSurname, String JavaDoc newUserCommonName) throws PrincipalAlreadyExistsException, PrincipalNotFoundException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc newGroupName) throws PrincipalAlreadyExistsException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc oldUsername, String JavaDoc newUsername) throws PrincipalNotFoundException, PrincipalAlreadyExistsException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc oldGroupName, String JavaDoc newGroupName) throws PrincipalNotFoundException, PrincipalAlreadyExistsException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc username, String JavaDoc groupName) throws PrincipalNotFoundException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc username, String JavaDoc password) throws PrincipalNotFoundException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc permissionName, String JavaDoc permissionParam, String JavaDoc username) throws PrincipalNotFoundException, PermissionAlreadyExistsException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc permissionName, String JavaDoc permissionParam, String JavaDoc groupName) throws PrincipalNotFoundException, PermissionAlreadyExistsException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc getPermissionsForUser(String JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc username) throws PrincipalNotFoundException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc getPermissionsForGroup(String JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc groupName) throws PrincipalNotFoundException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc username) throws PrincipalNotFoundException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc groupName) throws PrincipalNotFoundException, GroupNotEmptyException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc permissionName, String JavaDoc permissionParam, String JavaDoc username) throws PermissionNotFoundException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc permissionName, String JavaDoc permissionParam, String JavaDoc groupName) throws PermissionNotFoundException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc whiteListEntry) throws WhiteListEntryAlreadyExistsException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc authenticationUsername, String JavaDoc authenticationPassword, String JavaDoc whiteListEntry) throws WhiteListEntryNotFoundException, MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc getUsers(String JavaDoc authenticationUsername, String JavaDoc authenticationPassword) throws MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc getGroups(String JavaDoc authenticationUsername, String JavaDoc authenticationPassword) throws MantaSecurityException, JMSSecurityException JavaDoc;
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 JavaDoc getWhiteList(String JavaDoc authenticationUsername, String JavaDoc authenticationPassword) throws MantaSecurityException, JMSSecurityException JavaDoc;
270 }
271
Popular Tags