The Akeyless Dev Hub

If you're looking for help with the only zero-trust, SaaS, unified platform for secrets management - you've come to the right place.

This is our documentation and updates center.

Documentation

Create a static secret

To store a static secret, you need to create a key and configure its value. All secret values are encrypted using the patented Akeyless distributed fragment cryptography (DFC) technology.

You can create secrets from:

Create a static secret from the CLI

๐Ÿ“˜

Prerequisites

Install and Authenticate the Akeyless CLI.

To create a new secret, run the creat-secret command similar to the following:

akeyless create-secret --name mySecret1 --value MySecretPassword

Read more about the options here.

Create the secret from the UI

Make sure you've fulfilled the prerequisites. It's time to create a static secret.

๐Ÿ“˜

Prerequisites

You must have Create access to the area in which you want to create this secret. If you don't see the options described here, speak with your administrator for assistance.

  1. Navigate to the folder in which you want to create the new secret.
  2. Go to Secret & Keys > New.

Create new static secret

  1. From the dropdown menu select Static Secret (+). The Create New Static Secret window pops up.

Create New Static Secret window

  1. Enter valid values in the window and click Save to create the new secret. The fields and values are described in Create New Static Secret Values described here:

Create New Static Secret Values

The following table describes the different fields in the Create New Static Secret window and their valid values.

UI Field

CLI Options

Description and values

Name

--name

Assign any unique name to help you identify which key this is.
Values should include no special characters except for a hyphen "-", dot "." , and underscore "_".

Location

Optional.
Akeyless Vault uses paths in order to locate objects and permit access (CRUD actions).
Though folders may look like a real object, they are in practice virtual objects, made for representation purposes.

Use the slash "/" separator to create or indicate a path as part of the secret creation.

From the CLI, include the entire path and the secret name together as part of the --name option.

Description

-m, --metadata

Optional.
This is especially handy when the name of the secret is generic or not specific enough.

Tags

-t, --tag
To specify multiple tags use argument multiple times:
-t Tag1 -t Tag2

Use tags as an extra tool for organizing and searching secrets. If the tag you want hasn't yet been created, you can add it as part of secret creation.

Encrypt secret with the following key

-k, --key

Choose an Encryption Key to be used to encrypt your secret. Leave the field empty in order to use the default (protectionKey) system key.

Value

--value

This is the value of the secret (the password essentially). The length should be 16KB.

--multiline

The provided value is a multiline value (separated by '\n')

Updated 2 days ago


What's Next

In order to fetch the secret read more here:

Retrieve and View Static Secrets

Create a static secret


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.