# Documentation Django 5.2.8

# Authentification des utilisateurs dans Django

Django contient un système d’authentification des utilisateurs. Il gère des comptes utilisateur, des groupes, des permissions et des sessions utilisateur basées sur les cookies. Cette section de la documentation expose le fonctionnement par défaut de l’authentification et présente également la manière d’étendre et de personnaliser ce système pour l’adapter aux besoins de votre projet.

## Aperçu

Le système d’authentification de Django gère aussi bien l’authentification que l’autorisation. En bref, l’authentification vérifie que l’utilisateur est bien celui qu’il prétend être et l’autorisation détermine ce qu’un utilisateur authentifié est autorisé à faire. Ici, nous utiliserons le terme authentification pour nous référer à ces deux tâches.

Le système d’authentification consiste en :

- Utilisateurs

- Permissions : drapeaux binaires (oui/non) indiquant si un utilisateur a le droit d’effectuer certaines tâches

- Groupes : une manière générique d’appliquer des étiquettes et des permissions à plus d’un utilisateur

- Un système de hachage de mots de passe configurable

- Outils de formulaires et de vues pour connecter les utilisateurs ou limiter l’accès au contenu

- Un système de moteur d’authentification enfichable

Le système d’authentification de Django est conçu de manière très générique et ne fournit pas certaines fonctionnalités couramment présentes dans les systèmes d’authentification sur le Web. Des solutions pour certains de ces problèmes courants ont été implémentées dans des paquets externes :

- Contrôle de la force des mots de passe

- Limitation des tentatives de connexion

- Authentification à des services externes (OAuth, par exemple)

- Permissions au niveau des objets

## Installation

La prise en charge de l’authentification est intégrée dans Django sous forme de module contribué dans `django.contrib.auth`. Par défaut, la configuration requise est déjà incluse dans le fichier `settings.py` généré par la commande `django-admin startproject`. Cette configuration consiste en deux éléments figurant dans le réglage `INSTALLED_APPS`:

1. `'django.contrib.auth'` contient le cœur du système d’authentification et ses modèles par défaut.

2. `'django.contrib.contenttypes'` est le système de types de contenu de Django qui permet d’associer des permissions aux modèles que vous créez.

et ces lignes dans le réglage `MIDDLEWARE`:

1. `SessionMiddleware` gère les sessions tout au long des requêtes.

2. `AuthenticationMiddleware` associe les utilisateurs aux requêtes en utilisant les sessions.

Avec ces réglages configurés, le lancement de la commande `manage.py migrate` crée les tables de base de données nécessaires pour les modèles liés à l’authentification et crée les permissions de tous les modèles définis dans les applications installées.

## Utilisation

Using Django’s default implementation

- Manipulation des objets utilisateur

- Permissions et autorisations

- Authentification dans les requêtes Web

- Gestion des utilisateurs dans le site d’administration

Référence de l’API de l’implémentation par défaut

Customizing Users and authentication

Password management in Django