Skip to content

Commit 26b7542

Browse files
committed
Restructured security index
1 parent 6255948 commit 26b7542

File tree

3 files changed

+41
-10
lines changed

3 files changed

+41
-10
lines changed

ydb/docs/en/core/concepts/glossary.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -327,15 +327,15 @@ An **access control list** or **ACL** is a list of all [rights](#access-right) g
327327

328328
### Access level {#access-level}
329329

330-
An **[access level](../security/authorization.md#level)** determines additional privileges of an [access subject](#access-subject) for [scheme objects](#scheme-object) as well as privileges that are not related to [scheme objects](#scheme-object).
330+
An **access level** determines additional privileges of an [access subject](#access-subject) for [scheme objects](#scheme-object) as well as privileges that are not related to [scheme objects](#scheme-object).
331331

332332
An access level is granted by adding an access subject to an [access level list](#access-level-list).
333333

334334
### Access level list {#access-level-list}
335335

336336
An **access level list** is a list of [SIDs](#access-sid) that grants a certain [access level](#access-level) to the associated [access subjects](#access-subject).
337337

338-
{{ ydb-short-name }} provides several [access level lists](../reference/configuration/index.md#security-access-levels) that collectively determine [access levels](#access-level) in the system.
338+
{{ ydb-short-name }} provides several [access level lists](../reference/configuration/security_config.md#security-access-levels) that collectively determine [access levels](#access-level) in the system.
339339

340340
### Owner {#access-owner}
341341

ydb/docs/ru/core/concepts/glossary.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -342,15 +342,19 @@
342342

343343
### Уровень доступа {#access-level}
344344

345-
**[Уровень доступа](../security/authorization.md#level)** — состояние, определяющее дополнительные возможности [субъекта доступа](#access-subject) при работе с [объектами схемы](#scheme-object), а также возможности [субъекта доступа](#access-subject) в контекстах, не связанных с [объектами схемы](#scheme-object).
345+
**Уровень доступа** — состояние, определяющее дополнительные возможности [субъекта доступа](#access-subject) при работе с [объектами схемы](#scheme-object), а также возможности [субъекта доступа](#access-subject) в контекстах, не связанных с [объектами схемы](#scheme-object). {{ ydb-short-name }} использует три уровня доступа:
346+
347+
- наблюдатель;
348+
- оператор;
349+
- администратор.
346350

347351
Уровень доступа определяется принадлежностью субъекта к [спискам разрешений](#access-level-list).
348352

349353
### Список уровня доступа {#access-level-list}
350354

351355
**Список уровня доступа** или **список разрешений** — список [SID](#access-sid)'ов [субъектов доступа](#access-subject), которым разрешён определённый [уровень доступа](#access-level).
352356

353-
{{ ydb-short-name }} имеет несколько [списков уровней доступа](../reference/configuration/index.md#security-access-levels), совместно определяющих набор [уровней доступа](#access-level) в системе.
357+
{{ ydb-short-name }} имеет несколько [списков уровней доступа](../reference/configuration/security_config.md#security-access-levels), совместно определяющих набор [уровней доступа](#access-level) в системе.
354358

355359
### Владелец {#access-owner}
356360

ydb/docs/ru/core/security/index.md

+33-6
Original file line numberDiff line numberDiff line change
@@ -8,22 +8,49 @@
88

99
Система безопасности {{ ydb-short-name }} оперирует следующими концепциями и элементами:
1010

11+
- **Субъекты доступа**:
12+
13+
- **Пользователи**. {{ ydb-short-name }} позволяет работать как с внутренними [пользователями](./authorization.md#user), так и с пользователями из внешних источников (каталогов и систем).
14+
15+
- **Группы**. {{ ydb-short-name }} позволяет объединять пользователей в именованные множества с равными возможностями для своих членов.
16+
17+
- **Объекты доступа**. В {{ ydb-short-name }} объектами доступа являются объекты схемы, для которых настраиваются права доступа.
18+
19+
- **Права доступа** и **уровни доступа**. Привилегии пользователей и групп в {{ ydb-short-name }} настраиваются с помощью **прав доступа** и **уровней доступа**:
20+
21+
- [Права доступа](./authorization.md#right) — это возможность субъекта доступа выполнять определенные правом действия над объектом доступа. Права доступа на конкретный [объект доступа](../concepts/glossary.md#access-object) перечисляются в [списке прав](../concepts/glossary.md#access-control-list) данного объекта доступа.
22+
23+
- Для управления дополнительными возможностями [субъекта доступа](../concepts/glossary.md#access-subject) в контекстах, не связанных с [объектами схемы](../concepts/glossary.md#scheme-object), используются [уровни доступа](../concepts/glossary.md#access-level):
24+
25+
- наблюдатель;
26+
- оператор;
27+
- администратор.
28+
29+
Распределение пользователей по уровням доступа производится с помощью [списков уровней доступа](../concepts/glossary.md#access-level-list).
30+
1131
- **[Аутентификация](./authentication.md) и [авторизация](./authorization.md)**. Система управления доступом в {{ ydb-short-name }} предоставляет механизм защиты данных в кластере {{ ydb-short-name }}. Только аутентифицированные [субъекты доступа](../concepts/glossary.md#access-subject) (пользователи и группы) могут работать с данными, а доступ к данным может ограничиваться.
1232

13-
При доступе к базе данных {{ ydb-short-name }} [пользователи](../concepts/glossary.md#access-user) проходят [аутентификацию](./authentication.md) — процесс проверки, подтверждающий подлинность пользователя при доступе к базе данных. На основе аутентификационных данных пользователь затем проходит [авторизацию](./authorization.md) — процесс проверки наличия определённых [прав доступа](../concepts/glossary.md#access-right) и [уровней доступа](../concepts/glossary.md#access-level) для выполнения операции пользователя.
33+
- **Аутентификация**. При доступе к базе данных {{ ydb-short-name }} [пользователи](../concepts/glossary.md#access-user) проходят [аутентификацию](./authentication.md) — процесс проверки, подтверждающий подлинность пользователя при доступе к базе данных.
1434

15-
{{ ydb-short-name }} позволяет работать как с внутренними [пользователями](./authorization.md#user), так и с пользователями из внешних источников (каталогов и систем). После прохождения [аутентификации](./authentication.md) пользователи получают идентификатор в виде [SID](./authorization.md#sid), который используется для идентификации пользователя в {{ ydb-short-name }} и использования в механизмах управления доступом.
35+
После прохождения [аутентификации](./authentication.md) пользователи получают идентификатор и аутентификационный токен:
1636

17-
[Права доступа](./authorization.md#right) в {{ ydb-short-name }} привязываются к [объекту доступа](../concepts/glossary.md#access-object) с помощью [списков прав](../concepts/glossary.md#access-control-list). Формат списков прав описан в статье [{#T}](./short-access-control-notation.md).
37+
- Идентификатор в виде [SID](./authorization.md#sid) используется для идентификации пользователя в {{ ydb-short-name }} и использования в механизмах управления доступом.
1838

19-
Для управления дополнительными возможностями [субъекта доступа](../concepts/glossary.md#access-subject) в контекстах, не связанных с [объектами схемы](../concepts/glossary.md#scheme-object), используются используются [уровни доступа](../concepts/glossary.md#access-level). Распределение пользователей по уровням доступа производится с помощью [списков уровней доступа](../concepts/glossary.md#access-level-list).
39+
- Аутентификационный токен используется узлами {{ ydb-short-name }} для подтверждения подлинности пользователя перед обработкой его запросов.
2040

21-
По умолчанию при первом запуске кластера {{ ydb-short-name }} выполняется [встроенная настройка безопасности](./builtin-security.md), которая добавляет в систему [суперпользователя](./builtin-security.md#superuser), а также реализует набор [ролей](./builtin-security.md#role) безопасности для удобного управления пользователями.
41+
Если источник, в котором был создан пользователь, подтверждает аутентификацию пользователя, то создаётся и кэшируется токен пользователя для аутентификации будущих запросов от этого пользователя, чтобы не проводить проверку аутентификационного токена заново.
2242

23-
- **Шифрование**. Поскольку {{ ydb-short-name }} является распределённой системой, обычно работающей на кластере, часто расположенном в нескольких датацентрах или зонах доступности, пользовательские данные регулярно передаются по сети. Могут использоваться различные протоколы, каждый из которых может быть настроен для работы с использованием [шифрования данных при передаче](./encryption/data-in-transit.md). {{ ydb-short-name }} также поддерживает прозрачное [шифрование данных при хранении](./encryption/data-at-rest.md) на уровне прокси распределённого хранилища.
43+
- **Авторизация**. На основе аутентификационных данных пользователь затем проходит [авторизацию](./authorization.md) — процесс проверки наличия определённых [прав доступа](../concepts/glossary.md#access-right) и [уровней доступа](../concepts/glossary.md#access-level) для выполнения операции пользователя.
2444

2545
- **Аудитные логи**. {{ ydb-short-name }} предоставляет в [аудитных логах](./audit-log.md) данные об операциях по изменению объектов (успешных или неуспешных), таких как изменение прав доступа, создание и удаление объектов и т.п. Аудитные логи не отслеживают операции DML.
2646

47+
- **Шифрование**. Поскольку {{ ydb-short-name }} является распределённой системой, обычно работающей на кластере, часто расположенном в нескольких датацентрах или зонах доступности, пользовательские данные регулярно передаются по сети. YDB использует:
48+
49+
- [шифрование данных при передаче](./encryption/data-in-transit.md) для обеспечения безопасности трафика, передаваемого от клиента к {{ ydb-short-name }} и между узлами {{ ydb-short-name }};
50+
- [шифрование данных при хранении](./encryption/data-at-rest.md).
51+
52+
- **Встроенная настройка безопасности**. По умолчанию при первом запуске кластера {{ ydb-short-name }} выполняется [встроенная настройка безопасности](./builtin-security.md), которая добавляет в систему [суперпользователя](./builtin-security.md#superuser), а также реализует набор [ролей](./builtin-security.md#role) безопасности для удобного управления пользователями.
53+
2754

2855
Основные материалы:
2956

0 commit comments

Comments
 (0)