Documentation forServer & Application Monitor

Manage credentials for API pollers and AppOptics integrations in SAM

Starting in SAM 2020.2.5, the Manage Credentials page serves as a centralized credential store for the following types of SAM credentials:

Supported credential types include:

  • API Key: A long random string passed between applications and often used in API poller request URLs and headers.
  • Basic Authorization: Also called "Basic Auth," this method passes usernames and passwords in request headers, sent via HTTPS and encoded with Base64 for security. Passwords are required.
  • Bearer Token: Also called "token authentication," this scheme uses access tokens to authenticate requests, in the form of text strings added to request headers (for example, Authorization: Bearer <Your API Key>).
  • OAuth 2.0: Uses access tokens that an API server passes to an authentication server to grant access via public and private keys. To learn more about Grant Type, Tenant ID, and other OAuth terms, see API credentials.
  • SolarWinds Cloud Token: An API token generated for an active AppOptics organization. See Retrieve a SolarWinds Cloud Token to integrate AppOptics with SAM.

Note the following details about the Manage Credentials page:

  • There are several places in SAM where you can work with credentials, such as the Credentials Library for component monitors. For details, see Manage credentials in SAM.
  • Related logs are stored in this default location: ProgramData\SolarWinds\Logs\SolarWinds.Credentials\SolarWinds.Credentials\SolarWinds.Credentials.log
  • The SolarWinds Credentials feature uses port 38008.

To access the Manage Credentials page:

  1. Log into the Orion Web Console with an Orion administrator account.

  2. Click Settings > All Settings.
  3. Scroll down to the Credentials section of the page and click Manage API Poller Credentials.

To add a credentials set: 

  1. Click New.
  2. Specify the type of Authorization you're adding credentials for.
  3. Add a name for the set of credentials and fill out the remaining fields
  4. Click Save.
Added credentials are currently sent by HTTP in plain text, instead of HTTPS. Consider adding credentials by logging into the Orion Web Console directly from the Orion server.

To edit existing credentials:

  1. Select the credential set you want to edit.
  2. Click Edit.
  3. Modify values, as necessary.
  4. Click Save.

To delete credentials:

  1. Select credentials you want to delete.

    Credentials currently in use cannot be deleted. For example, if credentials are assigned to a SolarWinds Service Desk API poller, you'll need to remove credentials from that poller before deleting them on the Manage Credentials page.

  2. Click Delete.
  3. When prompted, confirm the permanent deletion of the credentials.

Deleting credentials is permanent.