Connexion par passkey (Face ID, Touch ID, empreinte)

未关闭
#131 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
25/100
Issue 类型
功能
描述清晰度
描述清楚
活跃度
活跃
技术栈
go, redis

调研方向

Start by reading the backend configuration and user login flow, then inspect the SvelteKit login and account settings routes and the existing database migration patterns. The issue specifies Redis backed WebAuthn challenges, passkey management, browser support checks, and session compatibility. Done means all listed acceptance criteria and service tests pass, with a changelog entry.

由索引模型根据 Issue 内容生成。

描述

agent-ready backend enhancement frontend security

User story

En tant que musicien, je veux me connecter avec Face ID, Touch ID ou mon empreinte (passkey), afin de ne plus jamais avoir à taper ni retenir de mot de passe, y compris dans la PWA installée.

Les passkeys sont synchronisées par iCloud Keychain et le gestionnaire de mots de passe Google : un membre qui change de téléphone retrouve sa passkey. Ça répond directement au problème des mots de passe perdus, sans service tiers ni email.

Tâches

Base de données
  1. Migration : table user_passkeys (id, user_id FK users ON DELETE CASCADE, credential_id unique, public_key, sign_count, transports, aaguid, name modifiable (ex. « iPhone de Léa »), created_at, last_used_at).
Backend
  1. Bibliothèque github.com/go-webauthn/webauthn. Configuration via backend/config/ : WEBAUTHN_RP_ID (ex. setly.fr, localhost en dev), WEBAUTHN_RP_ORIGINS, WEBAUTHN_RP_NAME (« Setly »), à ajouter à .env.example.
  2. Enregistrement (JWTAuthUserOnly) : POST /api/user/passkeys/register/begin et /finish. Les données de session WebAuthn (challenge) sont stockées dans Redis avec un TTL de 5 min et consommées une seule fois. User verification required, resident key required (pour permettre la connexion sans saisir de nom d'utilisateur).
  3. Connexion (public, rate-limité) : POST /api/auth/passkey/begin et /finish, en mode « discoverable » (aucun nom d'utilisateur demandé). Au succès : mise à jour de sign_count et last_used_at, puis exactement la même AuthResponse que UserService.Login.
  4. Gestion (JWTAuthUserOnly) : GET /api/user/passkeys, PATCH /api/user/passkeys/{id} (renommer), DELETE /api/user/passkeys/{id}. Refuser la suppression si c'est le dernier moyen de connexion du compte (pas de mot de passe, pas d'identité Google, une seule passkey).
Frontend
  1. Le serveur SvelteKit relaie les appels au backend et pose les cookies au succès, comme pour le login classique (le navigateur n'appelle jamais le backend directement). Côté navigateur, navigator.credentials.create/get, ou @simplewebauthn/browser pour l'encodage.
  2. Page de connexion : bouton « Se connecter avec une passkey », et autocomplete="username webauthn" sur le champ nom d'utilisateur pour l'interface conditionnelle (suggestion automatique de la passkey).
  3. Paramètres du compte, section « Connexion » : liste des passkeys (nom, date, dernière utilisation), ajouter, renommer, supprimer.
  4. Après une connexion par mot de passe réussie sur un appareil compatible (PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable()), proposer une fois « Activer Face ID / empreinte pour la prochaine fois ? » (refus mémorisé par appareil).

Critères d'acceptation

  • Étant donné un membre connecté, quand il ajoute une passkey, alors elle apparaît dans ses paramètres et il peut se reconnecter avec, sans saisir de nom d'utilisateur.
  • Étant donné un challenge déjà consommé ou expiré, alors l'enregistrement ou la connexion échoue.
  • Étant donné une assertion dont l'origine ne fait pas partie de WEBAUTHN_RP_ORIGINS, alors la connexion échoue.
  • Les sessions issues d'une passkey sont identiques aux sessions classiques.
  • La suppression du dernier moyen de connexion d'un compte est refusée.
  • Le navigateur sans support WebAuthn n'affiche aucun bouton passkey, et le login classique fonctionne.
  • Tests unitaires des services (challenge à usage unique, règles de suppression, sessions), mocks à jour.
  • CHANGELOG.md : une ligne sous ## [Non publié] → ### Ajouté.

Remarques

  • Ce ticket et #95 (Google) touchent tous les deux la page de connexion et les paramètres du compte : la section « Connexion » des paramètres doit accueillir les deux.
  • WebAuthn exige HTTPS (ou localhost). Vérifier la PWA installée sur iOS et Android avant la release.
主要语言
Python
星标
2
派生
0
平均合并
21 分钟
30 天内合并 PR
2

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

Doud75/Setly 的其他 Issue

查看 Doud75/Setly 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。