4cd23c03ad
- Documentation configuration OIDC, démarrage, diagnostic - Scripts batch pour démarrage backend et client - Script shell pour configuration Keycloak frontend
128 lines
4.2 KiB
Markdown
128 lines
4.2 KiB
Markdown
# Backend Démarré avec Succès
|
|
|
|
## Résumé
|
|
|
|
Le backend **Lions User Manager** démarre maintenant correctement sur le **port 8081**.
|
|
|
|
## Problèmes Résolus
|
|
|
|
### 1. Conflit RESTEasy / Keycloak Admin Client
|
|
**Problème**: Utilisation de `keycloak-admin-client` (version standalone) avec `quarkus-rest` (RESTEasy Reactive) créait un conflit.
|
|
|
|
**Solution**: Remplacement par `quarkus-keycloak-admin-rest-client` dans le `pom.xml`:
|
|
```xml
|
|
<dependency>
|
|
<groupId>io.quarkus</groupId>
|
|
<artifactId>quarkus-keycloak-admin-rest-client</artifactId>
|
|
</dependency>
|
|
```
|
|
|
|
### 2. Annotations de Validation sur Méthodes Privées
|
|
**Problème**: Les méthodes privées dans `RoleServiceImpl` avaient des annotations `@NotBlank`, `@NotNull` ce qui est interdit par Quarkus.
|
|
|
|
**Erreur**:
|
|
```
|
|
@io.quarkus.hibernate.validator.runtime.interceptor.MethodValidated will have no effect on method
|
|
dev.lions.user.manager.service.impl.RoleServiceImpl.assignClientRolesToUser()
|
|
because the method is private
|
|
```
|
|
|
|
**Solution**: Suppression des annotations de validation sur toutes les méthodes privées :
|
|
- `assignClientRolesToUser()`
|
|
- `assignRealmRolesToUser()`
|
|
- `revokeClientRolesFromUser()`
|
|
- `revokeRealmRolesFromUser()`
|
|
- `getRealmRoleById()`
|
|
- `getRealmRoleByName()`
|
|
- `getClientRoleByName()`
|
|
- `userHasRealmRole()`
|
|
- `userHasClientRole()`
|
|
|
|
### 3. Continuous Testing Bloquant le Démarrage
|
|
**Problème**: Le backend restait bloqué sur "Tests paused" et ne démarrait pas complètement.
|
|
|
|
**Solution**: Ajout dans `application-dev.properties`:
|
|
```properties
|
|
quarkus.test.continuous-testing=disabled
|
|
```
|
|
|
|
### 4. Port de Debug Occupé
|
|
**Problème**: Le port 5005 (debug) était déjà utilisé par un processus zombie.
|
|
|
|
**Solution**: Tuer le processus occupant le port 5005.
|
|
|
|
## État Actuel
|
|
|
|
### Backend (Port 8081)
|
|
✅ **DÉMARRÉ** - Le backend fonctionne correctement sur http://localhost:8081
|
|
|
|
**Endpoints disponibles**:
|
|
- **Swagger UI**: http://localhost:8081/q/swagger-ui
|
|
- **Dev UI**: http://localhost:8081/q/dev-ui
|
|
- **Health Check**: http://localhost:8081/q/health
|
|
- **OpenAPI**: http://localhost:8081/q/openapi
|
|
- **Metrics**: http://localhost:8081/metrics
|
|
|
|
**API Endpoints**:
|
|
- Users: `GET/POST/PUT/DELETE /api/users`
|
|
- Roles: `GET/POST/PUT/DELETE /api/roles/*`
|
|
- Health: `GET /api/health/keycloak`, `GET /api/health/status`
|
|
- Audit: `/api/audit/*`
|
|
- Sync: `/api/sync/*`
|
|
|
|
### Keycloak (Port 8180)
|
|
✅ **EN MARCHE** - Keycloak fonctionne sur http://localhost:8180
|
|
|
|
**Configuration**:
|
|
- Realm: `lions-user-manager`
|
|
- Client: `lions-user-manager-client`
|
|
- Client Secret: `client-secret-lions-2025`
|
|
- Test User: `testuser` / `test123`
|
|
- Admin: `admin` / `admin`
|
|
|
|
### Frontend (Port 8080)
|
|
⚠️ **À DÉMARRER** - Le frontend n'est pas encore lancé
|
|
|
|
## Problème Restant
|
|
|
|
### Connexion Keycloak
|
|
Le backend ne parvient pas à se connecter à Keycloak :
|
|
```json
|
|
{"connected":false,"status":"DOWN"}
|
|
```
|
|
|
|
**Cause probable**: Configuration dans `application-dev.properties` utilise des credentials ou URL incorrects.
|
|
|
|
**Vérification nécessaire**:
|
|
```properties
|
|
lions.keycloak.server-url=http://localhost:8180
|
|
lions.keycloak.admin-realm=master
|
|
lions.keycloak.admin-client-id=admin-cli
|
|
lions.keycloak.admin-username=admin
|
|
lions.keycloak.admin-password=admin
|
|
```
|
|
|
|
## Prochaines Étapes
|
|
|
|
1. ✅ Backend démarré sur port 8081
|
|
2. ⚠️ Corriger la connexion Keycloak du backend
|
|
3. ⏳ Démarrer le frontend sur port 8080
|
|
4. ⏳ Tester l'authentification complète
|
|
5. ⏳ Tester les endpoints API
|
|
|
|
## Commande de Démarrage
|
|
|
|
```bash
|
|
cd C:\Users\dadyo\PersonalProjects\lions-workspace\lions-user-manager\lions-user-manager-server-impl-quarkus
|
|
mvn quarkus:dev -Ddebug=false
|
|
```
|
|
|
|
## Warnings à Ignorer
|
|
|
|
Ces warnings sont normaux et n'empêchent pas le fonctionnement :
|
|
- `Hibernate ORM is disabled because no JPA entities were found` - Normal, pas de DB configurée
|
|
- `Unable to properly register the hierarchy...for reflection` - Les DTOs fonctionnent malgré tout
|
|
- `Unrecognized configuration key "quarkus.smallrye-fault-tolerance.enabled"` - Propriété obsolète mais sans impact
|
|
- `Unrecognized configuration key "quarkus.oidc.dev-ui.enabled"` - Propriété obsolète mais sans impact
|
|
- `Unrecognized configuration key "quarkus.security.auth.proactive"` - Propriété obsolète mais sans impact
|