000026969 - Alternative methods for adding Users in RSA NetWitness Platform

Document created by RSA Customer Support Employee on Jun 14, 2016Last modified by RSA Customer Support on Sep 26, 2019
Version 4Show Document
  • View in full screen mode

Article Content

Article Number000026969
Applies ToRSA Product Set: NetWitness Logs & Network
RSA Product/Service Type: NW Server
RSA Version/Condition: 10.6.x, 11.x
Platform: CentOS 6, 7
IssueAlternative methods for adding Users in RSA NetWitness
Provide alternatives to adding Users via NetWitness (NW) UI.
How can I add Users with NwConsole?
How can I add Users through the REST interface?

NwConsole - Adding Users

Example of adding local users to a broker using a NwConsole one-liner. The -c is used to separate multiple commands run within NwConsole.

NwConsole -c login localhost:50003 admin admin_acct_password -c /users addOrMod name=exampleuser password=exampleuserpassword groups=Administrators authType=netwitness queryTimeout=20

Note: make sure you use single quotes ' if your password contains special characters.


REST Interface - Adding Users

The REST interface is another way that an administrator can maintain appliances. It uses HTTP protocol to transfer queries. Some administrators use this to perform user management using scripting.


curl --user '$USERNAME:$PASS' 'http://$IPADDRESS:$PORT/users?msg=addOrMod&name=$USERNAMETOCREATE&password=$USERSPASSWORD&groups=$WHICHGROUP&queryTimeout=$MIN'



$USERNAME: Username of the account used to run REST query e.g. admin

$PASS: Password of the account used to run REST query

$IPADDRESS: your Appliance IP address

$PORT: REST port

$USERNAMETOCREATE: Username you wish to add

$USERSPASSWORD: User's password

$WHICHGROUP: which group user will be a member of e.g. Administrators

$MIN: The maximum number of minutes that a query is allowed to execute for this user.  Zero means unlimited.

Hint: You may not want to sent password in cleartext via REST, you can send password as a hash instead


curl --user '$USERNAME:$PASS' 'http://$IPADDRESS:$PORT/users?msg=addOrMod&name=$USERNAMETOCREATE&password=$HASH&pwdIsHashed=true&groups=$WHICHGROUP&queryTimeout=$MIN'

$HASH: Is a salted SHA256 hash.
Legacy Article IDa64782