Authentification

Identifiants PMS : format, environnements, stockage sûr, rotation et révocation.

Chaque requête, sauf GET /v1/health, transmet votre identifiant PMS comme jeton Bearer :

GET /v1/me HTTP/1.1
Host: staging.api.tatallo.com
Authorization: Bearer tat_stg_sk_<credential-id>_<secret>

Il n’y a pas d’échange de jeton, et rien à renouveler : la clé elle-même est l’identifiant. Une clé peut porter une date d’expiration, que Tatallo vous indique au moment où il l’émet.

​

Format de la clé et environnements

Un identifiant PMS est une chaîne opaque émise par Tatallo. Son préfixe nomme l’environnement auquel il appartient :

Préfixe	Environnement	URL de base
tat_stg_sk_	Staging	https://staging.api.tatallo.com
tat_live_sk_	Production	https://api.tatallo.com

Une clé ne fonctionne que dans son propre environnement. Une clé de staging envoyée en production reçoit un 401, tout comme une clé de production envoyée sur le staging : le trafic de test ne peut donc jamais atteindre les données réelles. Traitez le reste de la clé comme une valeur opaque : ne l’analysez pas.

​

Conservez les clés sur vos serveurs

• Appelez l’API PMS Tatallo uniquement de serveur à serveur. N’envoyez jamais une clé vers un navigateur, une application mobile ou tout autre client.
• Conservez les clés dans votre gestionnaire de secrets, pas dans le code source ni dans les fichiers de configuration.
• Ne journalisez jamais une clé, et ne journalisez jamais l’en-tête Authorization. GET /v1/me ne renvoie jamais de secret : journaliser sa réponse est donc sans risque.
• Si une clé a pu fuir, prévenez [e-mail] immédiatement. Tatallo la révoque aussitôt.

​

Rotation et révocation

Demandez à [e-mail] la rotation d’une clé. Tatallo émet d’abord la nouvelle clé, par un lien secret à usage unique. Vous basculez vos serveurs dessus, et Tatallo ne révoque l’ancienne clé qu’une fois qu’il observe des appels avec la nouvelle : il n’y a donc aucune interruption.

Une clé révoquée ou expirée reçoit un 401 dès la requête suivante.

​

401 ou 403 ?

Statut	Code	Signification	Que faire
401	unauthorized	La clé est absente, mal formée, destinée à l’autre environnement, expirée ou révoquée. Tous ces cas reçoivent la même réponse, volontairement.	Vérifiez l’en-tête, le préfixe par rapport à l’URL de base, et que la clé est à jour.
403	insufficient_scope	La clé est valide, mais il lui manque le scope exigé par la route (properties:read pour les propriétés).	Demandez une clé dotée de ce scope.

GET /v1/me affiche les scopes de la clé que vous utilisez.