1 package PVE
::API2
::Role
;
5 use PVE
::Cluster qw
(cfs_read_file cfs_write_file
);
6 use PVE
::AccessControl
;
7 use PVE
::JSONSchema
qw(get_standard_option register_standard_option);
13 use base
qw(PVE::RESTHandler);
15 register_standard_option
('role-id', {
17 format
=> 'pve-roleid',
19 register_standard_option
('role-privs', {
21 format
=> 'pve-priv-list',
25 __PACKAGE__-
>register_method ({
29 description
=> "Role index.",
34 additionalProperties
=> 0,
42 roleid
=> get_standard_option
('role-id'),
43 privs
=> get_standard_option
('role-privs'),
44 special
=> { type
=> 'boolean', optional
=> 1, default => 0 },
47 links
=> [ { rel
=> 'child', href
=> "{roleid}" } ],
54 my $usercfg = cfs_read_file
("user.cfg");
56 foreach my $role (keys %{$usercfg->{roles
}}) {
57 my $privs = join(',', sort keys %{$usercfg->{roles
}->{$role}});
61 special
=> PVE
::AccessControl
::role_is_special
($role),
68 __PACKAGE__-
>register_method ({
69 name
=> 'create_role',
74 check
=> ['perm', '/access', ['Sys.Modify']],
76 description
=> "Create new role.",
78 additionalProperties
=> 0,
80 roleid
=> get_standard_option
('role-id'),
81 privs
=> get_standard_option
('role-privs'),
84 returns
=> { type
=> 'null' },
88 PVE
::AccessControl
::lock_user_config
(sub {
89 my $usercfg = cfs_read_file
("user.cfg");
91 my $role = $param->{roleid
};
93 die "role '$role' already exists\n" if $usercfg->{roles
}->{$role};
95 $usercfg->{roles
}->{$role} = {};
97 PVE
::AccessControl
::add_role_privs
($role, $usercfg, $param->{privs
});
99 cfs_write_file
("user.cfg", $usercfg);
100 }, "create role failed");
105 __PACKAGE__-
>register_method ({
106 name
=> 'update_role',
111 check
=> ['perm', '/access', ['Sys.Modify']],
113 description
=> "Update an existing role.",
115 additionalProperties
=> 0,
117 roleid
=> get_standard_option
('role-id'),
118 privs
=> get_standard_option
('role-privs'),
119 append
=> { type
=> 'boolean', optional
=> 1, requires
=> 'privs' },
122 returns
=> { type
=> 'null' },
126 my $role = $param->{roleid
};
128 die "auto-generated role '$role' cannot be modified\n"
129 if PVE
::AccessControl
::role_is_special
($role);
131 PVE
::AccessControl
::lock_user_config
(sub {
132 my $usercfg = cfs_read_file
("user.cfg");
134 die "role '$role' does not exist\n" if !$usercfg->{roles
}->{$role};
136 $usercfg->{roles
}->{$role} = {} if !$param->{append
};
138 PVE
::AccessControl
::add_role_privs
($role, $usercfg, $param->{privs
});
140 cfs_write_file
("user.cfg", $usercfg);
141 }, "update role failed");
146 __PACKAGE__-
>register_method ({
153 description
=> "Get role configuration.",
155 additionalProperties
=> 0,
157 roleid
=> get_standard_option
('role-id'),
162 additionalProperties
=> 0,
163 properties
=> PVE
::AccessControl
::create_priv_properties
(),
168 my $usercfg = cfs_read_file
("user.cfg");
170 my $role = $param->{roleid
};
172 my $data = $usercfg->{roles
}->{$role};
174 die "role '$role' does not exist\n" if !$data;
180 __PACKAGE__-
>register_method ({
181 name
=> 'delete_role',
186 check
=> ['perm', '/access', ['Sys.Modify']],
188 description
=> "Delete role.",
190 additionalProperties
=> 0,
192 roleid
=> get_standard_option
('role-id'),
195 returns
=> { type
=> 'null' },
199 my $role = $param->{roleid
};
201 die "auto-generated role '$role' cannot be deleted\n"
202 if PVE
::AccessControl
::role_is_special
($role);
204 PVE
::AccessControl
::lock_user_config
(sub {
205 my $usercfg = cfs_read_file
("user.cfg");
207 die "role '$role' does not exist\n" if !$usercfg->{roles
}->{$role};
209 delete ($usercfg->{roles
}->{$role});
211 # fixme: delete role from acl?
213 cfs_write_file
("user.cfg", $usercfg);
214 }, "delete role failed");