Изменение статуса 2FA для группы

Изменяет статус обязательной двухфакторной аутентификации для группы. Чтобы изменить остальные параметры группы, воспользуйтесь запросом «Изменить параметры группы» на хост api360.yandex.net.

Отправить запрос может администратор организации или сотрудник с ролью Менеджер пользователей.

Этот инструмент доступен в тарифах для крупных организаций Корпоративный + Безопасность и Корпоративный Максимум. Чтобы узнать подробности, оставьте заявку: менеджер Яндекс 360 свяжется с вами, ответит на все вопросы и поможет с подключением. Оставить заявку

Метод актуален, если:

В организации установлена двухфакторная аутентификация через сервис для управления 2FA с возможностью персональной настройки или в интерфейсе Кабинета организации.
Режим двухфакторной аутентификации enforcement_mode: per_user — только отдельным сотрудникам. Узнать режим, который установлен для 2FA в вашей организации, можно с помощью метода, описанного в разделе Посмотреть статус 2FA с возможностью персональной настройки.

Особенности обязательной 2FA для группы

На кого распространяется

Статус 2FA действует только на участников группы с аккаунтами на домене организации:

Начинает действовать при вступлении сотрудника в группу.
Перестает действовать после удаления сотрудника из группы.
Не распространяется на вложенные группы — для них нужно задавать статус отдельно.

Как работает с персональной 2FA

Статус 2FA для группы не изменяет персональную настройку 2FA у сотрудников:

Если для группы установлено is_2fa_enabled=true, сотрудники будут обязаны проходить 2FA.
При этом методы, возвращающие персональный статус 2FA, по-прежнему будут показывать is_2fa_enabled=false для этих сотрудников.

Правила применения 2FA

Сотрудник обязан проходить 2FA, если хотя бы один из параметров is_2fa_enabled имеет значение true:

Персональная настройка 2FA.
Настройка 2FA для подразделения.
Настройка 2FA хотя бы для одной из групп, в которых состоит сотрудник.

Для выполнения запроса требуется право directory:write_groups.

Request

PATCH

https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/groups/{group_id}

Path parameters

Name

Description

group_id

Type: integer

Идентификатор группы.

org_id

Type: integer

Идентификатор организации.

Body

application/json

{
  "default_email": "team@example.com",
  "is_2fa_enabled": true
}

Name

Description

default_email

Type: string

Адрес, используемый по умолчанию.

Example: team@example.com

is_2fa_enabled

Type: boolean

Статус обязательной двухфакторной аутентификации для группы.

Возможные значения:

true — включена;
false — выключена.

Responses

200 OK

Параметры группы изменены.

Body

application/json

{
  "id": 7654321,
  "name": "Команда разработки",
  "type": "generic",
  "description": "Группа сотрудников отдела разработки.",
  "label": "development-team",
  "members_count": 12,
  "email": "team@example.com",
  "default_email": "team@example.com",
  "aliases": [
    "developers"
  ],
  "external_id": "group-123",
  "removed": false,
  "member_of": [
    {
      "id": 7654322
    }
  ],
  "created_at": "2026-05-01T10:00:00+00:00",
  "is_2fa_enabled": true
}

Name	Description
aliases	Type: string[] Алиасы почтовых рассылок группы. Example `[ "developers" ]`
created_at	Type: string Дата и время создания группы. Example: `2026-05-01T10:00:00+00:00`
default_email	Type: string Адрес, используемый по умолчанию. Example: `team@example.com`
description	Type: string Описание группы. Example: `Группа сотрудников отдела разработки.`
email	Type: string Адрес рассылки, по которому будут отфильтрованы группы. Example: `team@example.com`
external_id	Type: string Произвольный внешний идентификатор группы. Example: `group-123`
id	Type: integer Идентификатор группы.
is_2fa_enabled	Type: boolean Статус обязательной двухфакторной аутентификации для группы. Возможные значения: `true` — включена; `false` — выключена.
label	Type: string Имя почтовой рассылки группы. Example: `development-team`
member_of	Type: MemberOf Родительские группы, в которые входит текущая группа. Example `[ { "id": 7654322 } ]`
members_count	Type: integer Количество участников группы.
name	Type: string Название группы. Example: `Команда разработки`
removed	Type: boolean Признак удаленной группы: true — группа удалена; false — группа действующая.
type	Type: string Тип группы. Возможные значения: `generic` — стандартная группа, созданная одним из сотрудников организации. Пользователи могут изменять параметры такой группы и ее состав. `organization_admin` — группа администраторов организации. Неизменяемая техническая группа. `robots` — группа роботов. Неизменяемая техническая группа. `organization_deputy_admin` — группа менеджеров организации. Неизменяемая техническая группа." Example: `generic`

MemberOfItem

Родительская группа, в которую входит текущая группа.

Name

Description

Type: integer

Идентификатор группы.

Example

{
  "id": 7654322
}

MemberOf

Родительские группы, в которые входит текущая группа.

Type: MemberOfItem[]

Example

[
  {
    "id": 7654322
  }
]

403 Forbidden

Доступ к ресурсу запрещен. У пользователя или приложения недостаточно прав.

Body

application/json

{
  "error": "forbidden",
  "description": "Forbidden",
  "message": "Forbidden",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Forbidden

error

Type: string

Код ошибки

Example: forbidden

message

Type: string

Сообщение об ошибке.

Example: Forbidden

details

Type: object

Дополнительные детали ошибки

Example

{}

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json

{
  "error": "not_found",
  "description": "Not found",
  "message": "Not found",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Not found

error

Type: string

Код ошибки

Example: not_found

message

Type: string

Сообщение об ошибке.

Example: Not found

details

Type: object

Дополнительные детали ошибки

Example

{}

422 Unprocessable Entity

Возможные ошибки:

Feature unavailable
Invalid data

Body

application/json

{
  "error": "feature_unavailable",
  "description": "Feature unavailable",
  "message": "Feature unavailable",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Feature unavailable

error

Type: string

Код ошибки

Example: feature_unavailable

message

Type: string

Сообщение об ошибке.

Example: Feature unavailable

details

Type: object

Дополнительные детали ошибки

Example

{}

Была ли статья полезна?

Получить информацию о группе

Получить список подразделений