id: Гость   вход   регистрация
текущее время 00:05 29/03/2024
Владелец: SATtva (создано 08/03/2007 19:01), редакция от 03/07/2007 21:34 (автор: SATtva) Печать
Категории: криптография, софт, gnupg, аутентификация, эцп, разное, расширения, сообщество
создать
просмотр
редакции
ссылки

Общая спецификация интеграции GnuPG


Оглавление документа:

Задачи


Задачами, решаемыми интеграцией GnuPG, являются:


  1. Валидация загружаемого пользователем (в свой профиль) открытого ключа на корректность с последующим внесением отпечатка в базу данных.
  2. Авторизация (по протоколу запрос-ответ) ряда чувствительных операций: смены пользовательского пароля доступа и почтового адреса.
  3. Защита приватной связи между пользователями сайта.
  4. Защита отправляемого пользователю восстановленного пароля.
  5. Функциональное обеспечение публичного доступа к серверам ключей.
  6. Функциональное обеспечение публичного декодировщика OpenPGP-пакетов.
  7. Проверка цифровых подписей для пользовательских комментариев.

Возможность аутентификации на сайте с помощью протокола запрос-ответ (подписание пользователем строки запроса, сгенерированной сервером) не определяется в числе задач, поскольку, хотя и скрывает пароль от наблюдателя на канале связи, сама по себе не в силах предотвратить несанкционированный доступ к учетной записи пользователя с помощью перехваченных cookie и иными путями. Решение же данной проблемы — SSL — вообще делает подобную схему избыточной, поскольку защищает как реквизиты авторизованной сессии (cookie/SID) при работе с сайтом, так и реквизиты пользователя (логин/пароль) в момент аутентификации.


Тем не менее, список задач остается открыт для дополнений.

Функции


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

Загрузка ключа


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


Все этапы загрузки/валидации ключа выполняются в контексте специальной временной связки. Валидация ключа состоит из двух этапов: 1) имеет ли пользователь доступ к закрытой части ключа (это лишь защита от случайной загрузки пользователем чужого ключа, который он в дальнейшем не сможет заменить) и 2) пригоден ли ключ для операций шифрования. Первый этап производится в простом протоколе запрос/ответ и для верификации использует функцию VerifyMsg(). На втором этапе производится вызов CheckPK(). Если ключ удовлетворяет всем условиям, то он перемещается в основную связку сервера.

UploadPK(keyASCII)

Импортирует загруженный ключ на временную связку. Единственный аргумент, keyASCII, представляет собой загруженный пользователем блок открытого ключа, передаваемый в GnuPG через STDIN с параметром --import. Сразу после исполнения вызывается CheckPK(keyID), которая анализирует ключ с целью определения его пригодности для зашифрования.

RecievePK(keyID[, ksURL])

Импортирует ключ с сервера ключей на временную связку. Передает GnuPG указанный пользователем (в профиле) ID ключа в параметре командной строки --recv-keys. Опциональный аргумент ksURL позволяет пользователю задать URL сервера ключей, вместо дефолтного.


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


Хотя вся указанная функциональность реализована, тестирование показало, что большинство серверов ключей не способны корректно обходить коллизии в ID: одни обязывают передавать ID в восьмизначном формате (который и образует коллизию), а другие, хоть и не устанавливают такого требования, все равно возвращают пакеты открытых ключей и главные UserID по их восьмизначным ID, независимо от реальной длины ввода.

AcceptPK(keyID)

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

Шифрование данных


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

EncryptMsg(plaintext, keyID)

Шифрует произвольное текстовое сообщение. Вызывает GnuPG с параметрами -r <keyID> -e, подает открытый текст через STDIN и возвращает шифртекст, полученный от программы. Следует обратить внимание, что перед вызовом данной функции нужно произвести вызов CheckPK() и проверить, пригоден ли открытый ключ получателя для зашифрования.

Верификация данных

VerifyMsg(data)

Принимает произвольные данные, с которых снимает цифровую подпись (вызов GnuPG: gpg -v; команда --verify не используется, поскольку не возвращает сам заверенный текст). Результаты операции определяются по выданным статус-кодам. Возвращает 1) состояние подписи, 2) отпечаток первичного ключа, 3) метку времени ЭЦП, 4) идентификатор ЭЦП, а также 5) тело подписанного сообщения.

Извлечение ключа


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

GetPK(keyID)

Извлекает блок указанного открытого ключа из рабочей связки сервера и подает его на выход (параметры командной строки: --armor --export <keyID>).

Удаление/замена ключа


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

Функции обслуживания


Набор функций, используемых для обеспечения ряда вышеназванных задач.

CreateToken(procedure)

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

C = T, P, H(S, U, T, P)

где T — метка времени, P — обозначение операции (передается через аргумент функции), S — секретное значение системы, U — идентификатор PHP-сессии пользователя. (В качестве H применяется хэш-функция SHA-1.) Получаемый идентификатор выглядит примерно так:

1179831196|deletepk
251fb1d6718f7042948d77c583e75d5b3b39e52a

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

ValidateToken(token, procedure, expiry)

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

CheckPK(keyID)

Парсит сертификат ключа (используются параметры --with-colons --list-public-keys <keyID>) и проверяет следующие условия: 1) ключ содержит по крайней мере один шифровальный подключ и 2) базовый ключ и шифровальный подключ в данный момент действительны. Оба условия не имеют критического значения при загрузке ключа (пользователю выводится только предупреждение), но при восстановлении пароля или отправке зашифрованного приватного сообщения должно привести к неудачному завершению операции.

DeletePK(keyID)

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

Реализация


Ограничивающим фактором в реализации схемы выступает запрет стандартной PHP-функции exec() (что является нормой для любого виртуального хостинга). Таким образом, взаимодействие с GnuPG может осуществляться только через интерфейс CGI. Использовать с этой целью CGI-сборку PHP нерационально, поэтому итоговая конструкция представляет собой:


.                   openSpace Engine
    пользовательский уровень, графический интерфейс
                           /\
                           ||
                           \/
               openSpace-GPG engine class
   функциональная прокладка, реализующая необходимый
    набор функций ввода/вывода для взаимодействия с
         GnuPG и проверки результатов операций
                           /\
                           ||
                           \/
                openSpace-GPG CGI wrapper
    простейшая Perl-оболочка, "тупо" вызывающая GnuPG
    с переданными параметрами командной строки и воз-
       вращающая вывод программы верхнему уровню
                           /\
                           ||
                           \/
                   GnuPG executable
     исполняемый файл программы, лежащий за пределами
           публичной www-директории сервера

Временный контекст


Все операции, требующие сохранения временных данных на диске сервера (по существу, это любые операции, поскольку статус-коды и сообщения об ошибках перенаправляются на диск всегда), выполняются в контексте временного каталога, создаваемого конструктором объекта по номеру PHP-сессии пользователя, и удаляемого деструктором объекта по окончании исполнения скрипта. Таким образом, весь парсинг и анализ входных и выходных данных должен производиться в текущем цикле исполнения движка, либо необходимо идти на особые ухищрения, как то сохранение необходимых данных в сессии пользователя (что не рекомендуется).

Класс openSpace-GPG


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


Файл конфигурации gpg.conf


Поскольку GnuPG должен работать в полностью автономном режиме, видится необходимым следующий конфигурационный файл. Корректирующие параметры могут быть переданы как аргументы командной строки (например, --no-default-keyring).


CGI-обертка openSpace-GPG


Идея использования пайпа для передачи данных GnuPG из стандартного ввода принадлежит ПэГусеву, за что ему особая благодарность. В остальном обертка не содержит ничего существенного: HTTP-ввод разбирается на пары переменная=значение, вывод GPG открывается как файловый дескриптор и подается на стандартный вывод сервера для последующего перехвата вызывающей программой (конкретно, методом Call() класса; см. выше).


Для защиты от выполнения произвольных команд GnuPG путем прямого вызова скрипта вызывающее приложение должно передать секретное значение (HTTP-переменная pv), равное значению переменной $protection, заданной в скрипте.



 
На страницу: 1, 2, 3, 4, 5, 6, 7, 8 След.
Комментарии [скрыть комментарии/форму]
— SATtva (19/03/2007 17:38)   профиль/связь   <#>
комментариев: 11558   документов: 1036   редакций: 4118
Комментарии и корректировки документа принимаются.
— serzh (01/04/2007 16:27)   профиль/связь   <#>
комментариев: 232   документов: 17   редакций: 99
При попытке импорта выдаёт следующее: "openSpace-GPG: unable to open CGI wrapper."
Сам ключ после этого на сервере не появляется.
— SATtva (01/04/2007 16:49)   профиль/связь   <#>
комментариев: 11558   документов: 1036   редакций: 4118
Привилегии враппера сбились. Исправлено.
— serzh (01/04/2007 17:13)   профиль/связь   <#>
комментариев: 232   документов: 17   редакций: 99
В сообщениях достаточно выводить KeyID, а не весь отпечаток. Так немного перегружено получается.
— serzh (01/04/2007 17:21)   профиль/связь   <#>
комментариев: 232   документов: 17   редакций: 99
Если изменить свои данные(e-mail), то импортированый ключ исчезает из базы.
— SATtva (01/04/2007 19:00)   профиль/связь   <#>
комментариев: 11558   документов: 1036   редакций: 4118
Ошибка исправлена.
— SATtva (02/04/2007 20:33, исправлен 02/04/2007 20:34)   профиль/связь   <#>
комментариев: 11558   документов: 1036   редакций: 4118
В процессе написания кода для меня оставался открытым один вопрос: каким образом подать GnuPG пользовательский ввод из веб-формы непосредственно как STDIN? (В частности, это относится к загружаемому материалу ключа, но позднее этот вопрос ещё аукнется при шифровании сообщений.)

В данный момент, что видно в методе UploadPK() (см. "Класс openSpace-GPG" выше), используется обходной манёвр: вначале загруженный ключ сохраняется во временном файле на сервере, а затем производится импорт уже конкретно содержимого этого файла. И хотя все временные данные удаляются по завершении исполнения скрипта, хотелось бы по возможности избавиться от раскидывания всякого разного по диску сервера.

Прошу помощи: может ли кто-нибудь подсказать какой-то трюк, чтобы подать пользовательский ввод из HTTP-POST-запроса на вход GnuPG, вызвав его при этом с необходимыми параметрами командной строки?
— ПэГусев (03/04/2007 06:02)   профиль/связь   <#>
комментариев: 112   документов: 8   редакций: 15
Прошу помощи: может ли кто-нибудь подсказать какой-то трюк, чтобы подать пользовательский ввод из HTTP-POST-запроса на вход GnuPG, вызвав его при этом с необходимыми параметрами командной строки?

popen ?
— SATtva (03/04/2007 09:12)   профиль/связь   <#>
комментариев: 11558   документов: 1036   редакций: 4118
Да, процесс — это интересно. На уровне PHP у нас это не получится, а вот в Perl-оболочке можно попробовать что-нибудь придумать. Остаюсь открыт для идей и предложений.
— ПэГусев (03/04/2007 10:59)   профиль/связь   <#>
комментариев: 112   документов: 8   редакций: 15
На уровне PHP у нас это не получится

А если попробовать передать ключ как параметр (можно предварительно закодировать в base64) в post-запросе Perl-скрипту, а там, соответственно, раскодировать и отправить по конвейеру (pipe) GnuPG.
— SATtva (03/04/2007 22:43)   профиль/связь   <#>
комментариев: 11558   документов: 1036   редакций: 4118
Пайпинг с base64-кодированным вводом подошёл наилучшим образом. Переписано несколько строчек в методе Call() класса и процедура вызова GnuPG в Perl-оболочке (да, и в gpg.conf добавил trust-model, что позднее потребуется для шифрования). ПэГусев, большое спасибо за подсказку! :-)
— Гость (04/04/2007 14:17)   <#>
А не лучше ли показывать отпечаток при наведении указателя, примерно вот так:

SATtva (03/04/2007 22:43) профиль <#>
комментариев: 3286 документов: 715 редакций: 114
— SATtva (04/04/2007 14:55)   профиль/связь   <#>
комментариев: 11558   документов: 1036   редакций: 4118
Это лаконичней, но не так очевидно, а отпечаток должен быть виден при любых условиях, это было изначальной задачей. Вот где unknown впервые упоминал о ней.

Вообще, учитывая достаточно компактный хидер каждого комментария (особенно в сравнении с популярными форумами типа phpBB и иже с ним), добавление отдельной строки с отпечатком не кажется мне такой уж большой нагрузкой. Возможно, сможете меня переубедить, но пока я не вижу лучшего варианта.
— spinore (04/04/2007 17:20)   профиль/связь   <#>
комментариев: 1515   документов: 44   редакций: 5786
Значит, работает :-)))
И всё же был бы смысл реализовать возможность постить подписанные сообщения, при этом бы сайт автоматом проверял правильность подписи и ставил специальную галку возле сообщения (что подписано), а все желающие, щёлкнув на неё, могли бы получить оригинальный пост с подписью и удостовериться сами, что сайт действительно не обманывает при проверке подписи.
— Гость (04/04/2007 18:07)   <#>
unknown там пишет, что шрифт должен быть мелкий!

SATtva (04/04/2007 18:10) профиль <#>
комментариев: 3289 документов: 715 редакций: 116
отпечаток ключа: 6BBF A6A8 2488 F017 4211 0AA5 FAEB 26F7 8443 620A

Или пусть он будет хотя-бы серый!

SATtva (04/04/2007 18:12) профиль <#>
комментариев: 3290 документов: 715 редакций: 116 отпечаток ключа: 6BBF A6A8 ...

Может уменьшить число показываемых симолов?
На страницу: 1, 2, 3, 4, 5, 6, 7, 8 След.
Ваша оценка документа [показать результаты]
-3-2-1 0+1+2+3