snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ru/user-guide/permissions-access/capabilities/permissions.mdx

@@ -0,0 +1,213 @@
+---
+title: Разрешения
+description: Управляйте доступом к объектам, полям и настройкам с помощью разрешений на основе ролей.
+---
+
+Система разрешений Twenty позволяет вам контролировать доступ к трем основным областям:
+
+* **Объекты и поля**: Контролировать, кто может просматривать, редактировать или удалять записи и отдельные поля
+* **Настройки**: Управление доступом к конфигурации рабочего пространства и административным функциям
+* **Действия**: Контролировать общие действия рабочего пространства, такие как импорт данных или отправка писем
+
+## Создать роль
+
+Чтобы создать новую роль:
+
+1. Перейдите в **Настройки → Участники → Роли**
+2. В разделе **Все роли** нажмите **+ Создать роль**
+3. Введите имя роли
+4. На вкладке **Разрешения** по умолчанию [настройте разрешения](#customize-permissions)
+5. Нажмите **Сохранить**, чтобы завершить
+
+## Удалить роль
+
+Чтобы удалить роль:
+
+1. Перейдите в **Настройки → Участники → Роли**
+2. Нажмите на роль, которую хотите удалить
+3. Откройте вкладку **Настройки**, затем нажмите **Удалить роль**
+4. Нажмите **Подтвердить** в модальном окне
+
+<Note>
+Если роль удалена, любой участник рабочего пространства, назначенный на неё, будет автоматически переназначен на роль по умолчанию. Все роли кроме роли **Администратора** могут быть удалены. Всегда должен быть назначен хотя бы один участник на роль **Администратора**.
+</Note>
+
+## Назначение ролей участникам
+
+### Просмотр текущих назначений
+
+* Перейдите в **Настройки → Участники → Роли**
+* Просмотрите все роли и количество назначенных им участников
+* Просмотрите, какие роли у каких участников
+
+### Назначить роль участнику
+
+1. Перейдите в **Настройки → Участники → Роли**
+2. Нажмите на роль, которую вы хотите назначить
+3. Откройте вкладку **Назначение**
+4. Нажмите **+ Назначить участнику**
+5. Выберите участника рабочего пространства из списка
+6. Подтвердите назначение
+
+### Установить роль по умолчанию
+
+1. Перейдите в **Настройки → Участники → Роли**
+2. В разделе **Опции** найдите **Роль по умолчанию**
+3. Выберите, какую роль новые участники должны получать автоматически
+4. Новые участники рабочего пространства будут получать эту роль при присоединении
+
+<Note>
+Вы можете назначать роли только существующим участникам рабочего пространства. Чтобы пригласить новых участников, используйте [Управление членами](/l/ru/user-guide/settings/capabilities/member-management).
+</Note>
+
+## Настроить разрешения
+
+Разрешения определяют, что каждая роль может получить доступ к вашей рабочей области или изменять ее, включая объекты, записи, настройки и действия.
+
+### Разрешения на уровне объекта
+
+Раздел **Объекты** определяет, что эта роль может делать с записями во всём вашем рабочем пространстве.
+
+#### Задать разрешения по умолчанию (для всех объектов)
+
+Сначала настройте базовые разрешения, которые по умолчанию применяются ко **всем объектам**:
+
+| Разрешение                                  | Описание                                                              |
+| ------------------------------------------- | --------------------------------------------------------------------- |
+| **Просмотр записей на всех объектах**       | Просматривать записи в списках и на страницах с подробной информацией |
+| **Редактирование записей на всех объектах** | Изменять существующие записи                                          |
+| **Удаление записей на всех объектах**       | Мягко удалять записи (их можно восстановить)                          |
+| **Уничтожение записей на всех объектах**    | Безвозвратно удалять записи                                           |
+
+Включайте или отключайте в зависимости от того, каким должно быть поведение по умолчанию для этой роли.
+
+<Note>
+**Пример — роль стажёра**: По умолчанию стажёр должен видеть все объекты, но не редактировать их. Включите "Просмотр записей для всех объектов", но оставьте "Редактирование записей для всех объектов" не отмеченным.
+</Note>
+
+#### Добавить исключения на уровне объекта
+
+После настройки значений по умолчанию используйте подраздел **На уровне объекта**, чтобы добавить правила, которые переопределяют значения по умолчанию для конкретных объектов.
+
+Нажмите **+ Добавить правило** и выберите объект, чтобы создать исключение.
+
+**Примеры правил для роли стажёра:**
+
+| Правило                                      | Результат                                                        |
+| -------------------------------------------- | ---------------------------------------------------------------- |
+| Opportunities → отключить "Просмотр записей" | Стажёр вообще не видит объект Opportunities                      |
+| People → включить "Редактирование записей"   | Стажёр может редактировать записи People (но не других объектов) |
+
+### Разрешения на уровне строк
+
+<Note>
+Разрешения на уровне строк — это **премиальная функция**, доступная в тарифе **Organization** (Cloud и Self-Hosted).
+</Note>
+
+Разрешения на уровне строк позволяют ограничить, какие отдельные записи может просматривать или редактировать роль, на основе динамических критериев. В отличие от разрешений на объекты (которые применяются ко всему типу объекта), разрешения на уровне строк оценивают каждую запись независимо.
+
+**Примеры случаев использования:**
+
+* Торговые представители могут видеть только свои сделки
+* Менеджеры могут видеть все записи в своём регионе
+* Сотрудники службы поддержки могут просматривать только назначенные им заявки
+
+Чтобы настроить разрешения на уровне строк, откройте роль, перейдите на вкладку **Objects** и используйте раздел **Row-Level** для определения условий фильтрации для конкретного объекта.
+
+### Разрешения на уровне поля
+
+В рамках каждого правила на уровне объекта вы можете дополнительно настроить **разрешения на уровне поля**, чтобы управлять доступом к конкретным полям.
+
+| Разрешение              | Описание                    |
+| ----------------------- | --------------------------- |
+| **Просмотр поля**       | Просматривать значение поля |
+| **Редактирование поля** | Изменять значение поля      |
+| **Нет доступа**         | Поле полностью скрыто       |
+
+**Пример — ограничение доступа к конфиденциальным полям:**
+
+Для роли стажёра с правом редактирования People вы можете ограничить некоторые поля:
+
+* People → Email → только **Просмотр поля** (редактирование недоступно)
+* People → Address → **Нет доступа** (полностью скрыто)
+
+Это позволяет стажёру редактировать большинство полей People, при этом защищая конфиденциальную информацию.
+
+### Как работает наследование разрешений
+
+Разрешения применяются каскадно — от общих к конкретным:
+
+1. **Все объекты** → задаёт базовый уровень для всех объектов
+2. **Правила на уровне объекта** → переопределяют базовые настройки для конкретных объектов
+3. **Правила на уровне поля** → переопределяют настройки объекта для конкретных полей
+
+Более конкретные настройки всегда имеют приоритет.
+
+### Управление переопределениями разрешений
+
+Чтобы переопределить унаследованные разрешения:
+
+1. Нажмите **X**, чтобы удалить унаследованное правило
+2. Выберите нужные конкретные разрешения
+3. Нажмите оранжевую **Отмена** (круглая стрелка), чтобы отменить изменения
+
+Когда закончите, нажмите **Завершить**, затем **Сохранить**, после чего вас перенаправит на страницу роли.
+
+### Разрешения для настроек рабочего пространства
+
+Контролируйте доступ к настройкам рабочего пространства двумя способами:
+
+* Переключатель **Все доступ к настройкам** для предоставления полного доступа
+* Или включите специальные разрешения (например, генерация API-ключей, предпочтения рабочего пространства, назначение ролей, настройка модели данных, настройки безопасности и управление Workflows)
+
+<Note>
+**Текущее ограничение**: Для ручного запуска рабочих процессов в настоящее время требуется доступ к управлению рабочими процессами. Это поведение может измениться в будущих версиях.
+</Note>
+
+### Разрешения на действия в рабочем пространстве
+
+Контролируйте доступ к общим действиям рабочего пространства:
+
+* Переключатель **Все доступ к приложениям** для предоставления полных разрешений
+* Или включите индивидуальные действия, такие как **Отправить email**, **Импортировать CSV** и **Экспортировать CSV**
+
+## Назначить роли агентам API и API
+
+Помимо участников рабочего пространства, роли также можно назначать **ключам API** и **AI-агентам**. Это особенно полезно для команд, которые хотят точно контролировать, «кто» что может делать в их рабочем пространстве — включая автоматизированные процессы и интеграции.
+
+### Зачем назначать роли ключам API и AI-агентам?
+
+* **Безопасность**: Ограничьте доступ и возможность изменений для автоматизированных процессов
+* **Соответствие требованиям**: Обеспечьте, чтобы интеграции получали доступ только к необходимым данным
+* **Контроль**: Предотвратите случайные изменения данных из-за неверно настроенных автоматизаций
+* **Аудит**: Отслеживайте, какие действия выполнены какой интеграцией или каким агентом
+
+### Назначить роль ключу API
+
+1. Перейдите в **Настройки → Участники → Роли**
+2. Нажмите на роль, которую вы хотите назначить
+3. Откройте вкладку **Назначение**
+4. В разделе **Ключи API** нажмите **+ Назначить ключу API**
+5. Выберите ключ API из списка
+6. Подтвердите назначение
+
+Теперь ключ API унаследует все разрешения, определённые этой ролью. Любые вызовы API, выполненные с этим ключом, будут соответствующим образом ограничены.
+
+<Note>
+Ключи API без назначенной роли используют разрешения по умолчанию. Для повышения безопасности всегда назначайте конкретную роль производственным ключам API.
+</Note>
+
+### Назначить роль AI-агенту
+
+1. Перейдите в **Настройки → Участники → Роли**
+2. Нажмите на роль, которую вы хотите назначить
+3. Откройте вкладку **Назначение**
+4. В разделе **AI-агенты** нажмите **+ Назначить AI-агенту**
+5. Выберите AI-агента из списка
+6. Подтвердите назначение
+
+AI-агент сможет получать доступ к данным и выполнять действия только в пределах разрешений назначенной ему роли.
+
+<Note>
+Для AI-агентов, работающих в рамках рабочих процессов, это гарантирует, что агент не сможет получать доступ к данным или изменять их вне своей предназначенной области — даже если у рабочего процесса есть более широкие разрешения.
+</Note>

packages/twenty-docs/l/ru/user-guide/permissions-access/capabilities/sso-configuration.mdx

@@ -0,0 +1,125 @@
+---
+title: Конфигурация SSO
+description: Настройте единый вход (SSO) для безопасной корпоративной аутентификации.
+---
+
+## О SSO
+
+Единый вход (SSO) позволяет участникам вашей команды входить в Twenty, используя провайдера идентификации вашей организации. Это обеспечивает:
+
+* **Централизованное управление доступом**: управляйте доступом из одного места
+* **Повышенная безопасность**: используйте существующие политики безопасности
+* **Лучший пользовательский опыт**: один набор учетных данных для всех инструментов
+
+## Поддерживаемые провайдеры
+
+Twenty поддерживает SSO с:
+
+* **SAML 2.0**: работает с большинством корпоративных провайдеров идентификации
+* **Google Workspace**: для организаций, использующих Google
+* **Microsoft Entra ID** (ранее Azure AD): Для среды Microsoft
+
+## Настройка SSO
+
+### Требования
+
+* План Organization (облачные и самостоятельно размещённые рабочие пространства)
+* Доступ администратора к вашему провайдеру идентификации
+* Админ доступ к вашему двадцать проекту
+
+### Шаги настройки
+
+#### 1. Доступ к настройкам SSO
+
+1. Перейдите в **Настройки → Безопасность**
+2. Найдите раздел **Конфигурация SSO**
+3. Нажмите **Настроить SSO**
+
+#### 2) Выберите своего провайдера
+
+Выберите вашего провайдера идентификации из списка или выберите "Custom SAML" для других провайдеров.
+
+#### 3. Настройте вашего провайдера идентификации
+
+Вам потребуется настроить вашего провайдера идентификации со следующими параметрами:
+
+* **Entity ID**: предоставляется Twenty
+* **ACS URL**: URL обратного вызова для аутентификации
+* **Сертификат**: для защищённой связи
+
+#### 4. Введите данные провайдера в Twenty
+
+* **SSO URL**: URL для входа от вашего провайдера
+* **Entity ID**: идентификатор вашего провайдера
+* **Сертификат**: сертификат X.509 от вашего провайдера
+
+#### 5. Проверка и включение
+
+1. Нажмите **Проверить конфигурацию**, чтобы проверить настройку
+2. Включите SSO, когда проверка пройдёт успешно
+3. Настройте параметры подготовки пользователей
+
+## Подготовка пользователей
+
+### Подготовка Just-in-Time (JIT)
+
+* Пользователи создаются автоматически при первом входе
+* Пользователям назначена роль по умолчанию автоматически
+* Ручное создание пользователей не требуется
+
+### Ручная подготовка
+
+* Пригласите пользователей до того, как они смогут войти
+* Предварительно назначьте конкретные роли
+* Дополнительный контроль над тем, кто может получить доступ к проекту
+
+## Управление пользователями SSO
+
+### Назначение ролей
+
+Пользователям SSO можно назначать роли так же, как обычным пользователям:
+
+1. Перейдите в **Настройки → Участники**
+2. Найдите пользователя
+3. Измените их роль при необходимости
+
+### Отзыв доступа
+
+Чтобы удалить доступ для пользователей SSO:
+
+* Удалите их из вашего провайдера идентификации или
+* Удалите их из рабочего пространства Twenty
+
+## Лучшие практики
+
+### Безопасность
+
+* **Требовать SSO**: отключите вход по паролю для пользователей SSO
+* **Регулярные аудиты**: периодически пересматривайте доступ
+* **Строгие политики IdP**: обеспечьте MFA на стороне провайдера идентификации
+
+### Управление пользователями
+
+* **Понятные названия**: используйте единообразные наименования из вашего каталога
+* **Сопоставление групп**: сопоставьте группы IdP с ролями Twenty (если доступно)
+* **Процесс офбординга**: включите Twenty в ваш рабочий процесс отзыва доступов
+
+## Устранение неполадок
+
+### Распространённые проблемы
+
+* **Ошибки сертификата**: убедитесь, что сертификат не истек
+* **Несоответствие URL**: Проверьте соответствие ACS URL
+* **Пользователь не найден**: проверьте настройки JIT-подготовки
+
+### Получение помощи
+
+Если вы столкнётесь с проблемами, обратитесь в поддержку, указав:
+
+* Полученные сообщения об ошибках
+* Используемый провайдер идентификации
+* Подробности конфигурации (без конфиденциальных данных)
+
+<Tip>
+Нужно настроить SSO для вашей организации? [Найдите сертифицированного партнёра Twenty](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-sso), который специализируется на настройке SSO и систем идентификации. *(Предпочитаете связаться с Twenty напрямую? [contact@twenty.com](mailto:contact@twenty.com))*
+</Tip>

packages/twenty-docs/l/ru/user-guide/permissions-access/how-tos/permissions-faq.mdx

@@ -0,0 +1,120 @@
+---
+title: Часто задаваемые вопросы о разрешениях.
+description: Часто задаваемые вопросы о ролях и разрешениях.
+---
+
+## Роли
+
+<AccordionGroup>
+<Accordion title="Какие роли доступны в Twenty по умолчанию?">
+Двадцать поставляется с **Администраторами** и **Участником** по умолчанию. Вы можете создавать дополнительные пользовательские роли в зависимости от потребностей вашей команды (например, торговый представитель, менеджер, пользователь только для чтения).
+</Accordion>
+
+<Accordion title="Могу ли я удалить роль Администратора?">
+Нет, роль Администратора удалить нельзя. На роль Администратора всегда должен быть назначен как минимум один участник.
+</Accordion>
+
+<Accordion title="Что произойдёт, если я удалю роль?">
+Любой участник рабочего пространства, назначенный на эту роль, будет автоматически переназначен на роль по умолчанию.
+</Accordion>
+
+<Accordion title="Как установить роль по умолчанию для новых участников?">
+Перейдите в **Настройки → Участники → Роли**, найдите параметр **Роль по умолчанию** и выберите, какую роль новые участники должны автоматически получать при присоединении.
+</Accordion>
+
+<Accordion title="Могу ли я назначить одному пользователю несколько ролей?">
+Нет, у каждого пользователя может быть только одна роль одновременно. Создайте пользовательскую роль, если вам нужна комбинация разрешений.
+</Accordion>
+</AccordionGroup>
+
+## Разрешения
+
+<AccordionGroup>
+<Accordion title="В чём разница между разрешениями на объекты и на поля?">
+* **Разрешения на объекты**: Управляют доступом ко всем записям целиком (например, можно видеть/редактировать/удалять записи объекта «Люди»)
+* **Разрешения на поля**: Управляют доступом к конкретным полям внутри объекта (например, можно видеть, но не редактировать поле «Зарплата»)
+
+Разрешения на поля позволяют более тонко контролировать доступ к конфиденциальным данным.
+</Accordion>
+
+<Accordion title="Как работает переопределение разрешений?">
+Разрешения применяются каскадно — от общих к конкретным:
+1. **Все объекты** задаёт базовый уровень для всех объектов
+2. **Разрешения на уровне объекта** могут переопределять глобальные настройки для конкретных объектов
+3. **Разрешения на уровне поля** могут переопределять настройки объекта для конкретных полей
+
+Более конкретные настройки всегда имеют приоритет.
+</Accordion>
+
+<Accordion title="Что означают разные уровни разрешений?">
+Для объектов:
+* **Просмотр записей**: Просмотр записей в списках и на страницах подробной информации
+* **Редактирование записей**: Изменение существующих записей
+* **Удаление записей**: Мягкое удаление записей (их можно восстановить)
+* **Полное удаление записей**: Безвозвратное удаление записей
+
+Для полей:
+* **Просмотр поля**: Просмотр значения поля
+* **Редактирование поля**: Изменение значения поля
+* **Нет доступа**: Поле полностью скрыто
+</Accordion>
+
+<Accordion title="Могу ли я ограничить доступ к отдельным записям (разрешения на уровне строки)?">
+Разрешения на уровне строки доступны в тарифе **Organization**. Это позволит ограничивать доступ к отдельным записям на основе критериев (например, видеть только собственные сделки).
+</Accordion>
+
+<Accordion title="Как сделать поле доступным только для чтения для отдельных пользователей?">
+1. Перейдите в **Настройки → Участники → Роли**
+2. Выберите роль
+3. Перейдите к объекту, который содержит это поле
+4. Установите для поля разрешение **Просмотр поля** (без **Редактирование поля**)
+</Accordion>
+</AccordionGroup>
+
+## Настройки и действия
+
+<AccordionGroup>
+<Accordion title="Какие разрешения на настройки доступны?">
+Вы можете управлять доступом к:
+* Создание ключей API
+* Настройки рабочего пространства
+* Назначение ролей
+* Настройка модели данных
+* Настройки безопасности
+* Управление рабочими процессами
+
+Используйте **Settings All Access**, чтобы предоставить полный доступ, или включайте конкретные разрешения.
+</Accordion>
+
+<Accordion title="Какие разрешения на действия доступны?">
+Вы можете управлять:
+* **Отправка электронной почты**: Возможность отправлять письма из Twenty
+* **Импорт CSV**: Возможность импортировать данные через CSV
+* **Экспорт CSV**: Возможность экспортировать данные в CSV
+
+Используйте **Application All Access**, чтобы предоставить все действия, либо включайте отдельные.
+</Accordion>
+</AccordionGroup>
+
+## Единая система идентификации
+
+<AccordionGroup>
+<Accordion title="Доступна ли SSO во всех тарифах?">
+Нет, SSO — это премиум-функция, доступная только в тарифе **Organization**.
+</Accordion>
+
+<Accordion title="Какие поставщики идентификации поддерживаются?">
+Twenty поддерживает:
+* **SAML 2.0** (работает с большинством корпоративных поставщиков идентификации)
+* **Google Workspace**
+* **Microsoft Entra ID** (ранее Azure AD)
+</Accordion>
+
+<Accordion title="Что такое подготовка Just-in-Time (JIT)?">
+При JIT-подготовке учетные записи пользователей автоматически создаются в Twenty, когда кто-то впервые входит через SSO. Им автоматически назначается роль по умолчанию.
+</Accordion>
+
+<Accordion title="Могу ли я обязать всех пользователей использовать SSO?">
+Да, после настройки SSO вы можете отключить вход по паролю для пользователей SSO, чтобы принудительно обеспечивать аутентификацию через вашего поставщика идентификации.
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/ru/user-guide/permissions-access/overview.mdx

@@ -0,0 +1,34 @@
+---
+title: Права доступа и доступ
+description: Управляйте ролями, разрешениями и контролем доступа в вашем рабочем пространстве.
+---
+
+Система разрешений Twenty позволяет контролировать, кто может получать доступ и изменять данные в вашем рабочем пространстве. Создавайте роли, назначайте разрешения и настраивайте SSO для безопасного доступа.
+
+## Что в этом разделе
+
+<CardGroup cols={2}>
+  <Card title="Разрешения" icon="lock" href="/l/ru/user-guide/permissions-access/capabilities/permissions">
+    Создавайте роли и настраивайте разрешения для объектов, полей и настроек.
+  </Card>
+  <Card title="Конфигурация SSO" icon="key" href="/l/ru/user-guide/permissions-access/capabilities/sso-configuration">
+    Настройте единый вход (SSO) с вашим провайдером удостоверений.
+  </Card>
+  <Card title="Частые вопросы" icon="circle-question" href="/l/ru/user-guide/permissions-access/how-tos/permissions-faq">
+    Распространенные вопросы о ролях, разрешениях и SSO.
+  </Card>
+</CardGroup>
+
+## Ключевые возможности
+
+* **Доступ на основе ролей**: создавайте пользовательские роли с определенными разрешениями
+* **Разрешения для объектов**: контролируйте, кто может просматривать, редактировать или удалять записи
+* **Разрешения для полей**: ограничивайте доступ к конфиденциальным полям
+* **Разрешения для настроек**: управляйте доступом к конфигурации рабочего пространства
+* **Интеграция SSO**: настройте единый вход (SSO) для корпоративной безопасности (план Organization)
+
+## Быстрые ссылки
+
+* [Создать роль](/l/ru/user-guide/permissions-access/capabilities/permissions#create-a-role)
+* [Настроить SSO](/l/ru/user-guide/permissions-access/capabilities/sso-configuration)
+* [Управлять участниками команды](/l/ru/user-guide/settings/capabilities/member-management)