20.2. Атрибуты ролей #
Роль базы данных может иметь атрибуты, определяющие её полномочия и взаимодействие с системой аутентификации клиентов.
- Право подключения
Только роли с атрибутом
LOGINмогут использоваться для начального подключения к базе данных. Роль с атрибутомLOGINможно рассматривать как пользователя базы данных. Для создания такой роли можно использовать любой из вариантов:CREATE ROLE
имяLOGIN; CREATE USERимя;(Команда
CREATE USERэквивалентнаCREATE ROLEза исключением того, чтоCREATE USERпо умолчанию включает атрибутLOGIN, в то время какCREATE ROLE— нет.)- Статус суперпользователя
Суперпользователь базы данных обходит все проверки прав доступа, за исключением права на вход в систему. Это опасная привилегия и она не должна использоваться небрежно. Лучше всего выполнять большую часть работы не как суперпользователь. Для создания нового суперпользователя используется
CREATE ROLE. Это нужно выполнить из под роли, которая также является суперпользователем.имяSUPERUSER- Создание базы данных
Роль должна явно иметь разрешение на создание базы данных (за исключением суперпользователей, которые пропускают все проверки). Для создания такой роли используется
CREATE ROLE.имяCREATEDB- Создание роли
Роль должна явно иметь разрешение на создание других ролей (за исключением суперпользователей, которые пропускают все проверки). Для создания такой роли используется
CREATE ROLE. Роль с правомимяCREATEROLECREATEROLEможет изменять и удалять роли, которые были назначены пользователю с правамиCREATEROLEиADMIN OPTION. Такое назначение ролей происходит автоматически, когда пользователь с правомCREATEROLE, не являющийся суперпользователем, создаёт новую роль. Поэтому по умолчанию пользователь с правомCREATEROLEможет изменять и удалять созданные им роли. Изменение роли включает большинство действий командыALTER ROLE, например смену пароля, а также действия командCOMMENTиSECURITY LABELв отношении ролей.Однако, имея право
CREATEROLE, нельзя ни создавать, ни каким-либо образом влиять на ролиSUPERUSER. Кроме того, с правомCREATEROLEнельзя ни создавать пользователейREPLICATION, ни предоставлять или отзывать правоREPLICATION, ни изменять свойства ролей таких пользователей. Тем не менее, это право позволяет использовать командыALTER ROLE ... SETиALTER ROLE ... RENAMEв отношении ролейREPLICATION, а такжеCOMMENT ON ROLE,SECURITY LABEL ON ROLEиDROP ROLE. Наконец, правоCREATEROLEне даёт возможности предоставлять или отзывать правоBYPASSRLS.- Запуск репликации
Роль должна иметь явное разрешение на запуск потоковой репликации (за исключением суперпользователей, которые пропускают все проверки). Роль, используемая для потоковой репликации, также должна иметь атрибут
LOGIN. Для создания такой роли используетсяCREATE ROLE.имяREPLICATION LOGIN- Пароль
Пароль имеет значение, если метод аутентификации клиентов требует, чтобы пользователи предоставляли пароль при подключении к базе данных. Методы аутентификации
passwordиmd5используют пароли. База данных и операционная система используют раздельные пароли. Пароль указывается при создании роли:CREATE ROLE.имяPASSWORD 'строка'- Наследование прав
По умолчанию роль наследует права ролей, членом которых она является. Однако можно создать роль, которая не будет наследовать права по умолчанию. Для этого выполните
CREATE ROLE. Как вариант, атрибуты наследования отдельных прав можно переопределить, указавимяNOINHERITWITH INHERIT TRUEилиWITH INHERIT FALSE.- Игнорирование защиты на уровне строк
Разрешение обходить все политики защиты на уровне строк (RLS) нужно давать роли явно. Создать роль с таким разрешением можно, выполнив
CREATE ROLEот имени суперпользователя.имяBYPASSRLS- Ограничение соединений
Для роли можно ограничить число одновременных соединений. -1 (по умолчанию) означает отсутствие ограничения. Для создания роли с ограничением используется
CREATE ROLE.nameCONNECTION LIMIT 'число'
Атрибуты ролей могут быть изменены после создания командой ALTER ROLE. Более детальная информация в справке по командам CREATE ROLE и ALTER ROLE.
На уровне ролей можно устанавливать многие конфигурационные параметры времени выполнения, описанные в Главе 18. Например, если по некоторым причинам всякий раз при подключении к базе данных требуется отключить использование индексов (подсказка: плохая идея), можно выполнить:
ALTER ROLE myname SET enable_indexscan TO off;
Установленное значение параметра будет сохранено (но не будет применено сразу). Для последующих подключений с этой ролью это будет выглядеть как выполнение команды SET enable_indexscan TO off перед началом сеанса. Но это только значение по умолчанию; в течение сеанса этот параметр можно изменить. Для удаления установок на уровне ролей для параметров конфигурации используется ALTER ROLE . Обратите внимание, что установка параметров конфигурации на уровне роли без права имя_роли RESET имя_переменнойLOGIN лишено смысла, т. к. они никогда не будут применены.
Когда не суперпользователь с правом CREATEROLE создаёт роль, создающая роль автоматически получает членство в создаваемой, как если бы начальный суперпользователь выполнил команду GRANT created_user TO creating_user WITH ADMIN TRUE, SET FALSE, INHERIT FALSE. Поскольку пользователь с правом CREATEROLE может пользоваться специальными правами в отношении существующей роли только при наличии атрибута ADMIN OPTION, такого права вполне достаточно для того, чтобы пользователь с правом CREATEROLE мог администрировать созданную им роль. Тем не менее, поскольку роль создаётся с атрибутами INHERIT FALSE, SET FALSE, пользователь с правом CREATEROLE не будет наследовать права созданной роли и не сможет переключиться на неё с помощью команды SET ROLE. Однако поскольку любой пользователь с правом ADMIN OPTION для роли может разрешать членство в этой роли любым пользователям, пользователь с правом CREATEROLE может стать членом созданной им роли, просто назначив эту роль на себя при помощи INHERIT и/или SET. Поэтому факт того, что права не наследуются по умолчанию и что право не назначается по умолчанию командой SET ROLE, — это способ оградиться от случайных ошибок, а не средство защиты. Кроме того, обратите внимание, что это право автоматически выдаётся от имени начального суперпользователя, поэтому пользователь с правом CREATEROLE не сможет удалить или изменить его. Тем не менее любой суперпользователь может отозвать, модифицировать и/или выдать дополнительно такие права другим пользователям с правом CREATEROLE. Любой пользователь с правами CREATEROLE и ADMIN OPTION в этой роли может её администрировать.
20.2. Role Attributes #
A database role can have a number of attributes that define its privileges and interact with the client authentication system.
- login privilege
Only roles that have the
LOGINattribute can be used as the initial role name for a database connection. A role with theLOGINattribute can be considered the same as a “database user”. To create a role with login privilege, use either:CREATE ROLE
nameLOGIN; CREATE USERname;(
CREATE USERis equivalent toCREATE ROLEexcept thatCREATE USERincludesLOGINby default, whileCREATE ROLEdoes not.)- superuser status
A database superuser bypasses all permission checks, except the right to log in. This is a dangerous privilege and should not be used carelessly; it is best to do most of your work as a role that is not a superuser. To create a new database superuser, use
CREATE ROLE. You must do this as a role that is already a superuser.nameSUPERUSER- database creation
A role must be explicitly given permission to create databases (except for superusers, since those bypass all permission checks). To create such a role, use
CREATE ROLE.nameCREATEDB- role creation
A role must be explicitly given permission to create more roles (except for superusers, since those bypass all permission checks). To create such a role, use
CREATE ROLE. A role withnameCREATEROLECREATEROLEprivilege can alter and drop roles which have been granted to theCREATEROLEuser with theADMINoption. Such a grant occurs automatically when aCREATEROLEuser that is not a superuser creates a new role, so that by default, aCREATEROLEuser can alter and drop the roles which they have created. Altering a role includes most changes that can be made usingALTER ROLE, including, for example, changing passwords. It also includes modifications to a role that can be made using theCOMMENTandSECURITY LABELcommands.However,
CREATEROLEdoes not convey the ability to createSUPERUSERroles, nor does it convey any power overSUPERUSERroles that already exist. Furthermore,CREATEROLEdoes not convey the power to createREPLICATIONusers, nor the ability to grant or revoke theREPLICATIONprivilege, nor the ability to modify the role properties of such users. However, it does allowALTER ROLE ... SETandALTER ROLE ... RENAMEto be used onREPLICATIONroles, as well as the use ofCOMMENT ON ROLE,SECURITY LABEL ON ROLE, andDROP ROLE. Finally,CREATEROLEdoes not confer the ability to grant or revoke theBYPASSRLSprivilege.- initiating replication
A role must explicitly be given permission to initiate streaming replication (except for superusers, since those bypass all permission checks). A role used for streaming replication must have
LOGINpermission as well. To create such a role, useCREATE ROLE.nameREPLICATION LOGIN- password
A password is only significant if the client authentication method requires the user to supply a password when connecting to the database. The
passwordandmd5authentication methods make use of passwords. Database passwords are separate from operating system passwords. Specify a password upon role creation withCREATE ROLE.namePASSWORD 'string'- inheritance of privileges
A role inherits the privileges of roles it is a member of, by default. However, to create a role which does not inherit privileges by default, use
CREATE ROLE. Alternatively, inheritance can be overridden for individual grants by usingnameNOINHERITWITH INHERIT TRUEorWITH INHERIT FALSE.- bypassing row-level security
A role must be explicitly given permission to bypass every row-level security (RLS) policy (except for superusers, since those bypass all permission checks). To create such a role, use
CREATE ROLEas a superuser.nameBYPASSRLS- connection limit
Connection limit can specify how many concurrent connections a role can make. -1 (the default) means no limit. Specify connection limit upon role creation with
CREATE ROLE.nameCONNECTION LIMIT 'integer'
A role's attributes can be modified after creation with ALTER ROLE. See the reference pages for the CREATE ROLE and ALTER ROLE commands for details.
A role can also have role-specific defaults for many of the run-time configuration settings described in Chapter 18. For example, if for some reason you want to disable index scans (hint: not a good idea) anytime you connect, you can use:
ALTER ROLE myname SET enable_indexscan TO off;
This will save the setting (but not set it immediately). In subsequent connections by this role it will appear as though SET enable_indexscan TO off had been executed just before the session started. You can still alter this setting during the session; it will only be the default. To remove a role-specific default setting, use ALTER ROLE . Note that role-specific defaults attached to roles without rolename RESET varnameLOGIN privilege are fairly useless, since they will never be invoked.
When a non-superuser creates a role using the CREATEROLE privilege, the created role is automatically granted back to the creating user, just as if the bootstrap superuser had executed the command GRANT created_user TO creating_user WITH ADMIN TRUE, SET FALSE, INHERIT FALSE. Since a CREATEROLE user can only exercise special privileges with regard to an existing role if they have ADMIN OPTION on it, this grant is just sufficient to allow a CREATEROLE user to administer the roles they created. However, because it is created with INHERIT FALSE, SET FALSE, the CREATEROLE user doesn't inherit the privileges of the created role, nor can it access the privileges of that role using SET ROLE. However, since any user who has ADMIN OPTION on a role can grant membership in that role to any other user, the CREATEROLE user can gain access to the created role by simply granting that role back to themselves with the INHERIT and/or SET options. Thus, the fact that privileges are not inherited by default nor is SET ROLE granted by default is a safeguard against accidents, not a security feature. Also note that, because this automatic grant is granted by the bootstrap superuser, it cannot be removed or changed by the CREATEROLE user; however, any superuser could revoke it, modify it, and/or issue additional such grants to other CREATEROLE users. Whichever CREATEROLE users have ADMIN OPTION on a role at any given time can administer it.