# auth.md

Документ для программных агентов, которые обращаются к данным каталога
магазина Бертон (компрессоры HIBLOW, ремкомплекты, запчасти).

## Аудитория

Агенты и языковые модели, которым нужно прочитать каталог: состав разделов,
модели, цены, условия доставки и оплаты.

## Что доступно без регистрации

Публичное чтение открыто и не требует ключей:

- карта сайта — https://www.hiblow-compressors.ru/sitemap.xml
- выжимка для моделей — https://www.hiblow-compressors.ru/llms.txt
- описание API — https://www.hiblow-compressors.ru/openapi.json
- навыки — https://www.hiblow-compressors.ru/.well-known/agent-skills/index.json

## Регистрация агента

```json
{
  "agent_auth": {
    "skill": "https://www.hiblow-compressors.ru/.well-known/agent-skills/index.json",
    "register_uri": "https://www.hiblow-compressors.ru/agent/oauth/register/",
    "claim_uri": "https://www.hiblow-compressors.ru/agent/oauth/claim/",
    "identity_types_supported": ["anonymous"],
    "anonymous": {
      "credential_types_supported": ["identity_assertion"],
      "claim_uri": "https://www.hiblow-compressors.ru/agent/oauth/claim/"
    }
  }
}
```

Метаданные защищённого ресурса: https://www.hiblow-compressors.ru/.well-known/oauth-protected-resource
Метаданные сервера авторизации: https://www.hiblow-compressors.ru/.well-known/oauth-authorization-server

Регистрация выдаёт identity_assertion сразу, без церемонии подтверждения
владельца — /agent/oauth/claim/ отвечает not_offered: у Бертона нет модели
«владелец подтверждает агента», каталог публичен и так.

Способ передачи токена — заголовок `Authorization: Bearer <token>`.
Область доступа — `catalog:read`.

## Ограничения

Оформление заказов через агентов не поддерживается: заказ оформляется человеком
на сайте. Агенту доступно только чтение каталога и справочной информации.