|Firebird Documentation Index → Firebird 2.0 and 2.1 Quick Start → Server configuration and management|
There are several things you should be aware of – and take care of – before you start using your freshly installed Firebird server. This part of the manual introduces you to some useful tools and shows you how to protect your server and databases.
Firebird comes with a command-line user management tool called gsec. Although its functions can also be performed by a number of third-party GUI utilities, you should at least have a basic knowledge of gsec, since this is the official tool and it's present in every Firebird server installation. In the next sections you will use gsec to execute two tasks: changing the SYSDBA password and adding a Firebird user. First though, some points of attention:
With some Firebird installations, you can only run gsec
if you are logged into the operating system as Superuser (
root on Linux) or as the user the Firebird server process
runs under. On Windows server platforms, you typically need to be in the Power User
group or higher to run gsec successfully.
If you have enough privileges but invoking gsec results
in a message like “
cannot attach to password database - unable to
You may be running Firebird on Windows and for some reason the local protocol
isn't working. One rather common cause for this is running Windows with Terminal
Services (Remote Desktop Services) enabled and connecting to the server from a
different session. To enable the local protocol, open
firebird.conf, uncomment the
parameter and set it to
Global\FIREBIRD. Then restart the
In Firebird 2.0.1 and up, Firebird automatically prepends
Global\ to the IPCname if the connection fails because of
insufficient permissions, so this should not happen anymore.
If the above doesn't apply to you, you can at least circumvent the problem by “tricking” gsec into using TCP/IP. Add the following parameter to the command line, adjusting the path if necessary:
-database "localhost:C:\Program Files\Firebird\Firebird_2_0\security2.fdb"
security2.fdb is the security
database, where Firebird keeps its user account details. It is located
in your Firebird installation directory.
Maybe your security database is a renamed
from Firebird 1.5. Of course this can't be the case immediately after installation.
Someone (you?) must have put it there, in order to keep the existing accounts
available. Consult the Release Notes for instructions on how to upgrade old security
If the error message starts with “
Cannot attach to services
manager”, the server may not be running at all. In that case, go
back to Testing your
installation and fix the problem.
On **nix systems, if you call gsec from its own directory, you should type ./gsec instead of just gsec. The current directory is usually not part of the search path, so plain gsec may either fail or launch a “wrong” gsec.
One Firebird account is created automatically as part of the installation process: SYSDBA. This account has all the privileges on the server and cannot be deleted. Depending on version, OS, and architecture, the installation program will either
install the SYSDBA user with the password
masterke: characters after
the eighth are ignored), or
ask you to enter a password during installation, or
generate a random password and store that in the file
SYSDBA.password within your Firebird installation directory.
If the password is
masterkey and your server is exposed to the
Internet at all – or even to a local network, unless you trust every
user with the SYSDBA password – you should change it immediately using
the gsec command-line utility. Go to a command shell,
cd to the Firebird
subdirectory and issue the following command to change the password to (as an example)
gsec -user sysdba -pass masterkey -mo sysdba -pw icuryy4me
Notice that you specify “sysdba” twice in the command:
-user parameter you identify yourself as
SYSDBA. You also provide SYSDBA's current
password in the
-mo[dify] parameter tells gsec that you want to modify
an account – which happens to be SYSDBA again. Lastly,
-pw specifies the type of modification: the password.
If all has gone well, the new password
icuryy4me is now encrypted
and stored, and
masterkey is no longer valid. Please be aware that unlike
Firebird user names, passwords are case-sensitive.
Firebird allows the creation of many different user accounts. Each of them can own databases and also have various types of access to databases and database objects it doesn't own.
Using gsec, you can add a user account as follows from the
command line in the Firebird
gsec -user sysdba -pass masterkey -add billyboy -pw sekrit66
Provided that you've supplied the correct password for SYSDBA, a
user account called
billyboy will now have been
created with password
sekrit66. Remember that passwords are
Since Firebird 2, users can change their own passwords. Previous versions required SYSDBA to do this.
Firebird 2 offers a number of security options, designed to make unauthorised access as difficult as possible. Be warned however that some configurable security features default to the old, “insecure” behaviour inherited from InterBase and Firebird 1.0, in order not to break existing applications.
It pays to familiarise yourself with Firebird's security-related configuration parameters. You can significantly enhance your system's security if you raise the protection level wherever possible. This is not only a matter of setting parameters, by the way: other measures involve tuning filesystem access permissions, an intelligent user accounts policy, etc.
Below are some guidelines for protecting your Firebird server and databases.
On Unix-like systems, Firebird already runs as user
firebird by default, not as
root. On Windows server platforms, you can also run the
Firebird service under a designated user account (e.g.
Firebird). The default practice – running the service as
LocalSystem user – poses a security risk
if your system is connected to the Internet. Consult
doc subdir to learn more about
As discussed before, if your Firebird server is reachable from the network and the
system password is
masterkey, change it.
SYSDBA is a very powerful account, with full (destructive) access rights to all your Firebird databases. Its password should be known to a few trusted database administrators only. Therefore, you shouldn't use this super-account to create and populate regular databases. Instead, generate normal user accounts, and provide their account names and passwords to your users as needed. You can do this with gsec as shown above, or with any third-party Firebird administration tool.
Anybody who has filesystem-level read access to a database file can copy it, install it on a system under his or her own control, and extract all data from it – including possibly sensitive information. Anybody who has filesystem-level write access to a database file can corrupt it or totally destroy it.
As a rule, only the Firebird server process should have access to the database files. Users don't need, and should not have, access to the files – not even read-only. They query databases via the server, and the server makes sure that users only get the allowed type of access (if at all) to any objects within the database.
An exception to the above rule is the so-called local or embedded access mode of
Firebird Classic Server on Linux. This mode requires that users
have proper access rights to the database file itself. They must also have read access
to the security database
security2.fdb. If this worries you,
reserve filesystem access to the security database (and other databases, while you're at
it) for the server process only. Users are then obliged to connect via the network
layer. However, the
should not be removed from your system, because the Firebird command-line tools refuse
to run if they are not present.
(Another exception is the Windows Embedded Server, but that's outside the scope of this manual.)
Database aliases shield the client from physical database
locations. Using aliases, a client can e.g. connect to
frodo:zappa” without having to know that the real
Aliases also allow you to relocate databases while the clients keep using their existing
Aliases are listed in the file
aliases.conf, in this format
on Windows machines:
poker = E:\Games\Data\PokerBase.fdb blackjack.fdb = C:\Firebird\Databases\cardgames\blkjk_2.fdb
And on Linux:
books = /home/bookworm/database/books.fdb zappa = /var/firebird/music/underground/mothers_of_invention.fdb
Giving the alias an
.fdb (or any other)
extension is fully optional. Of course if you do include it, you must also specify it
when you use the alias to connect to the database.
DatabaseAccess parameter in
firebird.conf can be set to
Restrict to limit
access to explicitly listed filesystem trees, or even to
allow access to aliased databases only. Default is
All, i.e. no
Note that this is not the same thing as the filesystem-level access protection
discussed earlier: when
DatabaseAccess is anything other than
All, the server will refuse to open any databases outside the
defined scope even if it has sufficient rights on the database files.
Firebird 2.1 and higher support three authentication models when connecting to databases or using the tools:
Native: The user must identify him/herself with a Firebird username and password, which the server checks against the security database.
Trusted: The user is automatically identified by his OS account name.
Mixed: The user either supplies a Firebird username and password, or is logged in with his OS account name.
On Linux, the mixed model is used.
On Windows, the default is mixed in 2.1, 2.1.1 and 2.1.2, and
native in 2.1.3 and higher. You can change the model by setting the
Authentication parameter in
Depending on your Windows system configuration and the way Firebird is used,
trusted may be the most secure option. If trusted authentication is
used when the connection is made (this is possible in the trusted
and mixed models), Windows administrators automatically receive
Firebird 2.0 doesn't have the
Authentication under Windows is native.
There are more security parameters, but the ones not mentioned here are already set to
an adequate protection level by default. You can read about them in the 1.5 and 2.0 Release
Notes and in the comments in
Several control panel applets are available for use with Firebird. Whilst such applets are not essential, they do provide a convenient way to start and stop the server and check its current status.
The Firebird Server Manager applet is included in the Firebird distribution. The option to install this applet is only available for Superserver.
The applet is also usable for Classic server, provided that it (the server, that is) runs as a service, not as an application. Since the installation dialogue won't give you the option to include the applet with a Classic server, you must, if you really want it:
Install Superserver first;
Copy the applet
Firebird2Control.cpl from the Windows
system folder to a safe place;
Copy the applet back to the system directory.
This is a screenshot of the activated applet. Notice that the title bar says “Firebird Server Control”, although it is listed in the Control Panel as Firebird 2.0 Server Manager.
This applet only works on Windows NT, 2000/3/8, XP, Vista and 7.
For an alternative to the bundled applet, you can visit this webpage:
...and download the Firebird Control Center (FBCC). Please note that, unlike the applet included with Firebird, the Firebird Control Center will not work with Classic or SuperClassic servers. This may change in the future.
The current version – 0.4.2 – should work well under Windows 2000 and up. It offers the same functionality as Firebird's own applet, and more. An older release, still downloadable at http://www.achim-kalwa.de/dl/fbcc-0.2.7.exe, also runs under Windows 9x, ME and NT. Notice however that these Windows versions are no longer actively supported by the Firebird project, even if the engine runs on it.
The Firebird kit does not come with a GUI admin tool. It does have a set of command-line
tools – executable programs which are located in the
bin subdirectory of your Firebird installation. One of them,
gsec, has already been introduced to you.
The range of excellent GUI tools available for use with a Windows client machine is too numerous to describe here. A few GUI tools written in Borland Kylix, for use on Linux client machines, are also in various stages of completion.
Remember: you can use a Windows client to access a Linux server and vice-versa.
|Firebird Documentation Index → Firebird 2.0 and 2.1 Quick Start → Server configuration and management|