Как начать работать c Key Management Service
В этой инструкции вы создадите свой первый ключ, а также зашифруете и расшифруете текст с помощью сервиса KMS.
Подготовка к работе
Чтобы начать работать с Key Management Service:
- Войдите в консоль управления. Если вы еще не зарегистрированы, перейдите в консоль управления и следуйте инструкциям.
- На странице биллинга убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе
ACTIVEилиTRIAL_ACTIVE. Если платежного аккаунта нет, создайте его. - Убедитесь, что в нужном облаке у вас есть роль
ownerилиeditor. - Если у вас еще нет интерфейса командной строки Yandex.Cloud (CLI), установите и инициализируйте его.
Создайте ключ симметричного шифрования
Создайте ключ симметричного шифрования:
- В консоли управления выберите каталог, в котором хотите создать ключ.
- Выберите сервис Key Management Service.
- На вкладке Ключи нажмите кнопку Создать и задайте параметры ключа:
- В поле Имя укажите
my-first-key. - В поле Алгоритм шифрования укажите
AES-256. - В поле Период ротации, дни оставьте значение
Нет ротации. - Нажмите кнопку Создать.
- В поле Имя укажите
- Нажмите на строку с именем ключа и убедитесь, что в блоке Версии есть первая версия ключа.
Зашифруйте текст с помощью ключа
Придумайте секретный текст, например Запуск состоится 42 мартобря.
. Размер текста не должен превышать 32 КБ, для шифрования больших объемов данных используйте шифрование по схеме envelope encryption.
Зашифруйте текст:
-
Запишите секретный текст в файл
plaintext.txt. -
Из консоли управления скопируйте идентификатор ключа, созданного ранее.
- В консоли управления перейдите в каталог, в котором был создан ключ.
- Выберите сервис Key Management Service.
- В открывшемся окне скопируйте ключ из поля ID.
-
Зашифруйте текст:
yc kms symmetric-crypto encrypt \ --id <ID ключа> \ --plaintext-file plaintext.txt \ --ciphertext-file ciphertext
Результат работы команды — это бинарный файл ciphertext, содержащий шифртекст.
Расшифруйте текст
Расшифруйте бинарный файл ciphertext, полученный на предыдущем шаге.
Расшифруйте текст:
yc kms symmetric-crypto decrypt \
--id <ID ключа> \
--ciphertext-file ciphertext \
--plaintext-file decrypted.txt
В результате файл ciphertext будет расшифрован, и в decrypted.txt будет записан расшифрованный текст: Запуск состоится 42 мартобря.
.