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 :
- Charger l'utilisateur : un
UserDetailsServiceretrouve unUserDetails(nom, mot de passe encodé, rôles) à partir d'un nom d'utilisateur. - Vérifier le mot de passe : un
PasswordEncodercompare le mot de passe saisi au mot de passe stocké, sans jamais le déchiffrer (bcrypt n'est pas réversible).
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 unUserDetails, ou lèveUsernameNotFoundExceptionsi 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
PasswordEncoderrenvoyé parPasswordEncoderFactories.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
UserDetailsServicequi 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
Authenticationnon vérifiée et renvoie uneAuthenticationvérifiée (ou lève une exception). Son implémentation par défaut,ProviderManager, délègue à une liste d'AuthenticationProvider, dont leDaoAuthenticationProviderqui s'appuie surUserDetailsServiceetPasswordEncoder.
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.