Evmctl
Версия от 14:35, 20 апреля 2022; Elena Mishina (обсуждение | вклад)
evmctl - программа для создания и проверки цифровых подписей для IMA/EVM, а также для добавления ключей в набор ключей ядра. Распространяется по лицензии GPL2.0+.
Установка
Установить пакет ima-evm-utils:
apt-get install ima-evm-utils
Для создания ключей также потребуется программа openssl:
apt-get install openssl
Использование
Описание ima-evm-utils находится в файле /usr/share/doc/ima-evm-utils-*/README
, а так же в man evmctl
.
Ниже примеры использования.
Подписи в старом формате v1 (RSA ключи)
Импорт RSA-ключа, подпись файла с помощью этого ключа и проверка подписи файла:
- Создание RSA-ключей (для подписей типа v1) и копирование их в каталог
/etc/keys
, в котором находятся ключи используемые по умолчанию:openssl genrsa -out privkey_evm.pem 1024 openssl rsa -pubout -in privkey_evm.pem -out pubkey_evm.pem mkdir /etc/keys cp {pubkey_evm.pem,privkey_evm.pem} /etc/keys
privkey_evm.pem
— приватный RSA ключ,pubkey_evm.pem
— публичный RSA ключ (не сертификат).
- Импорт созданного публичного ключа в набор ключей ядра (keyring):
evmctl import --rsa /etc/keys/pubkey_evm.pem $evm_id
- IMA + EVM подпись (формата v1, что характеризуется опцией
--rsa
) произвольного файла ключом/etc/keys/privkey_evm.pem
:evmctl sign --imasig --rsa <название файла>
- Проверка EVM подписи (IMA не проверяется) по публичному ключу
/etc/keys/pubkey_evm.pem
:evmctl verify <название файла>
- В случае соответствия подписи будет выдано сообщение —
Verification is OK
.
Подписи в новом формате v2 (RSA ключ и x509 сертификат)
- Пример конфига для генерации ключа и сертификата от организации "IMA-CA" положить в файл
test-ca.conf
:[ req ] distinguished_name = req_distinguished_name prompt = no string_mask = utf8only x509_extensions = v3_ca [ req_distinguished_name ] O = IMA-CA CN = IMA/EVM certificate signing key emailAddress = ca@ima-ca [ v3_ca ] basicConstraints=CA:TRUE subjectKeyIdentifier=hash authorityKeyIdentifier=keyid:always,issuer
- Генерация 2048-битного RSA ключа и x509 сертификата (на 10000 дней) с использованием этого конфига:
$ openssl req -verbose -new -nodes -utf8 -sha1 -days 10000 -batch -x509 \ -config test-ca.conf \ -newkey rsa:2048 \ -out x509_evm.der -outform DER \ -keyout privkey_evm.pem
- На выходе файл
privkey_evm.pem
с приватным ключом иx509_evm.der
с публичным сертификатом. Их можно положить в каталог/etc/keys
.
- IMA + EVM подпись (формата v2, что характеризуется отсутствием опции
--rsa
) произвольного файла ключом/etc/keys/privkey_evm.pem
:evmctl sign --imasig <название файла>
- Проверка EVM подписи (IMA не проверяется!) по публичному сертификату
/etc/keys/x509_evm.der
:evmctl verify -v <название файла>
- В случае соответствия подписи будет выдано сообщение
verification is OK
.
- Только IMA подпись произвольного файла ключом
/etc/keys/privkey_evm.pem
:evmctl ima_sign <название файла>
- Проверка IMA подписи по публичному сертификату
/etc/keys/x509_evm.der
:evmctl ima_verify -v <название файла>
- В случае соответствия подписи будет выдано сообщение
verification is OK
и код возврата будет успешный (exit code 0).
Подписи в новом формате v2 (ГОСТ ключ и x509 сертификат)
- Генерация 256-битного ГОСТ 34.10 ключа и x509 сертификата (на 10000 дней) с использованием вышеприведенного конфига (
test-ca.conf
):$ openssl req -nodes -x509 -utf8 -days 10000 -batch \ -config test-ca.conf \ -newkey gost2012_256 \ -pkeyopt paramset:A \ -out x509_evm.der -outform DER \ -keyout privkey_evm.pem
- Только IMA подпись произвольного файла ключом
/etc/keys/privkey_evm.pem
:evmctl ima_sign --hashalgo md_gost12_256 <название файла>
- Проверка IMA подписи по публичному сертификату
/etc/keys/x509_evm.der
:evmctl ima_verify -v <название файла>
- В случае соответствия подписи будет выдано сообщение
verification is OK
и код возврата будет 0.