📂 Advanced File Manager

Multi-Root Navigation System

⬆ Ke Atas 🏠 Root Server 🏠 Root App 🔄 Refresh

📍 Lokasi: /usr/share/doc/firebird/sql.extensions 💾 Free: 45.6 GB

⚠️ Direktori ini tidak writable.

✏️ Mengedit: README.mapping.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
	<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
	<title></title>
	<meta name="generator" content="LibreOffice 6.3.4.2.0 (Linux)"/>
	<meta name="author" content="irina "/>
	<meta name="created" content="2014-03-25T00:00:00.010305100"/>
	<meta name="changed" content="2020-04-13T14:19:46.849216419"/>
	<style type="text/css">
		@page { margin: 2.01cm }
		p { margin-bottom: 0.2cm }
		a:link { so-language: zxx }
	</style>
</head>
<body lang="ru-RU" dir="ltr">
SQL Language Extension:
CREATE/ALTER/CREATE_OR_ALTER/DROP MAPPING

Implements
capability to control mapping of security objects to and between
databases.

Author:
Alex
Peshkoff &lt;<a href="mailto:peshkoff@mail.ru">peshkoff@mail.ru</a>&gt;

Preamble:

Firebird
3 supports multiple security databases. This is great feature, but it
raises some problems, missing in systems with single security
database. Clusters of databases, using same security database, are
efficiently separated and this is what we typically want to achieve
using different security databases. But in some cases we need
controlled limited interaction between such clusters. As an examples
can be provided EXECUTE STATEMENT ON EXTERNAL DATA SOURCE when some
data exchange between clusters is required and letting server-wide
SYSDBA access databases from other clusters using services. More or
less similar problems were already known in windows version of
firebird since v. 2.1 due to presence of trusted windows
authentication – we had 2 separate lists of users (in security
database and OS) and sometimes it was needed to make them be related.
For example it appears to be good idea to automatically assign to
windows users from some group appropriate firebird role.

Single
solution for all this problems is MAPPING login information, assigned
to user when it connected to firebird server, to internal security
objects in database – current_user and current_role. Mapping rule
contains 4 parts of information: 

<ul>
	<li>mapping
	scope (is mapping local for current database or affects all
	databases in cluster, including security database),
	<li>mapping
	name (mappings are named like all the other objects in database), 
	
	<li>from
	what we map 
	
	<li>to
	what we map.
</ul>
Here
it's necessary to mention that all versions of firebird had one
hardcoded global default rule – users authenticated in security
database are always mapped into any database one-to-one. This rule is
safe - if we have some security database it makes no use not to trust
itself. Therefore (and due to backward compatibility) this rule is
kept as is in firebird 3. What about mapping windows users to
current_user (which was enabled by default in 2.1 &amp; 2.5 when
trusted authentication enabled) in firebird 3 it must be done
explicitly. This is required for systems with multiple security
databases - not all of them need/use windows trusted authentication.

'From'
part of mapping has 4 items:
<ul>
	<li>authentication
	source (plugin name or result of mapping in other database or use of
	serverwide authentication or any method),
	<li>name
	of database where authentication succeeded, 
	
	<li>name
	from which mapping is performed,
	<li>type
	of that name (username, role, OS group – this depends upon plugin
	which added that name during authentication).
</ul>
Each
item may be ignored (any item is accepted) except type – it's
definitely bad idea to mix different types of security objects.

'To'
part has 2 items:
<ul>
	<li>name
	to which mapping is performed,
	<li>type
	of that name (only USER/ROLE are accepted here).
</ul>

Mappings
are defined using SQL (DDL) commands.

Syntax:

{CREATE | ALTER | CREATE OR
ALTER} [GLOBAL] MAPPING name

USING {PLUGIN name [IN
database] | 


ANY PLUGIN [IN database |
SERVERWIDE] | 

MAPPING
[IN database] | 

'*'
[IN database]}

FROM {ANY type | type name}
TO
{USER | ROLE} [name]

DROP
[GLOBAL] MAPPING name

Description:

Each
mapping may be tagged as GLOBAL. Pay attention that global and local
maps with same name may exist and they are different objects!

Create,
alter and create or alter commands use same set of options. Name of
mapping is used to identify it in former DDL commands. USING clause
has a most complicated set of options. One can provide explicit
plugin name, making it work only for given plugin, or make it use any
plugin (but not a result of previous mappings), or make it work only
with server-wide plugins, or make it work only with previous mapping
results, or let it use any method using asterisk. In almost all cases
(except server-wide authentication which is not related with
databases) one can also provide name of database in which name from
which mapping is performed was “born”. FROM clause must set
required parameter – type of name from which mapping is done. When
mapping names from plugins type is defined by plugin, when previous
mapping results - type can be only user or role. One can provide
explicit name which will be taken into an account by this mapping or
use ANY keyword to work with any name of given type. In TO clause
USER or ROLE (to what mapping is done) must be specified, name is
optional - when it is not provided original name (from what mapping
is done) is used.

Samples:

All
sample are provided for CREATE command, use of ALTER is exactly the
same, use of DROP is obvious.

Enable
use of windows trusted authentication in all databases that use
current security database:
CREATE
GLOBAL MAPPING TRUSTED_AUTH USING PLUGIN WIN_SSPI FROM ANY USER TO
USER;

Enable
SYSDBA-like access for windows admins in current database:
CREATE
MAPPING WIN_ADMINS USING PLUGIN WIN_SSPI FROM Predefined_Group
DOMAIN_ANY_RID_ADMINS TO ROLE RDB$ADMIN;
(there
is no group DOMAIN_ANY_RID_ADMINS in windows, but such name is added
by win_sspi plugin to provide exact backwards compatibility)

Enable
particular user from other database access current database with
other name:
CREATE
MAPPING FROM_RT USING PLUGIN SRP IN &quot;rt&quot; FROM USER U1 TO
USER U2;
(providing
database names/aliases in double quotes is important for operating
systems that have case-sensitive file names)

Enable
server's SYSDBA (from main security database) access current database
(assuming it has non-default security database):
CREATE
MAPPING DEF_SYSDBA USING PLUGIN SRP IN &quot;security.db&quot; FROM
USER SYSDBA TO USER;

Force
people who logged in using legacy authentication plugin have not too
much rights:
CREATE
MAPPING LEGACY_2_GUEST USING PLUGIN legacy_auth FROM ANY USER TO USER
GUEST;

Map
windows group to trusted firebird role:
CREATE
MAPPING WINGROUP1 USING PLUGIN WIN_SSPI FROM GROUP GROUP_NAME TO ROLE
ROLE_NAME;
Here
we expect that some windows users may belong to group GROUP_NAME. If
needed name of the group may be given in long form, i.e.
DOMAIN\GROUP.

Notice:
-
Global mapping works best if firebird 3 or higher version database is
used as security database. If you plan to use other database as
security one (using for example your own provider) please create in
it table RDB$AUTH_MAPPING with structure repeating one in firebird 3
database, public read access and SYSDBA-only write access.
-
Mappings
work only with information, coming from authentication plugins or
previously done mapping. Information present in DPB (particular SQL
role name) is not affected by mappings and can not be changed using
them.

Tip:
It’s
relatively easy to accidentally make a database remotely inaccessible
using CREATE MAPPING statement. For example: 

CREATE
MAPPING BREAK_DB_1 USING * FROM ANY USER TO ROLE ROLE1;
CREATE
MAPPING BREAK_DB_2 USING * FROM ANY USER TO ROLE ROLE2;
This
will disallow any user (including SYSDBA) to connect. Luckily
mappings are not processed when database is used in embedded mode,
i.e. in such a case one should attach to database using embedded
access and fix bad mappings.

</body>
</html>

❌ Batal

Nama	Ukuran	Dimodifikasi	Permission	Aksi
📄 README.aggregate_filter.md	941 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.aggregate_tracking	3.9 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.alternate_string_quoting.txt	846 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.autonomous_transactions.txt	1.3 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.blob_append.md	5 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.builtin_functions.txt	29.5 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.case	1.7 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.coalesce	1 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.column_type_psql.txt	871 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.common_table_expressions	4.8 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.context_variables	4.7 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.context_variables2	8.5 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.cumulative_roles.txt	2.3 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.current_time	814 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.cursor_variables.txt	2.7 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.cursors	2.4 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.data_type_results_of_aggregations.txt	1.6 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.data_types	8.3 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.db_triggers.txt	1.8 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.ddl.txt	22.5 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.ddl_access.txt	1.5 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.ddl_triggers.txt	11.7 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.default_parameters	1.9 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.derived_tables.txt	2.7 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.distinct	813 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.domains_psql.txt	933 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.exception_handling	2.4 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.execute_block	1.5 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.execute_statement	4.2 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.execute_statement2	9.5 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.explicit_locks	5.9 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.expression_indices	1.3 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.external_connections_pool	4.3 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.floating_point_types.md	2.3 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.global_temporary_tables	3.4 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.hex_literals.txt	1.1 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.identity_columns.txt	3.2 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.iif	541 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.isc_info_xxx	3.6 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.joins.txt	1.2 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.keywords	5.3 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.leave_labels	1.7 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.length	486 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.linger	1.3 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.list	1 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.management_statements_psql.md	925 B	2026-04-17 16:36	0644	✏️ Edit ⬇
💻 README.mapping.html	14.9 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.merge.txt	1.8 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.null_value	23 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.nullif	611 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.offset_fetch.txt	1.7 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.order_by_expressions_nulls	1.7 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.packages.txt	5.1 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.plan	3.5 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.PSQL_stack_trace.txt	2 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.regr_functions.txt	1.1 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.returning	2.9 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.rows	1.3 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.savepoints	4.1 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.scrollable_cursors.txt	3.1 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.select_expressions	2.2 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.sequence_generators	1.7 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.set_bind.md	4.5 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.set_role	768 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.set_transaction.txt	1.6 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.similar_to.txt	9.5 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.sql_security.txt	5.5 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.statistical_functions.txt	1.6 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.subroutines.txt	4.2 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.substring_similar.txt	1.2 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.time_zone.md	14.3 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.trim	997 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.universal_triggers	2.8 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.update_or_insert	1.4 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.user_management	4.4 KB	2026-04-17 16:36	0644	✏️ Edit ⬇
📎 README.view_updates	23 B	2026-04-17 16:36	0644	✏️ Edit ⬇
📄 README.window_functions.md	14.9 KB	2026-04-17 16:36	0644	✏️ Edit ⬇

📂 Advanced File Manager

✏️ Mengedit: README.mapping.html

✍️ Rename: