Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Сертификат модуля

Сертификат модуля OPC UA Сервер может быть:

  • Самоподписанным. Самоподписанный сертификат генерируется автоматически при установке экземпляра Alpha.Server и сохраняется в хранилище сертификатов в папку \certs. Файл закрытого ключа сохраняется в папку \private.
  • Выпущен с помощью закрытого ключа доверенного сертификата центра сертификации. В качестве центра сертификации можно использовать любой публичный центр сертификации или создать собственный. Сертификат, подписанный центром сертификации, должен храниться в хранилище сертификатов экземпляра Alpha.Server в папке \certs. Файл закрытого ключа должен храниться в папке \private.

Чтобы узнать, кем выдан сертификат модуля OPC UA Сервер, ознакомиться с политикой безопасности сертификата, посмотреть срок действия или другие параметры, откройте *.DER-файл сертификата в папке \certs и перейдите на вкладку Состав.

Модуль OPC UA Сервер использует только тот сертификат, у которого в качестве имени субъекта указано значение AutomiqOpcUaServer. Сертификаты с другими именами субъектов модуль не использует.

Если у сертификата заканчивается срок действия, продлите сертификат.

Если необходимо изменить другие параметры сертификата, создайте новый сертификат.

При переустановке Alpha.Server в хранилище сертификатов генерируется новый самоподписанный сертификат модуля и его закрытый ключ, но предыдущие сертификаты и закрытые ключи из хранилища не удаляются. Вновь установленный экземпляр Alpha.Server использует любой сертификат модуля, который расположен в хранилище, что может привести к потере соединения с клиентом. Поэтому при переустановке Alpha.Server оставьте только тот сертификат, который находится в папке доверенных сертификатов у клиента:

  • в папке \certs оставьте сертификат с открытым ключом;
  • в папке \private оставьте закрытый ключ этого сертификата.

Остальные сертификаты модуля OPC UA Сервер и их закрытые ключи следует удалить.

Создание и продление сертификата модуля

ОС Windows

Для создания/продления сертификата модуля используйте командную строку и любую стандартную утилиту генерации сертификатов. Примеры ниже приведены с использованием утилиты Opc.Ua.CertificateGenerator.exe, которая расположена в папке C:\Program Files\Automiq\Alpha.Server\Server.

В теле команд создания и продления сертификата используются собственные параметры и ключи утилиты Opc.Ua.CertificateGenerator.exe:

Параметр Описание
-an Имя приложения – часть имени субъекта сертификата.
-au Уникальный идентификатор приложения (URI).
-ca

Флаг создания центра сертификации:

  • true – создать корневой сертификат центра сертификации;
  • false – создать самоподписанный или подписанный центром сертификации сертификат.
-cmd

Выбор действия, которое необходимо выполнить с сертификатом. Конкретное действие определяет следующий за -cmd параметр.

issue Признак выпуска нового сертификата.
-dn Одно или несколько доменных имён, для которых действителен сертификат. Доменные имена в списке разделяются запятыми.
-ikf Путь к файлу закрытого ключа сертификата-издателя для подписи нового сертификата.
-ikp Пароль к файлу закрытого ключа сертификата-издателя.
-ks Длина ключа – размер ключа в битах, кратный 1024: 1024, 2048, 3072 или 4096. Чем длиннее ключ, тем большую безопасность он обеспечивает, но тем больше требуется ресурсов на его обработку.
-lm Срок действия сертификата в месяцах.
-o Название организации – часть имени субъекта сертификата.
-pbf Путь к *.DER-файлу сертификата, который нужно продлить.
-pw Пароль для нового файла закрытого ключа.
-sp Путь к папке, где будет сохранен созданный сертификат.

Перед созданием/продлением сертификата в командной строке перейдите в папку, где хранится утилита Opc.Ua.CertificateGenerator.exe.

cd C:\Program Files\Automiq\Alpha.Server\Server

Создание самоподписанного сертификата

Чтобы создать самоподписанный сертификат модуля OPC UA Сервер, выполните команду:

Opc.Ua.CertificateGenerator.exe -cmd issue -sp <путь к папке сертификата и его закрытого ключа> -an <имя приложения> -o "название организации" -dn <доменное имя компьютера 1>,<доменное имя компьютера 2> -au urn:<доменное имя компьютера>:<имя приложения> -ks <длина ключа> -lm <срок действия сертификата в месяцах>

Opc.Ua.CertificateGenerator.exe -cmd issue -sp ".\SelfSigned" -an "AutomiqOpcUaServer" -o "Automiq Software" -dn ComputerDomainName -au urn:ComputerDomainName:AutomiqOpcUaServer -ks 2048 -lm 60

В результате выполнения команды созданы:

  • файл сертификата в папке \SelfSigned\certs в формате *.der;
  • файл закрытого ключа в папке \SelfSigned\private в формате *.pfx.

Создание корневого сертификата центра сертификации

Чтобы создать корневой сертификат центра сертификации, выполните команду:

Opc.Ua.CertificateGenerator.exe -cmd issue -sp <путь к папке сертификата и его закрытого ключа> -an <название центра сертификации> -o <название организации> -pw <пароль> -ks <длина ключа> -lm <срок действия сертификата в месяцах> -ca true

Opc.Ua.CertificateGenerator.exe -cmd issue -sp ".\CA" -an "CA_Name" -o "Automiq Software" -pw password -ks 2048 -lm 60 -ca true

В результате выполнения команды созданы:

  • файл сертификата в папке \CA\certs в формате *.der;
  • файл закрытого ключа в папке \CA\private в формате *.pfx.

Создание сертификата, подписанного центром сертификации

Чтобы выпустить сертификат модуля OPC UA Сервер, подписанный центром сертификации, выполните команду:

Opc.Ua.CertificateGenerator.exe -cmd issue -sp <путь к папке сертификата и его закрытого ключа> -an <имя приложения> -o <название организации> -dn <доменное имя компьютера 1>,<доменное имя компьютера 2> -au urn:<доменное имя компьютера>:<имя приложения> -ks <длина ключа> -lm <срок действия сертификата в месяцах> -ikf <путь к файлу закрытого ключа сертификата-издателя центра сертификации> -ikp <пароль>

Корневой сертификат центра сертификации хранится в папке \CA. Создание сертификата, подписанного корневым сертификатом:

Opc.Ua.CertificateGenerator.exe -cmd issue -sp ".\CA\issued" -an "AutomiqOpcUaServer" -o "Automiq Software" - dn ComputerDomainName -au urn:ComputerDomainName:AutomiqOpcUaServer -ks 2048 -lm 60 -ikf ".\CA\private\CA_Name [FEB2257AC7C1A8FE7FBCDA0601ED91C3312082A4].pfx" -ikp password

В результате выполнения команды создан сертификат, подписанный с помощью закрытого ключа корневого сертификата центра сертификации:

  • файл сертификата в папке \CA\issued\certs в формате *.der;
  • файл закрытого ключа в папке \CA\issued\private в формате *.pfx.

Продление сертификата

Чтобы продлить действие сертификата модуля OPC UA Сервер, выполните команду:

Opc.Ua.CertificateGenerator.exe -cmd issue -sp <путь к папке сертификатов> -pbf <путь к файлу обновляемого сертификата> -ikf <путь к файлу закрытого ключа> -an <имя приложения> -lm <срок действия сертификата в месяцах>

где <путь к файлу закрытого ключа>:

  • путь к файлу закрытого ключа обновляемого сертификата, если продлевается самоподписанный сертификат;
  • путь к файлу закрытого ключа сертификата-издателя, если продлевается сертификат, выпущенный центром сертификации.

В результате выполнения команды будут созданы закрытый ключ и сертификат с тем же субъектом, но с новым сроком действия. Вновь созданный сертификат не требует замены на стороне клиента.

Хранилище сертификатов расположено в папке \Certificates. Продление самоподписанного сертификата:

Opc.Ua.CertificateGenerator.exe -cmd issue -sp ".\Certificates" -pbf ".\Certificates\certs\AutomiqOpcUaServer [BC2B63ABAECF1C155524010D6FA21FCD06AC27ED].der" -ikf ".\Certificates\private\AutomiqOpcUaServer [BC2B63ABAECF1C155524010D6FA21FCD06AC27ED].pfx" -an "AutomiqOpcUaServer" -lm 100

Хранилище сертификатов расположено в папке \Certificates. Корневой сертификат центра сертификации хранится в папке \CA. Продление сертификата, выпущенного центром сертификации:

Opc.Ua.CertificateGenerator.exe -cmd issue -sp ".\CA" -pbf ".\Certificates\certs\AutomiqOpcUaServer [BC2B63ABAECF1C155524010D6FA21FCD06AC27ED].der" -ikf ".\CA\private\CA_Name [61981862A424CCF60E7B1BB30A354EFEBDCD3E2D].pfx" -an "AutomiqOpcUaServer" -lm 100 -ikp password

ОС Linux

Для создания, продления и обновления сертификатов используйте открытый инструмент криптографической защиты OpenSSL.

Чтобы создать самоподписанный сертификат с заданными по умолчанию параметрами, используйте скрипт create_opcua_key.sh, который расположен в директории /opt/Automiq/Alpha.Server:

  1. В терминале перейдите в папку, где хранится файл скрипта create_opcua_key.sh:

    cd /opt/Automiq/Alpha.Server

  2. Запустите скрипт на исполнение:

    sudo ./create_opcua_key.sh

В результате исполнения скрипта будут созданы:

  • файл сертификата в директории /certs в формате *.der со значениями параметров:

    Параметр Значение
    Имя субъекта (CN) AutomiqOpcUaServer
    Организация (O) Automiq Software
    Уникальный идентификатор приложения (URI) urn:<доменное имя компьютера>:AutomiqOpcUaServer
    Срок действия сертификата в днях 1825
    Длина ключа 4096
  • файл закрытого ключа в директории /private в формате *.pfx.