diff Lib/IMPL/Security.pm @ 180:d1676be8afcc

Перекодировка в utf-8
author sourcer
date Fri, 30 Dec 2011 23:40:00 +0300
parents 068acfe903c3
children 4d0e1962161c
line wrap: on
line diff
--- a/Lib/IMPL/Security.pm	Tue Dec 20 23:00:30 2011 +0300
+++ b/Lib/IMPL/Security.pm	Fri Dec 30 23:40:00 2011 +0300
@@ -50,7 +50,7 @@
 
 =head1 NAME
 
-C<IMPL::Security> -        .
+C<IMPL::Security> - Модуль для работы с функциями авторизации и аутентификации.
 
 =head1 SINOPSYS
 
@@ -107,15 +107,15 @@
 
 =head1 DESCRIPTION
 
-   ,     
-  .
+Модуль для инфраструктуры безопасности, реализует основные функции для авторизации
+и аутентификации пользователей.
 
- ,     , 
-,     ,  
-     .
+Модуль аутентификации, реализиция которого зависит от приложения, аутентифицирует
+пользователя, при этом создается контекст безопасности, который содержит
+идентификатор пользователя и список активных ролей.
 
-        ,
-   ,   .
+При проверке прав доступа происходит последовательная проверка правил доступа,
+если все правила выполнены, то доступ разрешается.
 
 =head1 MEMBERS
 
@@ -123,74 +123,74 @@
 
 =item C<AccessCheck($object,$desiredAccess,$context)>
 
-.       ,    .
+Метод. Проверка доступа к объекту с определенными правами, в определенном контексте безопасности.
 
 =over
 
 =item C<$object>
 
- .
+Объект доступа.
 
 =item C<$desiredAccess>
 
-  .
+Требуемые права доступа.
 
 =item C<$context>
 
- ,   ,    C<< IMPL::Security::Context->contextCurrent >>
+Контекст безопасности, если не указан, то используется текущий C<< IMPL::Security::Context->contextCurrent >>
 
 =item C<returns>
 
-C<true | false> -  
+C<true | false> - результат проверки
 
 =back
 
 =item C<MakeContext($principal,$role,$auth)>
 
-  ,    .
+Создает контекст безопасности, инициализируя его передданными параметрами.
 
 =over
 
 =item C<$principal>
 
- 
+Объект пользователя
 
 =item C<$role>
 
-     
+Роль или ссылка на массив ролей
 
 =item C<$auth>
 
- 
+Объект аутентификации
 
 =back
 
 =item C<Take($principal,$role)>
 
-.      .    
-  .     .
+Метод. Делегирует текущему пользователю полномочия другого пользователя. При этом выполняется проверка
+правомерности такой операции. В случае неудачи вызывается исключение.
 
 =over
 
 =item C<$principal>
 
-     C<IMPL::Security::Principal>.
+Либо имя пользователя либо объект C<IMPL::Security::Principal>.
 
 =item C<$role>
 
-     ,      ,  .
+Либо имя либо ссылка на роль, или ссылка на массив либо имен, либо ролей.
 
 =item C<returns>
 
-  .
+Новый контекст безопасности.
 
 =back
 
 =item C<Rules()>
 
-       .  
-,     .      
-   .
+Возвращает список правил которые выполняются при проверках доступа. Пререопределите этот
+метод, чтобы возвращать собственный список правил. Список правил является ссылкой на массив
+элементами которого являются функции.
 
 =begin code
 
@@ -210,9 +210,9 @@
 
 =item C<[static,get] authority>
 
-,      .  ,  ,
-          .
+Метод, позволяющий получить текущий источник системы безопасности. Источник безопасности, это модуль,
+который получает входные данные и использует их для работы системы безопасности.
 
 =back
 
-=cut
\ No newline at end of file
+=cut