Create and manage credentials for your Key Value Store instances

Prerequisites

• You have created a Key Value Store instance.
  Check Create and manage instances for Key Value Store

List, create, view, and delete service keys:

This article describes how to handle credentials for your Key Value Store instance. A service key is the only available form of credential that you can create for now. With a service key, you can fully authenticate yourself against your instance.

List service keys

STACKIT CLI

To get a list of all service keys for a Key Value Store instance:

Flag	Description
--instance-id	Instance ID of the instance you want to query

stackit key-value-store credentials list --instance-id <instance-id>

You will get an output similar to the following:

 ID
──────────────────────────────────────
b355ca17-4231-467c-b7f5-e22f979777f1

In this case, b355ca17-4231-467c-b7f5-e22f979777f1 is the service key ID.

STACKIT Portal

1. Open your project in the STACKIT Portal.
2. Navigate to Databases > Key Value Store.
3. Choose your instance and go to the overview.
4. On the sidebar, select Credentials.

Now you can see the list of service keys for your instance. Click on an entry in the list to see the details.

Create a service key

STACKIT CLI

To create a service key for a Key Value Store instance:

Flag	Description	Default	Optional
--instance-id	Instance ID of the instance you want to query
--show-password	Username of the new user		x

stackit key-value-store credentials create --instance-id <instance-id>

You will get an output similar to this:

Created credentials for instance "keyvalue-ypqvqby0khea".
Credentials ID: 67a5f5c3-121b-452e-baa2-43afaee9ca43

Username: a9s-brk-usr-fdd2f75db85a8291c91e50f621970f4aacb19c3ad1ed305b4f057
Password: <hidden>
Host: kvd601d47-master-1.data.eu01.onstackit.cloud
Port: 53137
URI: rediss://a9s-brk-usr-fdd2f75db85a8291c91e50f621970f4aacb19c3ad1ed305b4f057:<hidden>@kvd601d47-master-1.data.eu01.onstackit.cloud:53137

STACKIT Portal

1. Open your project in the STACKIT Portal.
2. Navigate to Databases > Key Value Store.
3. Choose your instance and go to the overview.
4. On the sidebar, select Credentials.
5. On the top bar, click on Create credentials.
6. Wait for the pop-up to appear and copy all information to a safe place.

Cloud Foundry CLI

1. To use the Cloud Foundry CLI, you first need to log in to your STACKIT project endpoint. Read Interact with Cloud Foundry for help logging in.

2. Create the service key with the cf command:

   cf create-service-key [service-name] [service-key]

   STACKIT Portal/CLI and Cloud Foundry cross-management is not possible. Read Service isolation between STACKIT Portal/CLI and Cloud Foundry to get more information.

3. List the service key with the cf command:

   cf service-key [service-name] [service-key]

View a service key

STACKIT CLI

To get details of a service key for a Key Value Store instance:

Flag	Description	Default	Optional
--instance-id	Instance ID of the instance you want to query
--credentials-id	The ID of the service key

stackit key-value-store credentials describe <credentials-id> --instance-id <instance-id>

You can use List service keys to get the credentials-id for the requested service key. You will get an output similar to the following:

ID       │ 67a5f5c3-121b-452e-baa2-43afaee9ca43
──────────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────>
USERNAME │ a9s-brk-usr-fdd2f75db85a8291c91e50f621970f4aacb19c3ad1ed305b4f057
──────────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────>
PASSWORD │ a9s215dd18cb44612ad154f13ecc7fa80c50bfdf90604854eab9edb56eb56217f
──────────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────>
URI      │ rediss://a9s-brk-usr-fdd2f75db85a8291c91e50f621970f4aacb19c3ad1ed305b4f057:<hidden>@kvd601d47-master-1.data.eu01.onstackit.cloud:53137

STACKIT Portal

1. Open your project in the STACKIT Portal.
2. Navigate to Databases > Key Value Store.
3. Choose your instance and go to the overview.
4. On the sidebar, select Credentials.
5. Click on the service key entry you want to view.

Delete a service key

STACKIT CLI

To delete a service key for a Key Value Store instance:

Flag	Description	Default	Optional
--instance-id	Instance ID of the instance you want to query
--credentials-id	The ID of the service key

stackit key-value-store credentials delete <credentials-id> --instance-id <instance-id>

After confirmation, you will get the following output:

Deleted credentials b355ca17-4231-467c-b7f5-e22f979777f1 of instance "my-key-value-instance"

STACKIT Portal

1. Open your project in the STACKIT Portal.
2. Navigate to Databases > Key Value Store.
3. Choose your instance and go to the overview.
4. On the sidebar, select Credentials.
5. Click on the three dots on the right side of a user entry.
6. Click on Delete.

Cloud Foundry CLI

1. To use the Cloud Foundry CLI, you first need to log in to your STACKIT project endpoint. Read Interact with Cloud Foundry for help logging in.

2. Delete the service key with the cf command:

   cf delete-service-key [service-name] [service-key]

   STACKIT Portal/CLI and Cloud Foundry cross-management is not possible. Read Service isolation between STACKIT Portal/CLI and Cloud Foundry to get more information.