← Yaroslav Koval

Open-source project

rust-axum-passkey

Тонкая JSON-консоль над passkey-rs.

View on GitHub

$ git clone https://github.com/koval01/rust-axum-passkey.git

README

rust-axum-passkey (demo)

Тонкая JSON-консоль над [passkey-rs](../passkey-rs).

На живой странице вкладка Guide — тот же глоссарий, что ниже (удобно читать рядом с Network).

Полный стек в Docker

docker compose up --build

| Сервис | Доступ |
|--------|--------|
| App | только через cloudflared (порты на хост не публикуются) |
| Tunnel | docker compose logs -f cloudflared → https://*.trycloudflare.com |
| Postgres / Redis | localhost:5432 / 6379 (для отладки с хоста) |

Localhost к app закрыт (BLOCK_LOCALHOST + нет publish ports). RP выставляется туннелем через POST /debug/rp.

В RustRover: Demo Stack (Docker Compose) / Demo Stack (compose up).

Нужен соседний [../passkey-rs](../passkey-rs).

Env: PASSKEY_ATTESTATION=compatible|none|packed, PASSKEY_TRUST_FORWARDED=1 (за cloudflared).

Логи

- RUST_LOG=debug,... в compose — подробный серверный лог
- Вкладка Server — SSE POST /debug/logs (Quick Tunnel буферит GET SSE; POST стримит)

E2E / локальный HTTPS без Docker app

cargo run   # https://localhost:8443
npm run test:e2e

WebAuthn / passkey — что это такое (для веб-разработчиков)

Passkey — не «ещё одна OAuth-кнопка». Это WebAuthn: браузер + аутентификатор доказывают владение приватным ключом, не отправляя секрет на сервер. На сервере лежит только публичный ключ.

Полный цикл **begin → navigator.credentials.* → finish называется ceremony** (церемония).

Register:  POST /api/register/begin  →  credentials.create()  →  POST /api/register/finish
Login:     POST /api/login/begin     →  credentials.get()     →  POST /api/login/finish

Relying Party, rpId, origin

| Термин | Смысл |
|--------|--------|
| Relying Party (RP) | Ваш сайт, которому доверяют passkey |
| rpId | Домен, к которому привязан ключ. Ключ с example.com не работает на evil.com |
| origin | https://host страницы; обязан совпасть в clientDataJSON — защита от фишинга |

В Docker-демо rpId/origin = hostname quick tunnel (*.trycloudflare.com). После recreate URL новый — старые passkeys к старому hostname не подойдут.

Поля, которые видите в Network

| Поле | Зачем |
|------|--------|
| challenge | Одноразовые случайные байты от сервера. Входят в подпись; без них возможен replay. Короткий TTL + (у нас) привязка к IP-hash |

[... continued on GitHub]

More projects

By Yaroslav Koval · Telegram · LinkedInHome