GUI Reference: Sign In

• Navigating to
• Page Contents
• Sign In
• Create Account
• Forgot Password
• Enter Emailed Code
• Navigating from
• Related Tasks

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

Navigating to the Page

The Sign In page can be reached in any of the following ways.

From any page:	Click the Sign In link in the GUI page header: If you are already logged in, the Sign in link will not be available. In its place will be an icon with your username: . To sign out, click this icon then click the Sign Out link that pops up.
By URL:	http://hub_location/sign_in.html
other cases:	If you try to perform an operation that is not permitted for the user account you are currently signed into (including the case where you are in an anonymous session and the operation is not permitted for special user Anonymous), CodeSonar will automatically navigate to the Sign In page and prompt you to sign in as a user with sufficient permissions.

Page Properties

Page Contents

The following annotated screen shot shows the various parts of the Sign In page.

Sign In with Password Tab

For signing in when you already have a hub user account.

Functionality for signing in with a username and password is always available.

Sign in with username and password

Signing into a user account with a username and password is only possible for accounts that have G_SIGN_IN and G_SIGN_IN_PASSWORD permissions.

To sign in:

1. Enter your username in the Username field.
2. Enter your password in the Password field. This can be:
   • the hub user account password for Username (if there is one), or
   • the password associated with Username in one of the third party authentication mechanisms configured for the hub.
3. Click Sign In.

Sign in with Certificate Tab

Signing into a user account with a TLS certificate is only possible for accounts that have :

• G_SIGN_IN and G_SIGN_IN_CERTIFICATE permissions, and
• at least one associated user certificate.

Additionally:

• your browser must have access to a local copy of the user certificate you wish to present, along with the corresponding private key, and
• the hub must have HTTPS enabled and be configured to permit certificate-based user authentication to see this tab.

To sign in:

1. Click Choose Certificate (under Authenticate with Certificate).
   The browser will prompt you to select a certificate (unless your browser remembers which certificate you have used with the hub in the past; restarting the browser may cause it to forget ).
2. Select the user certificate you wish to use, and confirm as prompted by your browser.

Create Account Tab

For creating a new hub user account.
You will only be able to access this tab if special user Anonymous has G_CREATE_USER permission.

The Create Account tab is very similar to the separate Create Account page, but differs in the following ways.

• It is only available to anonymous sessions, and only if user Anonymous has G_CREATE_USER permission.
• It does not provides the option to select a template user, because Anonymous is always treated as if it does not have G_ADMINISTER_USERS permission. The default template user is always used.
• If the new user account has G_SIGN_IN and G_SIGN_IN_PASSWORD permissions, you will be signed into it once it is created.

Creating a New Account

To create a new account:

1. Enter the username for the new user into the Username field.
2. Enter the user's contact email address in the Email Address field.
3. Enter the initial password for the new user into the Password field.
4. Enter the initial password into the Verify Password field.
5. Select Enabled if you want to assign the Enabled role to the new account, otherwise deselect it.
   Being assigned the Enabled role is sufficient to guarantee that the new user account will have G_SIGN_IN permission, but note the following.
   • The user will also need at least one of at least one of G_SIGN_IN_CERTIFICATE, G_SIGN_IN_PASSWORD in order to sign in. If the roles copied from the default template user do not provide at least one of these permissions, the new user will not be able to sign in.
   • If an administrator has added further role-permissions to the Enabled role, those will also apply.
6. Click Create account.

Forgot Password Tab

For requesting a forgotten password code.

Obtaining a forgotten password code

To request a code for resetting your password:

1. Enter the username associated with the account in the Username field on the Forgot Password tab.
2. Click Send Email.

   If all goes well:

   The forgotten password code will be emailed, and CodeSonar will display the Enter Emailed Code tab.

   Otherwise:

   CodeSonar will not email a forgotten password code if: the entered username that is not associated with a hub user account, or the username is associated with an account that does not have G_RECOVER_OWN_PASSWORD permission, or no SMTP server has been specified for the hub. For security reasons, CodeSonar will not notify that it is not emailing a code, nor specify the reason. If you do not receive an emailed code within a reasonable timeframe, consult your hub administrator for assistance. The administrator may need to do one or both of the following. Specify an SMTP server on the SMTP tab of the Settings page. Reset your password from the Account Editor.

3. To use the code, see Resetting a Password, below.

Enter Emailed Code Tab

For resetting a forgotten password once you have obtained a forgotten password code.

Resetting a Password

You will require G_RECOVER_OWN_PASSWORD permission to obtain a code, and G_CHANGE_OWN_PASSWORD permission to reset your password.

To reset a forgotten account password:

1. If you haven't already requested a forgotten password code, do it now.
2. Wait until email from CodeSonar arrives at the email address associated with the account, then open the email to retrieve the enclosed forgotten password code.
3. Enter the forgotten password code in the Emailed Code field.
4. Enter a new password for the account in the New Password field, then enter it again in the Verify New Password field.
5. Click Sign In.

   If all goes well:

   The account password will be changed, and you will be signed in under that account. If you created the account because you were asked to sign in to perform some operation (including navigation) in the web GUI, that operation will now proceed. Otherwise, you will be navigated to a screen with the contents You are signed in as username. Sign Out. Click Sign Out to sign out, use your browser's Back functionality to go back to an earlier page, or select Home from the page header to go to the Home page.

   Otherwise:

   If there is a problem with any of the information provided, CodeSonar will print a warning message instead of resetting the account password. At this point, the options are: Try again: use the information in the warning message to correct the problematic field or fields, then click Sign In. Abandon password resetting: use your browser's Back functionality to go back to an earlier page, or select Home from the page header to go to the Home page.

Navigating from the Page

Related Tasks

• Add a new user account