Выключить 2FA

Метод устарел и не поддерживается

Используйте новый метод Изменить статус 2FA.

Выключает обязательную двухфакторную аутентификацию для пользователей домена.

Примечание

Чтобы выполнить запрос, приложению требуется разрешение на управление обязательной двухфакторной аутентификацией. Убедитесь, что вы включили его при настройке приложения на OAuth-сервере Яндекса.

Request

DELETE

https://api360.yandex.net/security/v2/org/{orgId}/domain_2fa

Path parameters

Name

Description

orgId

Type: integer

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

Responses

200 OK

200 OK — запрос выполнен успешно.

Body

application/json
{
  "enabled": true,
  "duration": 0,
  "enabledAt": "2025-01-01T00:00:00Z",
  "scope": "example"
}

Name

Description

duration

Type: integer

Период (в секундах), в течение которого у пользователя в процессе авторизации есть возможность отложить настройку двухфакторной аутентификации. По истечении этого периода возможность отложить настройку отключается.

enabled

Type: boolean

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

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

enabledAt

Type: string<date-time>

Дата и время, когда была включена двухфакторная аутентификация.

Example: 2025-01-01T00:00:00Z

scope

Type: string

Режим двухфакторной аутентификации:

  • per_domain — сразу всем пользователям с аккаунтами на домене организации;
  • per_user — только отдельным сотрудникам. У кого именно из сотрудников настроен признак необходимости прохождения 2FA, если она включена в организации, можно узнать с помощью метода, описанного в разделе Посмотреть статус персональной 2FA.

Example: example

400 Bad Request

400 Bad Request — некорректный запрос.

Body

application/json
{
  "code": 0,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}

Name

Description

code

Type: integer

Код ошибки.

details

Type: protobufAny[]

Дополнительные сведения об ошибке.

Example
[
  {
    "@type": "example"
  }
]

message

Type: string

Описание ошибки.

Example: example

protobufAny

Name

Description

@type

Type: string

Example: example

[additional]

Type: unknown

Example: null
Example
{
  "@type": "example"
}

401 Unauthorized

401 Unauthorized — пользователь не авторизован.

Body

application/json
{
  "code": 0,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}

Name

Description

code

Type: integer

Код ошибки.

details

Type: protobufAny[]

Дополнительные сведения об ошибке.

Example
[
  {
    "@type": "example"
  }
]

message

Type: string

Описание ошибки.

Example: example

403 Forbidden

403 Forbidden — у пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.

Body

application/json
{
  "code": 0,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}

Name

Description

code

Type: integer

Код ошибки.

details

Type: protobufAny[]

Дополнительные сведения об ошибке.

Example
[
  {
    "@type": "example"
  }
]

message

Type: string

Описание ошибки.

Example: example

404 Not Found

404 Not Found — запрашиваемый ресурс не найден.

Body

application/json
{
  "code": 0,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}

Name

Description

code

Type: integer

Код ошибки.

details

Type: protobufAny[]

Дополнительные сведения об ошибке.

Example
[
  {
    "@type": "example"
  }
]

message

Type: string

Описание ошибки.

Example: example

500 Internal Server Error

500 Internal Server Error — внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

Body

application/json
{
  "code": 0,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}

Name

Description

code

Type: integer

Код ошибки.

details

Type: protobufAny[]

Дополнительные сведения об ошибке.

Example
[
  {
    "@type": "example"
  }
]

message

Type: string

Описание ошибки.

Example: example
Предыдущая
Включить 2FA
Следующая
Обзор