silverpeasDocumentation REST API

Authentification REST

Documentation française • Silverpeas 6.4.x •

GUIDE PRATIQUE

Deux modes d’authentification

Le code de AuthenticationResource indique que l’en-tête standard est Authorization (et non Authentication). Le mode Bearer est recommandé pour les appels API répétés.

1. Jeton API — Bearer

Envoyer le jeton API de l’utilisateur dans l’en-tête Authorization de chaque requête. Le service d’authentification crée alors une session limitée à la requête, sans session persistante à réutiliser.

curl -i -H "Authorization: Bearer $SILVERPEAS_API_TOKEN" \ "https://exemple.fr/silverpeas/services/profile/users/token"

2. Identifiants — Basic puis session

L’authentification retourne un profil utilisateur au format JSON. La session HTTP peut être réutilisée selon la configuration de l’instance.

curl -i -X POST \ -u "monlogin@domain0:monmotdepasse" \ "https://exemple.fr/silverpeas/services/authentication"

Attention : curl -u envoie l’en-tête Authorization: Basic base64(...). Basic n’est pas un chiffrement : utilisez impérativement HTTPS. Pour conserver les cookies de session HTTP, utilisez -c cookies.txt à l’authentification et -b cookies.txt aux appels suivants.

curl -i -X POST -c cookies.txt \ -u "monlogin@domain0:monmotdepasse" \ "https://exemple.fr/silverpeas/services/authentication" curl -i -b cookies.txt \ "https://exemple.fr/silverpeas/services/profile/users/me"

Jeton Web de session ≠ jeton API

GET /session/token produit un JSON contenant la propriété token à partir d’une session HTTP valide. Ce jeton Web n’est pas à confondre avec le jeton API utilisé par Bearer.