Протокол v2
В документации v2 обозначает версию API Kontur 4.0. Внешний сайт можно подключить по заявке.
Цепочка: challenge → finalize → verify. Challenge и каждая назначенная сервером следующая задача живут 120 секунд, квитанция — 60 секунд, поток — не более 30 минут. Повтор идентичного finalize возвращает исходный результат без продления сроков.
{
"challenge": {
"kind": "normal | image | work | accessible",
"token": "JWE",
"salt": "random",
"pow": {
"algorithm": "sha256-chain",
"step_bits": 16,
"steps": 8
},
"flow_id": "random",
"expires_at": "ISO timestamp"
},
"finalize": {
"sitekey": "public",
"token": "JWE",
"nonce": "solution",
"signals": "trace snapshot",
"answer": "optional image code"
},
"verify": {
"secret": "server only",
"response": "receipt JWE",
"request_id": "operation UUID",
"expected_action": "signup",
"expected_hostname": "shop.example.com",
"remoteip": "optional"
}
}Задачи и квитанции — JWE A256GCM, alg=dir, с идентификатором ключа. Назначения и типы токенов разделены. Клиент не назначает стадию, сложность и число попыток. Действие, сайт, контекст и hostname сохраняются на всех переходах.
PostgreSQL атомарно хранит переход, погашение и результат. Кеш verify живёт пять минут: тот же request_id и те же параметры дают исходный ответ; другие параметры — 409, другая операция с погашенным пропуском — отказ. Перед чтением кеша секрет проверяется заново. Сбой БД даёт 503.
RemoteIP сравнивается по сети. Неопределённость IPv4/IPv6 не считается нарушением. При необходимом усилении сервер один раз назначает вычисление, после которого поток может завершиться без цикла дополнительных проверок.