--- a/Lib/IMPL/Security/Auth.pm	Tue Dec 20 23:00:30 2011 +0300
+++ b/Lib/IMPL/Security/Auth.pm	Fri Dec 30 23:40:00 2011 +0300
@@ -46,22 +46,22 @@
 
 =head1 NAME
 
-C<IMPL::Security::Auth> �������� ����� ��� ������� ��������������.
+C<IMPL::Security::Auth> Базовыйы класс для пакетов аутентификации.
 
 =head1 DESCRIPTION
 
 C<[Abstract]>
 
-�������������� ����� ����������� ��������, ��� ���� ��������� ������ �������������� �������
-��������� ��������� ����� ����������.
+Аутентификация носит итеративный характер, для чего создается объект аутентификации который
+сохраняет состояние между итерациями.
 
-����������� �������������� �������� ������, ��������� ���� ������ ����� ������ ������
-��������������.
+Результатом аутентификации является сессия, состояние этой сессии также хранит объект
+аутентификации.
 
-� �������� ����������� ������ � ������ ������������� ������� ������������ C<$challenge>.
-� ����������� ������ �������� �������� ���� ���� (C<AUTH_SUCCESS>), ���� ������ �� �����������
-(C<AUTH_INCOMPLETE>), ���� ������� (C<AUTH_FAIL>). ���������� �������� ����� ���� ������,
-������� �� ������ ��������������.
+В процессе авторизации клиент и сервер обмениеваются данными безопасности C<$challenge>.
+И результатом каждой итерации является либо упех (C<AUTH_SUCCESS>), либо запрос на продолжение
+(C<AUTH_INCOMPLETE>), либо неудача (C<AUTH_FAIL>). Количество итераций может быть разным,
+зависит от пакета аутентификации.
 
 =head1 EXPORT
 
@@ -69,21 +69,21 @@
 
 =item C<:Const>
 
-��������� ���������� ��������������
+Константы результата аутентификации
 
 =over
 
 =item C<AUTH_SUCCESS>
 
-�������� ��������������
+Успешная аутентификация
 
 =item C<AUTH_INCOMPLETE>
 
-��������� �������������� ����
+Требуются дополнительные шаги
 
 =item C<AUTH_FAIL>
 
-�������������� ���������.
+Аутентификация неуспешна.
 
 =back
 
@@ -95,40 +95,40 @@
 
 =item C<CTOR($SecData)>
 
-������� ����� ��� ����������� �� ������ ������ ������������ ��� ������������.
-C<$SecData> - ������� �� ������ ��������������.
+Создает пакет для авторизации на основе данных безопасности для пользователя.
+C<$SecData> - Зависит от пакета аутентификации.
 
 =item C<[get] isTrusted>
 
-���� ����, ��� �������������� ��������� �������.
+Флаг того, что аутентификация закончена успешно.
 
 =item C<DoAuth($challenge)>
 
-���������� �������������� ������������ � ������������� ������,
-���������� ��������� ��������������, � ���� ������� ($status,$challenge).
+Производит аутентификацию пользователя и инициализацию сессии,
+возвращает результат аутентификации, в виде массива ($status,$challenge).
 
-����� �������� �������������� ������������ �������� ������ C<$challenge>
-��� �������������� ������.
+После успешной аутентификации пользователь получает данные C<$challenge>
+для аутентификации сессии.
 
 =item C<ValidateSession($challenge)>
 
-���������� �������������� ������, ���������� ��������� ��������������,
-� ���� ������� ($status,$challenge).
+Производит аутентификацию сессии, возвращает результат аутентификации,
+в виде массива ($status,$challenge).
 
 =item C<[static] CreateSecData(%args)>
 
-������� ������ ������������, �� ������ ����������. ��������� ������� �� ������ ��������������.
+Создает данные безопасности, на основе параметров. Параметры зависят от пакета аутентификации.
 
 =item C<[static] Create(%args)>
 
-������� ������ ��������������, �� ������ ����������. ��������� ������� �� ������ ��������������.
-������ �������� ����� C<CreateSecData(%args)>.
+Создает объект аутентификации, на основе параметров. Параметры зависят от пакета аутентификации.
+Внутри вызывает метод C<CreateSecData(%args)>.
 
 =item C<[static] SecDataArgs()>
 
-���������� ��� � ��������� ���������� ��� ������� C<CreateSecData>. ������� ��������
-����� ����������, ���������� - ����.
+Возвращает хеш с описанием параметров для функции C<CreateSecData>. Ключами являются
+имена параметров, значениями - типы.
 
 =back 
 
-=cut
\ No newline at end of file
+=cut