Security Administration - Get Operations for User Example

Get Operations for User Example

Example Overview
Integration with Web NMS
Sample Output
De-referencing

Example Overview

Example name : GetOperationsForUser.java
Location : <Web NMS Home>/examples/Security/authorization directory

This example explains how to use the method "getOperationsForUser(java.lang.String userName)" and will return the list of authorized operations for the specified user.

The interface used in this example is AuthorizationEngine

Method used in this example is :

getOperationsForUser(java.lang.String userName)

This method is used to get a list of operations authorized for this specified user name.

Specified by: getOperationsForUser() in interface AuthorizationEngine
Parameters: userName - the name of the user for which the operations list is to be retrieved.
Returns: A Vector which contains a list of operations authorized for the specified user name.
Throws: AuthorizationException - if there is any null parameter, any exception or error during database operation.
java.rmi.RemoteException - In case of RMI.

After getting handle of the NmsAuthEngineAPI through an RMI lookup, the example gets the allowed operations for a given user.

Note : The source code will have comment statements in it which will explain to you the different segments of the program.

Integration with Web NMS

The steps given below will help you in integrating this example with Web NMS. If any of the steps given below are not followed properly, then the example might not function in a desired manner.

Set the <Web NMS Home>/classes directory to classpath
Compile the GetOperationsForUser.java source file [ javac -d <Web NMS Home>/classes GetOperationsForUser.java ]
Ensure that the class file is placed in the <Web NMS Home>/classes directory after compilation, in line with the package name specified in the program
Now start the Web NMS Server and wait till it successfully starts up
Execute the program, giving a username as argument (Ideally, the user must exist !) as given below :

java com.adventnet.nms.example.security.authorization.GetOperationsForUser <username>

Sample Output

If there are operations assigned to the user, the output message printed in your console will be : "The operations for the user <username> are : <list of operations>"

Alternatively, if there are no operations assigned to the user, the following message is printed : "No operations for user <username>"

De-referencing

After you have tried this example, to remove its association with Web NMS, you must remove the class file GetOperationsForUser.class from <Web NMS Home>/classes/com/adventnet/nms/example/security/authorization directory.