Qu'est-ce qui est transmis?
Page simplifiée, pour un éditeur à qui Eiger Vault livre un plugin pour son CMS.
Vous n'avez pas à écrire de code. Eiger Vault écrit un petit module, un plugin, que vous installez dans votre CMS. Il envoie nos copies des articles au moment où ils sont publiés ou modifiés, avec votre clé. Cette page dit ce qu'il fait, quand, ce qu'il envoie, et ce qu'il ne lit jamais.
Aucun plugin n'est encore livré: la liste ci-dessous est le cahier des charges que nous nous imposons, non la description d'un produit en service. Elle dépendra aussi de ce que votre CMS permet.
Ce que fait le plugin
Il se branche sur les événements de publication de votre CMS. À chaque publication, et à chaque modification visible d'un article déjà publié, il construit un document qui décrit l'article, et l'envoie à Eiger Vault par une connexion sécurisée (https, seule adresse qu'il accepte). Il attend la réponse, et ne considère l'article comme livré qu'une fois cette réponse reçue.
Quand il tourne
- À chaque modification visible: le texte, le titre, le chapeau, les auteurs, la catégorie, les dates de publication et de mise à jour affichées, les images et les légendes, l'adresse canonique. Une correction silencieuse, qui ne change pas ce qu'un lecteur voit mais change le texte, en fait partie. Il ne pousse à aucune autre occasion.
- Toutes les heures, pour rattraper ce qui aurait manqué: il relit la liste des articles publiés ou modifiés ces 48 dernières heures, demande à Eiger Vault lesquels elle ne connaît pas, et n'envoie que ceux-là. Ces valeurs sont des valeurs de départ. Si votre CMS ne permet pas de relire une telle liste, une dispense est écrite dans la configuration, avec sa raison.
- En cas d'échec: il renvoie le même contenu, avec la même révision, sans risque: le renvoyer ne crée jamais de doublon.
Ce qu'il envoie
Pour chaque article, seulement ce que le lecteur voit:
- le texte, découpé en blocs: paragraphes, intertitres, encadrés, légendes;
- le titre, le chapeau, la langue, les auteurs, les lieux, la catégorie, les genres;
- les dates de publication et de mise à jour affichées;
- l'adresse canonique de l'article;
- les images, la page en PDF et les vidéos, si vous le décidez, avec leurs légendes;
- l'identifiant de l'article dans votre CMS, qui sert de référence, et un numéro de révision qui sert à éviter les doublons;
- le cas échéant, des droits (embargo, licences, prix), selon des règles que vous écrivez dans la configuration du plugin; sans règle, il n'en envoie aucun;
- les mots-clés de votre CMS, dans une partie à part que nous acceptons sans l'utiliser pour l'instant.
Ce qu'il ne lit jamais, et n'envoie jamais
- un brouillon, ou un article qui n'est pas publié;
- une note interne, l'état d'un flux de travail éditorial, un verrou d'édition, un emplacement dans la maquette, un compteur de lectures, une date technique de modification;
- rien de ce qui n'est pas dans l'article lui-même: ni vos utilisateurs, ni vos abonnés, ni vos statistiques.
Où va votre clé
La clé que nous vous remettons ne vit que dans la configuration du plugin, c'est-à-dire dans votre CMS. Elle n'est écrite dans aucune trace. Elle ne passe que dans un en-tête de la requête, jamais dans l'adresse. Nous ne la conservons pas: nous n'en gardons qu'une empreinte et un court préfixe pour la reconnaître. Vous pouvez à tout moment nous demander de la révoquer et d'en émettre une nouvelle.
Ce que nous contrôlons
Le code du plugin est relu par Eiger Vault avant d'être livré, et il vit dans son propre dépôt de code, qui ne consomme que notre contrat de dépôt. Il ne garde aucune copie des articles. La seule destination qu'il contacte est l'adresse de dépôt d'Eiger Vault.
Si ça se passe mal
Si Eiger Vault est indisponible, ou refuse un envoi, le plugin le consigne dans son propre journal, sans le texte de l'article, et recommence. Chaque refus a un code stable, que vous pouvez nous donner avec l'identifiant de corrélation que la réponse porte.