Creating Credentials for Vulnerability Scans

Applies to Product: USM Appliance™ LevelBlue OSSIM®

Although optional, we recommend that you use credentials to perform authenticated vulnerability scans. Authenticated scans shouldn't replace network scans, but they use less bandwidth, because they're performed locally, and yield better and more relevant results than unauthenticated scans. They are also more comprehensive and have fewer false positives than unauthenticated scans. For example, authenticated scans check installed software packages, local processes, and services running on the network.

Before running authenticated vulnerability scans in USM Appliance, you need to create some credentials first. For requirements on these credentials, see System Settings for Authenticated Scans. USM Appliance encrypts the credentials using Advanced Encryption Standard (AES) and stores them in the database. The AES algorithm uses Electronic Codebook (ECB) mode and supports a block length of 128 bits.

To create a set of credentials

  1. Go to Environment > Vulnerabilities > Overview, and then click Settings.

    Settings dialog box from Overview.

  2. In the Name field under New Credential, enter a name for the credential.

  3. In the Available For section, select one of the following:

    • A single user with permission to use this credential.
    • An entity that allows access by all users who are members of that entity.

  4. In the Login field, type the login name for the credential.

    Note: To specify a domain, use the syntax "<domain>\<user>", where <domain> is the domain name and <user> is the login name. If you do not specify a domain, USM Appliance uses "WORKGROUP\<user>" because it is the default workgroup name on Windows.

  5. Authenticate yourself by selecting one of the following:

    • (Default) Type the password for the credential in the Password field.
    • Select Key Pair, and then click Choose File to browse to the location of your private key or key pair file, and then click Open.

  6. Click Create Credential.

    A message appears at the top of the page to confirm that you successfully created the new credential.

    The new credential appears under Credentials (shown in the following illustration).

    Settings dialog box with Credentials highlighted.

To edit an existing credential

  1. Click the check mark and pencil icon (Test credentials icon).
  2. In the dialog box that appears, click inside of the empty field below the username or entity (shown).

  3. Type or select the appropriate IP address, and then click Check.

    USM Appliance displays the message:

    Checking...

    When the authentication process has completed, the Check Credential dialog box displays either "Wrong Credentials" or "Successfully logged in" under Status.

    Check Credential popup.

To delete a credential

  • Click the trash can icon (Delete icon).