Create and manage Stack Credentials

Updated 2 months ago

To interact with Stacks using the Koyeb S3-API endpoint, you need to generate Stack Credentials to authenticate the Koyeb S3-API. This page showcases how to create Stack Credentials and how to revoke them.

After you have generated your Stack Credentials, you can start interacting with your Stacks using the Koyeb S3-compatible API endpoint.

Create Stack credentials

There are two steps to create new Stack Credentials:

  1. Give a name and description to your Stack Credentials
  2. Copy the Stack access_key and secret_key

Get started

On the Koyeb control panel, click Account in the left side panel. You land on the Account page. Click the Security tab to create a new Stack Credentials.

Account security

Click the "NEW" button to start generating new a Stack credential.

Give a name and description to your Stack credential

A modal appears on your screen, you are asked to give a name and description to your Stack Credentials. The name and description are useful to remember what and where Stack Credentials are used for.

Account security new stack credentials form

Once the form completed, click the "SUBMIT" button.

Copy the Stack access_key and secret_key

A modal displaying the generated access_key and secret_key appears. Take care to copy and keep your tokens secret. Once the modal close, you are not able to access the secret_key, and you have to regenerate new Stack credential and revoke the previous one if you lost the secret_key.

Do not hard code your tokens into programs where they may accidentally be released in version control and are harder to rotate. Instead, use environmental variables. If a token becomes compromised, delete it to revoke that token's access.

Account security stack credentials save tokens

Your Stack credential is now generated. You can use any S3-compatible SDKs and tools to interact with your stacks.

Revoke Stack Credentials

There are two steps to revoke a Stack Credentials:

  1. Select the Stack Credentials to revoke and click Delete
  2. Confirm Stack Credentials revocation

Get started

On the Koyeb control panel, click Account in the left side panel. You land on the Account page. Click the Security tab to revoke a Stack credential.

Select the Stack credential to revoke and click Delete

In the list of Stack credentials, select the Stack credential you want to revoke and click the "DELETE" button.

Confirm Stack credential revocation

A modal appears and asks for confirmation before deleting the Stack Credentials. Once confirmed, your Stack Credentials is immediately revoked and can't be used anymore to interact with the Koyeb S3-API endpoint.

footer-frame