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