Users and groups

Authentication in DBOO is based on user ids and passwords. Each user is member of one or more groups. Access to databases is through the group. A user get access to a database with at least one matching group.

In the current implementation, a user have either all or no access.

Root user

When the server is created, the root user is added. At start it has an empty password and you should change it as soon as possible. Either through the set password command or by using the :code:`–set-root-password’ option to the server.

Adding users and groups

Create users while connected as a root user (any user can become a root user by being assigned to the root group). With add user, any non existing groups entered with the –groups option will be automatically created.

> dboo
dboo> connect -u=root -p=MyPassword
dboo root@dboo::server> add user <press tab here, shows completions>
<user_id>       options:       --password     --groups       --description
dboo root@dboo::server> add user MyNewUser --password=UserPwd --groups=AGroup
Added user 'MyNewUser'
dboo root@dboo::server>

Adding a group:

> dboo
dboo> connect -u=root -p=MyPassword
dboo root@dboo::server> add group <press tab here, shows completions>
<groupid>       options:       --password     --groups       --description
dboo root@dboo::server> add group MyNewGroup
Added group 'MyNewUser'
dboo root@dboo::server>

Reset root password

The root password can be reset by starting the server with --set-root-password option:

> dbood --set-root-password <password>

Or, if you don’t want to enter the password on command line, enter ‘–’ and type at hidden prompt:

> dbood --set-root-password --
New password: ******

# If you have your server in /var/dboo/mydb (path must be at end of command line)
> dbood --set-root-password -- /var/dboo/mydb
New password: ******

Once the password is set, the server will immediately shut down.