🚀 Demo Spring Boot + Keycloak

---

🌐 English version available — click here!

---

📝 Présentation

Ce projet est un exemple d’application Spring Boot intégrant Keycloak pour la gestion de l’authentification, l’inscription des utilisateurs, l'envoie d'email et les opérations CRUD. Il s’adresse à toute personne souhaitant sécuriser une API REST avec Keycloak.

✨ Fonctionnalités

• 🔐 Authentification via Keycloak
• 📝 Inscription d’utilisateurs
• 🛡️ Gestion des rôles (admin, user)
• 🗂️ Opérations CRUD sur les entités principales

⚙️ Prérequis

• ☕ Java 17+
• 🐘 Maven
• 🐳 Docker (pour Keycloak)

🚦 Installation et démarrage

1. Cloner le projet

   git clone https://github.com/bayembacke221/demo-springboot-keycloak-auth-crud.git
   cd demo-springboot-keycloak-auth-crud

2. Lancer Keycloak avec Docker Compose

   docker-compose up -d

3. Configurer Keycloak

   Suivre les étapes ci-dessous (voir section "Configuration Keycloak").

4. Lancer l’application Spring Boot

   ./mvnw spring-boot:run

🛠️ Configuration Keycloak

1. Créer un Realm

2. Créer un Client

3. Créer des rôles

4. Créer un utilisateur

📡 Utilisation de l’API

• 🔑 Authentification : Obtenir un token via /auth/realms/demo/protocol/openid-connect/token
• 📝 Inscription : Endpoint d’inscription utilisateur (exemple : /api/register)
• 🗂️ CRUD : Endpoints pour créer, lire, mettre à jour, supprimer des entités protégées par Keycloak

Voir le code source pour le détail des endpoints (src/main/java/sn/malcolm/demo/controller/)

🗃️ Structure du projet

src/
  main/
    java/sn/malcolm/demo/
      controller/      # Contrôleurs REST
      model/           # Entités JPA
      repository/      # Repositories Spring Data
      security/        # Configurations Keycloak
      service/         # Logique métier
      view/            # DTOs
  resources/
    application.properties
keycloak/              # Captures d’écran de la configuration Keycloak

🖼️ Captures d’écran de l’application

Voici quelques exemples d’utilisation de l’API via Postman :

🔑 Authentification (Login)

📝 Création d’un utilisateur

📧 Email de création de compte

📋 Récupérer tous les utilisateurs

🔍 Récupérer un utilisateur par ID

✏️ Mise à jour d’un utilisateur

❌ Suppression d’un utilisateur

🔄 Réinitialisation du mot de passe (reset-password)

🔒 Changement du mot de passe (change-password)

📚 Ressources utiles

• 📖 Documentation Keycloak
• 🔗 Spring Security & Keycloak

👤 Auteur

• Mbacke Mbaye

---

N’hésite pas à contribuer ou à ouvrir une issue ! 😃