Быстрый старт

1. В списке сервисов выберите Key Management Service → Ключи.

2. Нажмите кнопку Создать.

3. Укажите параметры нового ключа:

   • Укажите имя ключа, которое будет отображаться в списке ключей. На основе этого имени будет сгенерирован уникальный идентификатор ключа, изменить его невозможно.
   • Алгоритм шифрования — выберите алгоритм шифрования.
   • Период ротации — выберите или укажите периодичность ротации ключа.
   • (опционально) Добавьте описание ключа.

4. Нажмите кнопку Создать.

1. Получите список ключей и идентификатор ключа:

   1
   mws kms crypto-key list

   В ответе будет выведен список из одного ключа со значением true для параметра ENABLED.

2. Получите список версий этого ключа:

   1
   mws kms crypto-key-version list --key <идентификатор ключа>

   В ответе будет выведен список из одной версии с параметрами.

1. Получите список ключей:

   1
   curl -X GET https://kms.mwsapis.ru/kms/v1/projects/<имя проекта>/cryptoKeys \
   2
     -H "Authorization: Bearer <IAM-токен>" \
   3
     -H "Content-Type: application/json"

   В ответе будет выведен список из одного ключа со значением true для параметра usagePolicy:enabled.

2. Получите список версий этого ключа:

   1
   curl -X GET "https://kms.mwsapis.ru/kms/v1/projects/<имя проекта>/cryptoKeys/<идентификатор ключа>/cryptoKeyVersions" \
   2
       -H "Authorization: Bearer <IAM-токен>" \
   3
       -H "Content-Type: application/json"

   В ответе будет выведен список из одной версии с параметрами.

Выполните запрос:

1
mws kms crypto-key encrypt <идентификатор ключа> \
2
    --plaintext "$(echo -n '<открытый текст, который нужно зашифровать>' | base64 -w 0)"

Вывод команды будет содержать шифртекст (ciphertext).

Выполните запрос:

1
curl -X POST "https://kms.mwsapis.ru/kms/v1/projects/<имя проекта>/cryptoKeys/<идентификатор ключа>:encrypt" \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json" \
4
-d '{
5
    "plaintext": "'$(echo -n "<открытый текст, который нужно зашифровать>" | base64)'"
6
}'

Вывод команды будет содержать шифртекст (ciphertext) и версию ключа, которой текст был зашифрован.

Выполните запрос:

1
mws kms crypto-key decrypt <идентификатор ключа> \
2
    --ciphertext "<шифртекст, который был зашифрован этим ключом>" \
3
    | grep 'plaintext:' \
4
    | awk '{print $2}' \
5
    | base64 --decode

Вывод команды будет содержать исходный открытый текст.

Выполните запрос:

1
curl -X POST "https://kms.mwsapis.ru/kms/v1/projects/<имя проекта>/cryptoKeys/<идентификатор ключа>:decrypt" \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json" \
4
-d '{
5
    "ciphertext": "<шифртекст, который был зашифрован этим ключом>"
6
}' \
7
| grep -o '"plaintext"[^,]*' \
8
| cut -d'"' -f4 \
9
| base64 --decode

Вывод команды будет содержать исходный открытый текст.