Formations — 1 037 leçons en français

Accueil › Spring Boot › Authentification : utilisateurs et mots de passe

Authentification : utilisateurs et mots de passe

Spring Securityintermediaire

S'authentifier, c'est prouver qui on est. Spring Security sépare deux responsabilités :

En base de données, avec Spring Data JPA :

public interface UtilisateurRepository extends JpaRepository<Utilisateur, Long> {
    Optional<Utilisateur> findByUsername(String username);
}

@Service
public class JpaUserDetailsService implements UserDetailsService {

    private final UtilisateurRepository repo;

    public JpaUserDetailsService(UtilisateurRepository repo) {
        this.repo = repo;
    }

    @Override
    public UserDetails loadUserByUsername(String username) {
        Utilisateur u = repo.findByUsername(username)
            .orElseThrow(() -> new UsernameNotFoundException("Utilisateur introuvable : " + username));
        return User.withUsername(u.getUsername())
            .password(u.getMotDePasseEncode()) // déjà encodé, ex. "{bcrypt}$2a$..."
            .roles(u.getRole())
            .build();
    }
}

Et pour encoder un mot de passe à l'inscription :

@Bean
PasswordEncoder passwordEncoder() {
    return PasswordEncoderFactories.createDelegatingPasswordEncoder(); // encode en bcrypt par défaut
}

Le DaoAuthenticationProvider, utilisé automatiquement dès qu'un UserDetailsService et un PasswordEncoder sont des beans, assemble les deux : il appelle le premier pour charger l'utilisateur, puis le second pour vérifier le mot de passe.

Les termes à connaître

UserDetailsService

Interface à un seul rôle : loadUserByUsername(String username) renvoie un UserDetails, ou lève UsernameNotFoundException si l'utilisateur n'existe pas. C'est le point d'extension pour charger vos utilisateurs (base de données, LDAP…).

UserDetails

Interface qui représente un utilisateur pour Spring Security : nom, mot de passe (déjà encodé), autorités (GrantedAuthority), et des indicateurs de compte (isEnabled(), isAccountNonExpired(), isAccountNonLocked(), isCredentialsNonExpired()).

PasswordEncoder

Interface avec deux méthodes : encode(rawPassword) pour stocker un mot de passe, matches(rawPassword, encodedPassword) pour le vérifier à la connexion. Ne jamais comparer des mots de passe en clair soi-même.

BCryptPasswordEncoder

Implémentation la plus courante : algorithme bcrypt, avec un sel aléatoire intégré au résultat et un facteur de coût réglable (plus il est élevé, plus l'encodage — et une attaque par force brute — est lent).

DelegatingPasswordEncoder

PasswordEncoder renvoyé par PasswordEncoderFactories.createDelegatingPasswordEncoder(), utilisé par défaut par Spring Boot. Il préfixe chaque mot de passe encodé d'un identifiant entre accolades ({bcrypt}...) qui indique l'algorithme à utiliser pour le vérifier.

InMemoryUserDetailsManager

Implémentation de UserDetailsService qui garde les utilisateurs en mémoire, déclarés au démarrage. Pratique pour un prototype, une démo ou un test ; pas pour une vraie base d'utilisateurs.

AuthenticationManager

Interface centrale qui reçoit une Authentication non vérifiée et renvoie une Authentication vérifiée (ou lève une exception). Son implémentation par défaut, ProviderManager, délègue à une liste d'AuthenticationProvider, dont le DaoAuthenticationProvider qui s'appuie sur UserDetailsService et PasswordEncoder.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.