Connexion par passkey (Face ID, Touch ID, empreinte)
还没有人认领这个 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 内容生成。
描述
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
- Migration : table
user_passkeys(id,user_idFKusersON DELETE CASCADE,credential_idunique,public_key,sign_count,transports,aaguid,namemodifiable (ex. « iPhone de Léa »),created_at,last_used_at).
Backend
- Bibliothèque
github.com/go-webauthn/webauthn. Configuration viabackend/config/:WEBAUTHN_RP_ID(ex.setly.fr,localhosten dev),WEBAUTHN_RP_ORIGINS,WEBAUTHN_RP_NAME(« Setly »), à ajouter à.env.example. - Enregistrement (
JWTAuthUserOnly) :POST /api/user/passkeys/register/beginet/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 verificationrequired, resident keyrequired(pour permettre la connexion sans saisir de nom d'utilisateur). - Connexion (public, rate-limité) :
POST /api/auth/passkey/beginet/finish, en mode « discoverable » (aucun nom d'utilisateur demandé). Au succès : mise à jour design_countetlast_used_at, puis exactement la mêmeAuthResponsequeUserService.Login. - 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
- 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/browserpour l'encodage. - 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). - Paramètres du compte, section « Connexion » : liste des passkeys (nom, date, dernière utilisation), ajouter, renommer, supprimer.
- 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
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
Doud75/Setly 的其他 Issue
-
agent-ready chore
难度 2/5 1-3 小时 新手友好度 86/100
-
backend enhancement frontend security
难度 4/5 3-5 天 新手友好度 48/100
-
agent-ready backend enhancement frontend security
难度 5/5 一周以上 新手友好度 35/100
-
agent-ready backend bug frontend security
难度 5/5 一周以上 新手友好度 35/100
-
frontend
难度 5/5 一周以上 新手友好度 45/100
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 78/100
marketcalls/openalgo#2472 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 95/100
marimo-team/marimo#11949 ·
维护者通常 1 天内回复
-
bug server-time v2
难度 2/5 1-3 小时 新手友好度 76/100
modelcontextprotocol/servers#5559 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
jxxghp/MoviePilot#7449 ·
维护者通常 1 天内回复
-
devops help wanted
难度 2/5 1-3 小时 新手友好度 72/100
guaardvark/guaardvark#421 ·
维护者通常 2 天内回复