Rev 1298 | Rev 1301 | Go to most recent revision | Only display areas with differences | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 1298 | Rev 1300 | ||
---|---|---|---|
1 | <?php |
1 | <?php |
2 | 2 | ||
3 | /* |
3 | /* |
4 | * OIDplus 2.0 |
4 | * OIDplus 2.0 |
5 | * Copyright 2019 - 2023 Daniel Marschall, ViaThinkSoft |
5 | * Copyright 2019 - 2023 Daniel Marschall, ViaThinkSoft |
6 | * |
6 | * |
7 | * Licensed under the Apache License, Version 2.0 (the "License"); |
7 | * Licensed under the Apache License, Version 2.0 (the "License"); |
8 | * you may not use this file except in compliance with the License. |
8 | * you may not use this file except in compliance with the License. |
9 | * You may obtain a copy of the License at |
9 | * You may obtain a copy of the License at |
10 | * |
10 | * |
11 | * http://www.apache.org/licenses/LICENSE-2.0 |
11 | * http://www.apache.org/licenses/LICENSE-2.0 |
12 | * |
12 | * |
13 | * Unless required by applicable law or agreed to in writing, software |
13 | * Unless required by applicable law or agreed to in writing, software |
14 | * distributed under the License is distributed on an "AS IS" BASIS, |
14 | * distributed under the License is distributed on an "AS IS" BASIS, |
15 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
15 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
16 | * See the License for the specific language governing permissions and |
16 | * See the License for the specific language governing permissions and |
17 | * limitations under the License. |
17 | * limitations under the License. |
18 | */ |
18 | */ |
19 | 19 | ||
20 | namespace ViaThinkSoft\OIDplus; |
20 | namespace ViaThinkSoft\OIDplus; |
21 | 21 | ||
22 | // phpcs:disable PSR1.Files.SideEffects |
22 | // phpcs:disable PSR1.Files.SideEffects |
23 | \defined('INSIDE_OIDPLUS') or die; |
23 | \defined('INSIDE_OIDPLUS') or die; |
24 | // phpcs:enable PSR1.Files.SideEffects |
24 | // phpcs:enable PSR1.Files.SideEffects |
25 | 25 | ||
26 | class OIDplusAuthContentStoreJWT extends OIDplusAuthContentStoreDummy { |
26 | class OIDplusAuthContentStoreJWT extends OIDplusAuthContentStoreDummy { |
27 | 27 | ||
28 | /** |
28 | /** |
29 | * Cookie name for the JWT auth token |
29 | * Cookie name for the JWT auth token |
30 | */ |
30 | */ |
31 | const COOKIE_NAME = 'OIDPLUS_AUTH_JWT'; |
31 | const COOKIE_NAME = 'OIDPLUS_AUTH_JWT'; |
32 | 32 | ||
33 | /** |
33 | /** |
34 | * "Automated AJAX" plugin |
34 | * "Automated AJAX" plugin |
35 | */ |
35 | */ |
36 | const JWT_GENERATOR_AJAX = 10; |
36 | const JWT_GENERATOR_AJAX = 10; |
37 | /** |
37 | /** |
38 | * "REST API" plugin |
38 | * "REST API" plugin |
39 | */ |
39 | */ |
40 | const JWT_GENERATOR_REST = 20; |
40 | const JWT_GENERATOR_REST = 20; |
41 | /** |
41 | /** |
42 | * "Remember me" login method |
42 | * "Remember me" login method |
43 | */ |
43 | */ |
44 | const JWT_GENERATOR_LOGIN = 40; |
44 | const JWT_GENERATOR_LOGIN = 40; |
45 | /** |
45 | /** |
46 | * "Manually crafted" JWT tokens |
46 | * "Manually crafted" JWT tokens |
47 | */ |
47 | */ |
48 | const JWT_GENERATOR_MANUAL = 80; |
48 | const JWT_GENERATOR_MANUAL = 80; |
49 | 49 | ||
50 | /** |
50 | /** |
51 | * @param int $gen OIDplusAuthContentStoreJWT::JWT_GENERATOR_... |
51 | * @param int $gen OIDplusAuthContentStoreJWT::JWT_GENERATOR_... |
52 | * @param string $sub |
52 | * @param string $sub |
53 | * @return string |
53 | * @return string |
54 | */ |
54 | */ |
55 | private static function jwtGetBlacklistConfigKey(int $gen, string $sub): string { |
55 | private static function jwtGetBlacklistConfigKey(int $gen, string $sub): string { |
56 | // Note: Needs to be <= 50 characters! If $gen is 2 chars, then the config key is 49 chars long |
56 | // Note: Needs to be <= 50 characters! If $gen is 2 chars, then the config key is 49 chars long |
57 | return 'jwt_blacklist_gen('.$gen.')_sub('.trim(base64_encode(md5($sub,true)),'=').')'; |
57 | return 'jwt_blacklist_gen('.$gen.')_sub('.trim(base64_encode(md5($sub,true)),'=').')'; |
58 | } |
58 | } |
59 | 59 | ||
60 | /** |
60 | /** |
61 | * @param int $gen |
61 | * @param int $gen |
62 | */ |
62 | */ |
63 | private static function generatorName($gen) { |
63 | private static function generatorName($gen) { |
64 | // Note: The strings are not translated, because the name is used in config keys or logs |
64 | // Note: The strings are not translated, because the name is used in config keys or logs |
65 | if ($gen === self::JWT_GENERATOR_AJAX) return 'Automated AJAX calls'; |
65 | if ($gen === self::JWT_GENERATOR_AJAX) return 'Automated AJAX calls'; |
66 | if ($gen === self::JWT_GENERATOR_REST) return 'REST API'; |
66 | if ($gen === self::JWT_GENERATOR_REST) return 'REST API'; |
67 | if ($gen === self::JWT_GENERATOR_LOGIN) return 'Login ("Remember me")'; |
67 | if ($gen === self::JWT_GENERATOR_LOGIN) return 'Login ("Remember me")'; |
68 | if ($gen === self::JWT_GENERATOR_MANUAL) return 'Manually created'; |
68 | if ($gen === self::JWT_GENERATOR_MANUAL) return 'Manually created'; |
69 | return 'Unknown generator'; |
69 | return 'Unknown generator'; |
70 | } |
70 | } |
71 | 71 | ||
72 | /** |
72 | /** |
73 | * @param int $gen OIDplusAuthContentStoreJWT::JWT_GENERATOR_... |
73 | * @param int $gen OIDplusAuthContentStoreJWT::JWT_GENERATOR_... |
74 | * @param string $sub |
74 | * @param string $sub |
75 | * @return void |
75 | * @return void |
76 | * @throws OIDplusException |
76 | * @throws OIDplusException |
77 | */ |
77 | */ |
78 | public static function jwtBlacklist(int $gen, string $sub) { |
78 | public static function jwtBlacklist(int $gen, string $sub) { |
79 | $cfg = self::jwtGetBlacklistConfigKey($gen, $sub); |
79 | $cfg = self::jwtGetBlacklistConfigKey($gen, $sub); |
80 | $bl_time = time()-1; |
80 | $bl_time = time()-1; |
81 | 81 | ||
82 | $gen_desc = self::generatorName($gen); |
82 | $gen_desc = self::generatorName($gen); |
83 | 83 | ||
84 | OIDplus::config()->prepareConfigKey($cfg, 'Revoke timestamp of all JWT tokens for $sub with generator $gen ($gen_desc)', "$bl_time", OIDplusConfig::PROTECTION_HIDDEN, function($value) {}); |
84 | OIDplus::config()->prepareConfigKey($cfg, 'Revoke timestamp of all JWT tokens for $sub with generator $gen ($gen_desc)', "$bl_time", OIDplusConfig::PROTECTION_HIDDEN, function($value) {}); |
85 | OIDplus::config()->setValue($cfg, $bl_time); |
85 | OIDplus::config()->setValue($cfg, $bl_time); |
86 | } |
86 | } |
87 | 87 | ||
88 | /** |
88 | /** |
89 | * @param int $gen OIDplusAuthContentStoreJWT::JWT_GENERATOR_... |
89 | * @param int $gen OIDplusAuthContentStoreJWT::JWT_GENERATOR_... |
90 | * @param string $sub |
90 | * @param string $sub |
91 | * @return int |
91 | * @return int |
92 | * @throws OIDplusException |
92 | * @throws OIDplusException |
93 | */ |
93 | */ |
94 | public static function jwtGetBlacklistTime(int $gen, string $sub): int { |
94 | public static function jwtGetBlacklistTime(int $gen, string $sub): int { |
95 | $cfg = self::jwtGetBlacklistConfigKey($gen, $sub); |
95 | $cfg = self::jwtGetBlacklistConfigKey($gen, $sub); |
96 | return (int)OIDplus::config()->getValue($cfg,0); |
96 | return (int)OIDplus::config()->getValue($cfg,0); |
97 | } |
97 | } |
98 | 98 | ||
99 | /** |
99 | /** |
100 | * We include a hash of the server-secret here (ssh = server-secret-hash), so that the JWT can be invalidated by changing the server-secret |
100 | * We include a hash of the server-secret here (ssh = server-secret-hash), so that the JWT can be invalidated by changing the server-secret |
101 | * @return string |
101 | * @return string |
102 | * @throws OIDplusException |
102 | * @throws OIDplusException |
103 | */ |
103 | */ |
104 | private static function getSsh(): string { |
104 | private static function getSsh(): string { |
105 | return OIDplus::authUtils()->makeSecret(['bb1aebd6-fe6a-11ed-a553-3c4a92df8582']); |
105 | return OIDplus::authUtils()->makeSecret(['bb1aebd6-fe6a-11ed-a553-3c4a92df8582']); |
106 | } |
106 | } |
107 | 107 | ||
108 | /** |
108 | /** |
109 | * Do various checks if the token is allowed and not blacklisted |
109 | * Do various checks if the token is allowed and not blacklisted |
110 | * @param OIDplusAuthContentStore $contentProvider |
110 | * @param OIDplusAuthContentStore $contentProvider |
111 | * @param int|null $validGenerators Bitmask which generators to allow (null = allow all) |
111 | * @param int|null $validGenerators Bitmask which generators to allow (null = allow all) |
112 | * @return void |
112 | * @return void |
113 | * @throws OIDplusException |
113 | * @throws OIDplusException |
114 | */ |
114 | */ |
115 | private static function jwtSecurityCheck(OIDplusAuthContentStore $contentProvider, int $validGenerators=null) { |
115 | private static function jwtSecurityCheck(OIDplusAuthContentStore $contentProvider, int $validGenerators=null) { |
116 | // Check if the token is intended for us |
116 | // Check if the token is intended for us |
117 | if ($contentProvider->getValue('aud','') !== OIDplus::getEditionInfo()['jwtaud']) { |
117 | if ($contentProvider->getValue('aud','') !== OIDplus::getEditionInfo()['jwtaud']) { |
118 | throw new OIDplusException(_L('Token has wrong audience')); |
118 | throw new OIDplusException(_L('Token has wrong audience')); |
119 | } |
119 | } |
120 | 120 | ||
121 | if ($contentProvider->getValue('oidplus_ssh', '') !== self::getSsh()) { |
121 | if ($contentProvider->getValue('oidplus_ssh', '') !== self::getSsh()) { |
122 | throw new OIDplusException(_L('"Server Secret" was changed; therefore the JWT is not valid anymore')); |
122 | throw new OIDplusException(_L('"Server Secret" was changed; therefore the JWT is not valid anymore')); |
123 | } |
123 | } |
124 | 124 | ||
125 | $gen = $contentProvider->getValue('oidplus_generator', -1); |
125 | $gen = $contentProvider->getValue('oidplus_generator', -1); |
126 | 126 | ||
127 | $has_admin = $contentProvider->isAdminLoggedIn(); |
127 | $has_admin = $contentProvider->isAdminLoggedIn(); |
128 | $has_ra = $contentProvider->raNumLoggedIn() > 0; |
128 | $has_ra = $contentProvider->raNumLoggedIn() > 0; |
129 | 129 | ||
130 | // Check if the token generator is allowed |
130 | // Check if the token generator is allowed |
131 | if ($gen === self::JWT_GENERATOR_AJAX) { |
131 | if ($gen === self::JWT_GENERATOR_AJAX) { |
132 | if (($has_admin) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_AJAX_ADMIN', true)) { |
132 | if (($has_admin) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_AJAX_ADMIN', true)) { |
133 | // Generator: plugins/viathinksoft/adminPages/910_automated_ajax_calls/OIDplusPageAdminAutomatedAJAXCalls.class.php |
133 | // Generator: plugins/viathinksoft/adminPages/910_automated_ajax_calls/OIDplusPageAdminAutomatedAJAXCalls.class.php |
134 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_AJAX_ADMIN')); |
134 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_AJAX_ADMIN')); |
135 | } |
135 | } |
136 | if (($has_ra) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_AJAX_USER', true)) { |
136 | if (($has_ra) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_AJAX_USER', true)) { |
137 | // Generator: plugins/viathinksoft/raPages/910_automated_ajax_calls/OIDplusPageRaAutomatedAJAXCalls.class.php |
137 | // Generator: plugins/viathinksoft/raPages/910_automated_ajax_calls/OIDplusPageRaAutomatedAJAXCalls.class.php |
138 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_AJAX_USER')); |
138 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_AJAX_USER')); |
139 | } |
139 | } |
140 | } |
140 | } |
141 | else if ($gen === self::JWT_GENERATOR_REST) { |
141 | else if ($gen === self::JWT_GENERATOR_REST) { |
142 | if (($has_admin) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_REST_ADMIN', true)) { |
142 | if (($has_admin) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_REST_ADMIN', true)) { |
143 | // Generator: plugins/viathinksoft/adminPages/911_rest_api/OIDplusPageAdminRestApi.class.php |
143 | // Generator: plugins/viathinksoft/adminPages/911_rest_api/OIDplusPageAdminRestApi.class.php |
144 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_REST_ADMIN')); |
144 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_REST_ADMIN')); |
145 | } |
145 | } |
146 | if (($has_ra) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_REST_USER', true)) { |
146 | if (($has_ra) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_REST_USER', true)) { |
147 | // Generator: plugins/viathinksoft/raPages/911_rest_api/OIDplusPageRaRestApi.class.php |
147 | // Generator: plugins/viathinksoft/raPages/911_rest_api/OIDplusPageRaRestApi.class.php |
148 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_REST_USER')); |
148 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_REST_USER')); |
149 | } |
149 | } |
150 | } |
150 | } |
151 | else if ($gen === self::JWT_GENERATOR_LOGIN) { |
151 | else if ($gen === self::JWT_GENERATOR_LOGIN) { |
152 | // Used for feature "Remember me" (use JWT token in a cookie as alternative to PHP session): |
152 | // Used for feature "Remember me" (use JWT token in a cookie as alternative to PHP session): |
153 | // - No PHP session will be used |
153 | // - No PHP session will be used |
154 | // - Session will not be bound to IP address (therefore, you can switch between mobile/WiFi for example) |
154 | // - Session will not be bound to IP address (therefore, you can switch between mobile/WiFi for example) |
155 | // - No server-side session needed |
155 | // - No server-side session needed |
156 | if (($has_admin) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_LOGIN_ADMIN', true)) { |
156 | if (($has_admin) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_LOGIN_ADMIN', true)) { |
157 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_LOGIN_ADMIN')); |
157 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_LOGIN_ADMIN')); |
158 | } |
158 | } |
159 | if (($has_ra) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_LOGIN_USER', true)) { |
159 | if (($has_ra) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_LOGIN_USER', true)) { |
160 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_LOGIN_USER')); |
160 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_LOGIN_USER')); |
161 | } |
161 | } |
162 | } |
162 | } |
163 | else if ($gen === self::JWT_GENERATOR_MANUAL) { |
163 | else if ($gen === self::JWT_GENERATOR_MANUAL) { |
164 | // Generator 2 are "hand-crafted" tokens |
164 | // Generator: "hand-crafted" tokens |
- | 165 | if (($has_admin) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_MANUAL_ADMIN', false)) { |
|
- | 166 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_MANUAL_ADMIN')); |
|
- | 167 | } |
|
165 | if (!OIDplus::baseConfig()->getValue('JWT_ALLOW_MANUAL', false)) { |
168 | if (($has_ra) && !OIDplus::baseConfig()->getValue('JWT_ALLOW_MANUAL_USER', false)) { |
166 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_MANUAL')); |
169 | throw new OIDplusException(_L('The administrator has disabled this feature. (Base configuration setting %1).','JWT_ALLOW_MANUAL_USER')); |
167 | } |
170 | } |
168 | } else { |
171 | } else { |
169 | throw new OIDplusException(_L('Token generator %1 not recognized',$gen)); |
172 | throw new OIDplusException(_L('Token generator %1 not recognized',$gen)); |
170 | } |
173 | } |
171 | 174 | ||
172 | // Make sure that the IAT (issued at time) isn't in a blacklisted timeframe |
175 | // Make sure that the IAT (issued at time) isn't in a blacklisted timeframe |
173 | // When an user believes that a token was compromised, then they can blacklist the tokens identified by their "iat" ("Issued at") property |
176 | // When an user believes that a token was compromised, then they can blacklist the tokens identified by their "iat" ("Issued at") property |
174 | // When a user logs out of a "remember me" session, the JWT token will be blacklisted as well |
177 | // When a user logs out of a "remember me" session, the JWT token will be blacklisted as well |
175 | // Small side effect: All "remember me" sessions of that user will be revoked then |
178 | // Small side effect: All "remember me" sessions of that user will be revoked then |
176 | $iat = $contentProvider->getValue('iat',0); |
179 | $iat = $contentProvider->getValue('iat',0); |
177 | if (($iat-120/*leeway 2min*/) > time()) { |
180 | if (($iat-120/*leeway 2min*/) > time()) { |
178 | // Token was created in the future. Something is wrong! |
181 | // Token was created in the future. Something is wrong! |
179 | throw new OIDplusException(_L('JWT Token cannot be verified because the server time is wrong')); |
182 | throw new OIDplusException(_L('JWT Token cannot be verified because the server time is wrong')); |
180 | } |
183 | } |
181 | $sublist = $contentProvider->loggedInRaList(); |
184 | $sublist = $contentProvider->loggedInRaList(); |
182 | $usernames = array(); |
185 | $usernames = array(); |
183 | foreach ($sublist as $sub) { |
186 | foreach ($sublist as $sub) { |
184 | $usernames[] = $sub->raEmail(); |
187 | $usernames[] = $sub->raEmail(); |
185 | } |
188 | } |
186 | if ($has_admin) $usernames[] = 'admin'; |
189 | if ($has_admin) $usernames[] = 'admin'; |
187 | foreach ($usernames as $username) { |
190 | foreach ($usernames as $username) { |
188 | $bl_time = self::jwtGetBlacklistTime($gen, $username); |
191 | $bl_time = self::jwtGetBlacklistTime($gen, $username); |
189 | if ($iat <= $bl_time) { |
192 | if ($iat <= $bl_time) { |
190 | // Token is blacklisted (it was created before the last blacklist time) |
193 | // Token is blacklisted (it was created before the last blacklist time) |
191 | throw new OIDplusException(_L('The JWT token was blacklisted on %1. Please generate a new one',date('d F Y, H:i:s',$bl_time))); |
194 | throw new OIDplusException(_L('The JWT token was blacklisted on %1. Please generate a new one',date('d F Y, H:i:s',$bl_time))); |
192 | } |
195 | } |
193 | } |
196 | } |
194 | 197 | ||
195 | // Optional feature: Limit the JWT to a specific IP address |
198 | // Optional feature: Limit the JWT to a specific IP address |
196 | // Currently not used in OIDplus |
199 | // Currently not used in OIDplus |
197 | $ip = $contentProvider->getValue('ip',''); |
200 | $ip = $contentProvider->getValue('oidplus_limit_ip',''); |
198 | if ($ip !== '') { |
201 | if ($ip !== '') { |
199 | if (isset($_SERVER['REMOTE_ADDR']) && ($ip !== $_SERVER['REMOTE_ADDR'])) { |
202 | if (isset($_SERVER['REMOTE_ADDR']) && ($ip !== $_SERVER['REMOTE_ADDR'])) { |
200 | throw new OIDplusException(_L('Your IP address is not allowed to use this token')); |
203 | throw new OIDplusException(_L('Your IP address is not allowed to use this token')); |
201 | } |
204 | } |
202 | } |
205 | } |
203 | 206 | ||
204 | // Checks if JWT are dependent on the generator |
207 | // Checks if JWT are dependent on the generator |
205 | if (!is_null($validGenerators)) { |
208 | if (!is_null($validGenerators)) { |
206 | if (($gen & $validGenerators) === 0) { |
209 | if (($gen & $validGenerators) === 0) { |
207 | throw new OIDplusException(_L('This kind of JWT token (%1) cannot be used in this request type', self::generatorName($gen))); |
210 | throw new OIDplusException(_L('This kind of JWT token (%1) cannot be used in this request type', self::generatorName($gen))); |
208 | } |
211 | } |
209 | } |
212 | } |
210 | } |
213 | } |
211 | 214 | ||
212 | // Override abstract functions |
215 | // Override abstract functions |
213 | 216 | ||
214 | /** |
217 | /** |
215 | * @return void |
218 | * @return void |
216 | */ |
219 | */ |
217 | public function activate() { |
220 | public function activate() { |
218 | // Send cookie at the end of the HTTP request, in case there are multiple activate() calls |
221 | // Send cookie at the end of the HTTP request, in case there are multiple activate() calls |
219 | OIDplus::register_shutdown_function(array($this,'activateNow')); |
222 | OIDplus::register_shutdown_function(array($this,'activateNow')); |
220 | } |
223 | } |
221 | 224 | ||
222 | /** |
225 | /** |
223 | * @return void |
226 | * @return void |
224 | * @throws OIDplusException |
227 | * @throws OIDplusException |
225 | */ |
228 | */ |
226 | public function activateNow() { |
229 | public function activateNow() { |
227 | $token = $this->getJWTToken(); |
230 | $token = $this->getJWTToken(); |
228 | $exp = $this->getValue('exp',0); |
231 | $exp = $this->getValue('exp',0); |
229 | OIDplus::cookieUtils()->setcookie(self::COOKIE_NAME, $token, $exp, false); |
232 | OIDplus::cookieUtils()->setcookie(self::COOKIE_NAME, $token, $exp, false); |
230 | } |
233 | } |
231 | 234 | ||
232 | /** |
235 | /** |
233 | * @return void |
236 | * @return void |
234 | * @throws OIDplusException |
237 | * @throws OIDplusException |
235 | */ |
238 | */ |
236 | public function destroySession() { |
239 | public function destroySession() { |
237 | OIDplus::cookieUtils()->unsetcookie(self::COOKIE_NAME); |
240 | OIDplus::cookieUtils()->unsetcookie(self::COOKIE_NAME); |
238 | } |
241 | } |
239 | 242 | ||
240 | /** |
243 | /** |
241 | * @param string $email |
244 | * @param string $email |
242 | * @return void |
245 | * @return void |
243 | * @throws OIDplusException |
246 | * @throws OIDplusException |
244 | */ |
247 | */ |
245 | public function raLogout(string $email) { |
248 | public function raLogout(string $email) { |
246 | $gen = $this->getValue('oidplus_generator', -1); |
249 | $gen = $this->getValue('oidplus_generator', -1); |
247 | if ($gen >= 0) self::jwtBlacklist($gen, $email); |
250 | if ($gen >= 0) self::jwtBlacklist($gen, $email); |
248 | parent::raLogout($email); |
251 | parent::raLogout($email); |
249 | } |
252 | } |
250 | 253 | ||
251 | /** |
254 | /** |
252 | * @param string $email |
255 | * @param string $email |
253 | * @param string $loginfo |
256 | * @param string $loginfo |
254 | * @return void |
257 | * @return void |
255 | * @throws OIDplusException |
258 | * @throws OIDplusException |
256 | */ |
259 | */ |
257 | public function raLogoutEx(string $email, string &$loginfo) { |
260 | public function raLogoutEx(string $email, string &$loginfo) { |
258 | $this->raLogout($email); |
261 | $this->raLogout($email); |
259 | $loginfo = 'from JWT session'; |
262 | $loginfo = 'from JWT session'; |
260 | } |
263 | } |
261 | 264 | ||
262 | /** |
265 | /** |
263 | * @return void |
266 | * @return void |
264 | * @throws OIDplusException |
267 | * @throws OIDplusException |
265 | */ |
268 | */ |
266 | public function adminLogout() { |
269 | public function adminLogout() { |
267 | $gen = $this->getValue('oidplus_generator', -1); |
270 | $gen = $this->getValue('oidplus_generator', -1); |
268 | if ($gen >= 0) self::jwtBlacklist($gen, 'admin'); |
271 | if ($gen >= 0) self::jwtBlacklist($gen, 'admin'); |
269 | parent::adminLogout(); |
272 | parent::adminLogout(); |
270 | } |
273 | } |
271 | 274 | ||
272 | /** |
275 | /** |
273 | * @param string $loginfo |
276 | * @param string $loginfo |
274 | * @return void |
277 | * @return void |
275 | * @throws OIDplusException |
278 | * @throws OIDplusException |
276 | */ |
279 | */ |
277 | public function adminLogoutEx(string &$loginfo) { |
280 | public function adminLogoutEx(string &$loginfo) { |
278 | $this->adminLogout(); |
281 | $this->adminLogout(); |
279 | $loginfo = 'from JWT session'; |
282 | $loginfo = 'from JWT session'; |
280 | } |
283 | } |
281 | 284 | ||
282 | private static $contentProvider = null; |
285 | private static $contentProvider = null; |
283 | 286 | ||
284 | /** |
287 | /** |
285 | * @return OIDplusAuthContentStore|null |
288 | * @return OIDplusAuthContentStore|null |
286 | * @throws OIDplusException |
289 | * @throws OIDplusException |
287 | */ |
290 | */ |
288 | public static function getActiveProvider()/*: ?OIDplusAuthContentStore*/ { |
291 | public static function getActiveProvider()/*: ?OIDplusAuthContentStore*/ { |
289 | if (!self::$contentProvider) { |
292 | if (!self::$contentProvider) { |
290 | 293 | ||
291 | $tmp = null; |
294 | $tmp = null; |
292 | $silent_error = false; |
295 | $silent_error = false; |
293 | 296 | ||
294 | try { |
297 | try { |
295 | 298 | ||
296 | $rel_url = substr($_SERVER['REQUEST_URI'], strlen(OIDplus::webpath(null, OIDplus::PATH_RELATIVE_TO_ROOT))); |
299 | $rel_url = substr($_SERVER['REQUEST_URI'], strlen(OIDplus::webpath(null, OIDplus::PATH_RELATIVE_TO_ROOT))); |
297 | if (str_starts_with($rel_url, 'rest/')) { // <== TODO: Find a way how to move this into the plugin, since REST does not belong to the core. |
300 | if (str_starts_with($rel_url, 'rest/')) { // <== TODO: Find a way how to move this into the plugin, since REST does not belong to the core. |
298 | 301 | ||
299 | // REST may only use Bearer Authentication |
302 | // REST may only use Bearer Authentication |
300 | $bearer = getBearerToken(); |
303 | $bearer = getBearerToken(); |
301 | if (!is_null($bearer)) { |
304 | if (!is_null($bearer)) { |
302 | $silent_error = false; |
305 | $silent_error = false; |
303 | $tmp = new OIDplusAuthContentStoreJWT(); |
306 | $tmp = new OIDplusAuthContentStoreJWT(); |
304 | $tmp->loadJWT($bearer); |
307 | $tmp->loadJWT($bearer); |
305 | self::jwtSecurityCheck($tmp, self::JWT_GENERATOR_REST | self::JWT_GENERATOR_MANUAL); |
308 | self::jwtSecurityCheck($tmp, self::JWT_GENERATOR_REST | self::JWT_GENERATOR_MANUAL); |
306 | } |
309 | } |
307 | 310 | ||
308 | } else { |
311 | } else { |
309 | 312 | ||
310 | // A web-visitor (HTML and AJAX, but not REST) can use a JWT "remember me" Cookie |
313 | // A web-visitor (HTML and AJAX, but not REST) can use a JWT "remember me" Cookie |
311 | if (isset($_COOKIE[self::COOKIE_NAME])) { |
314 | if (isset($_COOKIE[self::COOKIE_NAME])) { |
312 | $silent_error = true; |
315 | $silent_error = true; |
313 | $tmp = new OIDplusAuthContentStoreJWT(); |
316 | $tmp = new OIDplusAuthContentStoreJWT(); |
314 | $tmp->loadJWT($_COOKIE[self::COOKIE_NAME]); |
317 | $tmp->loadJWT($_COOKIE[self::COOKIE_NAME]); |
315 | self::jwtSecurityCheck($tmp, self::JWT_GENERATOR_LOGIN | self::JWT_GENERATOR_MANUAL); |
318 | self::jwtSecurityCheck($tmp, self::JWT_GENERATOR_LOGIN | self::JWT_GENERATOR_MANUAL); |
316 | } |
319 | } |
317 | 320 | ||
318 | // AJAX may additionally use GET/POST automated AJAX (in addition to the normal JWT "remember me" Cookie) |
321 | // AJAX may additionally use GET/POST automated AJAX (in addition to the normal JWT "remember me" Cookie) |
319 | if (isset($_SERVER['SCRIPT_FILENAME']) && (strtolower(basename($_SERVER['SCRIPT_FILENAME'])) !== 'ajax.php')) { |
322 | if (isset($_SERVER['SCRIPT_FILENAME']) && (strtolower(basename($_SERVER['SCRIPT_FILENAME'])) !== 'ajax.php')) { |
320 | if (isset($_POST[self::COOKIE_NAME])) { |
323 | if (isset($_POST[self::COOKIE_NAME])) { |
321 | $silent_error = false; |
324 | $silent_error = false; |
322 | $tmp = new OIDplusAuthContentStoreJWT(); |
325 | $tmp = new OIDplusAuthContentStoreJWT(); |
323 | $tmp->loadJWT($_POST[self::COOKIE_NAME]); |
326 | $tmp->loadJWT($_POST[self::COOKIE_NAME]); |
324 | self::jwtSecurityCheck($tmp, self::JWT_GENERATOR_AJAX | self::JWT_GENERATOR_MANUAL); |
327 | self::jwtSecurityCheck($tmp, self::JWT_GENERATOR_AJAX | self::JWT_GENERATOR_MANUAL); |
325 | } |
328 | } |
326 | if (isset($_GET[self::COOKIE_NAME])) { |
329 | if (isset($_GET[self::COOKIE_NAME])) { |
327 | $silent_error = false; |
330 | $silent_error = false; |
328 | $tmp = new OIDplusAuthContentStoreJWT(); |
331 | $tmp = new OIDplusAuthContentStoreJWT(); |
329 | $tmp->loadJWT($_GET[self::COOKIE_NAME]); |
332 | $tmp->loadJWT($_GET[self::COOKIE_NAME]); |
330 | self::jwtSecurityCheck($tmp, self::JWT_GENERATOR_AJAX | self::JWT_GENERATOR_MANUAL); |
333 | self::jwtSecurityCheck($tmp, self::JWT_GENERATOR_AJAX | self::JWT_GENERATOR_MANUAL); |
331 | } |
334 | } |
332 | } |
335 | } |
333 | 336 | ||
334 | } |
337 | } |
335 | 338 | ||
336 | } catch (\Exception $e) { |
339 | } catch (\Exception $e) { |
337 | if (!$silent_error) { |
340 | if (!$silent_error) { |
338 | // Most likely an AJAX request. We can throw an Exception |
341 | // Most likely an AJAX request. We can throw an Exception |
339 | throw new OIDplusException(_L('The JWT token was rejected: %1',$e->getMessage())); |
342 | throw new OIDplusException(_L('The JWT token was rejected: %1',$e->getMessage())); |
340 | } else { |
343 | } else { |
341 | // Most likely an expired Cookie/Login session. We must not throw an Exception, otherwise we will break jsTree |
344 | // Most likely an expired Cookie/Login session. We must not throw an Exception, otherwise we will break jsTree |
342 | OIDplus::cookieUtils()->unsetcookie(self::COOKIE_NAME); |
345 | OIDplus::cookieUtils()->unsetcookie(self::COOKIE_NAME); |
343 | return null; |
346 | return null; |
344 | } |
347 | } |
345 | } |
348 | } |
346 | 349 | ||
347 | self::$contentProvider = $tmp; |
350 | self::$contentProvider = $tmp; |
348 | } |
351 | } |
349 | 352 | ||
350 | return self::$contentProvider; |
353 | return self::$contentProvider; |
351 | } |
354 | } |
352 | 355 | ||
353 | /** |
356 | /** |
354 | * @param string $email |
357 | * @param string $email |
355 | * @param string $loginfo |
358 | * @param string $loginfo |
356 | * @return void |
359 | * @return void |
357 | * @throws OIDplusException |
360 | * @throws OIDplusException |
358 | */ |
361 | */ |
359 | public function raLoginEx(string $email, string &$loginfo) { |
362 | public function raLoginEx(string $email, string &$loginfo) { |
360 | if (is_null(self::getActiveProvider())) { |
363 | if (is_null(self::getActiveProvider())) { |
361 | $this->raLogin($email); |
364 | $this->raLogin($email); |
362 | $loginfo = 'into new JWT session'; |
365 | $loginfo = 'into new JWT session'; |
363 | self::$contentProvider = $this; |
366 | self::$contentProvider = $this; |
364 | } else { |
367 | } else { |
365 | $gen = $this->getValue('oidplus_generator',-1); |
368 | $gen = $this->getValue('oidplus_generator',-1); |
366 | switch ($gen) { |
369 | switch ($gen) { |
367 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_AJAX : |
370 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_AJAX : |
368 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_REST : |
371 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_REST : |
369 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_MANUAL : |
372 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_MANUAL : |
370 | throw new OIDplusException(_L('This kind of JWT token cannot be altered. Therefore you cannot do this action.')); |
373 | throw new OIDplusException(_L('This kind of JWT token cannot be altered. Therefore you cannot do this action.')); |
371 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_LOGIN : |
374 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_LOGIN : |
372 | if (!OIDplus::baseConfig()->getValue('JWT_ALLOW_LOGIN_USER', true)) { |
375 | if (!OIDplus::baseConfig()->getValue('JWT_ALLOW_LOGIN_USER', true)) { |
373 | throw new OIDplusException(_L('You cannot add this login credential to your existing "remember me" session. You need to log-out first.')); |
376 | throw new OIDplusException(_L('You cannot add this login credential to your existing "remember me" session. You need to log-out first.')); |
374 | } |
377 | } |
375 | break; |
378 | break; |
376 | default: |
379 | default: |
377 | assert(false); // This cannot happen because jwtSecurityCheck will check for unknown generators |
380 | assert(false); // This cannot happen because jwtSecurityCheck will check for unknown generators |
378 | break; |
381 | break; |
379 | } |
382 | } |
380 | $this->raLogin($email); |
383 | $this->raLogin($email); |
381 | $loginfo = 'into existing JWT session'; |
384 | $loginfo = 'into existing JWT session'; |
382 | } |
385 | } |
383 | } |
386 | } |
384 | 387 | ||
385 | /** |
388 | /** |
386 | * @param string $loginfo |
389 | * @param string $loginfo |
387 | * @return void |
390 | * @return void |
388 | * @throws OIDplusException |
391 | * @throws OIDplusException |
389 | */ |
392 | */ |
390 | public function adminLoginEx(string &$loginfo) { |
393 | public function adminLoginEx(string &$loginfo) { |
391 | if (is_null(self::getActiveProvider())) { |
394 | if (is_null(self::getActiveProvider())) { |
392 | $this->adminLogin(); |
395 | $this->adminLogin(); |
393 | $loginfo = 'into new JWT session'; |
396 | $loginfo = 'into new JWT session'; |
394 | self::$contentProvider = $this; |
397 | self::$contentProvider = $this; |
395 | } else { |
398 | } else { |
396 | $gen = $this->getValue('oidplus_generator',-1); |
399 | $gen = $this->getValue('oidplus_generator',-1); |
397 | switch ($gen) { |
400 | switch ($gen) { |
398 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_AJAX : |
401 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_AJAX : |
399 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_REST : |
402 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_REST : |
400 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_MANUAL : |
403 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_MANUAL : |
401 | throw new OIDplusException(_L('This kind of JWT token cannot be altered. Therefore you cannot do this action.')); |
404 | throw new OIDplusException(_L('This kind of JWT token cannot be altered. Therefore you cannot do this action.')); |
402 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_LOGIN : |
405 | case OIDplusAuthContentStoreJWT::JWT_GENERATOR_LOGIN : |
403 | if (!OIDplus::baseConfig()->getValue('JWT_ALLOW_LOGIN_ADMIN', true)) { |
406 | if (!OIDplus::baseConfig()->getValue('JWT_ALLOW_LOGIN_ADMIN', true)) { |
404 | throw new OIDplusException(_L('You cannot add this login credential to your existing "remember me" session. You need to log-out first.')); |
407 | throw new OIDplusException(_L('You cannot add this login credential to your existing "remember me" session. You need to log-out first.')); |
405 | } |
408 | } |
406 | break; |
409 | break; |
407 | default: |
410 | default: |
408 | assert(false); // This cannot happen because jwtSecurityCheck will check for unknown generators |
411 | assert(false); // This cannot happen because jwtSecurityCheck will check for unknown generators |
409 | break; |
412 | break; |
410 | } |
413 | } |
411 | $this->adminLogin(); |
414 | $this->adminLogin(); |
412 | $loginfo = 'into existing JWT session'; |
415 | $loginfo = 'into existing JWT session'; |
413 | } |
416 | } |
414 | } |
417 | } |
415 | 418 | ||
416 | // Individual functions |
419 | // Individual functions |
417 | 420 | ||
418 | /** |
421 | /** |
419 | * Decode the JWT. In this step, the signature as well as EXP/NBF times will be checked |
422 | * Decode the JWT. In this step, the signature as well as EXP/NBF times will be checked |
420 | * @param string $jwt |
423 | * @param string $jwt |
421 | * @return void |
424 | * @return void |
422 | * @throws OIDplusException |
425 | * @throws OIDplusException |
423 | */ |
426 | */ |
424 | public function loadJWT(string $jwt) { |
427 | public function loadJWT(string $jwt) { |
425 | \Firebase\JWT\JWT::$leeway = 60; // leeway in seconds |
428 | \Firebase\JWT\JWT::$leeway = 60; // leeway in seconds |
426 | if (OIDplus::getPkiStatus()) { |
429 | if (OIDplus::getPkiStatus()) { |
427 | $pubKey = OIDplus::getSystemPublicKey(); |
430 | $pubKey = OIDplus::getSystemPublicKey(); |
428 | $k = new \Firebase\JWT\Key($pubKey, 'RS256'); // RSA+SHA256 is hardcoded in getPkiStatus() generation |
431 | $k = new \Firebase\JWT\Key($pubKey, 'RS256'); // RSA+SHA256 is hardcoded in getPkiStatus() generation |
429 | $this->content = (array) \Firebase\JWT\JWT::decode($jwt, $k); |
432 | $this->content = (array) \Firebase\JWT\JWT::decode($jwt, $k); |
430 | } else { |
433 | } else { |
431 | $key = OIDplus::authUtils()->makeSecret(['0be35e52-f4ef-11ed-b67e-3c4a92df8582']); |
434 | $key = OIDplus::authUtils()->makeSecret(['0be35e52-f4ef-11ed-b67e-3c4a92df8582']); |
432 | $key = hash_pbkdf2('sha512', $key, '', 10000, 32/*256bit*/, false); |
435 | $key = hash_pbkdf2('sha512', $key, '', 10000, 32/*256bit*/, false); |
433 | $k = new \Firebase\JWT\Key($key, 'HS512'); // HMAC+SHA512 is hardcoded here |
436 | $k = new \Firebase\JWT\Key($key, 'HS512'); // HMAC+SHA512 is hardcoded here |
434 | $this->content = (array) \Firebase\JWT\JWT::decode($jwt, $k); |
437 | $this->content = (array) \Firebase\JWT\JWT::decode($jwt, $k); |
435 | } |
438 | } |
436 | } |
439 | } |
437 | 440 | ||
438 | /** |
441 | /** |
439 | * @return string |
442 | * @return string |
440 | * @throws OIDplusException |
443 | * @throws OIDplusException |
441 | */ |
444 | */ |
442 | public function getJWTToken(): string { |
445 | public function getJWTToken(): string { |
443 | $payload = $this->content; |
446 | $payload = $this->content; |
- | 447 | $payload["oidplus_ssh"] = self::getSsh(); // SSH = Server Secret Hash |
|
444 | $payload["iss"] = OIDplus::getEditionInfo()['jwtaud']; |
448 | $payload["iss"] = OIDplus::getEditionInfo()['jwtaud']; |
445 | $payload["aud"] = OIDplus::getEditionInfo()['jwtaud']; |
449 | $payload["aud"] = OIDplus::getEditionInfo()['jwtaud']; |
446 | $payload["jti"] = gen_uuid(); |
450 | $payload["jti"] = gen_uuid(); |
447 | $payload["iat"] = time(); |
451 | $payload["iat"] = time(); |
448 | $payload["oidplus_ssh"] = self::getSsh(); // SSH = Server Secret Hash |
- | |
449 | 452 | ||
450 | if (OIDplus::getPkiStatus()) { |
453 | if (OIDplus::getPkiStatus()) { |
451 | $privKey = OIDplus::getSystemPrivateKey(); |
454 | $privKey = OIDplus::getSystemPrivateKey(); |
452 | return \Firebase\JWT\JWT::encode($payload, $privKey, 'RS256'); // RSA+SHA256 is hardcoded in getPkiStatus() generation |
455 | return \Firebase\JWT\JWT::encode($payload, $privKey, 'RS256'); // RSA+SHA256 is hardcoded in getPkiStatus() generation |
453 | } else { |
456 | } else { |
454 | $key = OIDplus::authUtils()->makeSecret(['0be35e52-f4ef-11ed-b67e-3c4a92df8582']); |
457 | $key = OIDplus::authUtils()->makeSecret(['0be35e52-f4ef-11ed-b67e-3c4a92df8582']); |
455 | $key = hash_pbkdf2('sha512', $key, '', 10000, 32/*256bit*/, false); |
458 | $key = hash_pbkdf2('sha512', $key, '', 10000, 32/*256bit*/, false); |
456 | return \Firebase\JWT\JWT::encode($payload, $key, 'HS512'); // HMAC+SHA512 is hardcoded here |
459 | return \Firebase\JWT\JWT::encode($payload, $key, 'HS512'); // HMAC+SHA512 is hardcoded here |
457 | } |
460 | } |
458 | } |
461 | } |
459 | 462 | ||
460 | } |
463 | } |
461 | 464 |