Gérer vos accès API

Paramètres → Accès API liste les boîtes noires qui lisent vos bases. Chacune a son jeton : en couper une ne touche pas aux autres. L'écran demande un compte Filarr connecté sur ce profil. Pour créer un accès : ··· sur une base, puis Ouvrir à une API… (Ouvrir une base à une API).

En tête, un badge dit combien d'accès sont ouverts sur combien votre palier en permet.

L'état d'un accès

état	ce que cela veut dire
en direct	la boîte noire s'est synchronisée récemment
jamais vu	la boîte noire ne s'est pas encore synchronisée : le jeton n'a pas encore servi
silencieux N h, silencieux N j	rien depuis ce temps : la boîte noire est arrêtée, hors ligne, ou ne joint plus Filarr
en pause	vous l'avez mise en pause
en pause (palier)	votre palier a baissé : les accès en trop sont mis en pause, les plus récents d'abord
expiré, révoqué	le jeton est refusé pour de bon

Ce que montre un accès

Jeton : son début seulement, de quoi le reconnaître. Le jeton lui-même n'est jamais montré de nouveau.
Boîte noire : quand elle a été vue pour la dernière fois, et sa version.
Bases : chaque base ouverte, en lecture ou en lecture et écriture.
Expire : la date d'échéance, ou « jamais ». Changer… la modifie.
Adresses autorisées : les adresses IP depuis lesquelles Filarr accepte le jeton, ou « toute adresse » (la liste est offerte à partir de Pro).
Ce mois-ci, pour cet accès : les requêtes de synchro du mois, le volume descendu du mois, les écritures du jour, contre les limites de votre palier. À 80 %, puis à 100 %, un avis s'affiche. Les lectures servies par la boîte noire ne sont jamais comptées : seul ce qui passe par Filarr l'est.
Ce que Filarr a vu : le journal de l'accès, gardé un nombre de jours qui dépend du palier. On y lit : accès créé, jeton présenté pour la première fois, jeton refusé (avec la raison), écritures validées, clés changées pour une base (avec la génération), clés rescellées, base ouverte ou retirée, quota atteint, mis en pause, rouvert, jeton remplacé, révoqué. Des blocs chiffrés et des écritures validées, jamais leur contenu : c'est tout ce qui passe par Filarr. Événements plus anciens remonte le temps.

Les gestes

geste	ce qui se passe
Renommer	le nom de l'accès change ; rien d'autre
Mettre en pause	Filarr refuse le jeton ; la boîte noire garde sa copie et continue de la servir. Rouvrir la relance
Remplacer le jeton	un nouveau jeton, montré une fois ; l'ancien est refusé tout de suite, et la boîte noire efface sa copie jusqu'à ce que vous lui donniez le nouveau
Retirer une base (Retirer et changer sa clé)	la base sort de l'accès, et sa clé change : l'ancien jeton ne pourra rien lire de ce qui s'écrira ensuite dans cette base. Les autres bases ne bougent pas
Révoquer (Révoquer et changer les clés)	la boîte noire perd l'accès tout de suite. Ses bases changent de clé (génération suivante) : l'ancien jeton ne pourra rien lire de ce qui s'écrira ensuite. Ce qu'elle a déjà copié reste chez elle : effacez-le sur la machine si elle n'est plus de confiance

Remplacer le jeton ne change pas les clés des bases ; révoquer, si. Si un jeton a fuité, révoquez l'accès et créez-en un autre.

Changer les clés demande que le coffre de la base soit ouvert et le serveur joignable. Sinon, l'écran dit que les clés de ces bases changeront dès que ce sera le cas, et un de vos appareils le fait à sa prochaine ouverture.

Le palier qui baisse

Les accès en trop sont mis en pause, les plus récents d'abord, et une base en lecture et écriture ne s'écrit plus si le nouveau palier n'a pas l'écriture. Rien n'est effacé : après une hausse, rouvrez vous-même les accès en pause.

Pour aller plus loin

Le tutoriel « Révoquer un accès, et réagir à une fuite » du dépôt de la boîte noire : github.com/filarr-work/filarr-gate.
Dépannage de la boîte noire