Kontur
О Kontur 4.0

Протокол 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 не считается нарушением. При необходимом усилении сервер один раз назначает вычисление, после которого поток может завершиться без цикла дополнительных проверок.