Jump toUpdate content

Quickstart

Reviewed on 21 November 2023 • Published on 21 February 2023

In this quickstart, we show you how to create a folder and a secret and how to create a secret’s version.

Security & Identity (IAM):

You may need certain IAM permissions to carry out some actions described on this page. This means:

  • you are the Owner of the Scaleway Organization in which the actions will be carried out, or
  • you are an IAM user of the Organization, with a policy granting you the necessary permission sets
Requirements:

You have an account and are logged into the Scaleway console

How to create a folder and a secret

Note:

If you have no resources yet in Secret Manager, you can create a folder during secret creation.

  1. Click Secret Manager in the Security and Identity section of the Scaleway console side menu.

  2. Click + Create secret.

  3. Choose the region in which you want to store your folder and your secret.

    Important:

    Folders and secrets cannot be moved from one region to another after creation.

  4. Select Create a new path and enter /, followed by a name for your folder.

    Important:

    A path is the directory structure to access your folders and secrets. Each path must be prefixed with a slash.

  5. Enter a name for your secret and add tags (optional).

  6. Add your secret manually or import it from a file.

    Note:

    The maximum file size for your secret is 64 KiB.

  7. Click Create secret. The Overview tab of your secret displays.

    Note:
    • You have created a folder and a secret on the go, located in the / path of the selected region.
    • The value of your secret is stored in its first version, which is enabled by default. At creation, your secret only has one version. Keep reading our quickstart to find out how to add more versions to your secret.
  8. Click Back to Secrets to display your folder and its contents.

    Tip:
    • Read our documentation to learn how to create more folders once you have created resources in Secret Manager.
    • Read our documentation to find out how to migrate secrets located in the / path, to specific folders.

How to add a secret version

  1. Click Secret Manager in the Security and Identity section of the Scaleway console side menu. Your resources located in the / path of the Paris region display.
  2. In the Region drop-down, select the pertinent region in which the secret you want to update is.
  3. Access the secret you want to add a version to. Your secret’s Overview tab displays.
  4. Click the Versions tab.
  5. Click + Create version. A pop-up displays.
  6. Add your version manually or import it from a file.
  7. Click «Toogle Icon» to enable or disable the version.
  8. Click Create version. Your secret versions display.