# Credential Management

To enable secure integration between **ReleaseOwl** and **SAP API Management**, credentials must be registered within ReleaseOwl’s Credential Manager. This process ensures authenticated access to the SAP API Portal for deploying and promoting API artifacts as part of DevOps pipelines.&#x20;

### Step-by-Step Guide: Registering Credentials in ReleaseOwl

**1. Navigate to Credential Manager**

* From the Administration menu, go to **Credential Manager**.
* Click **Register Credential**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FtRzdbMQQbOhVSoOZkhP5%2Fimage.png?alt=media&#x26;token=5b23e23f-0cdc-4dba-8d05-2898a07006ad" alt=""><figcaption></figcaption></figure>

**2. Provide Credential Details**

* **Credential Name**: Enter any identifiable name for the credential.
* **Credential Type**: Select **API Management**.
* **Scope** – Select the scope of the credential:
  * **Global** – Visible to all users.
  * **Private** – Visible only to the user who created it.
*   **Authentication Type:**  You have **two options** to register your credentials:

    **Option A: Upload Credentials File**

    * Click the **Browse** button.
    * Upload the credentials file downloaded from **SAP BTP Cockpit** (API Management Service).

    **Option B: Manual Entry**

    * If choosing **Manual Entry**, provide the required details from the **API service key** created in **SAP BTP Cockpit**. (The steps to create and extract the API service key are explained below.)

    <figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FM1r5dqDyGUAXyRYMzlUO%2Fimage.png?alt=media&#x26;token=ba9b6e2c-7fae-42d0-9feb-96db720d0a27" alt=""><figcaption></figcaption></figure>

### Steps to Retrieve API Management Details from SAP BTP Cockpit

To retrieve the **Client ID**, **Client Secret**, and **Token URL** for SAP API Management integration, follow these steps:

#### 3. Access the SAP BTP Cockpit

1. Go to the **SAP BTP Cockpit** and log in with your credentials.
2. In the **SAP BTP Cockpit**, navigate to **Instances and Subscriptions**.
3. Click on the **Create** button.
4. Fill in the necessary details as follows:
   * **Service**: API Management, API Portal
   * **Plan**: `apiportal-apiaccess`
   * **Runtime Environment**: Cloud Foundry
   * **Space**: Dev
   * **Instance Name**: Enter a name of your choice

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FBiJxwVVKrn0bnkoeNppL%2Fimage.png?alt=media&#x26;token=44a5a404-f119-451c-a645-ace3e7b23e8d" alt=""><figcaption></figcaption></figure>

#### 4. Create a Service Key

1. After the instance is created, click the **three-dot menu (⋮)** next to it.
2. Select **"Create Service Key"**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Ff99LPE05pFc7TqZCMR04%2Fimage.png?alt=media&#x26;token=dad579ce-6c4d-4115-bef8-9785ba26a861" alt=""><figcaption></figcaption></figure>

3. Enter a **name** for the key (e.g., `api-access-key`) and click **Create**.
4. Once created, click on the key to view credentials like `clientid`, `clientsecret`, and `url` — used for API authentication.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fa6OogPCgnQq6ITlSAykx%2Fimage.png?alt=media&#x26;token=b1e16dd4-881c-4c57-9540-5d6d073c7011" alt=""><figcaption></figcaption></figure>

### Steps to Complete Credential Registration in ReleaseOwl

**5. Enter Service Key Details in ReleaseOwl**

* Use the copied details from the service key:
  * **d. Client ID**: Paste the Client ID.
  * **e. Client Secret**: Paste the Client Secret.
  * **f. Token URL**: Paste the Token URL.

**6. Save Credential**

* Click **Save**.
* The credential will appear in the **List of Credentials**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fiezzdzx5v1EFJdITLX59%2Fimage.png?alt=media&#x26;token=8d50f684-5f8c-4cbe-91d3-611759e05a9f" alt=""><figcaption></figcaption></figure>
