# OAuth 2.0 Credentials

VM Essentials supports storage of credential sets for retrieving temporary access tokens, through OAuth 2.0, and using the tokens to access some resource. These credential sets can be used with REST-type Option Lists to retrieve information behind this type of authentication wall. Once stored, the credential can be used with as many Option Lists as needed and potentially in other areas of the product in the future.

To create a new credential set, click + ADD and then select “OAuth 2.0”. Complete the following, not all fields are present or required in every context:

- **CREDENTIAL STORE:** Select “Internal” or an integrated external Cypher store (if any). See the next section for instructions on standing up and integrating with an external Cypher store
- **NAME:** A name for the credential set in VM Essentials
- **DESCRIPTION:** An optional description for the credential set
- **ENABLED:** If checked, the credential set will be available for use
- **GRANT TYPE:** Client Credentials or Password Credentials
- **ACCESS TOKEN URL:** The authorization server’s token endpoint
- **CLIENT ID:** The client ID for an app registered with the target service
- **CLIENT SECRET:** The client secret, often needed when requesting access outside the context of a specific user
- **USERNAME:** (Only present with “Password Credentials” Grant Type) The username for a user with target data access
- **PASSWORD:** (Only present with “Password Credentials” Grant Type) The password for the user indicated above
- **SCOPE:** The scope of access requested to the target resource
- **CLIENT AUTHENTICATION:** “Send as basic auth header” or “Send client credentials in body” - Indicates how VM Essentials should issue the token received in requests to the target resource

Once done, click ADD CREDENTIALS.

**Subtopics**  

- **[Add Existing Key Pair](https://support.hpe.com/hpesc/public/api/document/sd00007735en_us/render?page=GUID-3BCC85EA-1CBD-405F-AEFC-844BF2D9FE6C.html)**
- **[Generate Key Pair](https://support.hpe.com/hpesc/public/api/document/sd00007735en_us/render?page=GUID-DFC73E7E-71E9-4FF1-A338-9944A8413A9D.html)**
- **[Delete Key Pair](https://support.hpe.com/hpesc/public/api/document/sd00007735en_us/render?page=GUID-5D0F2D33-623B-4AA3-A767-48980AA8A4E1.html)**
