Comment fonctionne une connexion
Une connexion ressemble à un simple formulaire. Derrière, le navigateur, le serveur et la base de données s'échangent une douzaine de messages, et des contrôles en chemin protègent le compte. Voici le modèle de base que chaque développeur de notre équipe apprend en premier.
Le premier projet de notre stagiaire coop a été un site web à elle, dont aucun client ne dépend. Il lui apprend notre structure de fichiers, nos conventions de nommage et les modèles que nous utilisons pour regrouper composants et utilitaires. Il lui donne aussi une base sur laquelle bâtir.
Les pages et le routage se sont mis en place rapidement. La connexion a été le premier vrai problème. Elle est complexe pour quiconque n'en a jamais construit, et un diagramme aide. Voici comment nous l'avons abordée.
Une connexion ressemble à un simple formulaire. Derrière, le navigateur, le serveur et la base de données s'échangent une douzaine de messages, et des contrôles en chemin protègent le compte.
C'est le modèle de base de la connexion, et chaque développeur de notre équipe l'apprend en premier.
L'ossature
Navigateur : envoie les identifiants au serveur.
Serveur : recherche l'utilisateur.
Base de données : renvoie l'enregistrement stocké.
Serveur : vérifie les identifiants par rapport à l'enregistrement stocké et crée une session avec une date d'expiration.
Base de données : stocke la session.
Serveur : renvoie un jeton au navigateur dans un cookie.
Navigateur : envoie ce cookie avec chaque requête suivante.
Serveur : vérifie la session avant de renvoyer la moindre donnée.
Base de données : confirme que la session existe et qu'elle est toujours active.
Serveur : rejette une session expirée et met fin à la session quand l'utilisateur se déconnecte.
Base de données : supprime l'enregistrement de session dans les deux cas.
Les points de contrôle clés
Le serveur décide à chaque requête
Le serveur décide qui est l'utilisateur et ce à quoi il peut accéder. Le navigateur présente les identifiants ou le jeton. Le serveur les valide, vérifie l'enregistrement de session dans la base de données à chaque requête et répond avec ce que cet utilisateur peut voir. Une requête sans session active reçoit un 401 et aucune donnée.
Stocker un hachage lent de chaque mot de passe
Le serveur stocke un hachage lent et à sens unique de chaque mot de passe, avec un sel unique. Le mot de passe lui-même n'est jamais stocké. À la connexion, le serveur hache le mot de passe soumis de la même façon et compare les deux résultats. Une base de données volée ne contient que des hachages salés, et chaque tentative contre eux est lente.
Garder le jeton dans un cookie protégé
Le navigateur joint automatiquement un cookie à chaque requête vers votre site, et il peut garder ce cookie hors de portée des scripts de la page. Placez trois indicateurs sur le cookie. HttpOnly empêche les scripts de la page de le lire. Secure ne l'envoie que par HTTPS. SameSite empêche d'autres sites de le joindre aux formulaires et aux requêtes en arrière-plan qu'ils envoient au vôtre.
Vérifier l'accès à chaque requête de données
Une session active prouve qui est l'utilisateur. Chaque appel qui renvoie des données vérifie aussi que cet utilisateur peut voir l'enregistrement demandé. La session de chaque client n'atteint que les données de ce client.
Donner une expiration à chaque session
Le serveur stocke chaque session dans la base de données avec sa date d'expiration. À chaque requête, le serveur vérifie cette expiration avant de renvoyer des données. Une session prend fin à une heure fixée ou après une période d'inactivité, et le serveur supprime son enregistrement de la base de données. Une expiration courte et un délai d'inactivité limitent la durée pendant laquelle un jeton copié fonctionne.
Se déconnecter sur le serveur
Le navigateur demande au serveur de déconnecter l'utilisateur. Le serveur supprime l'enregistrement de session de la base de données, puis efface le cookie. Un jeton copié cesse de fonctionner dès que l'enregistrement disparaît.
Répondre de la même façon à chaque échec de connexion
« Nom d'utilisateur ou mot de passe incorrect » couvre chaque échec. Des messages distincts pour un utilisateur inconnu et un mauvais mot de passe indiquent à un attaquant quels comptes existent. Le serveur ralentit aussi les tentatives répétées pour chaque compte et chaque adresse.
Le code, par flux de travail
Le diagramme montre une douzaine de messages. Le code derrière eux suit le flux de travail. Un seul appel traite plusieurs étapes, et la logique que les étapes partagent se trouve à un seul endroit.
| Flux de travail | Exemple | Couvre |
|---|---|---|
| Connexion | POST /api/login | Le hachage, le cookie protégé et le message d'échec unique |
| Chaque requête | Une vérification exécutée avant chaque route protégée | La décision du serveur, la session active et l'expiration |
| Appels de données | Chaque point d'accès qui renvoie des enregistrements | L'accès aux données pour l'enregistrement demandé |
| Déconnexion | POST /api/logout | La fin de la session sur le serveur et dans la base de données |
| Logique partagée | Un module que partagent les appels ci-dessus | Le hachage des mots de passe, les sessions, les indicateurs du cookie et l'expiration |
| Côté navigateur | Un utilitaire que chaque page utilise | La connexion, la déconnexion et l'utilisateur courant |
L'appel de connexion exécute toute la connexion en une seule requête. Il recherche l'utilisateur, compare les hachages et place le cookie. Il renvoie la même erreur pour chaque échec.
La vérification de requête s'exécute avant chaque route protégée. Elle lit le cookie, vérifie la session dans la base de données et répond 401 quand la session n'existe plus.
Le module partagé contient la logique que partagent les appels ci-dessus. Le hachage, les indicateurs du cookie et la règle d'expiration y figurent chacun une seule fois. Chaque appel les applique de la même façon.
L'utilitaire du navigateur donne à chaque page la même connexion, la même déconnexion et le même utilisateur courant. Il façonne ce que la page affiche. Le serveur décide quelles données sortent.
Bâtir dessus
Le modèle est extensible, et c'est son principal avantage. Une fois les fondamentaux en place, chaque élément devient quelque chose que vous pouvez remplacer. L'authentification unique par OpenID Connect ou SAML change la façon dont un utilisateur prouve son identité. Les clés d'accès aussi. Les intergiciels sur le serveur et dans le navigateur se branchent sur les mêmes étapes. Chacun d'eux part des bases ci-dessus.
Demander une démo
Contactez-nous. Nous vous présentons Aptli sur les types d'enregistrements que vous nommez.