Документация: ПО Факел — разрабатываемая версия

Инфраструктура открытых ключей

Обзор

Инфраструктура открытых ключей (PKI) ПО Факел хранит в конфигурации ключи и сертификаты, которые используют другие службы. Службы ссылаются на объекты PKI по имени, поэтому один сертификат или ключ можно использовать в нескольких местах. Объекты PKI используют:

  • VPN IPsec (vpn ipsec site-to-site и vpn ipsec remote-access) — сертификаты, сертификаты центров сертификации и пары ключей RSA;

  • L2TP поверх IPsec (vpn l2tp remote-access ipsec-settings), OpenConnect (vpn openconnect) и сервер SSTP (vpn sstp) — сертификаты и сертификаты центров сертификации;

  • интерфейсы OpenVPN (interfaces openvpn) — сертификаты, сертификаты центров сертификации, параметры Диффи — Хеллмана и общие ключи OpenVPN;

  • клиент SSTP (interfaces sstpc) — сертификаты центров сертификации;

  • проверка подлинности 802.1X на интерфейсах Ethernet (interfaces ethernet <ethernet> eapol) — сертификаты и сертификаты центров сертификации;

  • служба HTTPS (service https certificates) — сертификаты, сертификаты центров сертификации и параметры Диффи — Хеллмана;

  • обратный прокси-сервер (load-balancing reverse-proxy) — сертификаты и сертификаты центров сертификации;

  • подключение к кэш-серверам RPKI по SSH (protocols rpki cache <cache> ssh key) — ключи OpenSSH.

Если объект PKI, который использует служба, изменен, при применении конфигурации служба перенастраивается, а на экран выводится сообщение Updating configuration: "<путь> <имя>". Объект, который использует служба, удалить нельзя: применение конфигурации завершается ошибкой Embedded PKI <объект> with name "<имя>" is still in use by CLI path "<путь>".

Объекты PKI задаются в разделе pki:

  • ca — сертификаты центров сертификации (CA) с закрытым ключом (если маршрутизатор сам выпускает сертификаты) и списками отзыва (CRL);

  • certificate — сертификаты маршрутизатора с закрытыми ключами;

  • key-pair — пары открытого и закрытого ключей (например, ключи RSA для IPsec, см. Site-to-Site VPN);

  • dh — параметры Диффи — Хеллмана, openssh — ключи OpenSSH, openvpn — общие ключи OpenVPN;

  • x509 — общие параметры сертификатов X.509.

Команды режима «Администрирование» группы show pki выводят сертификаты X.509 из конфигурации:

  • команда show pki выводит все сертификаты центров сертификации, сертификаты и списки отзыва;

  • команда show pki ca выводит таблицу сертификатов центров сертификации: имя, субъект, издатель (CN), даты выпуска и окончания действия, наличие закрытого ключа и родительский центр сертификации;

  • команда show pki certificate выводит таблицу сертификатов: имя, тип (сервер или клиент), субъект (CN), издатель (CN), даты выпуска и окончания действия, признак отзыва, наличие закрытого ключа и наличие сертификата издателя в конфигурации;

  • команда show pki crl выводит списки отзыва: имя центра сертификации, дату обновления и число отозванных сертификатов;

  • формы с именем выводят один объект (если объекта нет, выводится сообщение CA "<name>" does not exist! или Certificate "<name>" does not exist!), форма pem — сам сертификат или список отзыва в формате PEM (например, чтобы передать его другой стороне), форма fingerprint — отпечаток сертификата по алгоритму SHA-256, SHA-384 или SHA-512 (например, чтобы сверить сертификат с полученным от другой стороны).

По датам окончания действия удобно заранее найти сертификаты, которые нужно обновить. Создание ключей и сертификатов командами generate pki … описано в разделах служб, которые их используют (например, Стек протоколов IPsec).

Сертификат можно получить автоматически по протоколу ACME (параметры pki certificate <name> acme: доменное имя, адрес электронной почты, адрес сервера ACME, по умолчанию — сервер Let’s Encrypt). Доменное имя и адрес электронной почты обязательны: без них применение конфигурации завершается ошибкой At least one domain-name is required to request certificate for "<name>" via ACME! или An email address is required to request certificate for "<name>" via ACME!. Сервер ACME проверяет право на домен по протоколу HTTP: на время проверки маршрутизатор открывает временный веб-сервер на TCP-порту 80 — на адресе listen-address или, если он не задан, на всех адресах. Поэтому:

  • маршрутизатору нужен доступ к серверу ACME;

  • доменное имя должно указывать на адрес маршрутизатора, а порт 80 этого адреса должен быть доступен из интернета;

  • порт 80 на маршрутизаторе должен быть свободен, иначе применение конфигурации завершается ошибкой Port 80 is already in use and not available to provide ACME challenge for "<name>"!.

Сертификат запрашивается при применении конфигурации; сначала выполняется пробный запрос. Если сервер ACME не подтвердил право на домен, применение конфигурации завершается ошибкой ACME certbot request failed for "<name>"! с причиной, которую сообщил сервер ACME (например, no valid A records found for <domain>).

Команда renew certbot немедленно запускает обновление сертификатов, полученных по протоколу ACME. Команда ничего не выводит на экран; результат записывается в журнал системы (show log), например No renewals were attempted., если сертификатов ACME нет. Команда доступна только пользователю уровня «Администратор» (см. Уровни пользователей).

Ключи и сертификаты, полученные на другом устройстве, загружают в конфигурацию PKI команды режима «Администрирование» группы import pki. Файл должен находиться на маршрутизаторе, например быть скопирован в каталог пользователя по SCP. Команды читают только текстовые файлы в формате PEM (строки -----BEGIN …----- и -----END …----- с данными в кодировке Base64); файлы в двоичном формате DER перед загрузкой преобразуйте в PEM. Общий ключ OpenVPN читается из файла статического ключа OpenVPN (строки -----BEGIN OpenVPN Static key V1----- и -----END OpenVPN Static key V1-----, строки комментариев пропускаются). Команды задают соответствующий объект PKI:

  • команды import pki ca <ca> … — сертификат (file) или закрытый ключ (key-file) центра сертификации;

  • команды import pki certificate <certificate> … — сертификат (file) или его закрытый ключ (key-file);

  • команда import pki crl <crl> file <file> — список отзыва центра сертификации <crl>;

  • команда import pki dh <dh> file <file> — параметры Диффи — Хеллмана;

  • команды import pki key-pair <key-pair> … — открытый (public-file) или закрытый (private-file) ключ пары ключей;

  • команда import pki openvpn shared-secret <shared-secret> file <file> — общий ключ OpenVPN и его версию.

Перед загрузкой закрытого ключа команда запрашивает его пароль (Enter private key passphrase:); в конфигурации ключ сохраняется без шифрования. Если файл не найден, команда выводит сообщение File not found: <file>, если содержимое файла не удалось прочитать — сообщение Invalid certificate: <file>, Invalid private key or passphrase, Invalid DH parameters: <file> или Invalid public key: <file>.

Если команда выполнена не из режима «Конфигурирование», она только выводит команды set, которые нужно выполнить (сообщение You are not in configure mode, commands to install manually from configure mode:). В режиме «Конфигурирование» выполните ее с префиксом run, например run import pki certificate <certificate> file <file>: значения записываются в конфигурацию, а если параметр уже задан, команда спрашивает, заменить ли его. После загрузки проверьте изменения командой compare и примените их командой commit. Команды доступны только пользователю уровня «Администратор» (см. Уровни пользователей).

Параметры сертификата центра сертификации задаются в разделе pki ca <ca>:

  • описание (description) — текст для администратора; в выводе команд show pki описание не отображается;

  • закрытый ключ (private key) — данные ключа в формате PEM без строк -----BEGIN …----- и -----END …-----, одной строкой; при применении конфигурации ключ проверяется, неверный ключ вызывает ошибку Invalid private key on CA certificate "<ca>";

  • признак защиты закрытого ключа паролем (private password-protected) — указывает, что ключ зашифрован паролем (формат PKCS#8, строка -----BEGIN ENCRYPTED PRIVATE KEY-----). Зашифрованный ключ без этого признака вызывает ту же ошибку при применении конфигурации; с признаком ключ при применении не проверяется. Команды, которым нужен ключ центра сертификации (generate pki certificate sign <ca>, generate pki crl <ca> и другие), запрашивают пароль: Enter CA private key passphrase:;

  • отзыв (revoke) — помечает сертификат подчиненного центра сертификации как отозванный (см. ниже «Списки отзыва»);

  • установка в системное хранилище (system-install) — добавляет сертификат в хранилище доверенных сертификатов центров сертификации маршрутизатора. После этого программы маршрутизатора, которые проверяют сертификаты по этому хранилищу, доверяют сертификатам, выпущенным этим центром сертификации. При удалении параметра сертификат удаляется из хранилища.

Параметры сертификата задаются в разделе pki certificate <certificate>: описание (description, как у центра сертификации), признак защиты закрытого ключа паролем (private password-protected), отзыв (revoke) и параметры получения сертификата по протоколу ACME (acme): доменное имя (domain-name), адрес электронной почты (email), локальный IPv4-адрес временного веб-сервера проверки домена (listen-address), длина ключа RSA (rsa-key-size, по умолчанию 2048 бит) и адрес сервера (url). Неверный закрытый ключ сертификата вызывает ошибку Invalid private key on certificate "<certificate>"; для зашифрованного ключа действуют те же правила, что для ключа центра сертификации.

Зашифрованный закрытый ключ сертификата могут использовать только службы, в настройках которых задается пароль ключа (параметр passphrase): VPN IPsec и L2TP поверх IPsec (authentication x509 passphrase), OpenConnect (ssl passphrase), проверка подлинности 802.1X (eapol passphrase). Другие службы (например, служба HTTPS) зашифрованный ключ использовать не могут. Команды generate pki … при создании ключа предупреждают об этом: Note: If you plan to use the generated key on this router, do not encrypt the private key. Пароль удобно использовать для ключей центров сертификации, которые нужны только для выпуска сертификатов.

Списки отзыва. Параметр revoke сам по себе список отзыва не меняет: команда show pki certificate показывает такой сертификат с признаком Revoked — Yes. Список отзыва центра сертификации создает команда generate pki crl <ca>: она включает в него все сертификаты и сертификаты подчиненных центров сертификации с параметром revoke, выпущенные этим центром сертификации. Команда с аргументом install, выполненная в режиме «Конфигурирование» с префиксом run, записывает список в параметр pki ca <ca> crl; после применения конфигурации команда show pki crl выводит имена отозванных сертификатов. Если отозванных сертификатов нет, команда выводит сообщение No revoked certificates to add to the CRL.

Параметры Диффи — Хеллмана задаются в разделе pki dh <dh> (команда parameters) в формате PEM без строк -----BEGIN …----- и -----END …-----. Неверные параметры вызывают ошибку Invalid DH parameters on "<dh>" при применении конфигурации. Параметры используют интерфейсы OpenVPN (tls dh-params) и служба HTTPS (certificates dh-params).

Ключи OpenSSH (pki openssh <openssh>) задаются открытым ключом с типом (поддерживается только тип ssh-rsa) и закрытым ключом в формате OpenSSH без строк -----BEGIN …----- и -----END …-----. Признак private password-protected указывает, что закрытый ключ зашифрован паролем: без него зашифрованный ключ вызывает ошибку Invalid OpenSSH private key "<openssh>", с ним ключ при применении конфигурации не проверяется.

Общий секретный ключ OpenVPN задается в разделе pki openvpn shared-secret <shared-secret>: данные ключа (key) и версия ключа (version). Данные ключа — содержимое файла статического ключа OpenVPN без строк заголовка и окончания и без комментариев, одной строкой (для ключа 2048 бит — 512 шестнадцатеричных цифр). Версия ключа — номер из строки заголовка файла (-----BEGIN OpenVPN Static key V1----- — версия 1). При применении конфигурации данные ключа не проверяются, поэтому создавайте ключ командой generate pki openvpn shared-secret install <shared-secret> или загружайте его из файла командой import pki openvpn shared-secret <shared-secret> file <file>: обе команды задают и данные, и версию. Ключ используют интерфейсы OpenVPN (shared-secret-key, tls auth-key, tls crypt-key).

Общие параметры сертификатов X.509 задаются в разделе pki x509 default: страна (country, по умолчанию RU), область (state, по умолчанию Some-State), населенный пункт (locality, по умолчанию Some-City) и организация (organization, по умолчанию IT Route). Команды generate pki certificate … и generate pki ca … предлагают эти значения по умолчанию для полей субъекта создаваемого сертификата или запроса на сертификат (например, Enter country code: (Default: RU)). Код страны — две латинские буквы; другое значение вызывает ошибку Invalid default country value. Value must be 2 alpha characters. при применении конфигурации.

Пример настройки

В примере сертификат web запрашивается по протоколу ACME у сервера Let’s Encrypt для домена example.com. Перед применением конфигурации убедитесь, что доменное имя example.com указывает на адрес маршрутизатора, порт TCP 80 этого адреса доступен из интернета и не занят другой службой маршрутизатора. Сертификат запрашивается при применении конфигурации; после получения его можно указать в настройках службы, например set service https certificates certificate web.

Шаг

Команда

Описание

1

set pki certificate web acme domain-name example.com

Задает доменное имя, для которого запрашивается сертификат

2

set pki certificate web acme email admin@example.com

Задает адрес электронной почты, связанный с сертификатом

Список команд

Режим «Конфигурирование»


pki ca <ca> description <description>

Описание:
Добавляет описание сертификата центра сертификации. Описание — текст для администратора; в выводе команд show pki оно не отображается.

Синтаксис:

  • set pki ca <ca> description <description>

  • delete pki ca <ca> description <description>

  • show pki ca <ca> description

Аргументы:

  • <ca> — имя сертификата центра сертификации.

  • <description> — описание сертификата. Формат: строка.

Режим: «Конфигурирование».


pki ca <ca> private key <key>

Описание:
Задает закрытый ключ центра сертификации. Ключ проверяется при применении конфигурации: неверный ключ вызывает ошибку Invalid private key on CA certificate "<ca>".

Синтаксис:

  • set pki ca <ca> private key <key>

  • delete pki ca <ca> private key <key>

  • show pki ca <ca> private key

Аргументы:

  • <ca> — имя сертификата центра сертификации.

  • <key> — закрытый ключ: данные в формате PEM без строк -----BEGIN …----- и -----END …-----, одной строкой.

Режим: «Конфигурирование».


pki ca <ca> private password-protected

Описание:
Указывает, что закрытый ключ центра сертификации зашифрован паролем (формат PKCS#8). Такой ключ при применении конфигурации не проверяется; команды, которым нужен ключ центра сертификации (например, generate pki certificate sign <ca>), запрашивают пароль: Enter CA private key passphrase:.

Синтаксис:

  • set pki ca <ca> private password-protected

  • delete pki ca <ca> private password-protected

  • show pki ca <ca> private password-protected

Аргументы:

  • <ca> — имя сертификата центра сертификации.

Режим: «Конфигурирование».


pki ca <ca> revoke

Описание:
Помечает сертификат подчиненного центра сертификации как отозванный. Сертификат попадает в список отзыва (CRL) родительского центра сертификации, когда список создается командой generate pki crl <ca>.

Синтаксис:

  • set pki ca <ca> revoke

  • delete pki ca <ca> revoke

  • show pki ca <ca> revoke

Аргументы:

  • <ca> — имя сертификата центра сертификации.

Режим: «Конфигурирование».


pki ca <ca> system-install

Описание:
Добавляет сертификат центра сертификации в хранилище доверенных сертификатов маршрутизатора: программы маршрутизатора, которые проверяют сертификаты по этому хранилищу, доверяют сертификатам, выпущенным этим центром сертификации. При удалении параметра сертификат удаляется из хранилища.

Синтаксис:

  • set pki ca <ca> system-install

  • delete pki ca <ca> system-install

  • show pki ca <ca> system-install

Аргументы:

  • <ca> — имя сертификата центра сертификации.

Режим: «Конфигурирование».


pki certificate <certificate> acme domain-name <domain-name>

Описание:
Задает доменное имя, для которого запрашивается сертификат по протоколу ACME.

Синтаксис:

  • set pki certificate <certificate> acme domain-name <domain-name>

  • delete pki certificate <certificate> acme domain-name <domain-name>

  • show pki certificate <certificate> acme domain-name

Аргументы:

  • <certificate> — имя сертификата.

  • <domain-name> — доменное имя. Можно задать несколько значений.

Режим: «Конфигурирование».


pki certificate <certificate> acme email <email>

Описание:
Задает адрес электронной почты, который связывается с сертификатом, получаемым по протоколу ACME.

Синтаксис:

  • set pki certificate <certificate> acme email <email>

  • delete pki certificate <certificate> acme email <email>

  • show pki certificate <certificate> acme email

Аргументы:

  • <certificate> — имя сертификата.

  • <email> — адрес электронной почты.

Режим: «Конфигурирование».


pki certificate <certificate> acme listen-address <listen-address>

Описание:
Задает локальный IPv4-адрес, на котором маршрутизатор на время получения сертификата по протоколу ACME открывает временный веб-сервер на TCP-порту 80: к нему обращается сервер ACME, чтобы проверить право на домен. Если параметр не задан, веб-сервер принимает соединения на всех адресах.

Синтаксис:

  • set pki certificate <certificate> acme listen-address <listen-address>

  • delete pki certificate <certificate> acme listen-address <listen-address>

  • show pki certificate <certificate> acme listen-address

Аргументы:

  • <certificate> — имя сертификата.

  • <listen-address> — локальный IPv4-адрес. Формат: IPv4-адрес (x.x.x.x).

Режим: «Конфигурирование».


pki certificate <certificate> acme rsa-key-size <rsa-key-size>

Описание:
Задает длину ключа RSA для сертификата, получаемого по протоколу ACME.

Синтаксис:

  • set pki certificate <certificate> acme rsa-key-size <rsa-key-size>

  • delete pki certificate <certificate> acme rsa-key-size <rsa-key-size>

  • show pki certificate <certificate> acme rsa-key-size

Аргументы:

  • <certificate> — имя сертификата.

  • <rsa-key-size> — длина ключа RSA в битах. Возможные значения: 2048 — длина ключа 2048 бит; 3072 — длина ключа 3072 бита; 4096 — длина ключа 4096 бит. Значение по умолчанию: 2048.

Режим: «Конфигурирование».


pki certificate <certificate> acme url <url>

Описание:
Задает адрес сервера ACME.

Синтаксис:

  • set pki certificate <certificate> acme url <url>

  • delete pki certificate <certificate> acme url <url>

  • show pki certificate <certificate> acme url

Аргументы:

  • <certificate> — имя сертификата.

  • <url> — адрес сервера ACME. Формат: URL (HTTP или HTTPS). Значение по умолчанию: https://acme-v02.api.letsencrypt.org/directory.

Режим: «Конфигурирование».


pki certificate <certificate> description <description>

Описание:
Добавляет описание сертификата.

Синтаксис:

  • set pki certificate <certificate> description <description>

  • delete pki certificate <certificate> description <description>

  • show pki certificate <certificate> description

Аргументы:

  • <certificate> — имя сертификата.

  • <description> — описание сертификата. Формат: строка.

Режим: «Конфигурирование».


pki certificate <certificate> private password-protected

Описание:
Указывает, что закрытый ключ сертификата зашифрован паролем (формат PKCS#8). Такой ключ при применении конфигурации не проверяется. Сертификат с зашифрованным ключом могут использовать только службы, в настройках которых задается пароль ключа (параметр passphrase, например VPN IPsec); другие службы (например, служба HTTPS) такой сертификат использовать не могут.

Синтаксис:

  • set pki certificate <certificate> private password-protected

  • delete pki certificate <certificate> private password-protected

  • show pki certificate <certificate> private password-protected

Аргументы:

  • <certificate> — имя сертификата.

Режим: «Конфигурирование».


pki certificate <certificate> revoke

Описание:
Помечает сертификат как отозванный (признак Revoked в выводе команды show pki certificate). Сертификат попадает в список отзыва (CRL) центра сертификации, который его выпустил, когда список создается командой generate pki crl <ca>.

Синтаксис:

  • set pki certificate <certificate> revoke

  • delete pki certificate <certificate> revoke

  • show pki certificate <certificate> revoke

Аргументы:

  • <certificate> — имя сертификата.

Режим: «Конфигурирование».


pki dh <dh>

Описание:
Создает объект параметров Диффи — Хеллмана (DH). Параметры используют интерфейсы OpenVPN (tls dh-params) и служба HTTPS (certificates dh-params).

Синтаксис:

  • set pki dh <dh>

  • delete pki dh <dh>

  • show pki dh <dh>

Аргументы:

  • <dh> — имя объекта параметров Диффи — Хеллмана.

Режим: «Конфигурирование».


pki dh <dh> parameters <parameters>

Описание:
Задает параметры Диффи — Хеллмана. Параметры проверяются при применении конфигурации: неверные параметры вызывают ошибку Invalid DH parameters on "<dh>".

Синтаксис:

  • set pki dh <dh> parameters <parameters>

  • delete pki dh <dh> parameters <parameters>

  • show pki dh <dh> parameters

Аргументы:

  • <dh> — имя объекта параметров Диффи — Хеллмана.

  • <parameters> — параметры Диффи — Хеллмана: данные в формате PEM без строк -----BEGIN DH PARAMETERS----- и -----END DH PARAMETERS-----, одной строкой.

Режим: «Конфигурирование».


pki openssh <openssh> private password-protected

Описание:
Указывает, что закрытый ключ OpenSSH зашифрован паролем. Без этого признака зашифрованный ключ вызывает ошибку Invalid OpenSSH private key "<openssh>" при применении конфигурации; с признаком ключ при применении не проверяется.

Синтаксис:

  • set pki openssh <openssh> private password-protected

  • delete pki openssh <openssh> private password-protected

  • show pki openssh <openssh> private password-protected

Аргументы:

  • <openssh> — имя ключа OpenSSH.

Режим: «Конфигурирование».


pki openvpn shared-secret <shared-secret>

Описание:
Создает общий секретный ключ OpenVPN. Ключ используют интерфейсы OpenVPN (shared-secret-key, tls auth-key, tls crypt-key).

Синтаксис:

  • set pki openvpn shared-secret <shared-secret>

  • delete pki openvpn shared-secret <shared-secret>

  • show pki openvpn shared-secret <shared-secret>

Аргументы:

  • <shared-secret> — имя общего секретного ключа OpenVPN.

Режим: «Конфигурирование».


pki openvpn shared-secret <shared-secret> key <key>

Описание:
Задает данные общего секретного ключа OpenVPN. При применении конфигурации данные не проверяются: создавайте ключ командой generate pki openvpn shared-secret install <shared-secret> или загружайте его командой import pki openvpn shared-secret <shared-secret> file <file>.

Синтаксис:

  • set pki openvpn shared-secret <shared-secret> key <key>

  • delete pki openvpn shared-secret <shared-secret> key <key>

  • show pki openvpn shared-secret <shared-secret> key

Аргументы:

  • <shared-secret> — имя общего секретного ключа OpenVPN.

  • <key> — данные ключа: содержимое файла статического ключа OpenVPN без строк заголовка и окончания и без комментариев, одной строкой (для ключа 2048 бит — 512 шестнадцатеричных цифр).

Режим: «Конфигурирование».


pki openvpn shared-secret <shared-secret> version <version>

Описание:
Задает версию общего секретного ключа OpenVPN.

Синтаксис:

  • set pki openvpn shared-secret <shared-secret> version <version>

  • delete pki openvpn shared-secret <shared-secret> version <version>

  • show pki openvpn shared-secret <shared-secret> version

Аргументы:

  • <shared-secret> — имя общего секретного ключа OpenVPN.

  • <version> — версия ключа: номер из строки заголовка файла ключа (-----BEGIN OpenVPN Static key V1----- — версия 1).

Режим: «Конфигурирование».


pki x509 default country <country>

Описание:
Задает код страны, который команды generate pki certificate … и generate pki ca … предлагают по умолчанию для поля субъекта C создаваемого сертификата или запроса на сертификат.

Синтаксис:

  • set pki x509 default country <country>

  • delete pki x509 default country <country>

  • show pki x509 default country

Аргументы:

  • <country> — код страны из двух латинских букв; другое значение вызывает ошибку Invalid default country value. Value must be 2 alpha characters. при применении конфигурации. Значение по умолчанию: RU.

Режим: «Конфигурирование».


pki x509 default locality <locality>

Описание:
Задает населенный пункт, который команды generate pki certificate … и generate pki ca … предлагают по умолчанию для поля субъекта L создаваемого сертификата или запроса на сертификат.

Синтаксис:

  • set pki x509 default locality <locality>

  • delete pki x509 default locality <locality>

  • show pki x509 default locality

Аргументы:

  • <locality> — населенный пункт. Значение по умолчанию: Some-City.

Режим: «Конфигурирование».


pki x509 default organization <organization>

Описание:
Задает организацию, которую команды generate pki certificate … и generate pki ca … предлагают по умолчанию для поля субъекта O создаваемого сертификата или запроса на сертификат.

Синтаксис:

  • set pki x509 default organization <organization>

  • delete pki x509 default organization <organization>

  • show pki x509 default organization

Аргументы:

  • <organization> — название организации. Значение по умолчанию: IT Route.

Режим: «Конфигурирование».


pki x509 default state <state>

Описание:
Задает область, которую команды generate pki certificate … и generate pki ca … предлагают по умолчанию для поля субъекта ST создаваемого сертификата или запроса на сертификат.

Синтаксис:

  • set pki x509 default state <state>

  • delete pki x509 default state <state>

  • show pki x509 default state

Аргументы:

  • <state> — область. Значение по умолчанию: Some-State.

Режим: «Конфигурирование».


Режим «Администрирование»


pki

Описание:
Выводит все сертификаты центров сертификации, сертификаты и списки отзыва из конфигурации PKI.

Синтаксис:

  • show pki

Режим: «Администрирование».


pki ca

Описание:
Выводит таблицу сертификатов центров сертификации.

Синтаксис:

  • show pki ca

  • show pki ca <name>

Аргументы:

  • <name> — имя сертификата центра сертификации в конфигурации PKI. Необязательный аргумент; если указан, выводится только этот сертификат.

Режим: «Администрирование».


pki ca <name> pem

Описание:
Выводит сертификат центра сертификации в формате PEM.

Синтаксис:

  • show pki ca <name> pem

Аргументы:

  • <name> — имя сертификата центра сертификации в конфигурации PKI.

Режим: «Администрирование».


pki certificate

Описание:
Выводит таблицу сертификатов.

Синтаксис:

  • show pki certificate

  • show pki certificate <name>

Аргументы:

  • <name> — имя сертификата в конфигурации PKI. Необязательный аргумент; если указан, выводится только этот сертификат.

Режим: «Администрирование».


pki certificate <name> pem

Описание:
Выводит сертификат в формате PEM.

Синтаксис:

  • show pki certificate <name> pem

Аргументы:

  • <name> — имя сертификата в конфигурации PKI.

Режим: «Администрирование».


pki certificate <name> fingerprint <hash>

Описание:
Выводит отпечаток сертификата по указанному алгоритму хеширования.

Синтаксис:

  • show pki certificate <name> fingerprint <hash>

Аргументы:

  • <name> — имя сертификата в конфигурации PKI.

  • <hash> — алгоритм хеширования. Возможные значения: sha256, sha384, sha512.

Режим: «Администрирование».


pki crl

Описание:
Выводит списки отзыва сертификатов.

Синтаксис:

  • show pki crl

  • show pki crl <name>

Аргументы:

  • <name> — имя сертификата центра сертификации в конфигурации PKI. Необязательный аргумент; если указан, выводится список отзыва этого центра сертификации.

Режим: «Администрирование».


pki crl <name> pem

Описание:
Выводит список отзыва указанного центра сертификации в формате PEM.

Синтаксис:

  • show pki crl <name> pem

Аргументы:

  • <name> — имя сертификата центра сертификации в конфигурации PKI.

Режим: «Администрирование».


renew certbot

Описание:
Немедленно запускает обновление сертификатов, полученных по протоколу ACME (pki certificate <name> acme). Команда ничего не выводит на экран; результат записывается в журнал системы (show log).

Синтаксис:

  • renew certbot

Режим: «Администрирование».

Уровень привилегий: «Администратор».


import pki ca <ca> file <file>

Описание:
Загружает сертификат центра сертификации из файла и добавляет его в конфигурацию PKI.

Синтаксис:

  • import pki ca <ca> file <file>

Аргументы:

  • <ca> — имя центра сертификации в конфигурации (pki ca <ca>). Формат: строка;

  • <file> — путь к файлу сертификата на маршрутизаторе. Файл в формате PEM.

Режим: «Администрирование».

Уровень привилегий: «Администратор».


import pki ca <ca> key-file <key-file>

Описание:
Загружает закрытый ключ центра сертификации из файла и добавляет его в конфигурацию PKI. Перед загрузкой команда запрашивает пароль закрытого ключа (если ключ не зашифрован, оставьте поле пустым); в конфигурации ключ сохраняется без шифрования.

Синтаксис:

  • import pki ca <ca> key-file <key-file>

Аргументы:

  • <ca> — имя центра сертификации в конфигурации (pki ca <ca>). Формат: строка;

  • <key-file> — путь к файлу закрытого ключа на маршрутизаторе. Файл в формате PEM.

Режим: «Администрирование».

Уровень привилегий: «Администратор».


import pki certificate <certificate> file <file>

Описание:
Загружает сертификат из файла и добавляет его в конфигурацию PKI.

Синтаксис:

  • import pki certificate <certificate> file <file>

Аргументы:

  • <certificate> — имя сертификата в конфигурации (pki certificate <certificate>). Формат: строка;

  • <file> — путь к файлу сертификата на маршрутизаторе. Файл в формате PEM.

Режим: «Администрирование».

Уровень привилегий: «Администратор».


import pki certificate <certificate> key-file <key-file>

Описание:
Загружает закрытый ключ сертификата из файла и добавляет его в конфигурацию PKI. Перед загрузкой команда запрашивает пароль закрытого ключа (если ключ не зашифрован, оставьте поле пустым); в конфигурации ключ сохраняется без шифрования.

Синтаксис:

  • import pki certificate <certificate> key-file <key-file>

Аргументы:

  • <certificate> — имя сертификата в конфигурации (pki certificate <certificate>). Формат: строка;

  • <key-file> — путь к файлу закрытого ключа на маршрутизаторе. Файл в формате PEM.

Режим: «Администрирование».

Уровень привилегий: «Администратор».


import pki crl <crl> file <file>

Описание:
Загружает список отзыва сертификатов (CRL) из файла и добавляет его к центру сертификации в конфигурации PKI.

Синтаксис:

  • import pki crl <crl> file <file>

Аргументы:

  • <crl> — имя центра сертификации в конфигурации, к которому относится список отзыва (pki ca <crl> crl). Формат: строка;

  • <file> — путь к файлу списка отзыва на маршрутизаторе. Файл в формате PEM.

Режим: «Администрирование».

Уровень привилегий: «Администратор».


import pki dh <dh> file <file>

Описание:
Загружает параметры Диффи — Хеллмана из файла и добавляет их в конфигурацию PKI.

Синтаксис:

  • import pki dh <dh> file <file>

Аргументы:

  • <dh> — имя параметров Диффи — Хеллмана в конфигурации (pki dh <dh>). Формат: строка;

  • <file> — путь к файлу параметров на маршрутизаторе. Файл в формате PEM.

Режим: «Администрирование».

Уровень привилегий: «Администратор».


import pki key-pair <key-pair> public-file <public-file>

Описание:
Загружает открытый ключ пары ключей из файла и добавляет его в конфигурацию PKI.

Синтаксис:

  • import pki key-pair <key-pair> public-file <public-file>

Аргументы:

  • <key-pair> — имя пары ключей в конфигурации (pki key-pair <key-pair>). Формат: строка;

  • <public-file> — путь к файлу открытого ключа на маршрутизаторе. Файл в формате PEM.

Режим: «Администрирование».

Уровень привилегий: «Администратор».


import pki key-pair <key-pair> private-file <private-file>

Описание:
Загружает закрытый ключ пары ключей из файла и добавляет его в конфигурацию PKI. Перед загрузкой команда запрашивает пароль закрытого ключа (если ключ не зашифрован, оставьте поле пустым); в конфигурации ключ сохраняется без шифрования.

Синтаксис:

  • import pki key-pair <key-pair> private-file <private-file>

Аргументы:

  • <key-pair> — имя пары ключей в конфигурации (pki key-pair <key-pair>). Формат: строка;

  • <private-file> — путь к файлу закрытого ключа на маршрутизаторе. Файл в формате PEM.

Режим: «Администрирование».

Уровень привилегий: «Администратор».


import pki openvpn shared-secret <shared-secret> file <file>

Описание:
Загружает общий ключ OpenVPN из файла и добавляет его в конфигурацию PKI вместе с версией ключа, указанной в файле.

Синтаксис:

  • import pki openvpn shared-secret <shared-secret> file <file>

Аргументы:

  • <shared-secret> — имя общего ключа в конфигурации (pki openvpn shared-secret <shared-secret>). Формат: строка;

  • <file> — путь к файлу статического ключа OpenVPN на маршрутизаторе.

Режим: «Администрирование».

Уровень привилегий: «Администратор».