Line data Source code
1 : /*-------------------------------------------------------------------------
2 : *
3 : * user.c
4 : * Commands for manipulating roles (formerly called users).
5 : *
6 : * Portions Copyright (c) 1996-2026, PostgreSQL Global Development Group
7 : * Portions Copyright (c) 1994, Regents of the University of California
8 : *
9 : * src/backend/commands/user.c
10 : *
11 : *-------------------------------------------------------------------------
12 : */
13 : #include "postgres.h"
14 :
15 : #include "access/genam.h"
16 : #include "access/htup_details.h"
17 : #include "access/table.h"
18 : #include "access/xact.h"
19 : #include "catalog/binary_upgrade.h"
20 : #include "catalog/catalog.h"
21 : #include "catalog/dependency.h"
22 : #include "catalog/indexing.h"
23 : #include "catalog/objectaccess.h"
24 : #include "catalog/pg_auth_members.h"
25 : #include "catalog/pg_authid.h"
26 : #include "catalog/pg_database.h"
27 : #include "catalog/pg_db_role_setting.h"
28 : #include "commands/comment.h"
29 : #include "commands/dbcommands.h"
30 : #include "commands/defrem.h"
31 : #include "commands/seclabel.h"
32 : #include "commands/user.h"
33 : #include "libpq/crypt.h"
34 : #include "miscadmin.h"
35 : #include "port/pg_bitutils.h"
36 : #include "storage/lmgr.h"
37 : #include "utils/acl.h"
38 : #include "utils/builtins.h"
39 : #include "utils/catcache.h"
40 : #include "utils/fmgroids.h"
41 : #include "utils/syscache.h"
42 : #include "utils/varlena.h"
43 :
44 : /*
45 : * Removing a role grant - or the admin option on it - might recurse to
46 : * dependent grants. We use these values to reason about what would need to
47 : * be done in such cases.
48 : *
49 : * RRG_NOOP indicates a grant that would not need to be altered by the
50 : * operation.
51 : *
52 : * RRG_REMOVE_ADMIN_OPTION indicates a grant that would need to have
53 : * admin_option set to false by the operation.
54 : *
55 : * Similarly, RRG_REMOVE_INHERIT_OPTION and RRG_REMOVE_SET_OPTION indicate
56 : * grants that would need to have the corresponding options set to false.
57 : *
58 : * RRG_DELETE_GRANT indicates a grant that would need to be removed entirely
59 : * by the operation.
60 : */
61 : typedef enum
62 : {
63 : RRG_NOOP,
64 : RRG_REMOVE_ADMIN_OPTION,
65 : RRG_REMOVE_INHERIT_OPTION,
66 : RRG_REMOVE_SET_OPTION,
67 : RRG_DELETE_GRANT,
68 : } RevokeRoleGrantAction;
69 :
70 : /* Potentially set by pg_upgrade_support functions */
71 : Oid binary_upgrade_next_pg_authid_oid = InvalidOid;
72 :
73 : typedef struct
74 : {
75 : unsigned specified;
76 : bool admin;
77 : bool inherit;
78 : bool set;
79 : } GrantRoleOptions;
80 :
81 : #define GRANT_ROLE_SPECIFIED_ADMIN 0x0001
82 : #define GRANT_ROLE_SPECIFIED_INHERIT 0x0002
83 : #define GRANT_ROLE_SPECIFIED_SET 0x0004
84 :
85 : /* GUC parameters */
86 : int Password_encryption = PASSWORD_TYPE_SCRAM_SHA_256;
87 : char *createrole_self_grant = "";
88 : static bool createrole_self_grant_enabled = false;
89 : static GrantRoleOptions createrole_self_grant_options;
90 :
91 : /* Hook to check passwords in CreateRole() and AlterRole() */
92 : check_password_hook_type check_password_hook = NULL;
93 :
94 : static void AddRoleMems(Oid currentUserId, const char *rolename, Oid roleid,
95 : List *memberSpecs, List *memberIds,
96 : Oid grantorId, GrantRoleOptions *popt);
97 : static void DelRoleMems(Oid currentUserId, const char *rolename, Oid roleid,
98 : List *memberSpecs, List *memberIds,
99 : Oid grantorId, GrantRoleOptions *popt,
100 : DropBehavior behavior);
101 : static void check_role_membership_authorization(Oid currentUserId, Oid roleid,
102 : bool is_grant);
103 : static Oid check_role_grantor(Oid currentUserId, Oid roleid, Oid grantorId,
104 : bool is_grant);
105 : static RevokeRoleGrantAction *initialize_revoke_actions(CatCList *memlist);
106 : static bool plan_single_revoke(CatCList *memlist,
107 : RevokeRoleGrantAction *actions,
108 : Oid member, Oid grantor,
109 : GrantRoleOptions *popt,
110 : DropBehavior behavior);
111 : static void plan_member_revoke(CatCList *memlist,
112 : RevokeRoleGrantAction *actions, Oid member);
113 : static void plan_recursive_revoke(CatCList *memlist,
114 : RevokeRoleGrantAction *actions,
115 : int index,
116 : bool revoke_admin_option_only,
117 : DropBehavior behavior);
118 : static void InitGrantRoleOptions(GrantRoleOptions *popt);
119 :
120 :
121 : /* Check if current user has createrole privileges */
122 : static bool
123 2286 : have_createrole_privilege(void)
124 : {
125 2286 : return has_createrole_privilege(GetUserId());
126 : }
127 :
128 :
129 : /*
130 : * CREATE ROLE
131 : */
132 : Oid
133 1916 : CreateRole(ParseState *pstate, CreateRoleStmt *stmt)
134 : {
135 : Relation pg_authid_rel;
136 : TupleDesc pg_authid_dsc;
137 : HeapTuple tuple;
138 1916 : Datum new_record[Natts_pg_authid] = {0};
139 1916 : bool new_record_nulls[Natts_pg_authid] = {0};
140 1916 : Oid currentUserId = GetUserId();
141 : Oid roleid;
142 : ListCell *item;
143 : ListCell *option;
144 1916 : char *password = NULL; /* user password */
145 1916 : bool issuper = false; /* Make the user a superuser? */
146 1916 : bool inherit = true; /* Auto inherit privileges? */
147 1916 : bool createrole = false; /* Can this user create roles? */
148 1916 : bool createdb = false; /* Can the user create databases? */
149 1916 : bool canlogin = false; /* Can this user login? */
150 1916 : bool isreplication = false; /* Is this a replication role? */
151 1916 : bool bypassrls = false; /* Is this a row security enabled role? */
152 1916 : int connlimit = -1; /* maximum connections allowed */
153 1916 : List *addroleto = NIL; /* roles to make this a member of */
154 1916 : List *rolemembers = NIL; /* roles to be members of this role */
155 1916 : List *adminmembers = NIL; /* roles to be admins of this role */
156 1916 : char *validUntil = NULL; /* time the login is valid until */
157 : Datum validUntil_datum; /* same, as timestamptz Datum */
158 : bool validUntil_null;
159 1916 : DefElem *dpassword = NULL;
160 1916 : DefElem *dissuper = NULL;
161 1916 : DefElem *dinherit = NULL;
162 1916 : DefElem *dcreaterole = NULL;
163 1916 : DefElem *dcreatedb = NULL;
164 1916 : DefElem *dcanlogin = NULL;
165 1916 : DefElem *disreplication = NULL;
166 1916 : DefElem *dconnlimit = NULL;
167 1916 : DefElem *daddroleto = NULL;
168 1916 : DefElem *drolemembers = NULL;
169 1916 : DefElem *dadminmembers = NULL;
170 1916 : DefElem *dvalidUntil = NULL;
171 1916 : DefElem *dbypassRLS = NULL;
172 : GrantRoleOptions popt;
173 :
174 : /* The defaults can vary depending on the original statement type */
175 1916 : switch (stmt->stmt_type)
176 : {
177 1434 : case ROLESTMT_ROLE:
178 1434 : break;
179 458 : case ROLESTMT_USER:
180 458 : canlogin = true;
181 : /* may eventually want inherit to default to false here */
182 458 : break;
183 24 : case ROLESTMT_GROUP:
184 24 : break;
185 : }
186 :
187 : /* Extract options from the statement node tree */
188 3096 : foreach(option, stmt->options)
189 : {
190 1180 : DefElem *defel = (DefElem *) lfirst(option);
191 :
192 1180 : if (strcmp(defel->defname, "password") == 0)
193 : {
194 120 : if (dpassword)
195 0 : errorConflictingDefElem(defel, pstate);
196 120 : dpassword = defel;
197 : }
198 1060 : else if (strcmp(defel->defname, "sysid") == 0)
199 : {
200 6 : ereport(NOTICE,
201 : (errmsg("SYSID can no longer be specified")));
202 : }
203 1054 : else if (strcmp(defel->defname, "superuser") == 0)
204 : {
205 192 : if (dissuper)
206 0 : errorConflictingDefElem(defel, pstate);
207 192 : dissuper = defel;
208 : }
209 862 : else if (strcmp(defel->defname, "inherit") == 0)
210 : {
211 64 : if (dinherit)
212 0 : errorConflictingDefElem(defel, pstate);
213 64 : dinherit = defel;
214 : }
215 798 : else if (strcmp(defel->defname, "createrole") == 0)
216 : {
217 90 : if (dcreaterole)
218 0 : errorConflictingDefElem(defel, pstate);
219 90 : dcreaterole = defel;
220 : }
221 708 : else if (strcmp(defel->defname, "createdb") == 0)
222 : {
223 70 : if (dcreatedb)
224 0 : errorConflictingDefElem(defel, pstate);
225 70 : dcreatedb = defel;
226 : }
227 638 : else if (strcmp(defel->defname, "canlogin") == 0)
228 : {
229 302 : if (dcanlogin)
230 0 : errorConflictingDefElem(defel, pstate);
231 302 : dcanlogin = defel;
232 : }
233 336 : else if (strcmp(defel->defname, "isreplication") == 0)
234 : {
235 90 : if (disreplication)
236 0 : errorConflictingDefElem(defel, pstate);
237 90 : disreplication = defel;
238 : }
239 246 : else if (strcmp(defel->defname, "connectionlimit") == 0)
240 : {
241 12 : if (dconnlimit)
242 0 : errorConflictingDefElem(defel, pstate);
243 12 : dconnlimit = defel;
244 : }
245 234 : else if (strcmp(defel->defname, "addroleto") == 0)
246 : {
247 100 : if (daddroleto)
248 0 : errorConflictingDefElem(defel, pstate);
249 100 : daddroleto = defel;
250 : }
251 134 : else if (strcmp(defel->defname, "rolemembers") == 0)
252 : {
253 28 : if (drolemembers)
254 0 : errorConflictingDefElem(defel, pstate);
255 28 : drolemembers = defel;
256 : }
257 106 : else if (strcmp(defel->defname, "adminmembers") == 0)
258 : {
259 22 : if (dadminmembers)
260 0 : errorConflictingDefElem(defel, pstate);
261 22 : dadminmembers = defel;
262 : }
263 84 : else if (strcmp(defel->defname, "validUntil") == 0)
264 : {
265 2 : if (dvalidUntil)
266 0 : errorConflictingDefElem(defel, pstate);
267 2 : dvalidUntil = defel;
268 : }
269 82 : else if (strcmp(defel->defname, "bypassrls") == 0)
270 : {
271 82 : if (dbypassRLS)
272 0 : errorConflictingDefElem(defel, pstate);
273 82 : dbypassRLS = defel;
274 : }
275 : else
276 0 : elog(ERROR, "option \"%s\" not recognized",
277 : defel->defname);
278 : }
279 :
280 1916 : if (dpassword && dpassword->arg)
281 108 : password = strVal(dpassword->arg);
282 1916 : if (dissuper)
283 192 : issuper = boolVal(dissuper->arg);
284 1916 : if (dinherit)
285 64 : inherit = boolVal(dinherit->arg);
286 1916 : if (dcreaterole)
287 90 : createrole = boolVal(dcreaterole->arg);
288 1916 : if (dcreatedb)
289 70 : createdb = boolVal(dcreatedb->arg);
290 1916 : if (dcanlogin)
291 302 : canlogin = boolVal(dcanlogin->arg);
292 1916 : if (disreplication)
293 90 : isreplication = boolVal(disreplication->arg);
294 1916 : if (dconnlimit)
295 : {
296 12 : connlimit = intVal(dconnlimit->arg);
297 12 : if (connlimit < -1)
298 0 : ereport(ERROR,
299 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
300 : errmsg("invalid connection limit: %d", connlimit)));
301 : }
302 1916 : if (daddroleto)
303 100 : addroleto = (List *) daddroleto->arg;
304 1916 : if (drolemembers)
305 28 : rolemembers = (List *) drolemembers->arg;
306 1916 : if (dadminmembers)
307 22 : adminmembers = (List *) dadminmembers->arg;
308 1916 : if (dvalidUntil)
309 2 : validUntil = strVal(dvalidUntil->arg);
310 1916 : if (dbypassRLS)
311 82 : bypassrls = boolVal(dbypassRLS->arg);
312 :
313 : /* Check some permissions first */
314 1916 : if (!superuser_arg(currentUserId))
315 : {
316 222 : if (!has_createrole_privilege(currentUserId))
317 0 : ereport(ERROR,
318 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
319 : errmsg("permission denied to create role"),
320 : errdetail("Only roles with the %s attribute may create roles.",
321 : "CREATEROLE")));
322 222 : if (issuper)
323 6 : ereport(ERROR,
324 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
325 : errmsg("permission denied to create role"),
326 : errdetail("Only roles with the %s attribute may create roles with the %s attribute.",
327 : "SUPERUSER", "SUPERUSER")));
328 216 : if (createdb && !have_createdb_privilege())
329 6 : ereport(ERROR,
330 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
331 : errmsg("permission denied to create role"),
332 : errdetail("Only roles with the %s attribute may create roles with the %s attribute.",
333 : "CREATEDB", "CREATEDB")));
334 210 : if (isreplication && !has_rolreplication(currentUserId))
335 12 : ereport(ERROR,
336 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
337 : errmsg("permission denied to create role"),
338 : errdetail("Only roles with the %s attribute may create roles with the %s attribute.",
339 : "REPLICATION", "REPLICATION")));
340 198 : if (bypassrls && !has_bypassrls_privilege(currentUserId))
341 6 : ereport(ERROR,
342 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
343 : errmsg("permission denied to create role"),
344 : errdetail("Only roles with the %s attribute may create roles with the %s attribute.",
345 : "BYPASSRLS", "BYPASSRLS")));
346 : }
347 :
348 : /*
349 : * Check that the user is not trying to create a role in the reserved
350 : * "pg_" namespace.
351 : */
352 1886 : if (IsReservedName(stmt->role))
353 8 : ereport(ERROR,
354 : (errcode(ERRCODE_RESERVED_NAME),
355 : errmsg("role name \"%s\" is reserved",
356 : stmt->role),
357 : errdetail("Role names starting with \"pg_\" are reserved.")));
358 :
359 : /*
360 : * If built with appropriate switch, whine when regression-testing
361 : * conventions for role names are violated.
362 : */
363 : #ifdef ENFORCE_REGRESSION_TEST_NAME_RESTRICTIONS
364 : if (strncmp(stmt->role, "regress_", 8) != 0)
365 : elog(WARNING, "roles created by regression test cases should have names starting with \"regress_\"");
366 : #endif
367 :
368 : /*
369 : * Check the pg_authid relation to be certain the role doesn't already
370 : * exist.
371 : */
372 1878 : pg_authid_rel = table_open(AuthIdRelationId, RowExclusiveLock);
373 1878 : pg_authid_dsc = RelationGetDescr(pg_authid_rel);
374 :
375 1878 : if (OidIsValid(get_role_oid(stmt->role, true)))
376 6 : ereport(ERROR,
377 : (errcode(ERRCODE_DUPLICATE_OBJECT),
378 : errmsg("role \"%s\" already exists",
379 : stmt->role)));
380 :
381 : /* Convert validuntil to internal form */
382 1872 : if (validUntil)
383 : {
384 2 : validUntil_datum = DirectFunctionCall3(timestamptz_in,
385 : CStringGetDatum(validUntil),
386 : ObjectIdGetDatum(InvalidOid),
387 : Int32GetDatum(-1));
388 2 : validUntil_null = false;
389 : }
390 : else
391 : {
392 1870 : validUntil_datum = (Datum) 0;
393 1870 : validUntil_null = true;
394 : }
395 :
396 : /*
397 : * Call the password checking hook if there is one defined
398 : */
399 1872 : if (check_password_hook && password)
400 0 : (*check_password_hook) (stmt->role,
401 : password,
402 : get_password_type(password),
403 : validUntil_datum,
404 : validUntil_null);
405 :
406 : /*
407 : * Build a tuple to insert
408 : */
409 1872 : new_record[Anum_pg_authid_rolname - 1] =
410 1872 : DirectFunctionCall1(namein, CStringGetDatum(stmt->role));
411 1872 : new_record[Anum_pg_authid_rolsuper - 1] = BoolGetDatum(issuper);
412 1872 : new_record[Anum_pg_authid_rolinherit - 1] = BoolGetDatum(inherit);
413 1872 : new_record[Anum_pg_authid_rolcreaterole - 1] = BoolGetDatum(createrole);
414 1872 : new_record[Anum_pg_authid_rolcreatedb - 1] = BoolGetDatum(createdb);
415 1872 : new_record[Anum_pg_authid_rolcanlogin - 1] = BoolGetDatum(canlogin);
416 1872 : new_record[Anum_pg_authid_rolreplication - 1] = BoolGetDatum(isreplication);
417 1872 : new_record[Anum_pg_authid_rolconnlimit - 1] = Int32GetDatum(connlimit);
418 :
419 1872 : if (password)
420 : {
421 : char *shadow_pass;
422 108 : const char *logdetail = NULL;
423 :
424 : /*
425 : * Don't allow an empty password. Libpq treats an empty password the
426 : * same as no password at all, and won't even try to authenticate. But
427 : * other clients might, so allowing it would be confusing. By clearing
428 : * the password when an empty string is specified, the account is
429 : * consistently locked for all clients.
430 : *
431 : * Note that this only covers passwords stored in the database itself.
432 : * There are also checks in the authentication code, to forbid an
433 : * empty password from being used with authentication methods that
434 : * fetch the password from an external system, like LDAP or PAM.
435 : */
436 210 : if (password[0] == '\0' ||
437 102 : plain_crypt_verify(stmt->role, password, "", &logdetail) == STATUS_OK)
438 : {
439 6 : ereport(NOTICE,
440 : (errmsg("empty string is not a valid password, clearing password")));
441 6 : new_record_nulls[Anum_pg_authid_rolpassword - 1] = true;
442 : }
443 : else
444 : {
445 : /* Encrypt the password to the requested format. */
446 102 : shadow_pass = encrypt_password(Password_encryption, stmt->role,
447 : password);
448 96 : new_record[Anum_pg_authid_rolpassword - 1] =
449 96 : CStringGetTextDatum(shadow_pass);
450 : }
451 : }
452 : else
453 1764 : new_record_nulls[Anum_pg_authid_rolpassword - 1] = true;
454 :
455 1866 : new_record[Anum_pg_authid_rolvaliduntil - 1] = validUntil_datum;
456 1866 : new_record_nulls[Anum_pg_authid_rolvaliduntil - 1] = validUntil_null;
457 :
458 1866 : new_record[Anum_pg_authid_rolbypassrls - 1] = BoolGetDatum(bypassrls);
459 :
460 : /*
461 : * pg_largeobject_metadata contains pg_authid.oid's, so we use the
462 : * binary-upgrade override.
463 : */
464 1866 : if (IsBinaryUpgrade)
465 : {
466 16 : if (!OidIsValid(binary_upgrade_next_pg_authid_oid))
467 0 : ereport(ERROR,
468 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
469 : errmsg("pg_authid OID value not set when in binary upgrade mode")));
470 :
471 16 : roleid = binary_upgrade_next_pg_authid_oid;
472 16 : binary_upgrade_next_pg_authid_oid = InvalidOid;
473 : }
474 : else
475 : {
476 1850 : roleid = GetNewOidWithIndex(pg_authid_rel, AuthIdOidIndexId,
477 : Anum_pg_authid_oid);
478 : }
479 :
480 1866 : new_record[Anum_pg_authid_oid - 1] = ObjectIdGetDatum(roleid);
481 :
482 1866 : tuple = heap_form_tuple(pg_authid_dsc, new_record, new_record_nulls);
483 :
484 : /*
485 : * Insert new record in the pg_authid table
486 : */
487 1866 : CatalogTupleInsert(pg_authid_rel, tuple);
488 :
489 : /*
490 : * Advance command counter so we can see new record; else tests in
491 : * AddRoleMems may fail.
492 : */
493 1866 : if (addroleto || adminmembers || rolemembers)
494 144 : CommandCounterIncrement();
495 :
496 : /* Default grant. */
497 1866 : InitGrantRoleOptions(&popt);
498 :
499 : /*
500 : * Add the new role to the specified existing roles.
501 : */
502 1866 : if (addroleto)
503 : {
504 100 : RoleSpec *thisrole = makeNode(RoleSpec);
505 100 : List *thisrole_list = list_make1(thisrole);
506 100 : List *thisrole_oidlist = list_make1_oid(roleid);
507 :
508 100 : thisrole->roletype = ROLESPEC_CSTRING;
509 100 : thisrole->rolename = stmt->role;
510 100 : thisrole->location = -1;
511 :
512 128 : foreach(item, addroleto)
513 : {
514 100 : RoleSpec *oldrole = lfirst(item);
515 100 : HeapTuple oldroletup = get_rolespec_tuple(oldrole);
516 100 : Form_pg_authid oldroleform = (Form_pg_authid) GETSTRUCT(oldroletup);
517 100 : Oid oldroleid = oldroleform->oid;
518 100 : char *oldrolename = NameStr(oldroleform->rolname);
519 :
520 : /* can only add this role to roles for which you have rights */
521 100 : check_role_membership_authorization(currentUserId, oldroleid, true);
522 28 : AddRoleMems(currentUserId, oldrolename, oldroleid,
523 : thisrole_list,
524 : thisrole_oidlist,
525 : InvalidOid, &popt);
526 :
527 28 : ReleaseSysCache(oldroletup);
528 : }
529 : }
530 :
531 : /*
532 : * If the current user isn't a superuser, make them an admin of the new
533 : * role so that they can administer the new object they just created.
534 : * Superusers will be able to do that anyway.
535 : *
536 : * The grantor of record for this implicit grant is the bootstrap
537 : * superuser, which means that the CREATEROLE user cannot revoke the
538 : * grant. They can however grant the created role back to themselves with
539 : * different options, since they enjoy ADMIN OPTION on it.
540 : */
541 1794 : if (!superuser())
542 : {
543 120 : RoleSpec *current_role = makeNode(RoleSpec);
544 : GrantRoleOptions poptself;
545 : List *memberSpecs;
546 120 : List *memberIds = list_make1_oid(currentUserId);
547 :
548 120 : current_role->roletype = ROLESPEC_CURRENT_ROLE;
549 120 : current_role->location = -1;
550 120 : memberSpecs = list_make1(current_role);
551 :
552 120 : poptself.specified = GRANT_ROLE_SPECIFIED_ADMIN
553 : | GRANT_ROLE_SPECIFIED_INHERIT
554 : | GRANT_ROLE_SPECIFIED_SET;
555 120 : poptself.admin = true;
556 120 : poptself.inherit = false;
557 120 : poptself.set = false;
558 :
559 120 : AddRoleMems(BOOTSTRAP_SUPERUSERID, stmt->role, roleid,
560 : memberSpecs, memberIds,
561 : BOOTSTRAP_SUPERUSERID, &poptself);
562 :
563 : /*
564 : * We must make the implicit grant visible to the code below, else the
565 : * additional grants will fail.
566 : */
567 120 : CommandCounterIncrement();
568 :
569 : /*
570 : * Because of the implicit grant above, a CREATEROLE user who creates
571 : * a role has the ability to grant that role back to themselves with
572 : * the INHERIT or SET options, if they wish to inherit the role's
573 : * privileges or be able to SET ROLE to it. The createrole_self_grant
574 : * GUC can be used to make this happen automatically. This has no
575 : * security implications since the same user is able to make the same
576 : * grant using an explicit GRANT statement; it's just convenient.
577 : */
578 120 : if (createrole_self_grant_enabled)
579 6 : AddRoleMems(currentUserId, stmt->role, roleid,
580 : memberSpecs, memberIds,
581 : currentUserId, &createrole_self_grant_options);
582 : }
583 :
584 : /*
585 : * Add the specified members to this new role. adminmembers get the admin
586 : * option, rolemembers don't.
587 : *
588 : * NB: No permissions check is required here. If you have enough rights to
589 : * create a role, you can add any members you like.
590 : */
591 1794 : AddRoleMems(currentUserId, stmt->role, roleid,
592 : rolemembers, roleSpecsToIds(rolemembers),
593 : InvalidOid, &popt);
594 1788 : popt.specified |= GRANT_ROLE_SPECIFIED_ADMIN;
595 1788 : popt.admin = true;
596 1788 : AddRoleMems(currentUserId, stmt->role, roleid,
597 : adminmembers, roleSpecsToIds(adminmembers),
598 : InvalidOid, &popt);
599 :
600 : /* Post creation hook for new role */
601 1782 : InvokeObjectPostCreateHook(AuthIdRelationId, roleid, 0);
602 :
603 : /*
604 : * Close pg_authid, but keep lock till commit.
605 : */
606 1782 : table_close(pg_authid_rel, NoLock);
607 :
608 1782 : return roleid;
609 : }
610 :
611 :
612 : /*
613 : * ALTER ROLE
614 : *
615 : * Note: the rolemembers option accepted here is intended to support the
616 : * backwards-compatible ALTER GROUP syntax. Although it will work to say
617 : * "ALTER ROLE role ROLE rolenames", we don't document it.
618 : */
619 : Oid
620 478 : AlterRole(ParseState *pstate, AlterRoleStmt *stmt)
621 : {
622 478 : Datum new_record[Natts_pg_authid] = {0};
623 478 : bool new_record_nulls[Natts_pg_authid] = {0};
624 478 : bool new_record_repl[Natts_pg_authid] = {0};
625 : Relation pg_authid_rel;
626 : TupleDesc pg_authid_dsc;
627 : HeapTuple tuple,
628 : new_tuple;
629 : Form_pg_authid authform;
630 : ListCell *option;
631 : char *rolename;
632 478 : char *password = NULL; /* user password */
633 478 : int connlimit = -1; /* maximum connections allowed */
634 478 : char *validUntil = NULL; /* time the login is valid until */
635 : Datum validUntil_datum; /* same, as timestamptz Datum */
636 : bool validUntil_null;
637 478 : DefElem *dpassword = NULL;
638 478 : DefElem *dissuper = NULL;
639 478 : DefElem *dinherit = NULL;
640 478 : DefElem *dcreaterole = NULL;
641 478 : DefElem *dcreatedb = NULL;
642 478 : DefElem *dcanlogin = NULL;
643 478 : DefElem *disreplication = NULL;
644 478 : DefElem *dconnlimit = NULL;
645 478 : DefElem *drolemembers = NULL;
646 478 : DefElem *dvalidUntil = NULL;
647 478 : DefElem *dbypassRLS = NULL;
648 : Oid roleid;
649 478 : Oid currentUserId = GetUserId();
650 : GrantRoleOptions popt;
651 :
652 478 : check_rolespec_name(stmt->role,
653 478 : _("Cannot alter reserved roles."));
654 :
655 : /* Extract options from the statement node tree */
656 1304 : foreach(option, stmt->options)
657 : {
658 826 : DefElem *defel = (DefElem *) lfirst(option);
659 :
660 826 : if (strcmp(defel->defname, "password") == 0)
661 : {
662 96 : if (dpassword)
663 0 : errorConflictingDefElem(defel, pstate);
664 96 : dpassword = defel;
665 : }
666 730 : else if (strcmp(defel->defname, "superuser") == 0)
667 : {
668 116 : if (dissuper)
669 0 : errorConflictingDefElem(defel, pstate);
670 116 : dissuper = defel;
671 : }
672 614 : else if (strcmp(defel->defname, "inherit") == 0)
673 : {
674 84 : if (dinherit)
675 0 : errorConflictingDefElem(defel, pstate);
676 84 : dinherit = defel;
677 : }
678 530 : else if (strcmp(defel->defname, "createrole") == 0)
679 : {
680 66 : if (dcreaterole)
681 0 : errorConflictingDefElem(defel, pstate);
682 66 : dcreaterole = defel;
683 : }
684 464 : else if (strcmp(defel->defname, "createdb") == 0)
685 : {
686 84 : if (dcreatedb)
687 0 : errorConflictingDefElem(defel, pstate);
688 84 : dcreatedb = defel;
689 : }
690 380 : else if (strcmp(defel->defname, "canlogin") == 0)
691 : {
692 90 : if (dcanlogin)
693 0 : errorConflictingDefElem(defel, pstate);
694 90 : dcanlogin = defel;
695 : }
696 290 : else if (strcmp(defel->defname, "isreplication") == 0)
697 : {
698 152 : if (disreplication)
699 0 : errorConflictingDefElem(defel, pstate);
700 152 : disreplication = defel;
701 : }
702 138 : else if (strcmp(defel->defname, "connectionlimit") == 0)
703 : {
704 12 : if (dconnlimit)
705 0 : errorConflictingDefElem(defel, pstate);
706 12 : dconnlimit = defel;
707 : }
708 126 : else if (strcmp(defel->defname, "rolemembers") == 0 &&
709 42 : stmt->action != 0)
710 : {
711 42 : if (drolemembers)
712 0 : errorConflictingDefElem(defel, pstate);
713 42 : drolemembers = defel;
714 : }
715 84 : else if (strcmp(defel->defname, "validUntil") == 0)
716 : {
717 0 : if (dvalidUntil)
718 0 : errorConflictingDefElem(defel, pstate);
719 0 : dvalidUntil = defel;
720 : }
721 84 : else if (strcmp(defel->defname, "bypassrls") == 0)
722 : {
723 84 : if (dbypassRLS)
724 0 : errorConflictingDefElem(defel, pstate);
725 84 : dbypassRLS = defel;
726 : }
727 : else
728 0 : elog(ERROR, "option \"%s\" not recognized",
729 : defel->defname);
730 : }
731 :
732 478 : if (dpassword && dpassword->arg)
733 96 : password = strVal(dpassword->arg);
734 478 : if (dconnlimit)
735 : {
736 12 : connlimit = intVal(dconnlimit->arg);
737 12 : if (connlimit < -1)
738 0 : ereport(ERROR,
739 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
740 : errmsg("invalid connection limit: %d", connlimit)));
741 : }
742 478 : if (dvalidUntil)
743 0 : validUntil = strVal(dvalidUntil->arg);
744 :
745 : /*
746 : * Scan the pg_authid relation to be certain the user exists.
747 : */
748 478 : pg_authid_rel = table_open(AuthIdRelationId, RowExclusiveLock);
749 478 : pg_authid_dsc = RelationGetDescr(pg_authid_rel);
750 :
751 478 : tuple = get_rolespec_tuple(stmt->role);
752 462 : authform = (Form_pg_authid) GETSTRUCT(tuple);
753 462 : rolename = pstrdup(NameStr(authform->rolname));
754 462 : roleid = authform->oid;
755 :
756 : /* To mess with a superuser in any way you gotta be superuser. */
757 462 : if (!superuser() && authform->rolsuper)
758 0 : ereport(ERROR,
759 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
760 : errmsg("permission denied to alter role"),
761 : errdetail("Only roles with the %s attribute may alter roles with the %s attribute.",
762 : "SUPERUSER", "SUPERUSER")));
763 462 : if (!superuser() && dissuper)
764 18 : ereport(ERROR,
765 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
766 : errmsg("permission denied to alter role"),
767 : errdetail("Only roles with the %s attribute may change the %s attribute.",
768 : "SUPERUSER", "SUPERUSER")));
769 :
770 : /*
771 : * Most changes to a role require that you both have CREATEROLE privileges
772 : * and also ADMIN OPTION on the role.
773 : */
774 444 : if (!have_createrole_privilege() ||
775 408 : !is_admin_of_role(GetUserId(), roleid))
776 : {
777 : /* things an unprivileged user certainly can't do */
778 42 : if (dinherit || dcreaterole || dcreatedb || dcanlogin || dconnlimit ||
779 36 : dvalidUntil || disreplication || dbypassRLS)
780 6 : ereport(ERROR,
781 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
782 : errmsg("permission denied to alter role"),
783 : errdetail("Only roles with the %s attribute and the %s option on role \"%s\" may alter this role.",
784 : "CREATEROLE", "ADMIN", rolename)));
785 :
786 : /* an unprivileged user can change their own password */
787 36 : if (dpassword && roleid != currentUserId)
788 6 : ereport(ERROR,
789 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
790 : errmsg("permission denied to alter role"),
791 : errdetail("To change another role's password, the current user must have the %s attribute and the %s option on the role.",
792 : "CREATEROLE", "ADMIN")));
793 : }
794 402 : else if (!superuser())
795 : {
796 : /*
797 : * Even if you have both CREATEROLE and ADMIN OPTION on a role, you
798 : * can only change the CREATEDB, REPLICATION, or BYPASSRLS attributes
799 : * if they are set for your own role (or you are the superuser).
800 : */
801 60 : if (dcreatedb && !have_createdb_privilege())
802 6 : ereport(ERROR,
803 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
804 : errmsg("permission denied to alter role"),
805 : errdetail("Only roles with the %s attribute may change the %s attribute.",
806 : "CREATEDB", "CREATEDB")));
807 54 : if (disreplication && !has_rolreplication(currentUserId))
808 6 : ereport(ERROR,
809 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
810 : errmsg("permission denied to alter role"),
811 : errdetail("Only roles with the %s attribute may change the %s attribute.",
812 : "REPLICATION", "REPLICATION")));
813 48 : if (dbypassRLS && !has_bypassrls_privilege(currentUserId))
814 6 : ereport(ERROR,
815 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
816 : errmsg("permission denied to alter role"),
817 : errdetail("Only roles with the %s attribute may change the %s attribute.",
818 : "BYPASSRLS", "BYPASSRLS")));
819 : }
820 :
821 : /* To add or drop members, you need ADMIN OPTION. */
822 414 : if (drolemembers && !is_admin_of_role(currentUserId, roleid))
823 12 : ereport(ERROR,
824 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
825 : errmsg("permission denied to alter role"),
826 : errdetail("Only roles with the %s option on role \"%s\" may add or drop members.",
827 : "ADMIN", rolename)));
828 :
829 : /* Convert validuntil to internal form */
830 402 : if (dvalidUntil)
831 : {
832 0 : validUntil_datum = DirectFunctionCall3(timestamptz_in,
833 : CStringGetDatum(validUntil),
834 : ObjectIdGetDatum(InvalidOid),
835 : Int32GetDatum(-1));
836 0 : validUntil_null = false;
837 : }
838 : else
839 : {
840 : /* fetch existing setting in case hook needs it */
841 402 : validUntil_datum = SysCacheGetAttr(AUTHNAME, tuple,
842 : Anum_pg_authid_rolvaliduntil,
843 : &validUntil_null);
844 : }
845 :
846 : /*
847 : * Call the password checking hook if there is one defined
848 : */
849 402 : if (check_password_hook && password)
850 14 : (*check_password_hook) (rolename,
851 : password,
852 : get_password_type(password),
853 : validUntil_datum,
854 : validUntil_null);
855 :
856 : /*
857 : * Build an updated tuple, perusing the information just obtained
858 : */
859 :
860 : /*
861 : * issuper/createrole/etc
862 : */
863 394 : if (dissuper)
864 : {
865 98 : bool should_be_super = boolVal(dissuper->arg);
866 :
867 98 : if (!should_be_super && roleid == BOOTSTRAP_SUPERUSERID)
868 0 : ereport(ERROR,
869 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
870 : errmsg("permission denied to alter role"),
871 : errdetail("The bootstrap superuser must have the %s attribute.",
872 : "SUPERUSER")));
873 :
874 98 : new_record[Anum_pg_authid_rolsuper - 1] = BoolGetDatum(should_be_super);
875 98 : new_record_repl[Anum_pg_authid_rolsuper - 1] = true;
876 : }
877 :
878 394 : if (dinherit)
879 : {
880 78 : new_record[Anum_pg_authid_rolinherit - 1] = BoolGetDatum(boolVal(dinherit->arg));
881 78 : new_record_repl[Anum_pg_authid_rolinherit - 1] = true;
882 : }
883 :
884 394 : if (dcreaterole)
885 : {
886 66 : new_record[Anum_pg_authid_rolcreaterole - 1] = BoolGetDatum(boolVal(dcreaterole->arg));
887 66 : new_record_repl[Anum_pg_authid_rolcreaterole - 1] = true;
888 : }
889 :
890 394 : if (dcreatedb)
891 : {
892 78 : new_record[Anum_pg_authid_rolcreatedb - 1] = BoolGetDatum(boolVal(dcreatedb->arg));
893 78 : new_record_repl[Anum_pg_authid_rolcreatedb - 1] = true;
894 : }
895 :
896 394 : if (dcanlogin)
897 : {
898 84 : new_record[Anum_pg_authid_rolcanlogin - 1] = BoolGetDatum(boolVal(dcanlogin->arg));
899 84 : new_record_repl[Anum_pg_authid_rolcanlogin - 1] = true;
900 : }
901 :
902 394 : if (disreplication)
903 : {
904 130 : new_record[Anum_pg_authid_rolreplication - 1] = BoolGetDatum(boolVal(disreplication->arg));
905 130 : new_record_repl[Anum_pg_authid_rolreplication - 1] = true;
906 : }
907 :
908 394 : if (dconnlimit)
909 : {
910 6 : new_record[Anum_pg_authid_rolconnlimit - 1] = Int32GetDatum(connlimit);
911 6 : new_record_repl[Anum_pg_authid_rolconnlimit - 1] = true;
912 : }
913 :
914 : /* password */
915 394 : if (password)
916 : {
917 : char *shadow_pass;
918 82 : const char *logdetail = NULL;
919 :
920 : /* Like in CREATE USER, don't allow an empty password. */
921 164 : if (password[0] == '\0' ||
922 82 : plain_crypt_verify(rolename, password, "", &logdetail) == STATUS_OK)
923 : {
924 12 : ereport(NOTICE,
925 : (errmsg("empty string is not a valid password, clearing password")));
926 12 : new_record_nulls[Anum_pg_authid_rolpassword - 1] = true;
927 : }
928 : else
929 : {
930 : /* Encrypt the password to the requested format. */
931 70 : shadow_pass = encrypt_password(Password_encryption, rolename,
932 : password);
933 64 : new_record[Anum_pg_authid_rolpassword - 1] =
934 64 : CStringGetTextDatum(shadow_pass);
935 : }
936 76 : new_record_repl[Anum_pg_authid_rolpassword - 1] = true;
937 : }
938 :
939 : /* unset password */
940 388 : if (dpassword && dpassword->arg == NULL)
941 : {
942 0 : new_record_repl[Anum_pg_authid_rolpassword - 1] = true;
943 0 : new_record_nulls[Anum_pg_authid_rolpassword - 1] = true;
944 : }
945 :
946 : /* valid until */
947 388 : new_record[Anum_pg_authid_rolvaliduntil - 1] = validUntil_datum;
948 388 : new_record_nulls[Anum_pg_authid_rolvaliduntil - 1] = validUntil_null;
949 388 : new_record_repl[Anum_pg_authid_rolvaliduntil - 1] = true;
950 :
951 388 : if (dbypassRLS)
952 : {
953 78 : new_record[Anum_pg_authid_rolbypassrls - 1] = BoolGetDatum(boolVal(dbypassRLS->arg));
954 78 : new_record_repl[Anum_pg_authid_rolbypassrls - 1] = true;
955 : }
956 :
957 388 : new_tuple = heap_modify_tuple(tuple, pg_authid_dsc, new_record,
958 : new_record_nulls, new_record_repl);
959 388 : CatalogTupleUpdate(pg_authid_rel, &tuple->t_self, new_tuple);
960 :
961 388 : InvokeObjectPostAlterHook(AuthIdRelationId, roleid, 0);
962 :
963 388 : ReleaseSysCache(tuple);
964 388 : heap_freetuple(new_tuple);
965 :
966 388 : InitGrantRoleOptions(&popt);
967 :
968 : /*
969 : * Advance command counter so we can see new record; else tests in
970 : * AddRoleMems may fail.
971 : */
972 388 : if (drolemembers)
973 : {
974 30 : List *rolemembers = (List *) drolemembers->arg;
975 :
976 30 : CommandCounterIncrement();
977 :
978 30 : if (stmt->action == +1) /* add members to role */
979 18 : AddRoleMems(currentUserId, rolename, roleid,
980 : rolemembers, roleSpecsToIds(rolemembers),
981 : InvalidOid, &popt);
982 12 : else if (stmt->action == -1) /* drop members from role */
983 12 : DelRoleMems(currentUserId, rolename, roleid,
984 : rolemembers, roleSpecsToIds(rolemembers),
985 : InvalidOid, &popt, DROP_RESTRICT);
986 : }
987 :
988 : /*
989 : * Close pg_authid, but keep lock till commit.
990 : */
991 388 : table_close(pg_authid_rel, NoLock);
992 :
993 388 : return roleid;
994 : }
995 :
996 :
997 : /*
998 : * ALTER ROLE ... SET
999 : */
1000 : Oid
1001 94 : AlterRoleSet(AlterRoleSetStmt *stmt)
1002 : {
1003 : HeapTuple roletuple;
1004 : Form_pg_authid roleform;
1005 94 : Oid databaseid = InvalidOid;
1006 94 : Oid roleid = InvalidOid;
1007 :
1008 94 : if (stmt->role)
1009 : {
1010 86 : check_rolespec_name(stmt->role,
1011 86 : _("Cannot alter reserved roles."));
1012 :
1013 86 : roletuple = get_rolespec_tuple(stmt->role);
1014 78 : roleform = (Form_pg_authid) GETSTRUCT(roletuple);
1015 78 : roleid = roleform->oid;
1016 :
1017 : /*
1018 : * Obtain a lock on the role and make sure it didn't go away in the
1019 : * meantime.
1020 : */
1021 78 : shdepLockAndCheckObject(AuthIdRelationId, roleid);
1022 :
1023 : /*
1024 : * To mess with a superuser you gotta be superuser; otherwise you need
1025 : * CREATEROLE plus admin option on the target role; unless you're just
1026 : * trying to change your own settings
1027 : */
1028 78 : if (roleform->rolsuper)
1029 : {
1030 32 : if (!superuser())
1031 0 : ereport(ERROR,
1032 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
1033 : errmsg("permission denied to alter role"),
1034 : errdetail("Only roles with the %s attribute may alter roles with the %s attribute.",
1035 : "SUPERUSER", "SUPERUSER")));
1036 : }
1037 : else
1038 : {
1039 46 : if ((!have_createrole_privilege() ||
1040 36 : !is_admin_of_role(GetUserId(), roleid))
1041 10 : && roleid != GetUserId())
1042 0 : ereport(ERROR,
1043 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
1044 : errmsg("permission denied to alter role"),
1045 : errdetail("Only roles with the %s attribute and the %s option on role \"%s\" may alter this role.",
1046 : "CREATEROLE", "ADMIN", NameStr(roleform->rolname))));
1047 : }
1048 :
1049 78 : ReleaseSysCache(roletuple);
1050 : }
1051 :
1052 : /* look up and lock the database, if specified */
1053 86 : if (stmt->database != NULL)
1054 : {
1055 4 : databaseid = get_database_oid(stmt->database, false);
1056 4 : shdepLockAndCheckObject(DatabaseRelationId, databaseid);
1057 :
1058 4 : if (!stmt->role)
1059 : {
1060 : /*
1061 : * If no role is specified, then this is effectively the same as
1062 : * ALTER DATABASE ... SET, so use the same permission check.
1063 : */
1064 0 : if (!object_ownercheck(DatabaseRelationId, databaseid, GetUserId()))
1065 0 : aclcheck_error(ACLCHECK_NOT_OWNER, OBJECT_DATABASE,
1066 0 : stmt->database);
1067 : }
1068 : }
1069 :
1070 86 : if (!stmt->role && !stmt->database)
1071 : {
1072 : /* Must be superuser to alter settings globally. */
1073 8 : if (!superuser())
1074 0 : ereport(ERROR,
1075 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
1076 : errmsg("permission denied to alter setting"),
1077 : errdetail("Only roles with the %s attribute may alter settings globally.",
1078 : "SUPERUSER")));
1079 : }
1080 :
1081 86 : AlterSetting(databaseid, roleid, stmt->setstmt);
1082 :
1083 82 : return roleid;
1084 : }
1085 :
1086 :
1087 : /*
1088 : * DROP ROLE
1089 : */
1090 : void
1091 1770 : DropRole(DropRoleStmt *stmt)
1092 : {
1093 : Relation pg_authid_rel,
1094 : pg_auth_members_rel;
1095 : ListCell *item;
1096 1770 : List *role_oids = NIL;
1097 :
1098 1770 : if (!have_createrole_privilege())
1099 0 : ereport(ERROR,
1100 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
1101 : errmsg("permission denied to drop role"),
1102 : errdetail("Only roles with the %s attribute and the %s option on the target roles may drop roles.",
1103 : "CREATEROLE", "ADMIN")));
1104 :
1105 : /*
1106 : * Scan the pg_authid relation to find the Oid of the role(s) to be
1107 : * deleted and perform preliminary permissions and sanity checks.
1108 : */
1109 1770 : pg_authid_rel = table_open(AuthIdRelationId, RowExclusiveLock);
1110 1770 : pg_auth_members_rel = table_open(AuthMemRelationId, RowExclusiveLock);
1111 :
1112 3542 : foreach(item, stmt->roles)
1113 : {
1114 1880 : RoleSpec *rolspec = lfirst(item);
1115 : char *role;
1116 : HeapTuple tuple,
1117 : tmp_tuple;
1118 : Form_pg_authid roleform;
1119 : ScanKeyData scankey;
1120 : SysScanDesc sscan;
1121 : Oid roleid;
1122 :
1123 1880 : if (rolspec->roletype != ROLESPEC_CSTRING)
1124 0 : ereport(ERROR,
1125 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
1126 : errmsg("cannot use special role specifier in DROP ROLE")));
1127 1880 : role = rolspec->rolename;
1128 :
1129 1880 : tuple = SearchSysCache1(AUTHNAME, PointerGetDatum(role));
1130 1880 : if (!HeapTupleIsValid(tuple))
1131 : {
1132 300 : if (!stmt->missing_ok)
1133 : {
1134 90 : ereport(ERROR,
1135 : (errcode(ERRCODE_UNDEFINED_OBJECT),
1136 : errmsg("role \"%s\" does not exist", role)));
1137 : }
1138 : else
1139 : {
1140 210 : ereport(NOTICE,
1141 : (errmsg("role \"%s\" does not exist, skipping",
1142 : role)));
1143 : }
1144 :
1145 210 : continue;
1146 : }
1147 :
1148 1580 : roleform = (Form_pg_authid) GETSTRUCT(tuple);
1149 1580 : roleid = roleform->oid;
1150 :
1151 1580 : if (roleid == GetUserId())
1152 6 : ereport(ERROR,
1153 : (errcode(ERRCODE_OBJECT_IN_USE),
1154 : errmsg("current user cannot be dropped")));
1155 1574 : if (roleid == GetOuterUserId())
1156 0 : ereport(ERROR,
1157 : (errcode(ERRCODE_OBJECT_IN_USE),
1158 : errmsg("current user cannot be dropped")));
1159 1574 : if (roleid == GetSessionUserId())
1160 0 : ereport(ERROR,
1161 : (errcode(ERRCODE_OBJECT_IN_USE),
1162 : errmsg("session user cannot be dropped")));
1163 :
1164 : /*
1165 : * For safety's sake, we allow createrole holders to drop ordinary
1166 : * roles but not superuser roles, and only if they also have ADMIN
1167 : * OPTION.
1168 : */
1169 1574 : if (roleform->rolsuper && !superuser())
1170 6 : ereport(ERROR,
1171 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
1172 : errmsg("permission denied to drop role"),
1173 : errdetail("Only roles with the %s attribute may drop roles with the %s attribute.",
1174 : "SUPERUSER", "SUPERUSER")));
1175 1568 : if (!is_admin_of_role(GetUserId(), roleid))
1176 6 : ereport(ERROR,
1177 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
1178 : errmsg("permission denied to drop role"),
1179 : errdetail("Only roles with the %s attribute and the %s option on role \"%s\" may drop this role.",
1180 : "CREATEROLE", "ADMIN", NameStr(roleform->rolname))));
1181 :
1182 : /* DROP hook for the role being removed */
1183 1562 : InvokeObjectDropHook(AuthIdRelationId, roleid, 0);
1184 :
1185 : /* Don't leak the syscache tuple */
1186 1562 : ReleaseSysCache(tuple);
1187 :
1188 : /*
1189 : * Lock the role, so nobody can add dependencies to her while we drop
1190 : * her. We keep the lock until the end of transaction.
1191 : */
1192 1562 : LockSharedObject(AuthIdRelationId, roleid, 0, AccessExclusiveLock);
1193 :
1194 : /*
1195 : * If there is a pg_auth_members entry that has one of the roles to be
1196 : * dropped as the roleid or member, it should be silently removed, but
1197 : * if there is a pg_auth_members entry that has one of the roles to be
1198 : * dropped as the grantor, the operation should fail.
1199 : *
1200 : * It's possible, however, that a single pg_auth_members entry could
1201 : * fall into multiple categories - e.g. the user could do "GRANT foo
1202 : * TO bar GRANTED BY baz" and then "DROP ROLE baz, bar". We want such
1203 : * an operation to succeed regardless of the order in which the
1204 : * to-be-dropped roles are passed to DROP ROLE.
1205 : *
1206 : * To make that work, we remove all pg_auth_members entries that can
1207 : * be silently removed in this loop, and then below we'll make a
1208 : * second pass over the list of roles to be removed and check for any
1209 : * remaining dependencies.
1210 : */
1211 1562 : ScanKeyInit(&scankey,
1212 : Anum_pg_auth_members_roleid,
1213 : BTEqualStrategyNumber, F_OIDEQ,
1214 : ObjectIdGetDatum(roleid));
1215 :
1216 1562 : sscan = systable_beginscan(pg_auth_members_rel, AuthMemRoleMemIndexId,
1217 : true, NULL, 1, &scankey);
1218 :
1219 1812 : while (HeapTupleIsValid(tmp_tuple = systable_getnext(sscan)))
1220 : {
1221 : Form_pg_auth_members authmem_form;
1222 :
1223 250 : authmem_form = (Form_pg_auth_members) GETSTRUCT(tmp_tuple);
1224 250 : deleteSharedDependencyRecordsFor(AuthMemRelationId,
1225 : authmem_form->oid, 0);
1226 250 : CatalogTupleDelete(pg_auth_members_rel, &tmp_tuple->t_self);
1227 : }
1228 :
1229 1562 : systable_endscan(sscan);
1230 :
1231 1562 : ScanKeyInit(&scankey,
1232 : Anum_pg_auth_members_member,
1233 : BTEqualStrategyNumber, F_OIDEQ,
1234 : ObjectIdGetDatum(roleid));
1235 :
1236 1562 : sscan = systable_beginscan(pg_auth_members_rel, AuthMemMemRoleIndexId,
1237 : true, NULL, 1, &scankey);
1238 :
1239 1830 : while (HeapTupleIsValid(tmp_tuple = systable_getnext(sscan)))
1240 : {
1241 : Form_pg_auth_members authmem_form;
1242 :
1243 268 : authmem_form = (Form_pg_auth_members) GETSTRUCT(tmp_tuple);
1244 268 : deleteSharedDependencyRecordsFor(AuthMemRelationId,
1245 : authmem_form->oid, 0);
1246 268 : CatalogTupleDelete(pg_auth_members_rel, &tmp_tuple->t_self);
1247 : }
1248 :
1249 1562 : systable_endscan(sscan);
1250 :
1251 : /*
1252 : * Advance command counter so that later iterations of this loop will
1253 : * see the changes already made. This is essential if, for example,
1254 : * we are trying to drop both a role and one of its direct members ---
1255 : * we'll get an error if we try to delete the linking pg_auth_members
1256 : * tuple twice. (We do not need a CCI between the two delete loops
1257 : * above, because it's not allowed for a role to directly contain
1258 : * itself.)
1259 : */
1260 1562 : CommandCounterIncrement();
1261 :
1262 : /* Looks tentatively OK, add it to the list if not there yet. */
1263 1562 : role_oids = list_append_unique_oid(role_oids, roleid);
1264 : }
1265 :
1266 : /*
1267 : * Second pass over the roles to be removed.
1268 : */
1269 3094 : foreach(item, role_oids)
1270 : {
1271 1556 : Oid roleid = lfirst_oid(item);
1272 : HeapTuple tuple;
1273 : Form_pg_authid roleform;
1274 : char *detail;
1275 : char *detail_log;
1276 :
1277 : /*
1278 : * Re-find the pg_authid tuple.
1279 : *
1280 : * Since we've taken a lock on the role OID, it shouldn't be possible
1281 : * for the tuple to have been deleted -- or for that matter updated --
1282 : * unless the user is manually modifying the system catalogs.
1283 : */
1284 1556 : tuple = SearchSysCache1(AUTHOID, ObjectIdGetDatum(roleid));
1285 1556 : if (!HeapTupleIsValid(tuple))
1286 0 : elog(ERROR, "could not find tuple for role %u", roleid);
1287 1556 : roleform = (Form_pg_authid) GETSTRUCT(tuple);
1288 :
1289 : /*
1290 : * Check for pg_shdepend entries depending on this role.
1291 : *
1292 : * This needs to happen after we've completed removing any
1293 : * pg_auth_members entries that can be removed silently, in order to
1294 : * avoid spurious failures. See notes above for more details.
1295 : */
1296 1556 : if (checkSharedDependencies(AuthIdRelationId, roleid,
1297 : &detail, &detail_log))
1298 124 : ereport(ERROR,
1299 : (errcode(ERRCODE_DEPENDENT_OBJECTS_STILL_EXIST),
1300 : errmsg("role \"%s\" cannot be dropped because some objects depend on it",
1301 : NameStr(roleform->rolname)),
1302 : errdetail_internal("%s", detail),
1303 : errdetail_log("%s", detail_log)));
1304 :
1305 : /*
1306 : * Remove the role from the pg_authid table
1307 : */
1308 1432 : CatalogTupleDelete(pg_authid_rel, &tuple->t_self);
1309 :
1310 1432 : ReleaseSysCache(tuple);
1311 :
1312 : /*
1313 : * Remove any comments or security labels on this role.
1314 : */
1315 1432 : DeleteSharedComments(roleid, AuthIdRelationId);
1316 1432 : DeleteSharedSecurityLabel(roleid, AuthIdRelationId);
1317 :
1318 : /*
1319 : * Remove settings for this role.
1320 : */
1321 1432 : DropSetting(InvalidOid, roleid);
1322 : }
1323 :
1324 : /*
1325 : * Now we can clean up; but keep locks until commit.
1326 : */
1327 1538 : table_close(pg_auth_members_rel, NoLock);
1328 1538 : table_close(pg_authid_rel, NoLock);
1329 1538 : }
1330 :
1331 : /*
1332 : * Rename role
1333 : */
1334 : ObjectAddress
1335 32 : RenameRole(const char *oldname, const char *newname)
1336 : {
1337 : HeapTuple oldtuple,
1338 : newtuple;
1339 : TupleDesc dsc;
1340 : Relation rel;
1341 : Datum datum;
1342 : bool isnull;
1343 : Datum repl_val[Natts_pg_authid];
1344 : bool repl_null[Natts_pg_authid];
1345 : bool repl_repl[Natts_pg_authid];
1346 : int i;
1347 : Oid roleid;
1348 : ObjectAddress address;
1349 : Form_pg_authid authform;
1350 :
1351 32 : rel = table_open(AuthIdRelationId, RowExclusiveLock);
1352 32 : dsc = RelationGetDescr(rel);
1353 :
1354 32 : oldtuple = SearchSysCache1(AUTHNAME, CStringGetDatum(oldname));
1355 32 : if (!HeapTupleIsValid(oldtuple))
1356 0 : ereport(ERROR,
1357 : (errcode(ERRCODE_UNDEFINED_OBJECT),
1358 : errmsg("role \"%s\" does not exist", oldname)));
1359 :
1360 : /*
1361 : * XXX Client applications probably store the session user somewhere, so
1362 : * renaming it could cause confusion. On the other hand, there may not be
1363 : * an actual problem besides a little confusion, so think about this and
1364 : * decide. Same for SET ROLE ... we don't restrict renaming the current
1365 : * effective userid, though.
1366 : */
1367 :
1368 32 : authform = (Form_pg_authid) GETSTRUCT(oldtuple);
1369 32 : roleid = authform->oid;
1370 :
1371 32 : if (roleid == GetSessionUserId())
1372 0 : ereport(ERROR,
1373 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
1374 : errmsg("session user cannot be renamed")));
1375 32 : if (roleid == GetOuterUserId())
1376 0 : ereport(ERROR,
1377 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
1378 : errmsg("current user cannot be renamed")));
1379 :
1380 : /*
1381 : * Check that the user is not trying to rename a system role and not
1382 : * trying to rename a role into the reserved "pg_" namespace.
1383 : */
1384 32 : if (IsReservedName(NameStr(authform->rolname)))
1385 0 : ereport(ERROR,
1386 : (errcode(ERRCODE_RESERVED_NAME),
1387 : errmsg("role name \"%s\" is reserved",
1388 : NameStr(authform->rolname)),
1389 : errdetail("Role names starting with \"pg_\" are reserved.")));
1390 :
1391 32 : if (IsReservedName(newname))
1392 0 : ereport(ERROR,
1393 : (errcode(ERRCODE_RESERVED_NAME),
1394 : errmsg("role name \"%s\" is reserved",
1395 : newname),
1396 : errdetail("Role names starting with \"pg_\" are reserved.")));
1397 :
1398 : /*
1399 : * If built with appropriate switch, whine when regression-testing
1400 : * conventions for role names are violated.
1401 : */
1402 : #ifdef ENFORCE_REGRESSION_TEST_NAME_RESTRICTIONS
1403 : if (strncmp(newname, "regress_", 8) != 0)
1404 : elog(WARNING, "roles created by regression test cases should have names starting with \"regress_\"");
1405 : #endif
1406 :
1407 : /* make sure the new name doesn't exist */
1408 32 : if (SearchSysCacheExists1(AUTHNAME, CStringGetDatum(newname)))
1409 0 : ereport(ERROR,
1410 : (errcode(ERRCODE_DUPLICATE_OBJECT),
1411 : errmsg("role \"%s\" already exists", newname)));
1412 :
1413 : /*
1414 : * Only superusers can mess with superusers. Otherwise, a user with
1415 : * CREATEROLE can rename a role for which they have ADMIN OPTION.
1416 : */
1417 32 : if (authform->rolsuper)
1418 : {
1419 6 : if (!superuser())
1420 0 : ereport(ERROR,
1421 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
1422 : errmsg("permission denied to rename role"),
1423 : errdetail("Only roles with the %s attribute may rename roles with the %s attribute.",
1424 : "SUPERUSER", "SUPERUSER")));
1425 : }
1426 : else
1427 : {
1428 26 : if (!have_createrole_privilege() ||
1429 26 : !is_admin_of_role(GetUserId(), roleid))
1430 6 : ereport(ERROR,
1431 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
1432 : errmsg("permission denied to rename role"),
1433 : errdetail("Only roles with the %s attribute and the %s option on role \"%s\" may rename this role.",
1434 : "CREATEROLE", "ADMIN", NameStr(authform->rolname))));
1435 : }
1436 :
1437 : /* OK, construct the modified tuple */
1438 338 : for (i = 0; i < Natts_pg_authid; i++)
1439 312 : repl_repl[i] = false;
1440 :
1441 26 : repl_repl[Anum_pg_authid_rolname - 1] = true;
1442 26 : repl_val[Anum_pg_authid_rolname - 1] = DirectFunctionCall1(namein,
1443 : CStringGetDatum(newname));
1444 26 : repl_null[Anum_pg_authid_rolname - 1] = false;
1445 :
1446 26 : datum = heap_getattr(oldtuple, Anum_pg_authid_rolpassword, dsc, &isnull);
1447 :
1448 26 : if (!isnull && get_password_type(TextDatumGetCString(datum)) == PASSWORD_TYPE_MD5)
1449 : {
1450 : /* MD5 uses the username as salt, so just clear it on a rename */
1451 6 : repl_repl[Anum_pg_authid_rolpassword - 1] = true;
1452 6 : repl_null[Anum_pg_authid_rolpassword - 1] = true;
1453 :
1454 6 : ereport(NOTICE,
1455 : (errmsg("MD5 password cleared because of role rename")));
1456 : }
1457 :
1458 26 : newtuple = heap_modify_tuple(oldtuple, dsc, repl_val, repl_null, repl_repl);
1459 26 : CatalogTupleUpdate(rel, &oldtuple->t_self, newtuple);
1460 :
1461 26 : InvokeObjectPostAlterHook(AuthIdRelationId, roleid, 0);
1462 :
1463 26 : ObjectAddressSet(address, AuthIdRelationId, roleid);
1464 :
1465 26 : ReleaseSysCache(oldtuple);
1466 :
1467 : /*
1468 : * Close pg_authid, but keep lock till commit.
1469 : */
1470 26 : table_close(rel, NoLock);
1471 :
1472 26 : return address;
1473 : }
1474 :
1475 : /*
1476 : * GrantRoleStmt
1477 : *
1478 : * Grant/Revoke roles to/from roles
1479 : */
1480 : void
1481 934 : GrantRole(ParseState *pstate, GrantRoleStmt *stmt)
1482 : {
1483 : Relation pg_authid_rel;
1484 : Oid grantor;
1485 : List *grantee_ids;
1486 : ListCell *item;
1487 : GrantRoleOptions popt;
1488 934 : Oid currentUserId = GetUserId();
1489 :
1490 : /* Parse options list. */
1491 934 : InitGrantRoleOptions(&popt);
1492 1298 : foreach(item, stmt->opt)
1493 : {
1494 364 : DefElem *opt = (DefElem *) lfirst(item);
1495 364 : char *optval = defGetString(opt);
1496 :
1497 364 : if (strcmp(opt->defname, "admin") == 0)
1498 : {
1499 188 : popt.specified |= GRANT_ROLE_SPECIFIED_ADMIN;
1500 :
1501 188 : if (parse_bool(optval, &popt.admin))
1502 188 : continue;
1503 : }
1504 176 : else if (strcmp(opt->defname, "inherit") == 0)
1505 : {
1506 94 : popt.specified |= GRANT_ROLE_SPECIFIED_INHERIT;
1507 94 : if (parse_bool(optval, &popt.inherit))
1508 94 : continue;
1509 : }
1510 82 : else if (strcmp(opt->defname, "set") == 0)
1511 : {
1512 82 : popt.specified |= GRANT_ROLE_SPECIFIED_SET;
1513 82 : if (parse_bool(optval, &popt.set))
1514 82 : continue;
1515 : }
1516 : else
1517 0 : ereport(ERROR,
1518 : errcode(ERRCODE_SYNTAX_ERROR),
1519 : errmsg("unrecognized role option \"%s\"", opt->defname),
1520 : parser_errposition(pstate, opt->location));
1521 :
1522 0 : ereport(ERROR,
1523 : (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
1524 : errmsg("unrecognized value for role option \"%s\": \"%s\"",
1525 : opt->defname, optval),
1526 : parser_errposition(pstate, opt->location)));
1527 : }
1528 :
1529 : /* Lookup OID of grantor, if specified. */
1530 934 : if (stmt->grantor)
1531 120 : grantor = get_rolespec_oid(stmt->grantor, false);
1532 : else
1533 814 : grantor = InvalidOid;
1534 :
1535 928 : grantee_ids = roleSpecsToIds(stmt->grantee_roles);
1536 :
1537 : /* AccessShareLock is enough since we aren't modifying pg_authid */
1538 928 : pg_authid_rel = table_open(AuthIdRelationId, AccessShareLock);
1539 :
1540 : /*
1541 : * Step through all of the granted roles and add, update, or remove
1542 : * entries in pg_auth_members as appropriate. If stmt->is_grant is true,
1543 : * we are adding new grants or, if they already exist, updating options on
1544 : * those grants. If stmt->is_grant is false, we are revoking grants or
1545 : * removing options from them.
1546 : */
1547 1738 : foreach(item, stmt->granted_roles)
1548 : {
1549 930 : AccessPriv *priv = (AccessPriv *) lfirst(item);
1550 930 : char *rolename = priv->priv_name;
1551 : Oid roleid;
1552 :
1553 : /* Must reject priv(columns) and ALL PRIVILEGES(columns) */
1554 930 : if (rolename == NULL || priv->cols != NIL)
1555 0 : ereport(ERROR,
1556 : (errcode(ERRCODE_INVALID_GRANT_OPERATION),
1557 : errmsg("column names cannot be included in GRANT/REVOKE ROLE")));
1558 :
1559 930 : roleid = get_role_oid(rolename, false);
1560 930 : check_role_membership_authorization(currentUserId,
1561 930 : roleid, stmt->is_grant);
1562 840 : if (stmt->is_grant)
1563 690 : AddRoleMems(currentUserId, rolename, roleid,
1564 : stmt->grantee_roles, grantee_ids,
1565 : grantor, &popt);
1566 : else
1567 150 : DelRoleMems(currentUserId, rolename, roleid,
1568 : stmt->grantee_roles, grantee_ids,
1569 : grantor, &popt, stmt->behavior);
1570 : }
1571 :
1572 : /*
1573 : * Close pg_authid, but keep lock till commit.
1574 : */
1575 808 : table_close(pg_authid_rel, NoLock);
1576 808 : }
1577 :
1578 : /*
1579 : * DropOwnedObjects
1580 : *
1581 : * Drop the objects owned by a given list of roles.
1582 : */
1583 : void
1584 148 : DropOwnedObjects(DropOwnedStmt *stmt)
1585 : {
1586 148 : List *role_ids = roleSpecsToIds(stmt->roles);
1587 : ListCell *cell;
1588 :
1589 : /* Check privileges */
1590 314 : foreach(cell, role_ids)
1591 : {
1592 178 : Oid roleid = lfirst_oid(cell);
1593 :
1594 178 : if (!has_privs_of_role(GetUserId(), roleid))
1595 12 : ereport(ERROR,
1596 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
1597 : errmsg("permission denied to drop objects"),
1598 : errdetail("Only roles with privileges of role \"%s\" may drop objects owned by it.",
1599 : GetUserNameFromId(roleid, false))));
1600 : }
1601 :
1602 : /* Ok, do it */
1603 136 : shdepDropOwned(role_ids, stmt->behavior);
1604 130 : }
1605 :
1606 : /*
1607 : * ReassignOwnedObjects
1608 : *
1609 : * Give the objects owned by a given list of roles away to another user.
1610 : */
1611 : void
1612 46 : ReassignOwnedObjects(ReassignOwnedStmt *stmt)
1613 : {
1614 46 : List *role_ids = roleSpecsToIds(stmt->roles);
1615 : ListCell *cell;
1616 : Oid newrole;
1617 :
1618 : /* Check privileges */
1619 80 : foreach(cell, role_ids)
1620 : {
1621 46 : Oid roleid = lfirst_oid(cell);
1622 :
1623 46 : if (!has_privs_of_role(GetUserId(), roleid))
1624 12 : ereport(ERROR,
1625 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
1626 : errmsg("permission denied to reassign objects"),
1627 : errdetail("Only roles with privileges of role \"%s\" may reassign objects owned by it.",
1628 : GetUserNameFromId(roleid, false))));
1629 : }
1630 :
1631 : /* Must have privileges on the receiving side too */
1632 34 : newrole = get_rolespec_oid(stmt->newrole, false);
1633 :
1634 34 : if (!has_privs_of_role(GetUserId(), newrole))
1635 6 : ereport(ERROR,
1636 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
1637 : errmsg("permission denied to reassign objects"),
1638 : errdetail("Only roles with privileges of role \"%s\" may reassign objects to it.",
1639 : GetUserNameFromId(newrole, false))));
1640 :
1641 : /* Ok, do it */
1642 28 : shdepReassignOwned(role_ids, newrole);
1643 28 : }
1644 :
1645 : /*
1646 : * roleSpecsToIds
1647 : *
1648 : * Given a list of RoleSpecs, generate a list of role OIDs in the same order.
1649 : *
1650 : * ROLESPEC_PUBLIC is not allowed.
1651 : */
1652 : List *
1653 4764 : roleSpecsToIds(List *memberNames)
1654 : {
1655 4764 : List *result = NIL;
1656 : ListCell *l;
1657 :
1658 6084 : foreach(l, memberNames)
1659 : {
1660 1320 : RoleSpec *rolespec = lfirst_node(RoleSpec, l);
1661 : Oid roleid;
1662 :
1663 1320 : roleid = get_rolespec_oid(rolespec, false);
1664 1320 : result = lappend_oid(result, roleid);
1665 : }
1666 4764 : return result;
1667 : }
1668 :
1669 : /*
1670 : * AddRoleMems -- Add given members to the specified role
1671 : *
1672 : * currentUserId: OID of role performing the operation
1673 : * rolename: name of role to add to (used only for error messages)
1674 : * roleid: OID of role to add to
1675 : * memberSpecs: list of RoleSpec of roles to add (used only for error messages)
1676 : * memberIds: OIDs of roles to add
1677 : * grantorId: OID that should be recorded as having granted the membership
1678 : * (InvalidOid if not set explicitly)
1679 : * popt: information about grant options
1680 : */
1681 : static void
1682 4444 : AddRoleMems(Oid currentUserId, const char *rolename, Oid roleid,
1683 : List *memberSpecs, List *memberIds,
1684 : Oid grantorId, GrantRoleOptions *popt)
1685 : {
1686 : Relation pg_authmem_rel;
1687 : TupleDesc pg_authmem_dsc;
1688 : ListCell *specitem;
1689 : ListCell *iditem;
1690 :
1691 : Assert(list_length(memberSpecs) == list_length(memberIds));
1692 :
1693 : /* Validate grantor (and resolve implicit grantor if not specified). */
1694 4444 : grantorId = check_role_grantor(currentUserId, roleid, grantorId, true);
1695 :
1696 4438 : pg_authmem_rel = table_open(AuthMemRelationId, RowExclusiveLock);
1697 4438 : pg_authmem_dsc = RelationGetDescr(pg_authmem_rel);
1698 :
1699 : /*
1700 : * Only allow changes to this role by one backend at a time, so that we
1701 : * can check integrity constraints like the lack of circular ADMIN OPTION
1702 : * grants without fear of race conditions.
1703 : */
1704 4438 : LockSharedObject(AuthIdRelationId, roleid, 0,
1705 : ShareUpdateExclusiveLock);
1706 :
1707 : /* Preliminary sanity checks. */
1708 5414 : forboth(specitem, memberSpecs, iditem, memberIds)
1709 : {
1710 994 : RoleSpec *memberRole = lfirst_node(RoleSpec, specitem);
1711 994 : Oid memberid = lfirst_oid(iditem);
1712 :
1713 : /*
1714 : * pg_database_owner is never a role member. Lifting this restriction
1715 : * would require a policy decision about membership loops. One could
1716 : * prevent loops, which would include making "ALTER DATABASE x OWNER
1717 : * TO proposed_datdba" fail if is_member_of_role(pg_database_owner,
1718 : * proposed_datdba). Hence, gaining a membership could reduce what a
1719 : * role could do. Alternately, one could allow these memberships to
1720 : * complete loops. A role could then have actual WITH ADMIN OPTION on
1721 : * itself, prompting a decision about is_admin_of_role() treatment of
1722 : * the case.
1723 : *
1724 : * Lifting this restriction also has policy implications for ownership
1725 : * of shared objects (databases and tablespaces). We allow such
1726 : * ownership, but we might find cause to ban it in the future.
1727 : * Designing such a ban would more troublesome if the design had to
1728 : * address pg_database_owner being a member of role FOO that owns a
1729 : * shared object. (The effect of such ownership is that any owner of
1730 : * another database can act as the owner of affected shared objects.)
1731 : */
1732 994 : if (memberid == ROLE_PG_DATABASE_OWNER)
1733 6 : ereport(ERROR,
1734 : errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
1735 : errmsg("role \"%s\" cannot be a member of any role",
1736 : get_rolespec_name(memberRole)));
1737 :
1738 : /*
1739 : * Refuse creation of membership loops, including the trivial case
1740 : * where a role is made a member of itself. We do this by checking to
1741 : * see if the target role is already a member of the proposed member
1742 : * role. We have to ignore possible superuserness, however, else we
1743 : * could never grant membership in a superuser-privileged role.
1744 : */
1745 988 : if (is_member_of_role_nosuper(roleid, memberid))
1746 12 : ereport(ERROR,
1747 : (errcode(ERRCODE_INVALID_GRANT_OPERATION),
1748 : errmsg("role \"%s\" is a member of role \"%s\"",
1749 : rolename, get_rolespec_name(memberRole))));
1750 : }
1751 :
1752 : /*
1753 : * Disallow attempts to grant ADMIN OPTION back to a user who granted it
1754 : * to you, similar to what check_circularity does for ACLs. We want the
1755 : * chains of grants to remain acyclic, so that it's always possible to use
1756 : * REVOKE .. CASCADE to clean up all grants that depend on the one being
1757 : * revoked.
1758 : *
1759 : * NB: This check might look redundant with the check for membership loops
1760 : * above, but it isn't. That's checking for role-member loop (e.g. A is a
1761 : * member of B and B is a member of A) while this is checking for a
1762 : * member-grantor loop (e.g. A gave ADMIN OPTION on X to B and now B, who
1763 : * has no other source of ADMIN OPTION on X, tries to give ADMIN OPTION on
1764 : * X back to A).
1765 : */
1766 4420 : if (popt->admin && grantorId != BOOTSTRAP_SUPERUSERID)
1767 : {
1768 : CatCList *memlist;
1769 : RevokeRoleGrantAction *actions;
1770 : int i;
1771 :
1772 : /* Get the list of members for this role. */
1773 144 : memlist = SearchSysCacheList1(AUTHMEMROLEMEM,
1774 : ObjectIdGetDatum(roleid));
1775 :
1776 : /*
1777 : * Figure out what would happen if we removed all existing grants to
1778 : * every role to which we've been asked to make a new grant.
1779 : */
1780 144 : actions = initialize_revoke_actions(memlist);
1781 228 : foreach(iditem, memberIds)
1782 : {
1783 84 : Oid memberid = lfirst_oid(iditem);
1784 :
1785 84 : if (memberid == BOOTSTRAP_SUPERUSERID)
1786 0 : ereport(ERROR,
1787 : (errcode(ERRCODE_INVALID_GRANT_OPERATION),
1788 : errmsg("%s option cannot be granted back to your own grantor",
1789 : "ADMIN")));
1790 84 : plan_member_revoke(memlist, actions, memberid);
1791 : }
1792 :
1793 : /*
1794 : * If the result would be that the grantor role would no longer have
1795 : * the ability to perform the grant, then the proposed grant would
1796 : * create a circularity.
1797 : */
1798 174 : for (i = 0; i < memlist->n_members; ++i)
1799 : {
1800 : HeapTuple authmem_tuple;
1801 : Form_pg_auth_members authmem_form;
1802 :
1803 168 : authmem_tuple = &memlist->members[i]->tuple;
1804 168 : authmem_form = (Form_pg_auth_members) GETSTRUCT(authmem_tuple);
1805 :
1806 168 : if (actions[i] == RRG_NOOP &&
1807 156 : authmem_form->member == grantorId &&
1808 138 : authmem_form->admin_option)
1809 138 : break;
1810 : }
1811 144 : if (i >= memlist->n_members)
1812 6 : ereport(ERROR,
1813 : (errcode(ERRCODE_INVALID_GRANT_OPERATION),
1814 : errmsg("%s option cannot be granted back to your own grantor",
1815 : "ADMIN")));
1816 :
1817 138 : ReleaseSysCacheList(memlist);
1818 : }
1819 :
1820 : /* Now perform the catalog updates. */
1821 5384 : forboth(specitem, memberSpecs, iditem, memberIds)
1822 : {
1823 970 : RoleSpec *memberRole = lfirst_node(RoleSpec, specitem);
1824 970 : Oid memberid = lfirst_oid(iditem);
1825 : HeapTuple authmem_tuple;
1826 : HeapTuple tuple;
1827 970 : Datum new_record[Natts_pg_auth_members] = {0};
1828 970 : bool new_record_nulls[Natts_pg_auth_members] = {0};
1829 970 : bool new_record_repl[Natts_pg_auth_members] = {0};
1830 :
1831 : /* Common initialization for possible insert or update */
1832 970 : new_record[Anum_pg_auth_members_roleid - 1] =
1833 970 : ObjectIdGetDatum(roleid);
1834 970 : new_record[Anum_pg_auth_members_member - 1] =
1835 970 : ObjectIdGetDatum(memberid);
1836 970 : new_record[Anum_pg_auth_members_grantor - 1] =
1837 970 : ObjectIdGetDatum(grantorId);
1838 :
1839 : /* Find any existing tuple */
1840 970 : authmem_tuple = SearchSysCache3(AUTHMEMROLEMEM,
1841 : ObjectIdGetDatum(roleid),
1842 : ObjectIdGetDatum(memberid),
1843 : ObjectIdGetDatum(grantorId));
1844 :
1845 : /*
1846 : * If we found a tuple, update it with new option values, unless there
1847 : * are no changes, in which case issue a WARNING.
1848 : *
1849 : * If we didn't find a tuple, just insert one.
1850 : */
1851 970 : if (HeapTupleIsValid(authmem_tuple))
1852 : {
1853 : Form_pg_auth_members authmem_form;
1854 34 : bool at_least_one_change = false;
1855 :
1856 34 : authmem_form = (Form_pg_auth_members) GETSTRUCT(authmem_tuple);
1857 :
1858 34 : if ((popt->specified & GRANT_ROLE_SPECIFIED_ADMIN) != 0
1859 0 : && authmem_form->admin_option != popt->admin)
1860 : {
1861 0 : new_record[Anum_pg_auth_members_admin_option - 1] =
1862 0 : BoolGetDatum(popt->admin);
1863 0 : new_record_repl[Anum_pg_auth_members_admin_option - 1] =
1864 : true;
1865 0 : at_least_one_change = true;
1866 : }
1867 :
1868 34 : if ((popt->specified & GRANT_ROLE_SPECIFIED_INHERIT) != 0
1869 16 : && authmem_form->inherit_option != popt->inherit)
1870 : {
1871 16 : new_record[Anum_pg_auth_members_inherit_option - 1] =
1872 16 : BoolGetDatum(popt->inherit);
1873 16 : new_record_repl[Anum_pg_auth_members_inherit_option - 1] =
1874 : true;
1875 16 : at_least_one_change = true;
1876 : }
1877 :
1878 34 : if ((popt->specified & GRANT_ROLE_SPECIFIED_SET) != 0
1879 10 : && authmem_form->set_option != popt->set)
1880 : {
1881 10 : new_record[Anum_pg_auth_members_set_option - 1] =
1882 10 : BoolGetDatum(popt->set);
1883 10 : new_record_repl[Anum_pg_auth_members_set_option - 1] =
1884 : true;
1885 10 : at_least_one_change = true;
1886 : }
1887 :
1888 34 : if (!at_least_one_change)
1889 : {
1890 18 : ereport(NOTICE,
1891 : (errmsg("role \"%s\" has already been granted membership in role \"%s\" by role \"%s\"",
1892 : get_rolespec_name(memberRole), rolename,
1893 : GetUserNameFromId(grantorId, false))));
1894 18 : ReleaseSysCache(authmem_tuple);
1895 18 : continue;
1896 : }
1897 :
1898 16 : tuple = heap_modify_tuple(authmem_tuple, pg_authmem_dsc,
1899 : new_record,
1900 : new_record_nulls, new_record_repl);
1901 16 : CatalogTupleUpdate(pg_authmem_rel, &tuple->t_self, tuple);
1902 :
1903 16 : ReleaseSysCache(authmem_tuple);
1904 : }
1905 : else
1906 : {
1907 : Oid objectId;
1908 936 : Oid *newmembers = palloc_object(Oid);
1909 :
1910 : /*
1911 : * The values for these options can be taken directly from 'popt'.
1912 : * Either they were specified, or the defaults as set by
1913 : * InitGrantRoleOptions are correct.
1914 : */
1915 936 : new_record[Anum_pg_auth_members_admin_option - 1] =
1916 936 : BoolGetDatum(popt->admin);
1917 936 : new_record[Anum_pg_auth_members_set_option - 1] =
1918 936 : BoolGetDatum(popt->set);
1919 :
1920 : /*
1921 : * If the user specified a value for the inherit option, use
1922 : * whatever was specified. Otherwise, set the default value based
1923 : * on the role-level property.
1924 : */
1925 936 : if ((popt->specified & GRANT_ROLE_SPECIFIED_INHERIT) != 0)
1926 194 : new_record[Anum_pg_auth_members_inherit_option - 1] =
1927 194 : BoolGetDatum(popt->inherit);
1928 : else
1929 : {
1930 : HeapTuple mrtup;
1931 : Form_pg_authid mrform;
1932 :
1933 742 : mrtup = SearchSysCache1(AUTHOID, ObjectIdGetDatum(memberid));
1934 742 : if (!HeapTupleIsValid(mrtup))
1935 0 : elog(ERROR, "cache lookup failed for role %u", memberid);
1936 742 : mrform = (Form_pg_authid) GETSTRUCT(mrtup);
1937 742 : new_record[Anum_pg_auth_members_inherit_option - 1] =
1938 742 : BoolGetDatum(mrform->rolinherit);
1939 742 : ReleaseSysCache(mrtup);
1940 : }
1941 :
1942 : /* get an OID for the new row and insert it */
1943 936 : objectId = GetNewOidWithIndex(pg_authmem_rel, AuthMemOidIndexId,
1944 : Anum_pg_auth_members_oid);
1945 936 : new_record[Anum_pg_auth_members_oid - 1] = ObjectIdGetDatum(objectId);
1946 936 : tuple = heap_form_tuple(pg_authmem_dsc,
1947 : new_record, new_record_nulls);
1948 936 : CatalogTupleInsert(pg_authmem_rel, tuple);
1949 :
1950 : /* updateAclDependencies wants to pfree array inputs */
1951 936 : newmembers[0] = grantorId;
1952 936 : updateAclDependencies(AuthMemRelationId, objectId,
1953 : 0, InvalidOid,
1954 : 0, NULL,
1955 : 1, newmembers);
1956 : }
1957 :
1958 : /* CCI after each change, in case there are duplicates in list */
1959 952 : CommandCounterIncrement();
1960 : }
1961 :
1962 : /*
1963 : * Close pg_authmem, but keep lock till commit.
1964 : */
1965 4414 : table_close(pg_authmem_rel, NoLock);
1966 4414 : }
1967 :
1968 : /*
1969 : * DelRoleMems -- Remove given members from the specified role
1970 : *
1971 : * rolename: name of role to del from (used only for error messages)
1972 : * roleid: OID of role to del from
1973 : * memberSpecs: list of RoleSpec of roles to del (used only for error messages)
1974 : * memberIds: OIDs of roles to del
1975 : * grantorId: who is revoking the membership
1976 : * popt: information about grant options
1977 : * behavior: RESTRICT or CASCADE behavior for recursive removal
1978 : */
1979 : static void
1980 162 : DelRoleMems(Oid currentUserId, const char *rolename, Oid roleid,
1981 : List *memberSpecs, List *memberIds,
1982 : Oid grantorId, GrantRoleOptions *popt, DropBehavior behavior)
1983 : {
1984 : Relation pg_authmem_rel;
1985 : TupleDesc pg_authmem_dsc;
1986 : ListCell *specitem;
1987 : ListCell *iditem;
1988 : CatCList *memlist;
1989 : RevokeRoleGrantAction *actions;
1990 : int i;
1991 :
1992 : Assert(list_length(memberSpecs) == list_length(memberIds));
1993 :
1994 : /* Validate grantor (and resolve implicit grantor if not specified). */
1995 162 : grantorId = check_role_grantor(currentUserId, roleid, grantorId, false);
1996 :
1997 162 : pg_authmem_rel = table_open(AuthMemRelationId, RowExclusiveLock);
1998 162 : pg_authmem_dsc = RelationGetDescr(pg_authmem_rel);
1999 :
2000 : /*
2001 : * Only allow changes to this role by one backend at a time, so that we
2002 : * can check for things like dependent privileges without fear of race
2003 : * conditions.
2004 : */
2005 162 : LockSharedObject(AuthIdRelationId, roleid, 0,
2006 : ShareUpdateExclusiveLock);
2007 :
2008 162 : memlist = SearchSysCacheList1(AUTHMEMROLEMEM, ObjectIdGetDatum(roleid));
2009 162 : actions = initialize_revoke_actions(memlist);
2010 :
2011 : /*
2012 : * We may need to recurse to dependent privileges if DROP_CASCADE was
2013 : * specified, or refuse to perform the operation if dependent privileges
2014 : * exist and DROP_RESTRICT was specified. plan_single_revoke() will figure
2015 : * out what to do with each catalog tuple.
2016 : */
2017 312 : forboth(specitem, memberSpecs, iditem, memberIds)
2018 : {
2019 162 : RoleSpec *memberRole = lfirst(specitem);
2020 162 : Oid memberid = lfirst_oid(iditem);
2021 :
2022 162 : if (!plan_single_revoke(memlist, actions, memberid, grantorId,
2023 : popt, behavior))
2024 : {
2025 6 : ereport(WARNING,
2026 : (errmsg("role \"%s\" has not been granted membership in role \"%s\" by role \"%s\"",
2027 : get_rolespec_name(memberRole), rolename,
2028 : GetUserNameFromId(grantorId, false))));
2029 6 : continue;
2030 : }
2031 : }
2032 :
2033 : /*
2034 : * We now know what to do with each catalog tuple: it should either be
2035 : * left alone, deleted, or just have the admin_option flag cleared.
2036 : * Perform the appropriate action in each case.
2037 : */
2038 436 : for (i = 0; i < memlist->n_members; ++i)
2039 : {
2040 : HeapTuple authmem_tuple;
2041 : Form_pg_auth_members authmem_form;
2042 :
2043 286 : if (actions[i] == RRG_NOOP)
2044 124 : continue;
2045 :
2046 162 : authmem_tuple = &memlist->members[i]->tuple;
2047 162 : authmem_form = (Form_pg_auth_members) GETSTRUCT(authmem_tuple);
2048 :
2049 162 : if (actions[i] == RRG_DELETE_GRANT)
2050 : {
2051 : /*
2052 : * Remove the entry altogether, after first removing its
2053 : * dependencies
2054 : */
2055 114 : deleteSharedDependencyRecordsFor(AuthMemRelationId,
2056 : authmem_form->oid, 0);
2057 114 : CatalogTupleDelete(pg_authmem_rel, &authmem_tuple->t_self);
2058 : }
2059 : else
2060 : {
2061 : /* Just turn off the specified option */
2062 : HeapTuple tuple;
2063 48 : Datum new_record[Natts_pg_auth_members] = {0};
2064 48 : bool new_record_nulls[Natts_pg_auth_members] = {0};
2065 48 : bool new_record_repl[Natts_pg_auth_members] = {0};
2066 :
2067 : /* Build a tuple to update with */
2068 48 : if (actions[i] == RRG_REMOVE_ADMIN_OPTION)
2069 : {
2070 30 : new_record[Anum_pg_auth_members_admin_option - 1] =
2071 30 : BoolGetDatum(false);
2072 30 : new_record_repl[Anum_pg_auth_members_admin_option - 1] =
2073 : true;
2074 : }
2075 18 : else if (actions[i] == RRG_REMOVE_INHERIT_OPTION)
2076 : {
2077 12 : new_record[Anum_pg_auth_members_inherit_option - 1] =
2078 12 : BoolGetDatum(false);
2079 12 : new_record_repl[Anum_pg_auth_members_inherit_option - 1] =
2080 : true;
2081 : }
2082 6 : else if (actions[i] == RRG_REMOVE_SET_OPTION)
2083 : {
2084 6 : new_record[Anum_pg_auth_members_set_option - 1] =
2085 6 : BoolGetDatum(false);
2086 6 : new_record_repl[Anum_pg_auth_members_set_option - 1] =
2087 : true;
2088 : }
2089 : else
2090 0 : elog(ERROR, "unknown role revoke action");
2091 :
2092 48 : tuple = heap_modify_tuple(authmem_tuple, pg_authmem_dsc,
2093 : new_record,
2094 : new_record_nulls, new_record_repl);
2095 48 : CatalogTupleUpdate(pg_authmem_rel, &tuple->t_self, tuple);
2096 : }
2097 : }
2098 :
2099 150 : ReleaseSysCacheList(memlist);
2100 :
2101 : /*
2102 : * Close pg_authmem, but keep lock till commit.
2103 : */
2104 150 : table_close(pg_authmem_rel, NoLock);
2105 150 : }
2106 :
2107 : /*
2108 : * Check that currentUserId has permission to modify the membership list for
2109 : * roleid. Throw an error if not.
2110 : */
2111 : static void
2112 1030 : check_role_membership_authorization(Oid currentUserId, Oid roleid,
2113 : bool is_grant)
2114 : {
2115 : /*
2116 : * The charter of pg_database_owner is to have exactly one, implicit,
2117 : * situation-dependent member. There's no technical need for this
2118 : * restriction. (One could lift it and take the further step of making
2119 : * object_ownercheck(DatabaseRelationId, ...) equivalent to
2120 : * has_privs_of_role(roleid, ROLE_PG_DATABASE_OWNER), in which case
2121 : * explicit, situation-independent members could act as the owner of any
2122 : * database.)
2123 : */
2124 1030 : if (is_grant && roleid == ROLE_PG_DATABASE_OWNER)
2125 12 : ereport(ERROR,
2126 : errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
2127 : errmsg("role \"%s\" cannot have explicit members",
2128 : GetUserNameFromId(roleid, false)));
2129 :
2130 : /* To mess with a superuser role, you gotta be superuser. */
2131 1018 : if (superuser_arg(roleid))
2132 : {
2133 16 : if (!superuser_arg(currentUserId))
2134 : {
2135 6 : if (is_grant)
2136 6 : ereport(ERROR,
2137 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
2138 : errmsg("permission denied to grant role \"%s\"",
2139 : GetUserNameFromId(roleid, false)),
2140 : errdetail("Only roles with the %s attribute may grant roles with the %s attribute.",
2141 : "SUPERUSER", "SUPERUSER")));
2142 : else
2143 0 : ereport(ERROR,
2144 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
2145 : errmsg("permission denied to revoke role \"%s\"",
2146 : GetUserNameFromId(roleid, false)),
2147 : errdetail("Only roles with the %s attribute may revoke roles with the %s attribute.",
2148 : "SUPERUSER", "SUPERUSER")));
2149 : }
2150 : }
2151 : else
2152 : {
2153 : /*
2154 : * Otherwise, must have admin option on the role to be changed.
2155 : */
2156 1002 : if (!is_admin_of_role(currentUserId, roleid))
2157 : {
2158 144 : if (is_grant)
2159 144 : ereport(ERROR,
2160 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
2161 : errmsg("permission denied to grant role \"%s\"",
2162 : GetUserNameFromId(roleid, false)),
2163 : errdetail("Only roles with the %s option on role \"%s\" may grant this role.",
2164 : "ADMIN", GetUserNameFromId(roleid, false))));
2165 : else
2166 0 : ereport(ERROR,
2167 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
2168 : errmsg("permission denied to revoke role \"%s\"",
2169 : GetUserNameFromId(roleid, false)),
2170 : errdetail("Only roles with the %s option on role \"%s\" may revoke this role.",
2171 : "ADMIN", GetUserNameFromId(roleid, false))));
2172 : }
2173 : }
2174 868 : }
2175 :
2176 : /*
2177 : * Sanity-check, or infer, the grantor for a GRANT or REVOKE statement
2178 : * targeting a role.
2179 : *
2180 : * The grantor must always be either a role with ADMIN OPTION on the role in
2181 : * which membership is being granted, or the bootstrap superuser. This is
2182 : * similar to the restriction enforced by select_best_grantor, except that
2183 : * roles don't have owners, so we regard the bootstrap superuser as the
2184 : * implicit owner.
2185 : *
2186 : * If the grantor was not explicitly specified by the user, grantorId should
2187 : * be passed as InvalidOid, and this function will infer the user to be
2188 : * recorded as the grantor. In many cases, this will be the current user, but
2189 : * things get more complicated when the current user doesn't possess ADMIN
2190 : * OPTION on the role but rather relies on having SUPERUSER privileges, or
2191 : * on inheriting the privileges of a role which does have ADMIN OPTION. See
2192 : * below for details.
2193 : *
2194 : * If the grantor was specified by the user, then it must be a user that
2195 : * can legally be recorded as the grantor, as per the rule stated above.
2196 : * This is an integrity constraint, not a permissions check, and thus even
2197 : * superusers are subject to this restriction. However, there is also a
2198 : * permissions check: to specify a role as the grantor, the current user
2199 : * must possess the privileges of that role. Superusers will always pass
2200 : * this check, but for non-superusers it may lead to an error.
2201 : *
2202 : * The return value is the OID to be regarded as the grantor when executing
2203 : * the operation.
2204 : */
2205 : static Oid
2206 4606 : check_role_grantor(Oid currentUserId, Oid roleid, Oid grantorId, bool is_grant)
2207 : {
2208 : /* If the grantor ID was not specified, pick one to use. */
2209 4606 : if (!OidIsValid(grantorId))
2210 : {
2211 : /*
2212 : * Grants where the grantor is recorded as the bootstrap superuser do
2213 : * not depend on any other existing grants, so always default to this
2214 : * interpretation when possible.
2215 : */
2216 4366 : if (superuser_arg(currentUserId))
2217 4030 : return BOOTSTRAP_SUPERUSERID;
2218 :
2219 : /*
2220 : * Otherwise, the grantor must either have ADMIN OPTION on the role or
2221 : * inherit the privileges of a role which does. In the former case,
2222 : * record the grantor as the current user; in the latter, pick one of
2223 : * the roles that is "most directly" inherited by the current role
2224 : * (i.e. fewest "hops").
2225 : *
2226 : * (We shouldn't fail to find a best grantor, because we've already
2227 : * established that the current user has permission to perform the
2228 : * operation.)
2229 : */
2230 336 : grantorId = select_best_admin(currentUserId, roleid);
2231 336 : if (!OidIsValid(grantorId))
2232 0 : elog(ERROR, "no possible grantors");
2233 336 : return grantorId;
2234 : }
2235 :
2236 : /*
2237 : * If an explicit grantor is specified, it must be a role whose privileges
2238 : * the current user possesses.
2239 : *
2240 : * It should also be a role that has ADMIN OPTION on the target role, but
2241 : * we check this condition only in case of GRANT. For REVOKE, no matching
2242 : * grant should exist anyway, but if it somehow does, let the user get rid
2243 : * of it.
2244 : */
2245 240 : if (is_grant)
2246 : {
2247 216 : if (!has_privs_of_role(currentUserId, grantorId))
2248 0 : ereport(ERROR,
2249 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
2250 : errmsg("permission denied to grant privileges as role \"%s\"",
2251 : GetUserNameFromId(grantorId, false)),
2252 : errdetail("Only roles with privileges of role \"%s\" may grant privileges as this role.",
2253 : GetUserNameFromId(grantorId, false))));
2254 :
2255 306 : if (grantorId != BOOTSTRAP_SUPERUSERID &&
2256 90 : select_best_admin(grantorId, roleid) != grantorId)
2257 6 : ereport(ERROR,
2258 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
2259 : errmsg("permission denied to grant privileges as role \"%s\"",
2260 : GetUserNameFromId(grantorId, false)),
2261 : errdetail("The grantor must have the %s option on role \"%s\".",
2262 : "ADMIN", GetUserNameFromId(roleid, false))));
2263 : }
2264 : else
2265 : {
2266 24 : if (!has_privs_of_role(currentUserId, grantorId))
2267 0 : ereport(ERROR,
2268 : (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
2269 : errmsg("permission denied to revoke privileges granted by role \"%s\"",
2270 : GetUserNameFromId(grantorId, false)),
2271 : errdetail("Only roles with privileges of role \"%s\" may revoke privileges granted by this role.",
2272 : GetUserNameFromId(grantorId, false))));
2273 : }
2274 :
2275 : /*
2276 : * If a grantor was specified explicitly, always attribute the grant to
2277 : * that role (unless we error out above).
2278 : */
2279 234 : return grantorId;
2280 : }
2281 :
2282 : /*
2283 : * Initialize an array of RevokeRoleGrantAction objects.
2284 : *
2285 : * 'memlist' should be a list of all grants for the target role.
2286 : *
2287 : * This constructs an array indicating that no actions are to be performed;
2288 : * that is, every element is initially RRG_NOOP.
2289 : */
2290 : static RevokeRoleGrantAction *
2291 306 : initialize_revoke_actions(CatCList *memlist)
2292 : {
2293 : RevokeRoleGrantAction *result;
2294 : int i;
2295 :
2296 306 : if (memlist->n_members == 0)
2297 0 : return NULL;
2298 :
2299 306 : result = palloc_array(RevokeRoleGrantAction, memlist->n_members);
2300 832 : for (i = 0; i < memlist->n_members; i++)
2301 526 : result[i] = RRG_NOOP;
2302 306 : return result;
2303 : }
2304 :
2305 : /*
2306 : * Figure out what we would need to do in order to revoke a grant, or just the
2307 : * admin option on a grant, given that there might be dependent privileges.
2308 : *
2309 : * 'memlist' should be a list of all grants for the target role.
2310 : *
2311 : * Whatever actions prove to be necessary will be signalled by updating
2312 : * 'actions'.
2313 : *
2314 : * If behavior is DROP_RESTRICT, an error will occur if there are dependent
2315 : * role membership grants; if DROP_CASCADE, those grants will be scheduled
2316 : * for deletion.
2317 : *
2318 : * The return value is true if the matching grant was found in the list,
2319 : * and false if not.
2320 : */
2321 : static bool
2322 162 : plan_single_revoke(CatCList *memlist, RevokeRoleGrantAction *actions,
2323 : Oid member, Oid grantor, GrantRoleOptions *popt,
2324 : DropBehavior behavior)
2325 : {
2326 : int i;
2327 :
2328 : /*
2329 : * If popt.specified == 0, we're revoking the grant entirely; otherwise,
2330 : * we expect just one bit to be set, and we're revoking the corresponding
2331 : * option. As of this writing, there's no syntax that would allow for an
2332 : * attempt to revoke multiple options at once, and the logic below
2333 : * wouldn't work properly if such syntax were added, so assert that our
2334 : * caller isn't trying to do that.
2335 : */
2336 : Assert(pg_popcount32(popt->specified) <= 1);
2337 :
2338 280 : for (i = 0; i < memlist->n_members; ++i)
2339 : {
2340 : HeapTuple authmem_tuple;
2341 : Form_pg_auth_members authmem_form;
2342 :
2343 274 : authmem_tuple = &memlist->members[i]->tuple;
2344 274 : authmem_form = (Form_pg_auth_members) GETSTRUCT(authmem_tuple);
2345 :
2346 274 : if (authmem_form->member == member &&
2347 174 : authmem_form->grantor == grantor)
2348 : {
2349 156 : if ((popt->specified & GRANT_ROLE_SPECIFIED_INHERIT) != 0)
2350 : {
2351 : /*
2352 : * Revoking the INHERIT option doesn't change anything for
2353 : * dependent privileges, so we don't need to recurse.
2354 : */
2355 12 : actions[i] = RRG_REMOVE_INHERIT_OPTION;
2356 : }
2357 144 : else if ((popt->specified & GRANT_ROLE_SPECIFIED_SET) != 0)
2358 : {
2359 : /* Here too, no need to recurse. */
2360 6 : actions[i] = RRG_REMOVE_SET_OPTION;
2361 : }
2362 : else
2363 : {
2364 : bool revoke_admin_option_only;
2365 :
2366 : /*
2367 : * Revoking the grant entirely, or ADMIN option on a grant,
2368 : * implicates dependent privileges, so we may need to recurse.
2369 : */
2370 138 : revoke_admin_option_only =
2371 138 : (popt->specified & GRANT_ROLE_SPECIFIED_ADMIN) != 0;
2372 138 : plan_recursive_revoke(memlist, actions, i,
2373 : revoke_admin_option_only, behavior);
2374 : }
2375 144 : return true;
2376 : }
2377 : }
2378 :
2379 6 : return false;
2380 : }
2381 :
2382 : /*
2383 : * Figure out what we would need to do in order to revoke all grants to
2384 : * a given member, given that there might be dependent privileges.
2385 : *
2386 : * 'memlist' should be a list of all grants for the target role.
2387 : *
2388 : * Whatever actions prove to be necessary will be signalled by updating
2389 : * 'actions'.
2390 : */
2391 : static void
2392 84 : plan_member_revoke(CatCList *memlist, RevokeRoleGrantAction *actions,
2393 : Oid member)
2394 : {
2395 : int i;
2396 :
2397 186 : for (i = 0; i < memlist->n_members; ++i)
2398 : {
2399 : HeapTuple authmem_tuple;
2400 : Form_pg_auth_members authmem_form;
2401 :
2402 102 : authmem_tuple = &memlist->members[i]->tuple;
2403 102 : authmem_form = (Form_pg_auth_members) GETSTRUCT(authmem_tuple);
2404 :
2405 102 : if (authmem_form->member == member)
2406 6 : plan_recursive_revoke(memlist, actions, i, false, DROP_CASCADE);
2407 : }
2408 84 : }
2409 :
2410 : /*
2411 : * Workhorse for figuring out recursive revocation of role grants.
2412 : *
2413 : * This is similar to what recursive_revoke() does for ACLs.
2414 : */
2415 : static void
2416 168 : plan_recursive_revoke(CatCList *memlist, RevokeRoleGrantAction *actions,
2417 : int index,
2418 : bool revoke_admin_option_only, DropBehavior behavior)
2419 : {
2420 168 : bool would_still_have_admin_option = false;
2421 : HeapTuple authmem_tuple;
2422 : Form_pg_auth_members authmem_form;
2423 : int i;
2424 :
2425 : /* If it's already been done, we can just return. */
2426 168 : if (actions[index] == RRG_DELETE_GRANT)
2427 0 : return;
2428 168 : if (actions[index] == RRG_REMOVE_ADMIN_OPTION &&
2429 : revoke_admin_option_only)
2430 0 : return;
2431 :
2432 : /* Locate tuple data. */
2433 168 : authmem_tuple = &memlist->members[index]->tuple;
2434 168 : authmem_form = (Form_pg_auth_members) GETSTRUCT(authmem_tuple);
2435 :
2436 : /*
2437 : * If the existing tuple does not have admin_option set, then we do not
2438 : * need to recurse. If we're just supposed to clear that bit we don't need
2439 : * to do anything at all; if we're supposed to remove the grant, we need
2440 : * to do something, but only to the tuple, and not any others.
2441 : */
2442 168 : if (!revoke_admin_option_only)
2443 : {
2444 132 : actions[index] = RRG_DELETE_GRANT;
2445 132 : if (!authmem_form->admin_option)
2446 90 : return;
2447 : }
2448 : else
2449 : {
2450 36 : if (!authmem_form->admin_option)
2451 0 : return;
2452 36 : actions[index] = RRG_REMOVE_ADMIN_OPTION;
2453 : }
2454 :
2455 : /* Determine whether the member would still have ADMIN OPTION. */
2456 228 : for (i = 0; i < memlist->n_members; ++i)
2457 : {
2458 : HeapTuple am_cascade_tuple;
2459 : Form_pg_auth_members am_cascade_form;
2460 :
2461 150 : am_cascade_tuple = &memlist->members[i]->tuple;
2462 150 : am_cascade_form = (Form_pg_auth_members) GETSTRUCT(am_cascade_tuple);
2463 :
2464 150 : if (am_cascade_form->member == authmem_form->member &&
2465 78 : am_cascade_form->admin_option && actions[i] == RRG_NOOP)
2466 : {
2467 0 : would_still_have_admin_option = true;
2468 0 : break;
2469 : }
2470 : }
2471 :
2472 : /* If the member would still have ADMIN OPTION, we need not recurse. */
2473 78 : if (would_still_have_admin_option)
2474 0 : return;
2475 :
2476 : /*
2477 : * Recurse to grants that are not yet slated for deletion which have this
2478 : * member as the grantor.
2479 : */
2480 216 : for (i = 0; i < memlist->n_members; ++i)
2481 : {
2482 : HeapTuple am_cascade_tuple;
2483 : Form_pg_auth_members am_cascade_form;
2484 :
2485 150 : am_cascade_tuple = &memlist->members[i]->tuple;
2486 150 : am_cascade_form = (Form_pg_auth_members) GETSTRUCT(am_cascade_tuple);
2487 :
2488 150 : if (am_cascade_form->grantor == authmem_form->member &&
2489 36 : actions[i] != RRG_DELETE_GRANT)
2490 : {
2491 36 : if (behavior == DROP_RESTRICT)
2492 12 : ereport(ERROR,
2493 : (errcode(ERRCODE_DEPENDENT_OBJECTS_STILL_EXIST),
2494 : errmsg("dependent privileges exist"),
2495 : errhint("Use CASCADE to revoke them too.")));
2496 :
2497 24 : plan_recursive_revoke(memlist, actions, i, false, behavior);
2498 : }
2499 : }
2500 : }
2501 :
2502 : /*
2503 : * Initialize a GrantRoleOptions object with default values.
2504 : */
2505 : static void
2506 3188 : InitGrantRoleOptions(GrantRoleOptions *popt)
2507 : {
2508 3188 : popt->specified = 0;
2509 3188 : popt->admin = false;
2510 3188 : popt->inherit = false;
2511 3188 : popt->set = true;
2512 3188 : }
2513 :
2514 : /*
2515 : * GUC check_hook for createrole_self_grant
2516 : */
2517 : bool
2518 2360 : check_createrole_self_grant(char **newval, void **extra, GucSource source)
2519 : {
2520 : char *rawstring;
2521 : List *elemlist;
2522 : ListCell *l;
2523 2360 : unsigned options = 0;
2524 : unsigned *result;
2525 :
2526 : /* Need a modifiable copy of string */
2527 2360 : rawstring = pstrdup(*newval);
2528 :
2529 2360 : if (!SplitIdentifierString(rawstring, ',', &elemlist))
2530 : {
2531 : /* syntax error in list */
2532 0 : GUC_check_errdetail("List syntax is invalid.");
2533 0 : pfree(rawstring);
2534 0 : list_free(elemlist);
2535 0 : return false;
2536 : }
2537 :
2538 2372 : foreach(l, elemlist)
2539 : {
2540 12 : char *tok = (char *) lfirst(l);
2541 :
2542 12 : if (pg_strcasecmp(tok, "SET") == 0)
2543 6 : options |= GRANT_ROLE_SPECIFIED_SET;
2544 6 : else if (pg_strcasecmp(tok, "INHERIT") == 0)
2545 6 : options |= GRANT_ROLE_SPECIFIED_INHERIT;
2546 : else
2547 : {
2548 0 : GUC_check_errdetail("Unrecognized key word: \"%s\".", tok);
2549 0 : pfree(rawstring);
2550 0 : list_free(elemlist);
2551 0 : return false;
2552 : }
2553 : }
2554 :
2555 2360 : pfree(rawstring);
2556 2360 : list_free(elemlist);
2557 :
2558 2360 : result = (unsigned *) guc_malloc(LOG, sizeof(unsigned));
2559 2360 : if (!result)
2560 0 : return false;
2561 2360 : *result = options;
2562 2360 : *extra = result;
2563 :
2564 2360 : return true;
2565 : }
2566 :
2567 : /*
2568 : * GUC assign_hook for createrole_self_grant
2569 : */
2570 : void
2571 2360 : assign_createrole_self_grant(const char *newval, void *extra)
2572 : {
2573 2360 : unsigned options = *(unsigned *) extra;
2574 :
2575 2360 : createrole_self_grant_enabled = (options != 0);
2576 2360 : createrole_self_grant_options.specified = GRANT_ROLE_SPECIFIED_ADMIN
2577 : | GRANT_ROLE_SPECIFIED_INHERIT
2578 : | GRANT_ROLE_SPECIFIED_SET;
2579 2360 : createrole_self_grant_options.admin = false;
2580 2360 : createrole_self_grant_options.inherit =
2581 2360 : (options & GRANT_ROLE_SPECIFIED_INHERIT) != 0;
2582 2360 : createrole_self_grant_options.set =
2583 2360 : (options & GRANT_ROLE_SPECIFIED_SET) != 0;
2584 2360 : }
|