-
Notifications
You must be signed in to change notification settings - Fork 643
Doc changes related to security features #17532
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Doc changes related to security features #17532
Conversation
✅ Documentation buildRevision built successfully |
✅ Documentation buildRevision built successfully |
✅ Documentation buildRevision built successfully |
✅ Documentation buildRevision built successfully |
✅ Documentation buildRevision built successfully |
✅ Documentation buildRevision built successfully |
✅ Documentation buildRevision built successfully |
39fc521
to
3e11971
Compare
✅ Documentation buildRevision built successfully |
✅ Documentation buildRevision built successfully |
✅ Documentation buildRevision built successfully |
✅ Documentation buildRevision built successfully |
a921899
into
ydb-platform:docs-feature-security
@@ -4,7 +4,7 @@ | |||
|
|||
## Схема кластера {{ ydb-short-name }} {#cluster-scheme} | |||
|
|||
Схема кластера {{ ydb-short-name }} — это иерархическое пространство имён кластера {{ ydb-short-name }}. Единственным корневым элементом этого пространства имён является **корень схемы кластера**. Дочерними элементами корня схемы кластера выступают [базы данных](../../concepts/glossary.md#database). В корне кластера также допустимо создавать различные [схемные объекты](../../concepts/glossary.md#scheme-object), эти объекты будут существовать на уровне кластера в целом и не принадлежат ни одной пользовательской БД. Внутри каждой базы данных можно создавать произвольную иерархию с помощью вложенных директорий. | |||
Схема кластера {{ ydb-short-name }} — это иерархическое пространство имён кластера {{ ydb-short-name }}. Верхнеуровневым элементом этого пространства имён является **корень схемы кластера**. Дочерними элементами корня схемы кластера выступают [базы данных](../../concepts/glossary.md#database). Внутри каждой базы данных можно создавать произвольную иерархию с помощью вложенных директорий. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Внутри каждой базы данных можно создавать произвольную иерархию объектов (таблиц, топиков и т.п.) с помощью вложенных директорий."
### Схема кластера {#scheme} | ||
|
||
**Схема кластера {{ ydb-short-name }}** — это иерархическое пространство имён кластера {{ ydb-short-name }}. Единственным корневым элементом этого пространства имён является [корень схемы кластера](#scheme-root). Корнем схемы кластера может выступать [директория](#folder) или [корневая база данных](#root-database). Дочерними элементами корня схемы кластера выступают [базы данных](#database) или другие [схемные объекты](#scheme-object), которые образуют произвольную иерархию с помощью вложенных директорий. | ||
**Схема кластера {{ ydb-short-name }}** — это иерархическое пространство имён кластера {{ ydb-short-name }}. Верхнеуровневым элементом этого пространства имён является [корень схемы кластера](#scheme-root). Дочерними элементами корня схемы кластера выступают [базы данных](#database). Внутри каждой базы данных можно создавать произвольную иерархию с помощью вложенных директорий. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
аналогично
@@ -2,39 +2,35 @@ | |||
|
|||
{{ ydb-short-name }} позволяет использовать различные способы аутентификации пользователей в системе. Настройки аутентификации и провайдеров аутентификации задаются в секции `auth_config` файла конфигурации {{ ydb-short-name }}. | |||
|
|||
## Конфигурация аутентификации внутренних пользователей {{ ydb-short-name }} {#internal-auth-config} | |||
## Конфигурация аутентификации локальных пользователей {{ ydb-short-name }} {#local-auth-config} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Я считаю, что мы должны термины "локальный пользователь" и "внешний пользователь" описать в Глоссарии
@@ -1,10 +1,17 @@ | |||
# Встроенная настройка безопасности | |||
# Начальная настройка безопасности |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Начальная настройка безопасности кластера
Права доступа и уровни доступа могут быть выданы конкретному пользователю, или группе. Пользователь, которого включили в группу, наделяется правами, выданными ранее этой группе, на время нахождения в этой группе. | ||
Подробнее о правах доступа см. в разделе [{#T}](./authorization.md#right). | ||
|
||
- **Уровни доступа**. С помощью **уровней доступа** в {{ ydb-short-name }} определяется доступ к дополнительным возможностям по управлению кластером - мониторинг состояния, запуск и остановка узлов, изменение настроек и т.п. - для конкретного пользователей или группы. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Напишу здесь комментарий.
Я бы хотел видеть более подробное описание термина "Уровень доступа" в глоссарии.
Сейчас это:
Уровень доступа предоставляет [субъекту доступа](https://ydb-platform--ydb.viewer.diplodoc.com/ru/ru/concepts/glossary#access-subject) дополнительные возможности при работе с [объектами схемы](https://ydb-platform--ydb.viewer.diplodoc.com/ru/ru/concepts/glossary#scheme-object), а также возможность выполнения операций над кластером в целом. YDB использует три уровня доступа:
наблюдатель;
оператор;
администратор.
Уровень доступа для субъекта настраивается с помощью [списков уровня доступа](https://ydb-platform--ydb.viewer.diplodoc.com/ru/ru/concepts/glossary#access-level-list).
Я бы прямо приводил примеры, чтобы было не сухо, а понятно
Changelog category
Description for reviewers
...