GUI: Bulk Add Users

JavaScript is not currently enabled, but is required for full CodeSonar manual search and browse functionality.

If you are viewing this file in your hub's Web GUI, enable JavaScript in your browser: you will also need it for GUI functionality.

If you opened this file directly from disk, your browser may be directly suppressing JavaScript functionality: certain browsers perform this suppression on local files (but not files delivered by web servers) for security reasons.

If you access the manual through the hub's Web GUI, the functionality will not be suppressed because the hub is a web server.
Alternatively, your browser may allow you to explicitly disable the security setting that suppresses functionality. See the CodeSonar FAQ for more information.

CodeSonar^® 9.2p0

CONFIDENTIAL

CodeSecure Inc

GUI Reference: Bulk Add Users

Create new user accounts in bulk.

Use this page if:

The special Anonymous user does not have G_CREATE_USER permission and no authentication services have been configured (or there are configured authentication services but some users will not be able to use them), or
you want to assign warnings to users who have never logged in, or
you want to configure access control for users who have never logged in.

Otherwise, you can have users create their own accounts on an as-needed basis. This includes users signing in using authentication services such as LDAP.

Important Note: the CodeSonar Web GUI makes extensive use of JavaScript. Make sure JavaScript is enabled in your web browser.

Navigating To

From Settings:	In the User Administration tab , click Bulk Add Users.
From Users:	Click the Bulk Add Users link (under the page heading).
By URL:	http://hub_location/bulk_add_users.html

From Settings:

In the User Administration tab , click Bulk Add Users.

From Users:

Click the Bulk Add Users link (under the page heading).

By URL:

http://hub_location/bulk_add_users.html

Page Properties

Page Access

G_CREATE_USER

Page Contents/Functionality

G_ADMINISTER_USERS
G_MANAGE_USERS

Contents and Usage

The following annotated screenshot shows the various parts of a Bulk Add Users page.

Standard Header	See GUI Reference: Standard Header.
Breadcrumbs	Home > Settings > Bulk Add Users where Home links to the GUI Home page Settings links to the Settings page
Page Heading	Bulk Add Users
Text Field	Enter the new usernames in this field, with one name per line, then click the Add Users button to add all the specified users to the hub. To specify an email address for an account, use a line of the form username \| emailaddress. If you do not specify an email address, the Email for the corresponding account will be set to NULL. For example: alice bob \| bob@example.com carol \| carol@example.com dan
Property Selectors	Specify additional properties for the new accounts. Template User: specify the user to use as the template for the new user accounts. This field is only available if you have G_ADMINISTER_USERS or G_MANAGE_USERS permission. Otherwise, the template for the new account will be the default template user. Enable Users: if selected, the new accounts will have the special Enabled role. If deselected, they will not. Being assigned the Enabled role is sufficient to guarantee that all the new users will have G_SIGN_IN permission, but note that: the users will also need at least one of at least one of G_SIGN_IN_CERTIFICATE, G_SIGN_IN_PASSWORD in order to sign in, and if an administrator has added further role-permissions to the Enabled role, those will also apply.
Add Users Button	Click to add the users listed in the text field The page will list the new accounts that were added, and note any accounts that could not be added because they already existed. If a hub user account with the specified name already exists and has a non-NULL Email, the user account will not be modified. If a hub user account with the specified name already exists but its Email is NULL, the email for that account will be changed to the specified address (if any). No other changes will be made. For example: 3 new user(s) were added: alice dan carol with email carol@example.com 1 user(s) already existed: bob Users that exist in any of the configured authentication services will be able to sign in immediately using the corresponding credentials. Any remaining users will require passwords before they can sign in. Either: set their passwords in the Account Editor (accessed from the Manage Users page), or have them use the Forgot Password feature to reset their passwords. The Forgot Password feature works by emailing a reset code to the user: if you plan to use this approach, make sure that you have specified an email address for each new user and that SMTP is configured for the hub.
General Information	Additional guidelines for adding new users.
Standard Footer	See GUI Reference: Standard Footer.

Standard Header

See GUI Reference: Standard Header.

Breadcrumbs

Home > Settings > Bulk Add Users
where

Home links to the GUI Home page
Settings links to the Settings page

Page Heading

Bulk Add Users

Text Field

Enter the new usernames in this field, with one name per line, then click the Add Users button to add all the specified users to the hub. To specify an email address for an account, use a line of the form username | emailaddress. If you do not specify an email address, the Email for the corresponding account will be set to NULL.

For example:

alice
bob | bob@example.com
carol | carol@example.com
dan

Property Selectors

Specify additional properties for the new accounts.

Template User: specify the user to use as the template for the new user accounts.
This field is only available if you have G_ADMINISTER_USERS or G_MANAGE_USERS permission. Otherwise, the template for the new account will be the default template user.
Enable Users: if selected, the new accounts will have the special Enabled role. If deselected, they will not.
Being assigned the Enabled role is sufficient to guarantee that all the new users will have G_SIGN_IN permission, but note that:
- the users will also need at least one of at least one of G_SIGN_IN_CERTIFICATE, G_SIGN_IN_PASSWORD in order to sign in, and
- if an administrator has added further role-permissions to the Enabled role, those will also apply.

Add Users Button

Click to add the users listed in the text field

The page will list the new accounts that were added, and note any accounts that could not be added because they already existed.

If a hub user account with the specified name already exists and has a non-NULL Email, the user account will not be modified.
If a hub user account with the specified name already exists but its Email is NULL, the email for that account will be changed to the specified address (if any). No other changes will be made.

For example:

3 new user(s) were added:
alice
dan
carol with email carol@example.com


1 user(s) already existed:
bob

Users that exist in any of the configured authentication services will be able to sign in immediately using the corresponding credentials. Any remaining users will require passwords before they can sign in. Either:

set their passwords in the Account Editor (accessed from the Manage Users page),
or
have them use the Forgot Password feature to reset their passwords.
The Forgot Password feature works by emailing a reset code to the user: if you plan to use this approach, make sure that you have specified an email address for each new user and that SMTP is configured for the hub.

General Information

Additional guidelines for adding new users.

Standard Footer

See GUI Reference: Standard Footer.