Create and manage credentials for your instances

Prerequisites

• You have created a Redis instance.
  Check Create and manage instances for Redis

List, create, view and delete a service keys:

This article describes how to handle credentials for your Redis 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 Redis instance:

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

stackit redis credentials list --instance-id <instance-id>

You get something like the following output:

 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 > Redis.
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 new service key

STACKIT CLI

To create a service key for a Redis 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 redis credentials create --instance-id <instance-id>

You get an output similiar to this:

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

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

STACKIT Portal

1. Open your project in the STACKIT Portal.
2. Navigate to Databases > Redis.
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 popup to appear and copy all information to a safe place.

Cloud Foundry CLI

1. To use the Cloud Foundry CLI you first need to login into your STACKIT project endpoint. Read Interact with Cloud Foundry to get 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 Redis 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 redis credentials describe <credentials-id> --instance-id <instance-id>

You can get use List service keys to get the credentials-id for the requested service key.

You get an output which is similiar to the following:

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

STACKIT Portal

1. Open your project in the STACKIT Portal.
2. Navigate to Databases > Redis.
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 watch

Delete a service key

STACKIT CLI

To delete a service key for a Redis 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 redis credentials delete <credentials-id> --instance-id <instance-id>

After comfirmation you get the following output:

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

STACKIT Portal

1. Open your project in the STACKIT Portal.
2. Navigate to Databases > Redis.
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 login into your STACKIT project endpoint. Read Interact with Cloud Foundry to get 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.