Дерево страниц

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Оглавление



Информация
titleСтатья применима к:
  • Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.6)
  • Astra Linux Special Edition РУСБ.10015-16 исп. 1 и исп. 2
  • Astra Linux Special Edition РУСБ.10265-01 (очередное обновление 8.1)
  • Astra Linux Common Edition 2.12


Стенд:



  • Сервер — Astra Linux Smolensk SE 1.6, Update 2, Bulletin 20190222SE16;
  • Клиент — Astra Linux Smolensk SE 1.6, Update 2, Bulletin 20190222SE16;
  • JaCarta PKI;



Предполагается, что Astra Linux Directory (ALD) уже развернут, существует минимум один доменный пользователь, который может пройти  аутентификацию по паролю, время клиента и сервера совпадают (ntp).


Терминология Kerberos

  • Билет (ticket) – временные данные, выдаваемые клиенту для аутентификации на сервере, на котором располагается необходимая служба.
  • Клиент (client) – некая сущность в сети (пользователь, хост или сервис), которая может получить билет от Kerberos.
  • Центр выдачи ключей (key distribution center, KDC) – сервис, выдающий билеты Kerberos.
  • Область (realm) – сеть, используемая Kerberos, состоящая из серверов KDC и множества клиентов. Имя realm регистрозависимо, обычно пишется в верхнем регистре и совпадает с именем домена.
  • Принципал (principal) – уникальное имя для клиента, для которого разрешается аутентификация в Kerberos. Записывается в виде root[/instance]@REALM.


Установка драйверов на сервер и клиент


Для обеспечения работы со смарт-картой JaCarta на клиенте и сервере установите следующие пакеты: libccid, pcscd, libpcsclite1, opensc.

Для обеспечения работы со смарт-картой подсистемы Kerberos добавочно к предустановленным пакетам ald/kerberos установите пакет krb5-pkinit, libpam-krb5 на клиенте и сервере.

Для обеспечения возможности выпуска ключей и сертификатов на JaCarta  на сервере также установите пакеты libengine-pkcs11-openssl1.1

Для обеспечения возможности обращения к смарт-карте JaCarta, на клиенте и сервере следует  установить библиотеку libjcPKCS11-2.so (для JaCarta PKI/ГОСТ/FLASH), libASEP11.so (для JaCarta PKI)  которую следует скачать с официального сайта Аладдина:  

https://www.aladdin-rd.ru/support/downloads/jacarta


Command
sudo apt install libccid pcscd libpcsclite1 pcsc-tools opensc krb5-pkinit libpam-krb5 libengine-pkcs11-openssl1.1


Command
sudo dpkg -i <имя_загруженного_файла>



Установка и настройка центра сертификации на сервере


Image Modified

Для работы модуля pkinit нам придется воспользоваться OpenSSL в качестве УЦ(CA), чтобы создать ключевые пары и сертификаты клиента и сервера.

OpenSSL — криптографический пакет с открытым исходным кодом для работы с SSL/TLS. Позволяет создавать ключи RSA, DH, DSA, ГОСТ и сертификаты X.509, подписывать их, формировать CSR и CRT.

Все настройки в руководстве выполняются для тестового домена SMARTCARD.ALD. Примем, что:

  • сервер и клиент принадлежат домену SMARTCARD.ALD
,
  • ;
  • имя
сервера
  • службы - kdc
, а
  • ;
  • имя клиента - client.

При настройке используйте имя вашего домена, сервера и клиента.

Выполните следующие действияПорядок действий:1) Создайте каталог CA

  1. Создать каталог удостоверяющего центра (УЦ) командой:

    Command
    mkdir /etc/ssl/CA
и перейдите в него.
  1. В этом каталоге будут размещаться сгенерированные ключи и сертификаты.


  1. Перейти в созданный каталог:

    Command
    cd /etc/ssl/CA


  2. Создать

2) Создайте
  1. ключ и сертификат

CA
  1. УЦ:

    Command
    openssl genrsa -out cakey.pem 2048
    openssl req -key cakey.pem -new -x509 -days 3650 -out cacert.pem


    Примечание

    Параметр days

-
  1. определяет количество дней действия сертификата

CA
  1. УЦ.


  2. В диалоге

заполните
  1. заполнить необходимую информацию о

вашем центре сертификации
  1. создаваемом УЦ.

    Примечание

    В параметре Common name указать имя домена. В случае нашего примера: SMARTCARD.ALD 

    Image Modified

3) Создайте
  1. Создать ключ и сертификат службы KDC:

    Command

    openssl genrsa -out kdckey.pem 2048
    openssl req -new -out kdc.req -key kdckey.pem

    В диалоге заполните необходимую информацию о вашем сервере.

    Примечание

    В Common name указать имя службы kdc.

4) Установите

  1. Установить переменные среды. Переменные среды устанавливаются в рамках сессии

и
  1. , не устанавливаются для других сессий

и
  1. , не сохраняются после закрытия сессии

.
  1. :

    Command
    export REALM=SMARTCARD.ALD
    export CLIENT=kdc
Для того, чтобы убедиться

  1. Убедиться что переменные указаны верно,

воспользуйтесь
  1. воспользовавшись командой:

    Command
    env | grep -E "REALM|CLIENT"
5) Загрузите

  1. Загрузить файл pkinit_extensions и

сохраните 
  1. сохранить в каталог в котором

, Вы выполняете   View filename
  1. выполняются команды:

  1. pkinit_extensions

height150
  1. .

    Раскрыть
    titleсодержимое файла pkinit_extensions:


    Блок кода
    [ kdc_cert ]
    basicConstraints=CA:FALSE
     
    # Here are some examples of the usage of nsCertType. If it is omitted
    keyUsage = nonRepudiation, digitalSignature, keyEncipherment, keyAgreement
     
    #Pkinit EKU
    extendedKeyUsage = 1.3.6.1.5.2.3.5
     
    subjectKeyIdentifier=hash
    authorityKeyIdentifier=keyid,issuer
     
    # Copy subject details
     
    issuerAltName=issuer:copy
     
    # Add id-pkinit-san (pkinit subjectAlternativeName)
    subjectAltName=otherName:1.3.6.1.5.2.2;SEQUENCE:kdc_princ_name
     
    [kdc_princ_name]
    realm = EXP:0, GeneralString:${ENV::REALM}
    principal_name = EXP:1, SEQUENCE:kdc_principal_seq
     
    [kdc_principal_seq]
    name_type = EXP:0, INTEGER:1
    name_string = EXP:1, SEQUENCE:kdc_principals
     
    [kdc_principals]
    princ1 = GeneralString:krbtgt
    princ2 = GeneralString:${ENV::REALM}
     
    [ client_cert ]
     
    # These extensions are added when 'ca' signs a request.
     
    basicConstraints=CA:FALSE
     
    keyUsage = digitalSignature, keyEncipherment, keyAgreement
     
    extendedKeyUsage =  1.3.6.1.5.2.3.4
    subjectKeyIdentifier=hash
    authorityKeyIdentifier=keyid,issuer
     
     
    subjectAltName=otherName:1.3.6.1.5.2.2;SEQUENCE:princ_name
     
     
    # Copy subject details
     
    issuerAltName=issuer:copy
     
    [princ_name]
    realm = EXP:0, GeneralString:${ENV::REALM}
    principal_name = EXP:1, SEQUENCE:principal_seq
     
    [principal_seq]
    name_type = EXP:0, INTEGER:1
    name_string = EXP:1, SEQUENCE:principals
     
    [principals]
    princ1 = GeneralString:${ENV::CLIENT}
6) Выпустите


  1. Выпустить сертификат KDC:

    Command
$
  1. openssl x509 -req -in kdc.req -CAkey cakey.pem -CA cacert.pem -out kdc.pem -extfile pkinit_extensions -extensions kdc_cert -CAcreateserial -days 365
7)

  1. Файлы kdc.pem, kdckey.pem, cacert.pem 

перенесите в 
  1. переместить в каталог/var/lib/krb5kdc/:

    Command
    sudo mv kdc.pem, kdckey.pem, cacert.pem /var/lib/krb5kdc/
8) Создайте

  1. Создайть резервную копию файла /etc/krb5kdc/kdc.conf

. Отредактируйте
  1. ;

  2. Отредактировать файл /etc/krb5kdc/kdc.conf, дополнив секцию [kdcdefaults] следующими записями:

command
  1. Блок кода
    pkinit_identity = FILE:/var/lib/krb5kdc/kdc.pem,/var/lib/krb5kdc/kdckey.pem
    pkinit_anchors = FILE:/var/lib/krb5kdc/cacert.pem

    Первая запись задаёт ключи и сертификат сервера, а вторая указывает на корневой сертификат центра сертификации.

9.
  1. Для принятия изменений

выполните
  1. выполнить команды:

code
  1. Command
    sudo
  1. systemctl
  1. restart
  1. krb5-admin-server
  1. sudo
  1. systemctl
  1. restart
  1. krb5-kdc


Подготовка смарт-карты. Выпуск ключей и сертификата пользователя

Подключите


  1. Подключить устройство, которое следует подготовить

.
  1. ;

    Предупреждение

    В зависимости от модели токена (PKI

/
  1. или GOST), в дальнейшем требуется указывать определенную библиотеку (

 
  1. libjcPKCS11-2.so

 или 
  1. или libASEP11.so)


Проверка работы JaCarta в системе



Для проверки работы JaCarta:

  • libjcPKCS11-2.so (для JaCarta PKI/ГОСТ/FLASH):

    Command
    pkcs11-tool --module /usr/lib/libjcPKCS11-2.so -T



  • libASEP11.so (для JaCarta PKI):

    Command
    pkcs11-tool --module /usr/lib/x64-athena/libASEP11.so -T




Image Modified

Примечание
путь до библиотеки

Путь к библиотекам libjcPKCS11-2.so, libASEP11.so может различаться.

Для того чтобы определить путь до библиотеки libjcPKCS11-2.so введите выполнить команду:

Command
find /usr/*(lib|lib64) -name libjcPKCS11-2.so



Инициализация устройства


Для инициализации токена необходимо воспользоваться утилитой pkcs11-tool.:

Command
pkcs11-tool --slot 0x1ffff --init-token --so-pin 00000000 --label 'JaCarta PKI' --module /usr/lib/libjcPKCS11-2.so

Для задания ПИН кода пользователя используйте использовать команду:

Command
pkcs11-tool --slot 0x1ffff --init-pin --so-pin 00000000 --login --pin 11111111 --module /usr/lib/libjcPKCS11-2.so


Информация

--slot 0x1ffff — указывает в какой виртуальный слот подключено устройство. Как правило, это слот 0, но могут быть и другие значения – 1,2 и т.д.

--init-token – команда инициализации токена.

--pin - пин код пользователя JaCarta. По умолчанию имеет значение 11111111

--so-pin 00000000 – ПИН код администратора JaCarta PKI. По умолчанию имеет значение 00000000

--label 'JaCarta PKI' - метка(название) устройства.

--module - указывает путь до библиотеки libjcPKCS11-2.so

Image Modified



Предупреждение

Внимание! Инициализация устройства удалит все данные на JaCarta PKI без возможности восстановления. 


Генерация пары ключей на JaCarta 


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

Command

pkcs11-tool --slot 0x1ffff --login --pin 11111111 --keypairgen --key-type rsa:2048 --id 33 --label “2fa_test1_key” --module /usr/lib/libjcPKCS11-2.so

Image Modified

Примечание

-keypairgen --key-type rsa:2048 — указывает, что должны быть сгенерированы RSA ключи длиной 2048 бит; 
--id 33 — устанавливает атрибут CKA_ID ключа. CKA_ID может быть любым; 
--label “test1 key” — устанавливает атрибут CKA_LABEL(имя) ключа. Атрибут может быть любым; 


Генерация запроса на сертификат



Сгенерируйте Сгенерировать запрос на сертификат с помощью утилиты инструмента openssl. Для этого введите выполнить следующие команды:

Примечание

1) В Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.6) pkcs11 libengine-pkcs11-openssl версии 1.0.2 не совместим с библиотекой libjcPKCS11-2.so. Для корректного функционирования, следует:

  • либо скачать и установить подписанный пакет libengine-pkcs11-openssl1.1 версии 0.4.4-4 для Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.6):

2) Либо



Command
Titleopenssl

OpenSSL> engine dynamic -pre SO_PATH:/usr/lib/x86_64-linux-gnu/engines-1.1/pkcs11.so -pre ID:pkcs11 -pre LIST_ADD:1  -pre LOAD -pre MODULE_PATH:/usr/lib/libjcPKCS11-2.so
(dynamic) Dynamic engine loading support
[Success]: SO_PATH:/usr/lib/x86_64-linux-gnu/engines-1.1/pkcs11.so
[Success]: ID:pkcs11
[Success]: LIST_ADD:1
[Success]: LOAD
[Success]: MODULE_PATH:/usr/lib/libjcPKCS11-2.so
Loaded: (pkcs11) pkcs11 engine
OpenSSL> req -engine pkcs11 -new -key 131071:33 -keyform engine -out client.req 
engine "pkcs11" set.
Enter PKCS#11 token PIN for JaCarta ECP <AstraLinux>:
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]:RU
State or Province Name (full name) [Some-State]:Moscow
Locality Name (eg, city) []:
Organization Name (eg, company) [Internet Widgits Pty Ltd]: Rusbitech  
Organizational Unit Name (eg, section) []: Astra
Common Name (e.g. server FQDN or YOUR name) []:test1 (!Ваш_Пользователь!)
Email Address []:*********
 
OpenSSL> exit


Примечание

-new -key 131071:33, где 131071— номер виртуального слота с устройством (0x1ffff) , 33— атрибут CKA_ID раннее сгенерированных ключей.

в CN = следует указать имя пользователя


Примечание

В случае если openssl выдаст ошибку о  неверном слоте, № слота следует укзать в 10-м формате, например: 131071:33

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



Необходимо установить переменные окружения:

Command

export REALM=<имя_домена>
export CLIENT=<имя_доменного_пользователя>

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

Примечание

env | grep -E "REALM|CLIENT"

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

Command
$ openssl x509 -CAkey cakey.pem -CA cacert.pem -req -in client.req -extensions client_cert -extfile pkinit_extensions -out client.pem -days 365

Далее перекодируйте полученный сертификат из формата PEM в формат DER. 

Command
# openssl x509 -in client.pem -out client.cer -inform PEM -outform DER


Запишите полученный сертификат на токен:

Command
pkcs11-tool --slot 0x1ffff --login --pin 11111111 --write-object client.cer --type 'cert' --label 'test1' --id 33 --module /usr/lib/libjcPKCS11-2.so


Примечание

--write-object ./client.cer— указывает, что необходимо записать объект и путь до него;
--type 'cert'— указывает, что тип записываемого объекта - сертификат;
'cert' --label 'test1'— устанавливает атрибут CKA_LABEL(имя) сертификата. Атрибут может быть любым;


Настройка клиента. Проверка работоспособности



Создайте на клиенте каталог /etc/krb5/. Скопируйте в /etc/krb5/ сертификат CA (cacert.pem) c сервера.

Настройте kerberos в /etc/krb5.conf. Секцию [libdefaults] дополните следующими строками:

Блок кода
[libdefaults] 
default_realm = SMARTCARD.ALD
pkinit_anchors = FILE:/etc/krb5/cacert.pem
# для аутентификации по токену
pkinit_identities = PKCS11:/usr/lib/libjcPKCS11-2.so


Выполните проверку: 

Command
$ kinit


Когда появится строка запроса PIN-кода к карте, введите его.

Для проверки того, что ,билет kerberos-тикет был успешно получен для пользователя, введите команду:

Command
klist


Для билета:

Command
kdestroy


Примечание

Для включения отадки перед командой команду kinit следует использовать так:

Command
env KRB5_TRACE=/dev/stdout kinit <имя_пользователя>


Image Modified

Вход выполняется выполнять с подключенным токеном к компьютеру токеном. При графическом входе в поле Login вводится имя пользователя, в поле Password вводится <PIN пользователя>. При консольном входе все аналогично, только в момент ввода пароля будет сообщено, что требуется <PIN пользователя>.:

Command
login <имя_пользователя>

Настройка политики аутентификации


Существует возможность указания дополнительных параметров модуля аутентификации pam_krb5.so в файле /etc/pam.d/common-auth в строке относящейся к pam_krb5.so:
Image Modified

– try_pkinit — режим при котором осуществляется попытка аутентификации с помощью устройств PKCS-11, в случае провала попытки предоставляется возможность входа с помощью Kerberos пароля пользователя;

– use_pkinit — режим при котором требуется аутентификация с помощью устройств PKCS-11, в случае провала процесс входа прерывается;

– pkinit_prompt — вывод приглашения для подключения устройства PKCS-11 перед выполнением попытки входа.

Примечание

После обновления pam-auth-update, опции pkinit исчезнут.   Для того, чтобы опция сохранялась принудительно, в конфигурационном файле /usr/share/pam-configs/krb5 в поле Auth-Initial следует дописать одну из опций.

Image Modified

Более подробное описание см. в руководстве man.


Полезные ссылки




...