Breadcrumbs

Сброс метода MFA

Метод используется для сброса и повторной настройки метода MFA для текущего пользователя. В результате метод устанавливает указанное новое значение manual_secret и возвращает набор из 10 одноразовых кодов, которые текущий пользователь может использовать для входа в Панель управления Клиента вместо метода MFA. Код ответа 200 OK.

Перед вызовом метода необходимо получить новое значение manual_secret (см. Создание параметров для настройки метода MFA).

POST {reseller_domain}/internal_api/mfa/reset

В этой статье:

Авторизация

Требуется авторизация с помощью access token пользователя.

Аргументы

Название

Тип параметра

Тип данных

Обязательный/ 
Опциональный

Описание

Content-Type

header

string

Обязательный

Тип данных, передаваемых в запросе. Укажите application/vnd.api+json

Accept

header

string

Обязательный

Поддерживаемые типы данных в ответе. Укажите application/vnd.api+json

X-Api-Locale

header

string

Опциональный

Двухбуквенный код языка данных в ответе

Authorization 

header

string

Обязательный

Действующий access token пользователя. Формат: Bearer <access token>

reseller_domain

path

string

Обязательный

Доменное имя реселлера

key

form

string

Обязательный

Ключ сбрасываемого метода MFA. Укажите тот же ключ, что и при вызове

Создание параметров для настройки метода MFA

params

form

object

Обязательный

Параметры метода MFA после сброса и повторной настройки текущим пользователем


code

form

string

Обязательный

Код, сгенерированный методом MFA (например, временный код, отображаемый в приложении для аутентификации)


manual_secret

form

string

Обязательный

Код для ручной настройки метода MFA, полученный при вызове 

Создание параметров для настройки метода MFA

Модель ответа

Модель ответа аналогична методу Создание резервных кодов.

Пример запроса

Bash
curl --location --request POST 'https://test.activeplatform.com/internal_api/mfa/reset' \
--header 'Content-Type: application/vnd.api+json' \
--header 'Accept: application/vnd.api+json' \
--header 'X-Api-Locale: en' \
--header 'Authorization: Bearer AccessTokenExample' \
--data-raw '{
     "data": {
        "attributes": {
            "key": "authenticator",
            "params": {
                "code": "123456",
                "manual_secret": "ABC123"
            }
        }
    }
}'

Пример ответа

JSON
{
    "backup_codes": [
        "b4c3da4f",
        "48a330cf",
        "7e3558ee",
        "676bd770",
        "661bcdfb",
        "7ada89f9",
        "800734a1",
        "73864b07",
        "88a55dd0",
        "76923f9e"
    ]
}