Авторизация с помощью клиентских SSL сертификатов

Post Reply
User avatar
Raven
Бородатый сис
Бородатый сис
Posts: 2794
Joined: 03 Mar 2010, 15:12
ОС: RHEL 8
Location: Из серверной

Авторизация с помощью клиентских SSL сертификатов

Post by Raven » 17 Dec 2010, 16:23

Авторизация с помощью клиентских SSL сертификатов

Протокол безопасной передачи данных SSL (Secure Sockets Layer) помимо обеспечения безопасной передачи данных позволяет также реализовать авторизацию клиентов на сервере с помощью клиентских SSL сертификатов. Данная статья является практическим руководством по реализации данного вида авторизации. В статье не рассматриваются теоретические основы криптографии или передачи данных по протоколу SSL. Подразумеваемся, что читатель хотя бы поверхностно знаком с понятиями, используемыми в этой статье, такими как сертификат, секретный ключ, подпись сертификата и т.д.

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

Наиболее наглядным примером использования авторизации посредством клиентских сертификатов является система платежей WebMoney Transfer, а точнее реализация WM Keeper Light. Данная схема авторизации признана наиболее надежной и, в том или ином виде, широко используется в сфере предоставления банковских услуг.

Практическая реализация рассматривается на основе популярной связки веб-сервера Apache и модуля mod_ssl , основанного на использовании библиотеки openssl . Предполагается, что соответствующее программное обеспечение у вас уже установлено.

Для реализации процесса авторизации по клиентским сертификатам требуется:
  • 1. Создать собственный доверенный сертификат (Certificate Authority), для того чтобы с помощью него подписывать и проверять клиентские сертификаты.
    2. Создать клиентские сертификаты, подписанные доверенным сертификатом, для последующей передачи их клиентам.
    3. Сконфигурировать веб-сервер для запроса и проверки клиентских сертификатов.
Примечание: Для работы с ключами используется программа openssl, входящая в пакет библиотеки openssl. Все приведенные в статье примеры максимально адаптированы для их выполнения из серверных скриптов при автоматизации процесса выдачи клиентских сертификатов, в частности нигде не используется интерактивный режим. При создании закрытых ключей не используется шифрование ключа, поэтому рекомендуется максимально использовать систему ограничения прав доступа операционной системы на файлы ключей.


Создание собственного самоподписанного доверенного сертификата.
Собственный доверенный сертификат (Certificate Authority - далее CA) необходим для подписи клиентских сертификатов и для их проверки при авторизации клиента веб-сервером. С помощью приведенной ниже команды создается закрытый ключ и самоподписанный сертификат.

Code: Select all

# openssl req -new -newkey rsa:1024 -nodes -keyout ca.key -x509 -days 500 -subj /C=RU/ST=Msk/L=Msk/O=My\ Inc/OU=Sale/CN=bla/emailAddress=usr@dom.ru -out ca.crt 

Описание аргументов:
  • req - Запрос на создание нового сертификата.
    -new Создание запроса на сертификат (Certificate Signing Request - далее CSR).
    -newkey rsa:1023 Автоматически будет создан новый закрытый RSA ключ длиной 1024 бита. Длину ключа можете настроить по своему усмотрению.
    -nodes Не шифровать закрытый ключ (См. примечание выше).
    -keyout ca.key Закрытый ключ сохранить в файл ca.key.
    -x509 Вместо создания CSR (см. опцию -new) создать самоподписанный сертификат.
    -days 500 Срок действия сертификата 500 дней. Размер периода действия можете настроить по своему усмотрению. Не рекомендуется вводить маленькие значения, так как этим сертификатом вы будете подписывать клиентские сертификаты.
    -subj /C=RU/ST=Msk/L=Msk/O=My\ Inc/OU=Sale/CN=bla/emailAddress=usr@dom.ru Данные сертификата, пары параметр=значение, перечисляются через '/'. Символы в значении параметра могут быть "подсечены" с помощью обратного слэша "\", например "O=My\ Inc". Также можно взять значение аргумента в кавычки, например, -subj "/xx/xx/xx".

Описание параметров:
  • С - Двухсимвольный код страны (Country). Необязательный параметр.
    ST - Название региона/области/края/республики/... (State Name). Необязательный параметр.
    L - Название города/поселка/... (Locality Name). Необязательный параметр.
    O - Название организации (Organization Name). Необязательный параметр.
    OU - Название отдела (Organization Unit). Необязательный параметр.
    CN - Имя сертификата, при создании серверных сертификатов используется доменное имя сайта, для клиентских сертификатов может быть использовано что угодно (Common Name). Обязательный параметр. Максимальная длина 64 символа.
    emailAddress - почтовый адрес (E-mail address). Необязательный параметр. Максимальная длина 40 символов.

Необязательные параметры могут быть пропущены, например,

Code: Select all

/C=RU/CN=blabla/emailAddress=user@domain.ru. -out ca.crt 
Сертификат сохранить в файл ca.crt.

В результате выполнения команды появятся два файла ca.key и ca.crt.
Просмотреть данные закрытого ключа и сертификата вы можете с помощью команд:

Code: Select all

   # openssl rsa -noout -text -in ca.key (для ключа) 
   # openssl x509 -noout -text -in ca.crt (для сертификата) 

Создание клиентских сертификатов

Подготовка конфигурации и файлов для подписи сертификатов.

Создайте конфигурационный файл с именем ca.config следующего содержания.

Code: Select all

  [ ca ] 
   default_ca = CA_CLIENT # При подписи сертификатов 
   # использовать секцию CA_CLIENT 
    
   [ CA_CLIENT ] 
   dir = ./db # Каталог для служебных файлов 
   certs = $dir/certs # Каталог для сертификатов 
   new_certs_dir = $dir/newcerts # Каталог для новых сертификатов 
    
   database = $dir/index.txt # Файл с базой данных 
   # подписанных сертификатов 
   serial = $dir/serial # Файл содержащий серийный номер 
   # сертификата 
   # (в шестнадцатиричном формате) 
   certificate = ./ca.crt # Файл сертификата CA 
   private_key = ./ca.key # Файл закрытого ключа CA 
    
   default_days = 365 # Срок действия подписываемого 
   # сертификата 
   default_crl_days = 7 # Срок действия CRL (см. $4) 
   default_md = md5 # Алгоритм подписи 
    
   policy = policy_anything # Название секции с описанием 
   # политики в отношении данных 
   # сертификата 
    
   [ policy_anything ] 
   countryName = optional # Код страны - не обязателен 
   stateOrProvinceName = optional # ...... 
   localityName = optional # ...... 
   organizationName = optional # ...... 
   organizationalUnitName = optional # ...... 
   commonName = supplied # ...... - обязателен 
   emailAddress = optional # ...... 

Создайте структуру каталогов и файлов, соответсвующую описанной в
конфигурационном файле

Code: Select all

   # mkdir db 
   # mkdir db/certs 
   # mkdir db/newcerts 
   # touch db/index.txt 
   # echo "01" > db/serial 

Примечание: В файле db/serial записывается текущий серийный номер подписываемого сертификата в шестнадцатиричном формате. В файл db/index.txt сохраняются данные о подписываемых сертификатах.

Создание клиентского закрытого ключа и запроса на сертификат (CSR).

Для создания подписанного клиентского сертификата предварительно необходимо создать запрос на сертификат, для его последующей подписи. Аргументы команды полностью аналогичны аргументам использовавшимся при создании самоподписанного доверенного сертификата (см. $1), но отсутсвует параметр -x509.

Code: Select all

   # openssl req -new -newkey rsa:1024 -nodes -keyout client01.key -subj /C=RU/ST=Msk/L=Msk/O=Inc/OU=Web/CN=usr/emailAddress=usr@dm.ru -out client01.csr 

В результате выполнения команды появятся два файла client01.key и client01.csr. Просмотреть данные закрытого ключа и запроса на сертификат (CSR) вы можете с помощью команд:

Code: Select all

   # openssl rsa -noout -text -in client01.key (для ключа) 
   # openssl req -noout -text -in client01.csr (для запроса) 


Подпись запроса на сертификат (CSR) с помощью доверенного сертификата (CA).

При подписи запроса используются параметры заданные в файле ca.config

Code: Select all

   # openssl ca -config ca.config -in client01.csr -out client01.crt -batch 

Описание аргументов:
  • ca Подпись запроса с помощью CA.
    -config ca.config Использовать конфигурационный файл ca.config.
    -in client01.csr CSR находится в файле client01.csr
    -out client01.crt Сохранить сертификат в файл client01.crt
    -batch Не спрашивать подтверждения подписи.

В результате выполнения команды появится файл клиентского сертификата client01.crt. Просмотреть данные сертификата вы можете с помощью команды:

Code: Select all

   # openssl x509 -noout -text -in client01.crt 


Подготовка данных для передачи клиенту.

Для передачи полученных в результате предыдущих операций файлов клиенту, обычно используется файл в формате PKCS#12. В этот файл упаковывается и защищается паролем вся информация необходимая клиенту для инсталяции сертификата в броузер.

Code: Select all

   # openssl pkcs12 -export -in client01.crt -inkey client01.key -certfile ca.crt -out client01.p12 -passout pass:q1w2e3 

Описание аргументов:

Code: Select all

 [b]pkcs12[/b] Работа с файлами формата PKCS#12. 
   [b]-export[/b] Экспортирование данных в файл. 
   [b]-in client01.crt[/b] Файл клиентского сертификата. 
   [b]-inkey client01.key [/b] Файл закрытого ключа. 
   [b]-certfile ca.crt [/b] Файл доверенного сертификата. 
   [b]-out client01.p12[/b] Сохранить данные в файл client01.p12. 
  [b] -passout pass:q1w2e3 [/b] Установить пароль q1w2e3 на файл (пароль может быть любым, в том числе и пустым) 

На этом процесс создания клиентского сертификата завершен. Теперь вам необходимо передать клиенту файл client01.p12 и пароль к нему любым удобным безопасным способом, а также проинструктировать его о процедуре инсталяции сертификата в броузер.


Настройка веб-сервера.


Для реализации процесса авторизации по клиентским сертификатам необходимо сконфигурировать веб-сервер для решения следующих задач:
  • 1. Запрет доступа к защищаемой области по протоколу HTTP.
    2. Запрос и проверка клиентских сертификатов.

Запрет доступа к защищаемой области по протоколу HTTP.

Найдите в конфигурационном файле веб-сервера httpd.conf секцию <VirtualHost IP-ADDRESS>, соответсвующую вашему сайту и добавьте в неё следующие директивы

Code: Select all

   <Directory /path/to/secure/area/> 
   SSLRequire 
   </Directory> 

Описание директив:
  • /path/to/secure/area/ Абсолютный путь до директории защищаемой области.
    SSLRequire Запрещает доступ клиенту, если при соединении не используется протокол HTTPS (HTTP через SSL).


Запрос и проверка клиентских сертификатов.

Найдите в конфигурационном файле веб-сервера httpd.conf секцию, соответсвующую вашему сайту и добавьте в неё следующие директивы:

Code: Select all

   SSLCACertificateFile /path/to/ca.crt 
   <Directory /path/to/secure/area/> 
   SSLVerifyClient require 
   </Directory> 

Описание директив:
  • SSLCACertificateFile /path/to/ca.crt Абсолютный путь до доверенного сертификата (см. $1.). Также в качестве значения директивы SSLCACertificateFile может быть указан файл, содержащий несколько доверенных сертификатов (формируется путем обычной конкатенации файлов сертификатов), тогда все они будут считаться доверенными сертификатами.
    SSLVerifyClient require При наличии этой директивы веб-сервер будет запрашивать сертификат у клиента в обязательном порядке. Если клиент не предоставляет сертификат, тогда сервер отклоняет запрос. Если клиент предоставляет сертификат, то веб-сервер проверяет его срок действия и поставщика сертификата (сертификат которым он подписан), если сертификат поставщика присутсвует в файле SSLCACertificateFile, то проверка считается успешной и клиенту предоставляется доступ до защищенной области.

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

Code: Select all

   # apachectl restart 

Альтернативные способы настройки веб-сервера.

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

*Пример 1.*

Допустим файл указанный в директиве SSLCACertificateFile содержит несколько доверенных сертификатов (см. описание директивы SSLCACertificateFile). Требуется разрешить доступ до защищенной области только владельцам сертификатов, подписанных только одним из поставщиков.

Code: Select all

   <Directory /path/to/secure/area/> 
   SSLVerifyClient require 
   SSLRequire %{SSL_CLIENT_I_DN_O} eq "First CA Inc." 
   </Directory> 

Описание директив:
  • SSLRequire %{SSL_CLIENT_I_DN_O} eq "First CA Inc." Требует чтобы организацией поставщика клиентского сертификата являлась "First CA Inc.". Аналогичным способом можно проверять любые другие параметры клиентского сертификата или его поставщика. Более подробную информацию о директиве SSLRequire и именах переменных смотрите в документации по mod_ssl.

*Пример 2.*

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

Code: Select all

   <Directory /path/to/secure/area/> 
   SSLVerifyClient require 
   SSLOptions +FakeBasicAuth 
   AuthName "My secure area" 
   AuthType Basic 
   AuthUserFile /path/to/passwd/file 
   require valid-user 
   </Directory> 

Содержимое файла /path/to/passwd/file

Code: Select all

   /C=RU/L=Msk/O=My Inc./CN=user/emailAddress=user@domain.ru:xxj31ZMTZzkVA 
   /C=RU/L=Sam/O=My LTD./CN=vas/emailAddress=vas@domain.ru:xxj31ZMTZzkVA 
   /C=RU/L=Zel/O=My LLC./CN=prs/emailAddress=prs@domain.ru:xxj31ZMTZzkVA 
........

Описание директив:
  • SSLOptions +FakeBasicAuth Имитирует простую авторизацию веб-сервером. Имя пользователя и пароль не запрашиваются, но сверяются данные клиентского сертификата с данными в файле /path/to/passwd/file. Строка идентифицирующая клиента может быть получена из клиентского сертификата с помощью команды:

    Code: Select all

       # openssl x509 -noout -subject -in client.crt 

    Или взята из базы данных db/index.txt, формируемой при подписи CSR. В качестве пароля всегда используется строка "xxj31ZMTZzkVA", являющаяся результатом шифрования строки "password" с помощью алгоритма DES.


Отзыв сертификатов.

Результат проверки веб-сервером клиентского сертификата будет успешным на весь срок действия сертификата. Возникает вопрос, что делать в случае если вы хотите отказать какому-либо клиенту в доступе по его клиентскому сертификату. Для решения этой проблемы создается список отзыва сертификатов (Certificate Revocation List - CRL). В списке отзыва перечисляются отозванные вами клиентские сертификаты. В соответсвии с этим списком веб-сервер будет отклонять запросы если сертифкат клиента отозван.


Создание списка отзыва (CRL).
При создании списка отзыва используется тот же конфигурационный файл и та же структура файлов, что и при подписи сертификатов, поэтому при выполнении следующей команды вы должны находиться в том же каталоге.

# openssl ca -gencrl -config ca.config -out ca.crl

Описание аргументов:
  • ca При создании CRL также используется этот аргумент.
    -gencrl Создание списка отзыва сертификатов.
    -config ca.config Использовать конфигурационный файл ca.config.
    -out ca.crl Сохранить созданный список отзыва в файл ca.crl

В результате будет создан список отзыва, основанный на базе данных подписанных сертификатах db/index.txt. Так как на данный момент ни один из сертификатов в базе данных не помечен как отозванный, то созданный список будет пустым. Просмотреть данные списка отзыва вы можете с помощью следующей команды.

# openssl crl -in ca.crl -text -noout

Одной из важных черт списка отзыва является его срок действия, указываемый в конфигурационном файле ca.config с помощью директивы default_crl_days. Также альтернативно может быть использована директива default_crl_hours, если вы планируете часто обновлять ваш CRL. Список отзыва должен обновляться не позже истечения срока действия. Для переодического вызова приведенной выше команды можно использовать cron.


Отзыв сертификата.

Для того чтобы отозвать клиентский сертификат необходимо пометить его в базе данных сертификатов db/index.txt как отозванный, тогда при следующем обновлении списка отзыва, этот сертификат будет в него включен. Для пометки сертификата как отозванного используйте приведенную ниже команду.

Code: Select all

   # openssl ca -config ca.config -revoke client01.crt 

Описание аргументов:
  • -revoke client01.crt Отозвать сертификат находящийся в файле client01.crt


Настройка веб-сервера
После создания списка отзыва сертификатов необходимо дать возможность веб-серверу использовать его. Для этого добавьте приведенную ниже директиву в конфигурационный файл веб-сервера.

Code: Select all

SSLCARevocationFile /path/to/ca.crl

Описание директив:
  • SSLCARevocationFile /path/to/ca.crl Абсолютный путь до файла со списком отзыва сертификатов

Не забывайте перезапускать веб-сервер после каждого изменения его конфигурации.

Code: Select all

   # apachectl restart 


Заключение.
Вышеизложенный материал можно дополнять и углублять, цель статьи - минимальное руководство по реализации авторизации по клиентским сертификатам на практике. Любой читатель, имеющий доступ к использовавшемуся программному обеспечению, с помощью этой статьи может за короткое время настроить свой веб-сервер для решения этой задачи.
Каждый из изложенных пунктов можно расширить и написать по нему отдельную статью, заинтересовавшиеся читатели могут получить дополнительные сведения в документации по Apache, mod_ssl и openssl. В заключение хочется дать несколько советов по программной реализации вышеописанных процессов.

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

Code: Select all

   open ( LOCK, ">/tmp/cert-sign.lck" ) or error_handling(); 
   flock ( LOCK, 2 ) or error_handling(); 
    
   # ... код, реализующий подпись сертификата ... 
    
   close( LOCK ); 

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

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

Code: Select all

   SSLOptions +StdEnvVars +ExportCertData 

Описание директив:
  • +StdEnvVars Включает установку в переменные окружения данных, относящихся к SSL.
    +ExportCertData Включает установку в переменные окружения текста сертификатов использовавшихся при передаче данных.
По умолчанию установка переменных окружения, относящихся к SSL, отключена, так как их извлечение из сертификатов влечет за собой снижение быстродействия веб-сервера. Поэтому следует добавлять эти опции только в случае реальной необходимости.

Альтернативой переменной REMOTE_USER могут служить следующие переменные: SSL_CLIENT_M_SERIAL - серийный номер клиентского сертификата, SSL_CLIENT_S_DN_CN - имя сертификата (Common Name) или SSL_CLIENT_S_DN - данные сертификата (Subject Name, см. описание аргумента -subj в $1).
Если вы хотите использовать переменную SSL_CLIENT_S_DN_CN для идентификации пользователя, то вы должны обеспечить уникальность Common Name для разных сертификатов при создании запросов на клиентский сертификат . Уникальность SSL_CLIENT_M_SERIAL и SSL_CLIENT_S_DN гарантируется автоматически при подписи сертификатов.
Я не злопамятный, я просто часто ковыряю логи
Post Reply

Return to “Общецелевая документация”