Create and manage key rings

Prerequisites

• You have a STACKIT customer account: Create a customer Account
• You have a STACKIT user account: Create a user account
• You have a STACKIT project: Create a project

Create a key ring

STACKIT Portal

1. On the left bar click on KMS.
2. On the top bar click on Create key ring.
3. Fill in a Key ring name and optionally a description.

   You can not change the name of the key ring afterwards.

4. Click on Create
5. Wait for your new key ring to reach the Active state.

STACKIT API

The first step to use the STACKIT KMS is creating a new key ring. Using curl, replace projectId with the UUID of the project you want to create the key ring in.

curl --header "Content-Type: application/json" \
--header "Authorization: Bearer <access-token>"
--request POST \
--data '{"description":"New Keyring","displayName":"KMS"}' \
https://kms.api.eu01.stackit.cloud/v1/projects/<project-id>/regions/<region-id>/keyrings

List and view details of key rings

STACKIT Portal

1. On the left bar click on KMS.
2. You see a list of all your key rings for this project.
3. Click on an entry in the list to view its details.

Delete a key ring

STACKIT Portal

1. On the left bar click on KMS.
2. Navigate to the key ring entry you want to delete and click on the three-dots-menu and select Delete.
3. Enter the instance’s name and click on Delete.