]> git.proxmox.com Git - pve-access-control.git/blame - src/PVE/RPCEnvironment.pm
rpcenv: skip undef propagation flag in more places
[pve-access-control.git] / src / PVE / RPCEnvironment.pm
CommitLineData
2c3a6c0a
DM
1package PVE::RPCEnvironment;
2
3use strict;
4use warnings;
c104e4ab 5
5e868938
TL
6use PVE::AccessControl;
7use PVE::Cluster;
37d45deb 8use PVE::Exception qw(raise raise_perm_exc);
2c3a6c0a 9use PVE::INotify;
2c3a6c0a 10use PVE::ProcFSTools;
5e868938
TL
11use PVE::RESTEnvironment;
12use PVE::SafeSyslog;
13use PVE::Tools;
2c3a6c0a 14
c104e4ab 15use base qw(PVE::RESTEnvironment);
2c3a6c0a 16
2c3a6c0a
DM
17# ACL cache
18
4bc17477
DM
19my $compile_acl_path = sub {
20 my ($self, $user, $path) = @_;
2c3a6c0a 21
2c3a6c0a
DM
22 my $cfg = $self->{user_cfg};
23
24 return undef if !$cfg->{roles};
25
4bc17477 26 die "internal error" if $user eq 'root@pam';
2c3a6c0a 27
4bc17477
DM
28 my $cache = $self->{aclcache};
29 $cache->{$user} = {} if !$cache->{$user};
30 my $data = $cache->{$user};
2c3a6c0a 31
e915e9e4
FG
32 my ($username, undef) = PVE::AccessControl::split_tokenid($user, 1);
33 die "internal error" if $username && $username ne 'root@pam' && !defined($cache->{$username});
34
4bc17477 35 if (!$data->{poolroles}) {
c104e4ab
DM
36 $data->{poolroles} = {};
37
39c85db8
DM
38 foreach my $pool (keys %{$cfg->{pools}}) {
39 my $d = $cfg->{pools}->{$pool};
7e8bcaa7
FG
40 my $pool_roles = PVE::AccessControl::roles($cfg, $user, "/pool/$pool"); # pool roles
41 next if !scalar(keys %$pool_roles);
4bc17477 42 foreach my $vmid (keys %{$d->{vms}}) {
7e8bcaa7 43 for my $role (keys %$pool_roles) {
4bc17477 44 $data->{poolroles}->{"/vms/$vmid"}->{$role} = 1;
2c3a6c0a
DM
45 }
46 }
4bc17477 47 foreach my $storeid (keys %{$d->{storage}}) {
7e8bcaa7 48 for my $role (keys %$pool_roles) {
4bc17477
DM
49 $data->{poolroles}->{"/storage/$storeid"}->{$role} = 1;
50 }
51 }
52 }
53 }
54
7e8bcaa7 55 my $roles = PVE::AccessControl::roles($cfg, $user, $path);
4bc17477
DM
56
57 # apply roles inherited from pools
58 # Note: assume we do not want to propagate those privs
59 if ($data->{poolroles}->{$path}) {
7e8bcaa7 60 if (!defined($roles->{NoAccess})) {
8ade28e6 61 if ($data->{poolroles}->{$path}->{NoAccess}) {
7e8bcaa7 62 $roles = { 'NoAccess' => 0 };
8ade28e6
DM
63 } else {
64 foreach my $role (keys %{$data->{poolroles}->{$path}}) {
7e8bcaa7 65 $roles->{$role} = 0 if !defined($roles->{$role});
8ade28e6 66 }
4bc17477 67 }
2c3a6c0a 68 }
4bc17477 69 }
2c3a6c0a 70
7e8bcaa7 71 $data->{roles}->{$path} = $roles;
c104e4ab 72
4bc17477 73 my $privs = {};
7e8bcaa7 74 foreach my $role (keys %$roles) {
4bc17477
DM
75 if (my $privset = $cfg->{roles}->{$role}) {
76 foreach my $p (keys %$privset) {
7e8bcaa7 77 $privs->{$p} = $roles->{$role};
4bc17477
DM
78 }
79 }
2c3a6c0a 80 }
e915e9e4
FG
81
82 if ($username && $username ne 'root@pam') {
83 # intersect user and token permissions
84 my $user_privs = $cache->{$username}->{privs}->{$path};
e8a0cee4
FG
85 my $filtered_privs = [ grep { $user_privs->{$_} } keys %$privs ];
86 $privs = { map { $_ => $user_privs->{$_} && $privs->{$_} } @$filtered_privs };
e915e9e4
FG
87 }
88
4bc17477 89 $data->{privs}->{$path} = $privs;
2c3a6c0a 90
4bc17477 91 return $privs;
2c3a6c0a
DM
92};
93
94sub permissions {
95 my ($self, $user, $path) = @_;
96
4bc17477
DM
97 if ($user eq 'root@pam') { # root can do anything
98 my $cfg = $self->{user_cfg};
7e8bcaa7 99 return { map { $_ => 1 } keys %{$cfg->{roles}->{'Administrator'}} };
c104e4ab 100 }
4bc17477 101
e915e9e4
FG
102 if (PVE::AccessControl::pve_verify_tokenid($user, 1)) {
103 my ($username, $token) = PVE::AccessControl::split_tokenid($user);
104 my $cfg = $self->{user_cfg};
105 my $token_info = $cfg->{users}->{$username}->{tokens}->{$token};
7e8bcaa7 106
e915e9e4
FG
107 return {} if !$token_info;
108
109 # ensure cache for user is populated
110 my $user_perms = $self->permissions($username, $path);
111
112 # return user privs for non-privsep tokens
113 return $user_perms if !$token_info->{privsep};
114 } else {
115 $user = PVE::AccessControl::verify_username($user, 1);
116 return {} if !$user;
117 }
2c3a6c0a
DM
118
119 my $cache = $self->{aclcache};
4bc17477 120 $cache->{$user} = {} if !$cache->{$user};
2c3a6c0a
DM
121
122 my $acl = $cache->{$user};
123
4bc17477
DM
124 my $perm = $acl->{privs}->{$path};
125 return $perm if $perm;
2c3a6c0a 126
4bc17477 127 return &$compile_acl_path($self, $user, $path);
2c3a6c0a
DM
128}
129
ac344d7d
DM
130sub compute_api_permission {
131 my ($self, $authuser) = @_;
132
133 my $usercfg = $self->{user_cfg};
134
135 my $res = {};
136 my $priv_re_map = {
137 vms => qr/VM\.|Permissions\.Modify/,
138 access => qr/(User|Group)\.|Permissions\.Modify/,
139 storage => qr/Datastore\.|Permissions\.Modify/,
140 nodes => qr/Sys\.|Permissions\.Modify/,
141 sdn => qr/SDN\.|Permissions\.Modify/,
142 dc => qr/Sys\.Audit|SDN\./,
143 };
144 map { $res->{$_} = {} } keys %$priv_re_map;
145
146 my $required_paths = ['/', '/nodes', '/access/groups', '/vms', '/storage', '/sdn'];
147
148 my $checked_paths = {};
149 foreach my $path (@$required_paths, keys %{$usercfg->{acl}}) {
150 next if $checked_paths->{$path};
151 $checked_paths->{$path} = 1;
152
153 my $path_perm = $self->permissions($authuser, $path);
154
155 my $toplevel = ($path =~ /^\/(\w+)/) ? $1 : 'dc';
156 if ($toplevel eq 'pool') {
157 foreach my $priv (keys %$path_perm) {
0786c1e5
FG
158 next if !defined($path_perm->{$priv});
159
ac344d7d
DM
160 if ($priv =~ m/^VM\./) {
161 $res->{vms}->{$priv} = 1;
162 } elsif ($priv =~ m/^Datastore\./) {
163 $res->{storage}->{$priv} = 1;
164 } elsif ($priv eq 'Permissions.Modify') {
165 $res->{storage}->{$priv} = 1;
166 $res->{vms}->{$priv} = 1;
167 }
168 }
169 } else {
170 my $priv_regex = $priv_re_map->{$toplevel} // next;
171 foreach my $priv (keys %$path_perm) {
0786c1e5
FG
172 next if !defined($path_perm->{$priv});
173
ac344d7d
DM
174 next if $priv !~ m/^($priv_regex)/;
175 $res->{$toplevel}->{$priv} = 1;
176 }
177 }
178 }
179
180 return $res;
181}
182
c3fa8a36
FG
183sub get_effective_permissions {
184 my ($self, $user) = @_;
185
186 # default / top level paths
187 my $paths = {
188 '/' => 1,
189 '/access' => 1,
190 '/access/groups' => 1,
191 '/nodes' => 1,
192 '/pools' => 1,
92f571d9 193 '/sdn' => 1,
c3fa8a36
FG
194 '/storage' => 1,
195 '/vms' => 1,
196 };
197
198 my $cfg = $self->{user_cfg};
199
200 # paths explicitly listed in ACLs
201 foreach my $acl_path (keys %{$cfg->{acl}}) {
202 $paths->{$acl_path} = 1;
203 }
204
205 # paths referenced by pool definitions
206 foreach my $pool (keys %{$cfg->{pools}}) {
207 my $d = $cfg->{pools}->{$pool};
208 foreach my $vmid (keys %{$d->{vms}}) {
209 $paths->{"/vms/$vmid"} = 1;
210 }
211 foreach my $storeid (keys %{$d->{storage}}) {
212 $paths->{"/storage/$storeid"} = 1;
213 }
214 }
215
216 my $perms = {};
217 foreach my $path (keys %$paths) {
218 my $path_perms = $self->permissions($user, $path);
0786c1e5
FG
219 foreach my $priv (keys %$path_perms) {
220 delete $path_perms->{$priv} if !defined($path_perms->{$priv});
221 }
c3fa8a36
FG
222 # filter paths where user has NO permissions
223 $perms->{$path} = $path_perms if %$path_perms;
224 }
225 return $perms;
226}
227
2c3a6c0a 228sub check {
37d45deb 229 my ($self, $user, $path, $privs, $noerr) = @_;
2c3a6c0a
DM
230
231 my $perm = $self->permissions($user, $path);
232
233 foreach my $priv (@$privs) {
37d45deb 234 PVE::AccessControl::verify_privname($priv);
7e8bcaa7 235 if (!defined($perm->{$priv})) {
37d45deb 236 return undef if $noerr;
c104e4ab 237 raise_perm_exc("$path, $priv");
37d45deb 238 }
2c3a6c0a
DM
239 };
240
241 return 1;
242};
243
37d45deb
DM
244sub check_any {
245 my ($self, $user, $path, $privs, $noerr) = @_;
246
247 my $perm = $self->permissions($user, $path);
efce1d57 248
37d45deb
DM
249 my $found = 0;
250 foreach my $priv (@$privs) {
251 PVE::AccessControl::verify_privname($priv);
7e8bcaa7 252 if (defined($perm->{$priv})) {
37d45deb
DM
253 $found = 1;
254 last;
255 }
256 };
257
258 return 1 if $found;
259
260 return undef if $noerr;
261
c104e4ab 262 raise_perm_exc("$path, " . join("|", @$privs));
37d45deb
DM
263};
264
c4a776a6
DM
265sub check_full {
266 my ($self, $username, $path, $privs, $any, $noerr) = @_;
267 if ($any) {
268 return $self->check_any($username, $path, $privs, $noerr);
269 } else {
270 return $self->check($username, $path, $privs, $noerr);
271 }
272}
273
7070c1ae
DM
274sub check_user_enabled {
275 my ($self, $user, $noerr) = @_;
c104e4ab 276
2c3a6c0a 277 my $cfg = $self->{user_cfg};
7070c1ae 278 return PVE::AccessControl::check_user_enabled($cfg, $user, $noerr);
2c3a6c0a
DM
279}
280
37d45deb
DM
281sub check_user_exist {
282 my ($self, $user, $noerr) = @_;
c104e4ab 283
37d45deb
DM
284 my $cfg = $self->{user_cfg};
285 return PVE::AccessControl::check_user_exist($cfg, $user, $noerr);
286}
287
a23cec1f
DM
288sub check_pool_exist {
289 my ($self, $pool, $noerr) = @_;
290
291 my $cfg = $self->{user_cfg};
292
293 return 1 if $cfg->{pools}->{$pool};
294
295 return undef if $noerr;
296
c104e4ab 297 raise_perm_exc("pool '$pool' does not exist");
a23cec1f
DM
298}
299
300sub check_vm_perm {
301 my ($self, $user, $vmid, $pool, $privs, $any, $noerr) = @_;
302
303 my $cfg = $self->{user_cfg};
c104e4ab 304
a23cec1f
DM
305 if ($pool) {
306 return if $self->check_full($user, "/pool/$pool", $privs, $any, 1);
307 }
308 return $self->check_full($user, "/vms/$vmid", $privs, $any, $noerr);
309};
310
37d45deb
DM
311sub is_group_member {
312 my ($self, $group, $user) = @_;
313
314 my $cfg = $self->{user_cfg};
315
316 return 0 if !$cfg->{groups}->{$group};
317
318 return defined($cfg->{groups}->{$group}->{users}->{$user});
319}
320
321sub filter_groups {
b9180ed2 322 my ($self, $user, $privs, $any) = @_;
37d45deb
DM
323
324 my $cfg = $self->{user_cfg};
325
326 my $groups = {};
327 foreach my $group (keys %{$cfg->{groups}}) {
b9180ed2 328 my $path = "/access/groups/$group";
c4a776a6
DM
329 if ($self->check_full($user, $path, $privs, $any, 1)) {
330 $groups->{$group} = $cfg->{groups}->{$group};
37d45deb
DM
331 }
332 }
333
334 return $groups;
335}
336
337sub group_member_join {
338 my ($self, $grouplist) = @_;
339
340 my $users = {};
341
342 my $cfg = $self->{user_cfg};
343 foreach my $group (@$grouplist) {
344 my $data = $cfg->{groups}->{$group};
345 next if !$data;
346 foreach my $user (keys %{$data->{users}}) {
347 $users->{$user} = 1;
348 }
349 }
350
351 return $users;
352}
353
e3a3a0d7
DM
354sub check_perm_modify {
355 my ($self, $username, $path, $noerr) = @_;
356
357 return $self->check($username, '/access', [ 'Permissions.Modify' ], $noerr) if !$path;
358
359 my $testperms = [ 'Permissions.Modify' ];
360 if ($path =~ m|^/storage/.+$|) {
361 push @$testperms, 'Datastore.Allocate';
362 } elsif ($path =~ m|^/vms/.+$|) {
363 push @$testperms, 'VM.Allocate';
7a7a517a
DM
364 } elsif ($path =~ m|^/pool/.+$|) {
365 push @$testperms, 'Pool.Allocate';
e3a3a0d7
DM
366 }
367
368 return $self->check_any($username, $path, $testperms, $noerr);
369}
370
f8cc5a5f
DM
371sub exec_api2_perm_check {
372 my ($self, $check, $username, $param, $noerr) = @_;
373
374 # syslog("info", "CHECK " . join(', ', @$check));
375
376 my $ind = 0;
377 my $test = $check->[$ind++];
378 die "no permission test specified" if !$test;
c104e4ab 379
f8cc5a5f
DM
380 if ($test eq 'and') {
381 while (my $subcheck = $check->[$ind++]) {
c104e4ab 382 $self->exec_api2_perm_check($subcheck, $username, $param);
f8cc5a5f
DM
383 }
384 return 1;
385 } elsif ($test eq 'or') {
386 while (my $subcheck = $check->[$ind++]) {
c104e4ab 387 return 1 if $self->exec_api2_perm_check($subcheck, $username, $param, 1);
f8cc5a5f
DM
388 }
389 return 0 if $noerr;
390 raise_perm_exc();
391 } elsif ($test eq 'perm') {
392 my ($t, $tmplpath, $privs, %options) = @$check;
393 my $any = $options{any};
394 die "missing parameters" if !($tmplpath && $privs);
c4a776a6
DM
395 my $require_param = $options{require_param};
396 if ($require_param && !defined($param->{$require_param})) {
397 return 0 if $noerr;
398 raise_perm_exc();
399 }
f8cc5a5f 400 my $path = PVE::Tools::template_replace($tmplpath, $param);
e3a3a0d7 401 $path = PVE::AccessControl::normalize_path($path);
c4a776a6 402 return $self->check_full($username, $path, $privs, $any, $noerr);
f8cc5a5f
DM
403 } elsif ($test eq 'userid-group') {
404 my $userid = $param->{userid};
405 my ($t, $privs, %options) = @$check;
82b63965
DM
406 return 0 if !$options{groups_param} && !$self->check_user_exist($userid, $noerr);
407 if (!$self->check_any($username, "/access/groups", $privs, 1)) {
f8cc5a5f
DM
408 my $groups = $self->filter_groups($username, $privs, 1);
409 if ($options{groups_param}) {
410 my @group_param = PVE::Tools::split_list($param->{groups});
82b63965 411 raise_perm_exc("/access/groups, " . join("|", @$privs)) if !scalar(@group_param);
f8cc5a5f
DM
412 foreach my $pg (@group_param) {
413 raise_perm_exc("/access/groups/$pg, " . join("|", @$privs))
414 if !$groups->{$pg};
415 }
416 } else {
417 my $allowed_users = $self->group_member_join([keys %$groups]);
418 if (!$allowed_users->{$userid}) {
419 return 0 if $noerr;
420 raise_perm_exc();
421 }
422 }
423 }
424 return 1;
425 } elsif ($test eq 'userid-param') {
09d27058 426 my ($userid, undef, $realm) = PVE::AccessControl::verify_username($param->{userid});
f8cc5a5f
DM
427 my ($t, $subtest) = @$check;
428 die "missing parameters" if !$subtest;
429 if ($subtest eq 'self') {
a69bbe2e 430 return 0 if !$self->check_user_exist($userid, $noerr);
1cf154b7 431 return 1 if $username eq $userid;
f8cc5a5f
DM
432 return 0 if $noerr;
433 raise_perm_exc();
82b63965
DM
434 } elsif ($subtest eq 'Realm.AllocateUser') {
435 my $path = "/access/realm/$realm";
436 return $self->check($username, $path, ['Realm.AllocateUser'], $noerr);
f8cc5a5f
DM
437 } else {
438 die "unknown userid-param test";
439 }
82b63965 440 } elsif ($test eq 'perm-modify') {
e3a3a0d7
DM
441 my ($t, $tmplpath) = @$check;
442 my $path = PVE::Tools::template_replace($tmplpath, $param);
443 $path = PVE::AccessControl::normalize_path($path);
444 return $self->check_perm_modify($username, $path, $noerr);
445 } else {
f8cc5a5f
DM
446 die "unknown permission test";
447 }
448};
449
450sub check_api2_permissions {
451 my ($self, $perm, $username, $param) = @_;
452
d146e520 453 return 1 if !$username && $perm->{user} && $perm->{user} eq 'world';
f8cc5a5f
DM
454
455 raise_perm_exc("user != null") if !$username;
456
457 return 1 if $username eq 'root@pam';
458
459 raise_perm_exc('user != root@pam') if !$perm;
460
461 return 1 if $perm->{user} && $perm->{user} eq 'all';
462
c104e4ab 463 return $self->exec_api2_perm_check($perm->{check}, $username, $param)
f8cc5a5f
DM
464 if $perm->{check};
465
466 raise_perm_exc();
467}
468
c104e4ab
DM
469sub log_cluster_msg {
470 my ($self, $pri, $user, $msg) = @_;
2c3a6c0a 471
c104e4ab
DM
472 PVE::Cluster::log_msg($pri, $user, $msg);
473}
2c3a6c0a 474
c104e4ab
DM
475sub broadcast_tasklist {
476 my ($self, $tlist) = @_;
2c3a6c0a 477
c104e4ab
DM
478 PVE::Cluster::broadcast_tasklist($tlist);
479}
2c3a6c0a 480
c104e4ab
DM
481# initialize environment - must be called once at program startup
482sub init {
483 my ($class, $type, %params) = @_;
86c4f1e6
DM
484
485 $class = ref($class) || $class;
5ae5900d 486
c104e4ab 487 my $self = $class->SUPER::init($type, %params);
5ae5900d 488
c104e4ab
DM
489 $self->{user_cfg} = {};
490 $self->{aclcache} = {};
491 $self->{aclversion} = undef;
2c3a6c0a 492
c104e4ab
DM
493 return $self;
494};
2c3a6c0a 495
2c3a6c0a
DM
496
497# init_request - must be called before each RPC request
498sub init_request {
499 my ($self, %params) = @_;
500
501 PVE::Cluster::cfs_update();
502
be6ea723 503 $self->{result_attributes} = {};
272fe9ff 504
2c3a6c0a
DM
505 my $userconfig; # we use this for regression tests
506 foreach my $p (keys %params) {
507 if ($p eq 'userconfig') {
508 $userconfig = $params{$p};
509 } else {
510 die "unknown parameter '$p'";
511 }
512 }
513
514 eval {
515 $self->{aclcache} = {};
516 if ($userconfig) {
517 my $ucdata = PVE::Tools::file_get_contents($userconfig);
518 my $cfg = PVE::AccessControl::parse_user_config($userconfig, $ucdata);
519 $self->{user_cfg} = $cfg;
520 } else {
c104e4ab
DM
521 my $ucvers = PVE::Cluster::cfs_file_version('user.cfg');
522 if (!$self->{aclcache} || !defined($self->{aclversion}) ||
2c3a6c0a
DM
523 !defined($ucvers) || ($ucvers ne $self->{aclversion})) {
524 $self->{aclversion} = $ucvers;
525 my $cfg = PVE::Cluster::cfs_read_file('user.cfg');
526 $self->{user_cfg} = $cfg;
527 }
528 }
529 };
530 if (my $err = $@) {
531 $self->{user_cfg} = {};
532 die "Unable to load access control list: $err";
533 }
534}
535
c104e4ab 536# hacks: to provide better backwards compatibiliy
2c3a6c0a 537
c104e4ab
DM
538# old code uses PVE::RPCEnvironment::get();
539# new code should use PVE::RPCEnvironment->get();
540sub get {
541 return PVE::RESTEnvironment->get();
2c3a6c0a
DM
542}
543
c104e4ab
DM
544# old code uses PVE::RPCEnvironment::is_worker();
545# new code should use PVE::RPCEnvironment->is_worker();
7b6dfe82 546sub is_worker {
c104e4ab 547 return PVE::RESTEnvironment->is_worker();
2c3a6c0a
DM
548}
549
5501;