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.
There are two steps to create new Stack Credentials:
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.
Click the "NEW" button to start generating new a 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.
Once the form completed, click the "SUBMIT" button.
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.
Your Stack credential is now generated. You can use any S3-compatible SDKs and tools to interact with your stacks.
There are two steps to revoke a Stack Credentials:
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.
In the list of Stack credentials, select the Stack credential you want to revoke and click the "DELETE" button.
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.