Adding a secret

Secrets are stored as one of the following types:

  • Text

    The raw text option is useful for storing private keys for secure shell sessions, connecting to file transfer servers, managing a common API key for a subscription service, or accessing cloud-based storage. Because the text string is encrypted for storage, the maximum size of the raw text is 24KB. For text strings that exceed this limit, you should upload them as secret files.

  • File

    The file option is useful if you have spreadsheets, image files, or other types of documents that contain sensitive or confidential information, include multiple private access or application license keys, or record administrative account information.

After you upload a secrets, you can set permissions on them directly or organize them into sets or folders to simplify other tasks such as assigning set or folder‑specific permissions.

Adding a new secret

You can add a secret one of two ways: either by dragging and dropping the secret file onto the secrets page or uploading it by way of adding it.

Adding a secret by dragging and dropping it

To drag and drop a secret, navigate to Resources > Secrets and you can drag and drop the secret as seen below:

Adding a secret by adding it

  1. In the Admin Portal, click Resources, then click Secrets to display the list of secrets.
  2. Click Add Secret.
  3. Type the display name and, optionally, a description to identify the secret.

    You can type a path to create folders and subfolders to organize your secrets. For example, in the Name field type Production/DevSys/mysecret. This creates a secret (text or file) with the filename mysecret in the folder Production/DevSys.

    You can also create subfolders and secrets in a folder that already exists. For instance, if the folder Production already exists, typing Production/DevSys/mysecret in the Name field creates the subfolder DevSys and the secret mysecret under the folder Production. In this case, you need to have the Add permission for the Production folder.

  4. Select Text or File from the Type drop-down menu.

    • For Text, click Enter Text and type or paste the text string in the Secret field. The text string limit is 24KB.
    • For File, click Select File and then browse to and select the file you want to upload. You can select any type of file to upload up to a maximum size of 5MB.
  5. At Add To Set, you can optionally add the secret an already configured set from the drop-down menu. For more information on sets, see Adding secret sets.
  6. Click Save.

    For additional configuration information, see: