Introduction
In OpsRamp, credentials play a vital role for secure access and management of resources in your IT environment. Credentials are sets of authentication details like usernames, passwords, keys that are used to connect to various resources in your platform.
OpsRamp supports a wide range of credential types like Application, SNMP, VMware, Windows (WMI), Linux OS - Agentless (SSH), and Nutanix.
Configuration and management of credentials is essential for a secure connection across your infrastructure and proper monitoring of IT resources.
Prerequisites
To create a credential set with a password vault, there should be an installed Password Management integration, like Hashicorp, ManageEngine Password Manager.
Note
Following permissions are required to create a credential:
- Integration_View
- Credentials_Manage
- Resources_View
Note: This feature is available only at the client level.
Create a credential
Follow these steps to create a credential:
Click Setup > Account.
From ACCOUNT DETAILS screen, click Credentials tile.
Click +ADD.
Enter the following information in CREDENTIALS screen:
CREDENTIALS
Field Name Field Type Description Credential Type Dropdown Select credential type.
Based on credential type selected, the input fields vary.Name String Provide a name for the credential. Description String Provide a brief description about the credential. User Name String Enter the User Name. Password String Enter a strong password. Port Integer Enter port number.
Secure: Select this checkbox to enable secure connection.Connection Timeout (ms) Integer Enter the connection time out.
Example: 10000.Password Vault (Optional) Checkbox Select the checkbox. The Integration and Policy Mapping dropdowns are displayed.
All installed Password Management integrations are listed in the Integrations dropdown.- Select integration from Integration dropdown.
- Select vault policy from Policy Mapping dropdown.
Assigned Resources Dropdown Select resources from the dropdown.
You can click ADVANCED SEARCH to search for resources.
Select resources from resource list or click +QUERY to build a query using OpsQL.
Note: You can select e maximum of 50 resources.Click SAVE. The credential is saved and listed on CREDENTIALS listing screen.
Follow these steps to configure credential types such as SNMP, Linux OS - Agentless (SSH), WINDOWS (WMI):
SNMP
For SNMP as credential type
Enter the following information in CREDENTIALS screen:
Field Name Field Type Description Credential Type Dropdown SNMP Name String Provide a name for the credential. Description String Provide a brief description about the credential. SNMP Version Dropdown Select a version. Default is V1.
Note: For Version V3, the input fields vary. Specify Context, Security Name, and Security Level.
For more information, see SNMP field values.Port Integer Enter the port number. Default is 161.
For more information, see SNMP field values.Community String Enter the community string. Default is public. Connection Timeout(ms) Integer Specify the connection timeout in milliseconds. Password Vault (Optional) Checkbox Select the checkbox. The Integration and Policy Mapping dropdowns are displayed.
All installed Password Management integrations are listed in the Integrations dropdown.- Select integration from Integration dropdown.
- Select vault policy from Policy Mapping dropdown.
Assigned Resources Dropdown Select resources from the dropdown.
You can click ADVANCED SEARCH to search for resources.
Select resources from resource list or click +QUERY to build a query using OpsQL.Click SAVE. The credential is saved and listed on CREDENTIALS listing screen.
Linux OS - Agentless (SSH)
For Linux OS - Agentless (SSH) as credential type
Enter the following information in CREDENTIALS screen:
Field Name Field Type Description Credential Type Dropdown SSH Name String Provide a name for the credential. Description String Provide a brief description about the credential. Authentication Type Dropdown PASSWORD or KEYPAIR types are available.
For Password, enter username, password, and confirm password fields.
For Keypair, enter username, upload a file through the Upload via file option or provide a link through the Already has a link option.SSH Key Passphrase String Enter passphrase. To ensure that you have typed the correct passphrase, click the eye icon to view the passphrase that you entered. Confirm SSH Key Passphrase String Reenter the passphrase. To ensure that you have typed the correct passphrase, click the eye icon to view the passphrase that you entered. Secure Checkbox Select this checkbox to enable secure connection. Port Integer Enter the port number. Default is 22. Connection Timeout(ms) Integer Specify the connection timeout in milliseconds.
Example: 10000Password Vault (Optional) Checkbox Select the checkbox. The Integration and Policy Mapping dropdowns are displayed.
All installed Password Management integrations are listed in the Integrations dropdown.- Select integration from Integration dropdown.
- Select vault policy from Policy Mapping dropdown.
Assigned Resources Dropdown Select resources from the dropdown.
You can click ADVANCED SEARCH to search for resources.
Select resources from resource list or click +QUERY to build a query using OpsQL.Click SAVE. The credential is saved and listed in CREDENTIALS listing screen.
WINDOWS (WMI)
For Windows (WMI) as credential type
Enter the following information in CREDENTIALS screen:
Field Name Field Type Description Credential Type Dropdown WINDOWS Name String Provide a name for the credential. Description String Provide a brief description about the credential. Domain Name String Enter domain name.
Example: AdministratorUser Name String Enter username. Password String Enter the password. To ensure that you have typed the correct password, click the eye icon to view the password that you entered. Confirm Password String Reenter the password. To ensure that you have typed the correct password, click the eye icon to view the password that you entered Connection Timeout(ms) Integer Specify the connection timeout in milliseconds.
Example: 10000Password Vault (Optional) Checkbox Select the checkbox. The Integration and Policy Mapping dropdowns are displayed.
All installed Password Management integrations are listed in the Integrations dropdown.- Select integration from Integration dropdown.
- Select vault policy from Policy Mapping dropdown.
Assigned Resources Dropdown Select resources from the dropdown.
You can click ADVANCED SEARCH to search for resources.
Select resources from resource list or click +QUERY to build a query using OpsQL.Click SAVE. The credential is saved and listed in CREDENTIALS listing screen.
Similarly, configure credential set for other credential types like Application, CiscoUCS, Nutanix, VMware, XEN.
Manage credentials
You can perform the following actions on credentials.
Action | Steps |
---|---|
Search | To search for a credential:
|
Filter | You can filter credentials by credential type:
|
View and Edit | To view or edit credential information:
|
Remove | To remove a credential:
|