Permissions

En bref

Chaque cle API dispose de scopes qui definissent les operations autorisees. Attribuez uniquement les permissions necessaires a chaque cle pour respecter le principe du moindre privilege.

Prerequis techniques

• Une cle API creee (voir Cles API)
• Acces aux parametres du workspace

Scopes disponibles

Les scopes controlent finement ce qu'une cle API peut faire dans votre workspace.

Scope	Acces	Description
read:nodes	Lecture	Lister et consulter les entites de l'ontologie.
write:nodes	Ecriture	Creer, modifier et supprimer des entites.
read:edges	Lecture	Lister et consulter les relations.
write:edges	Ecriture	Creer, modifier et supprimer des relations.
read:livedata	Lecture	Consulter les sources et donnees Live Data.
write:livedata	Ecriture	Configurer et gerer les sources Live Data.
read:events	Lecture	Consulter l'historique des evenements.
admin	Complet	Acces total au workspace (inclut tous les scopes).

Heritage des scopes

Les scopes suivent une logique d'heritage :

• Un scope write:* inclut automatiquement le scope read:* correspondant. Par exemple, write:nodes permet aussi de lire les entites.
• Le scope admin inclut tous les autres scopes. Une cle avec admin a un acces complet au workspace.

Vous n'avez donc pas besoin d'ajouter read:nodes si vous attribuez deja write:nodes.

Gestion des quotas

Chaque plan definit des limites de requetes par cle API.

Plan	Requetes/min	Requetes/jour
Starter	60	10 000
Pro	300	100 000
Enterprise	Personnalise	Personnalise

Lorsqu'une cle depasse son quota, les requetes suivantes recoivent une reponse 429 Too Many Requests jusqu'au prochain cycle de reset.

Rotation et revocation

La rotation reguliere des cles renforce la securite de vos integrations.

• Rotation recommandee : tous les 90 jours.
• Periode de grace : apres rotation, l'ancienne cle reste valide pendant 24 heures. Cela vous laisse le temps de mettre a jour vos integrations.
• Revocation immediate : en cas de cle compromise, revoquez-la immediatement. L'acces est coupe instantanement, sans periode de grace.

Suivi d'usage

Surveillez l'utilisation de chaque cle API pour detecter les anomalies et optimiser vos quotas.

Le tableau de bord d'usage affiche pour chaque cle :

• Nombre total de requetes sur la periode selectionnee
• Taux de succes (pourcentage de reponses 2xx)
• Endpoints les plus sollicites pour identifier les integrations actives

Principe du moindre privilege
N'utilisez jamais le scope admin pour des integrations qui n'ont besoin que de lecture. Attribuez uniquement les scopes strictement necessaires a chaque cle.

Limites

Limite	Valeur
Cles par workspace	50
Scopes par cle	10 maximum
Duree de grace apres rotation	24 heures

Depannage

Probleme	Cause	Solution
403 Forbidden	Scope insuffisant	Ajoutez le scope requis a la cle depuis les parametres.
429 Too Many Requests	Rate limit depasse	Attendez le reset du compteur ou passez au plan superieur.
Cle non reconnue	Cle revoquee ou expiree	Creez une nouvelle cle et mettez a jour votre integration.
Acces partiel	Scope write manquant	Verifiez que la cle dispose bien du scope d'ecriture necessaire.

Besoin d'aide ?

Consultez la page Cles API pour creer ou gerer vos cles, ou ecrivez-nous : Support et contact.