# OpenFGA: права доступа на практике

Авторский учебный проект ae-nekrasov.ru. OpenFGA 1.22.1, @openfga/sdk 0.9.8,
Bootstrap 5.3.9, Node 24 LTS. Только вымышленные пользователи, группы и документы.

## Механизм

Capture создаёт восемь новых временных stores в собственном OpenFGA сервере,
записывает модель/отношения, действительно вызывает Check, ListObjects, удаление
отношений и HTTP-пример. Stores удаляются в finally. Браузер переключает записи
этих настоящих запусков: на публичном сайте нет открытого OpenFGA API.

Модель: user, group, organization, project, document. У документа есть owner/editor/
viewer, can_edit и can_view; права наследуются от parent project, а у проекта —
от organization. В этой учебной политике member организации видит документы,
admin редактирует. Для чувствительных документов выберите другую модель.

## Windows / PowerShell

```powershell
docker compose -p aen-openfga-lab up -d openfga
Invoke-RestMethod http://127.0.0.1:18088/healthz
npm ci --ignore-scripts --no-audit --no-fund
npm run capture
npm test
npm run build
npm run serve
# http://127.0.0.1:8554/
```

## Linux / Bash

```bash
docker compose -p aen-openfga-lab up -d openfga
curl --fail http://127.0.0.1:18088/healthz
npm ci --ignore-scripts --no-audit --no-fund
npm run capture
npm test
npm run build
npm run serve
```

Если Node на хосте не нужен, проверочный клиент Linux входит в Compose:

```bash
docker compose -p aen-openfga-lab run --rm linux
```

Он устанавливает зависимости во временном каталоге, запускает настоящий клиент
против сервиса openfga:8080 и сохраняет recording-linux.json в public. Главный
сервер — Linux Docker даже при Windows-клиенте. node_modules между ОС не переносим.
Перед capture убедитесь, что /healthz доступен. Имена проекта/порты можно изменить
только вместе с разрешёнными isolated endpoints в src/client.mjs.

## Остановка своего стенда

```bash
docker compose -p aen-openfga-lab down
```

Останавливайте только свой project. Не используйте глобальные prune или удаление
контейнеров других приложений. Лаборатория использует memory datastore: данные
сервера не предназначены для хранения между перезапусками. Загрузки контейнеров
и npm требуют сеть; сами учебные HTTP-запросы идут в изолированный стенд.

## Только просмотр

Готовая public уже содержит обе записи. npm run serve использует стандартные
модули Node и не требует SDK или запущенного OpenFGA. Локальный порт 8554 слушает
127.0.0.1; Ctrl+C завершает сервер. PORT позволяет выбрать другой номер.

```powershell
$env:PORT = '8654'
npm run serve
# Альтернатива с PHP:
php -S 127.0.0.1:8554 -t public
```

## Check и ListObjects

Клиент закрепляет storeId и authorizationModelId. Для демонстрации отзыва
запросы используют HIGHER_CONSISTENCY. Список из ListObjects содержит ID,
не содержимое документов. Для получения данных запросите собственную БД;
не доверяйте произвольному user/relation из браузера.

## Серверный пример

src/enforcement.mjs запускает небольшой HTTP-сервер на случайном loopback-порту.
Синтетическая таблица demoSessions заменяет вход только в тесте. Для production
нужна настоящая проверенная сессия/токен. Capture подтверждает 200 для владельца,
401 без сессии, 403 чужому пользователю, 403 при подмене user в query и 503 при реальном
отказе соединения с отдельным отключённым endpoint авторизации.

Обычный false — отказ в праве. Ошибка сети — 503 и отсутствие тела документа,
а не разрешение по умолчанию. Это демонстрация fail-closed, не полноценный auth
framework. Выдача/отзыв tuples тоже требуют авторизации вашего управляющего API.

## Исходники и ограничения

public/sources.json содержит точные файлы проекта. В записи сохранены hashes,
матрицы всех запросов, выбранные связи и модель. Сгенерированные store/model IDs не
публикуются в запросах: каждый опубликованный пример показывает типы и relation,
а результаты связаны с canonical model SHA. Удаление временных stores не
доказывает очистку каких-либо ранее существовавших данных.

Production PostgreSQL, HA и восстановление backup в этой лаборатории не испытываются. Для VPS
есть отдельный шаблон compose.production.example.yaml и VPS.md. Не используйте
memory datastore и открытый anonymous API для рабочих полномочий.

Авторский код MIT; @openfga/sdk Apache 2.0; Bootstrap MIT. Лицензии в public/LICENSES.txt.
Официальные источники: https://openfga.dev/docs/ и https://github.com/openfga/js-sdk
