Aladdin Public API

IP whitelist

CIDR allowlist на каждый токен.

IP whitelist

Для каждого токена задаётся список разрешённых IP/CIDR.

  • Пустой список при выключенном «любой IP» отклоняет все запросы.
  • 0.0.0.0/0 и ::/0 допустимы только вместе с явным флагом allowAnyIp.
  • Клиентский IP берётся из одного hop reverse proxy (trust proxy = 1). Подмена X-Forwarded-For клиентом не обходит whitelist.

Неудачные попытки (неверный токен / чужой IP) пишутся в журнал событий без секрета и ограничиваются отдельным rate limit.

Пример отказа на любом GET

GET /v1/tasks HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly
{
  "statusCode": 403,
  "message": "Client IP is not allowed for this token",
  "error": "Forbidden"
}