|
52
|
1 package IMPL::Web::Security;
|
|
81
|
2 use strict;
|
|
73
|
3
|
|
81
|
4 use IMPL::Security::Auth qw(:Const);
|
|
230
|
5 use IMPL::declare {
|
|
|
6 require => {
|
|
|
7 Exception => 'IMPL::Exception',
|
|
|
8 NotImplementedException => '-IMPL::NotImplementedException',
|
|
|
9 SecurityContext => 'IMPL::Security::AbstractContext'
|
|
|
10 },
|
|
|
11 };
|
|
107
|
12
|
|
233
|
13 use constant {
|
|
|
14 ERR_NO_SUCH_USER => -1,
|
|
|
15 ERR_NO_SEC_DATA => -2,
|
|
239
|
16 ERR_NO_AUTHORITY => -3,
|
|
|
17 ERR_NO_SEC_CONTEXT => -4,
|
|
|
18 ERR_AUTH_FAIL => -5
|
|
233
|
19 };
|
|
|
20
|
|
81
|
21 sub AuthUser {
|
|
194
|
22 my ($this,$name,$package,$challenge) = @_;
|
|
|
23
|
|
230
|
24 my $user = $this->FindUserByName($name)
|
|
233
|
25 or return {
|
|
|
26 status => AUTH_FAIL,
|
|
|
27 code => ERR_NO_SUCH_USER
|
|
|
28 };
|
|
239
|
29
|
|
230
|
30 my $auth;
|
|
|
31 if ( my $secData = $user->GetSecData($package) ) {
|
|
194
|
32 $auth = $package->new($secData);
|
|
|
33 } else {
|
|
230
|
34 return {
|
|
|
35 status => AUTH_FAIL,
|
|
233
|
36 code => ERR_NO_SEC_DATA,
|
|
230
|
37 user => $user
|
|
|
38 };
|
|
194
|
39 }
|
|
|
40
|
|
239
|
41 return {
|
|
|
42 status => AUTH_FAIL,
|
|
|
43 code => ERR_NO_SEC_CONTEXT
|
|
|
44 } unless SecurityContext->current;
|
|
|
45
|
|
|
46 return {
|
|
|
47 status => AUTH_FAIL,
|
|
|
48 code => ERR_NO_AUTHORITY
|
|
|
49 } unless SecurityContext->current->authority;
|
|
|
50
|
|
232
|
51 my $status = SecurityContext->current->authority->InitSession(
|
|
|
52 $user,
|
|
239
|
53 [$user->roles],
|
|
232
|
54 $auth,
|
|
239
|
55 $challenge
|
|
232
|
56 );
|
|
230
|
57
|
|
194
|
58 return {
|
|
|
59 status => $status,
|
|
233
|
60 code => ($status == AUTH_FAIL ? ERR_AUTH_FAIL : 0),
|
|
230
|
61 user => $user
|
|
|
62 };
|
|
73
|
63 }
|
|
|
64
|
|
239
|
65 sub Logout {
|
|
|
66 my ($this) = @_;
|
|
|
67
|
|
|
68 my $session = SecurityContext->current;
|
|
|
69 if($session && $session->authority) {
|
|
|
70 $session->authority->CloseSession($session);
|
|
|
71
|
|
|
72 $this->CloseSession($session);
|
|
|
73 }
|
|
|
74 }
|
|
|
75
|
|
230
|
76 sub FindUserByName {
|
|
|
77 die NotImplementedException->new();
|
|
|
78 }
|
|
|
79
|
|
|
80 sub CreateSession {
|
|
|
81 die NotImplementedException->new();
|
|
|
82 }
|
|
|
83
|
|
|
84 sub GetSession {
|
|
|
85 die NotImplementedException->new();
|
|
|
86 }
|
|
|
87
|
|
|
88 sub SaveSession {
|
|
|
89 die NotImplementedException->new();
|
|
73
|
90 }
|
|
|
91
|
|
239
|
92 sub CloseSession {
|
|
|
93 die NotImplementedException->new();
|
|
|
94 }
|
|
|
95
|
|
52
|
96 1;
|
|
|
97
|
|
|
98 __END__
|
|
|
99
|
|
|
100 =pod
|
|
|
101
|
|
73
|
102 =head1 NAME
|
|
|
103
|
|
180
|
104 C<IMPL::Web::Security> Модуль для аутентификации и авторизации веб запроса.
|
|
73
|
105
|
|
52
|
106 =head1 DESCRIPTION
|
|
|
107
|
|
232
|
108 Текущий модуль обеспечивает функции верхнего уровня для работы с системой
|
|
|
109 безопасности. Поскольку модуль является абстрактым, конкретные функции
|
|
|
110 хранения и реализацию объектов модели безопасности должно обеспечить само
|
|
|
111 приложение.
|
|
|
112
|
|
|
113 Сама система безопасности в веб приложении состоит из двух частей
|
|
|
114
|
|
|
115 =over
|
|
|
116
|
|
|
117 =item Модель системы безопасности
|
|
52
|
118
|
|
232
|
119 Предоставляет такие объкты безопасности, как пользователь, сессия роль,
|
|
|
120 определяет правила проверки прав доступа субъекта к объекту.
|
|
|
121
|
|
|
122 =item Модуль безопасности
|
|
52
|
123
|
|
232
|
124 Как правило встраивается в транспортный уровеь в виде обработчика
|
|
|
125 C<IMPL::Web::Handler> и реализует непосредственно протокол аутентификации и
|
|
|
126 обмена с пользователем.
|
|
|
127
|
|
|
128 Также модуль безопасности использует модель для хранения сессий и данных
|
|
|
129 аутентификции. Контекст безопасности создается именно этим модулем.
|
|
|
130
|
|
|
131 =back
|
|
52
|
132
|
|
73
|
133 =head1 MEMBERS
|
|
52
|
134
|
|
233
|
135 =head2 C<AuthUser($name,$package,$challenge)>
|
|
|
136
|
|
|
137 Инициирует создание новой сессии используя провайдера безопасности текущего
|
|
|
138 контекста безопасности.
|
|
|
139
|
|
|
140 =over
|
|
|
141
|
|
|
142 =item C<$name>
|
|
|
143
|
|
|
144 Имя пользователя, которое будет использоваться при поиске его в БД.
|
|
|
145
|
|
|
146 =item C<$package>
|
|
|
147
|
|
|
148 Имя модуля аутентификации, например, C<IMPL::Security::Auth::Simple>.
|
|
|
149
|
|
|
150 =item C<$challenge>
|
|
|
151
|
|
|
152 Данные, полученные от клиента, которые будут переданы модулю аутентификации для
|
|
|
153 начала процесса аутентификации и создания сессии.
|
|
|
154
|
|
|
155 =back
|
|
|
156
|
|
|
157 Функция возвращает хеш с элементами
|
|
|
158
|
|
|
159 =over
|
|
|
160
|
|
|
161 =item C<status>
|
|
|
162
|
|
|
163 Статус аутентификации - отражает общее состояние процесса ацтентификации,
|
|
|
164
|
|
|
165 =over
|
|
|
166
|
|
|
167 =item C<AUTH_FAIL>
|
|
|
168
|
|
|
169 Аутентификация неудачная, сессия не создана.
|
|
|
170
|
|
|
171 =item C<AUTH_INCOMPLETE>
|
|
|
172
|
|
|
173 Аутентификация требует дополнительных шагов, сессия создана, но еще не доверена.
|
|
|
174
|
|
|
175 =item C<AUTH_SUCCESS>
|
|
|
176
|
|
|
177 Аутентификация успешно проведена, сессия создана.
|
|
|
178
|
|
|
179 =back
|
|
|
180
|
|
|
181 =item C<code>
|
|
|
182
|
|
|
183 =back
|
|
|
184
|
|
180
|
185 =cut
|
