Premiers pas

Ce tutoriel vous accompagne pas à pas dans votre première utilisation de TOSIAM.

Objectif

À la fin de ce tutoriel, vous aurez :

Installé TOSIAM sur votre machine
Créé votre premier domaine d’identités
Configuré un utilisateur et testé une authentification

Prérequis

Avant de commencer, assurez-vous d’avoir :

Java 17+ installé (java -version)
Docker (optionnel, recommandé pour la base de données)
Un terminal et des droits suffisants pour installer des logiciels

Étape 1 — Télécharger TOSIAM

Rendez-vous sur la page de téléchargement et récupérez la dernière version stable pour votre système d’exploitation.

# Exemple pour Linux x86-64
unzip tosiam-1.0.0-linux-x86_64.zip
cd tosiam-1.0.0/

Étape 2 — Démarrer le serveur

Lancez TOSIAM avec la configuration par défaut :

./bin/tosiam start

Le serveur démarre sur http://localhost:8080. La console d’administration est accessible à http://localhost:8080/admin.

Étape 3 — Créer un domaine

Un domaine (realm) est un espace isolé qui regroupe utilisateurs, applications et politiques d’accès.

Ouvrez http://localhost:8080/admin
Connectez-vous avec les identifiants par défaut (admin / admin)
Cliquez sur Nouveau domaine et nommez-le mon-domaine

Étape 4 — Créer un utilisateur

Dans le domaine mon-domaine :

Naviguez vers Utilisateurs → Ajouter
Renseignez le nom d’utilisateur, l’email et un mot de passe temporaire
Cliquez sur Enregistrer

Étape 5 — Tester l’authentification

Vérifiez que l’authentification fonctionne via l’API REST :

curl -X POST http://localhost:8080/auth/realms/mon-domaine/protocol/openid-connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=password&client_id=account&username=alice&password=secret"

Une réponse JSON contenant un access_token confirme que tout fonctionne.

Prochaines étapes

Continuez avec le tutoriel Gestion des rôles pour apprendre à contrôler les accès de façon fine.