`CREATE USER`

Creates a Firebird user account

Available in

DSQL

Syntax

CREATE USER username
  <user_option> [<user_option> ...]
  [TAGS (<user_var> [, <user_var> ...]]

<user_option> ::=
    PASSWORD 'password'
  | FIRSTNAME 'firstname'
  | MIDDLENAME 'middlename'
  | LASTNAME 'lastname'
  | {GRANT | REVOKE} ADMIN ROLE
  | {ACTIVE | INACTIVE}
  | USING PLUGIN plugin_name

<user_var> ::=
    tag_name = 'tag_value'
  | DROP tag_name

Table 1. `CREATE USER` Statement Parameters
Parameter	Description
username	Username.The maximum length is 63 characters, following the rules for Firebird identifiers.
password	User password.Valid or effective password length depends on the user manager plugin.Case-sensitive.
firstname	Optional: User’s first name.Maximum length 32 characters
middlename	Optional: User’s middle name.Maximum length 32 characters
lastname	Optional: User’s last name.Maximum length 32 characters.
plugin_name	Name of the user manager plugin.
tag_name	Name of a custom attribute.The maximum length is 63 characters, following the rules for Firebird regular identifiers.
tag_value	Value of the custom attribute.The maximum length is 255 characters.

If the user already exist in the Firebird security database for the specified user manager plugin, an error is raised.It is possible to create multiple users with the same name: one per user manager plugin.

The username argument must follow the rules for Firebird regular identifiers: see Identifiers in the Structure chapter.Usernames are case-sensitive when double-quoted (in other words, they follow the same rules as other delimited identifiers).

Important

Usernames follow the general rules and syntax of identifiers.Thus, a user named "Alex" is distinct from a user named "ALEX"

CREATE USER ALEX PASSWORD 'bz23ds';

- this user is the same as the first one
CREATE USER Alex PASSWORD 'bz23ds';

- this user is the same as the first one
CREATE USER "ALEX" PASSWORD 'bz23ds';

- and this is a different user
CREATE USER "Alex" PASSWORD 'bz23ds';

The PASSWORD clause specifies the user’s password, and is required.The valid or effective password length depends on the user manager plugin, see also [fblangref50-security-auth].

The optional FIRSTNAME, MIDDLENAME and LASTNAME clauses can be used to specify additional user properties, such as the person’s first name, middle name and last name, respectively.These are VARCHAR(32) fields and can be used to store anything you prefer.

If the GRANT ADMIN ROLE clause is specified, the new user account is created with the privileges of the RDB$ADMIN role in the security database ({secdb} or database-specific).It allows the new user to manage user accounts from any regular database they log into, but it does not grant the user any special privileges on objects in those databases.

The REVOKE ADMIN ROLE clause is syntactically valid in a CREATE USER statement, but has no effect.It is not possible to specify GRANT ADMIN ROLE and REVOKE ADMIN ROLE in one statement.

The ACTIVE clause specifies the user is active and can log in, this is the default.

The INACTIVE clause specifies the user is inactive and cannot log in.It is not possible to specify ACTIVE and INACTIVE in one statement.The ACTIVE/INACTIVE option is not supported by the Legacy_UserManager and will be ignored.

The USING PLUGIN clause explicitly specifies the user manager plugin to use for creating the user.Only plugins listed in the UserManager configuration for this database (firebird.conf, or overridden in databases.conf) are valid.The default user manager (first in the UserManager configuration) is applied when this clause is not specified.

Important

Users of the same name created using different user manager plugins are different objects.Therefore, the user created with one user manager plugin can only be altered or dropped by that same plugin.

From the perspective of ownership, and privileges and roles granted in a database, different user objects with the same name are considered one and the same user.

The TAGS clause can be used to specify additional user attributes.Custom attributes are not supported (silently ignored) by the Legacy_UserManager.Custom attributes names follow the rules of Firebird identifiers, but are handled case-insensitive (for example, specifying both "A BC" and "a bc" will raise an error).The value of a custom attribute can be a string of maximum 255 characters.The DROP tag_name option is syntactically valid in CREATE USER, but behaves as if the property is not specified.

Warning

Users can view and alter their own custom attributes.Do not use this for sensitive or security related information.

Note	`CREATE/ALTER/DROP USER` are DDL statements, and only take effect at commit.Remember to `COMMIT` your work.In isql, the command `SET AUTO ON` will enable autocommit on DDL statements.In third-party tools and other user applications, this may not be the case.

Who Can Create a User

To create a user account, the current user must have

administrator privileges in the security database
the USER_MANAGEMENT system privilege in the security database.Users with the USER_MANAGEMENT system privilege can not grant or revoke the admin role.

docnext count = 9

`CREATE USER` Examples

Creating a user with the username bigshot:
```
CREATE USER bigshot PASSWORD 'buckshot';
```

Creating a user with the Legacy_UserManager user manager plugin

CREATE USER godzilla PASSWORD 'robot'
  USING PLUGIN Legacy_UserManager;

Creating the user john with custom attributes:

CREATE USER john PASSWORD 'fYe_3Ksw'
  FIRSTNAME 'John' LASTNAME 'Doe'
  TAGS (BIRTHYEAR='1970', CITY='New York');

Creating an inactive user:

CREATE USER john PASSWORD 'fYe_3Ksw'
  INACTIVE;

Creating the user superuser with user management privileges:

CREATE USER superuser PASSWORD 'kMn8Kjh'
GRANT ADMIN ROLE;

`ALTER USER`

Alters a Firebird user account

Available in

DSQL

Syntax

ALTER {USER username | CURRENT USER}
  [SET] [<user_option> [<user_option> ...]]
  [TAGS (<user_var> [, <user_var> ...]]

<user_option> ::=
    PASSWORD 'password'
  | FIRSTNAME 'firstname'
  | MIDDLENAME 'middlename'
  | LASTNAME 'lastname'
  | {GRANT | REVOKE} ADMIN ROLE
  | {ACTIVE | INACTIVE}
  | USING PLUGIN plugin_name

<user_var> ::=
    tag_name = 'tag_value'
  | DROP tag_name

See [fblangref50-security-user-create] for details on the statement parameters.

Any user can alter their own account, except that only an administrator may use GRANT/REVOKE ADMIN ROLE and ACTIVE/INACTIVE.

All clauses are optional, but at least one other than USING PLUGIN must be present:

The PASSWORD parameter is for changing the password for the user
FIRSTNAME, MIDDLENAME and LASTNAME update these optional user properties, such as the person’s first name, middle name and last name respectively
GRANT ADMIN ROLE grants the user the privileges of the RDB$ADMIN role in the security database ({secdb}), enabling them to manage the accounts of other users.It does not grant the user any special privileges in regular databases.
REVOKE ADMIN ROLE removes the user’s administrator in the security database which, once the transaction is committed, will deny that user the ability to alter any user account except their own
ACTIVE will enable a disabled account (not supported for Legacy_UserManager)
INACTIVE will disable an account (not supported for Legacy_UserManager).This is convenient to temporarily disable an account without deleting it.
USING PLUGIN specifies the user manager plugin to use
TAGS can be used to add, update or remove (DROP) additional custom attributes (not supported for Legacy_UserManager).Attributes not listed will not be changed.

See [fblangref50-security-user-create] for more details on the clauses.

If you need to change your own account, then instead of specifying the name of the current user, you can use the CURRENT USER clause.

Warning

The ALTER CURRENT USER statement follows the normal rules for selecting the user manager plugin.If the current user was created with a non-default user manager plugin, they will need to explicitly specify the user manager plugins with USING PLUGIN plugin_name, or they will receive an error that the user is not found.Or, if a user with the same name exists for the default user manager, they will alter that user instead.

Note	Remember to commit your work if you are working in an application that does not auto-commit DDL.

Who Can Alter a User?

To modify the account of another user, the current user must have

administrator privileges in the security database
the USER_MANAGEMENT system privilege in the security databaseUsers with the USER_MANAGEMENT system privilege can not grant or revoke the admin role.

Anyone can modify their own account, except for the GRANT/REVOKE ADMIN ROLE and ACTIVE/INACTIVE options, which require administrative privileges to change.

`ALTER USER` Examples

Changing the password for the user bobby and granting them user management privileges:
```
ALTER USER bobby PASSWORD '67-UiT_G8'
GRANT ADMIN ROLE;
```
Editing the optional properties (the first and last names) of the user dan:
```
ALTER USER dan
FIRSTNAME 'No_Jack'
LASTNAME 'Kennedy';
```
Revoking user management privileges from user dumbbell:
```
ALTER USER dumbbell
DROP ADMIN ROLE;
```

`CREATE OR ALTER USER`

Creates a Firebird user account if it doesn’t exist, or alters a Firebird user account

Available in

DSQL

Syntax

CREATE OR ALTER USER username
  [SET] [<user_option> [<user_option> ...]]
  [TAGS (<user_var> [, <user_var> ...]]

<user_option> ::=
    PASSWORD 'password'
  | FIRSTNAME 'firstname'
  | MIDDLENAME 'middlename'
  | LASTNAME 'lastname'
  | {GRANT | REVOKE} ADMIN ROLE
  | {ACTIVE | INACTIVE}
  | USING PLUGIN plugin_name

<user_var> ::=
    tag_name = 'tag_value'
  | DROP tag_name

See [fblangref50-security-user-create] and [fblangref50-security-user-alter] for details on the statement parameters.

If the user does not exist, it will be created as if executing a CREATE USER statement.If the user already exists, it will be modified as if executing an ALTER USER statement.The CREATE OR ALTER USER statement must contain at least one of the optional clauses other than USING PLUGIN.If the user does not exist yet, the PASSWORD clause is required.

Note	Remember to commit your work if you are working in an application that does not auto-commit DDL.

`CREATE OR ALTER USER` Examples

Creating or altering a user

CREATE OR ALTER USER john PASSWORD 'fYe_3Ksw'
FIRSTNAME 'John'
LASTNAME 'Doe'
INACTIVE;

`DROP USER`

Drops a Firebird user account

Available in

DSQL

Syntax

DROP USER username
  [USING PLUGIN plugin_name]

Table 1. `DROP USER` Statement Parameter
Parameter	Description
username	Username
plugin_name	Name of the user manager plugin

The optional USING PLUGIN clause explicitly specifies the user manager plugin to use for dropping the user.Only plugins listed in the UserManager configuration for this database (firebird.conf, or overridden in databases.conf) are valid.The default user manager (first in the UserManager configuration) is applied when this clause is not specified.

Important

Users of the same name created using different user manager plugins are different objects.Therefore, the user created with one user manager plugin can only be dropped by that same plugin.

Note	Remember to commit your work if you are working in an application that does not auto-commit DDL.

Who Can Drop a User?

To drop a user, the current user must have

administrator privileges in the security database
the USER_MANAGEMENT system privilege in the security database

`DROP USER` Example

Deleting the user bobby:
```
DROP USER bobby;
```
Removing a user created with the Legacy_UserManager plugin:
```
DROP USER Godzilla
  USING PLUGIN Legacy_UserManager;
```

CREATE USER

CREATE USER

Who Can Create a User

docnext count = 9

CREATE USER Examples

ALTER USER

Who Can Alter a User?

ALTER USER Examples

CREATE OR ALTER USER

CREATE OR ALTER USER Examples

DROP USER

Who Can Drop a User?

DROP USER Example

`CREATE USER`

`CREATE USER` Examples

`ALTER USER`

`ALTER USER` Examples

`CREATE OR ALTER USER`

`CREATE OR ALTER USER` Examples

`DROP USER`

`DROP USER` Example