Aller au contenu principal
← Documentation

Extension Chrome — Sentinel BYO

Enrichissez Sentinel avec le contenu complet de vos abonnements presse payants — Le Monde, FT, NYT, Politico et 13 autres — sans jamais transmettre vos identifiants à nos serveurs.

Modèle de sécurité BYO

Navigateur Chrome (votre machine)

Session authentifiée

Le Monde · FT · NYT · Politico · …

Extension Sentinel BYO

  1. 1.Poll la file d'articles (toutes les 15 min)
  2. 2.Fetch l'article avec vos cookies locaux
  3. 3.Extrait le texte propre du DOM
  4. 4.Envoie le texte vers Sentinel (HTTPS)
HTTPS
texte structuré uniquement

Jamais transmis :

Mots de passe

Cookies de session

Identifiants

Serveurs Sentinel

Reçu & stocké

Texte des articles

user_id (piste d'audit)

Jamais reçu

Mots de passe

Cookies tiers

Sessions des médias

1. Conditions requises

  • Un compte Sentinel actif avec un plan Cabinet (Firm) ou Entreprise.
  • Google Chrome version 88 ou supérieure.
  • Être connecté à vos abonnements presse sur les sites concernés dans Chrome (votre session habituelle).
  • Laisser Chrome ouvert pour que le service worker tourne en arrière-plan.

Plan requis : Cabinet (Firm) ou Entreprise. La création de clé API renvoie une erreur 402 sur les plans Solo et Team. Contactez votre administrateur pour passer au bon plan.

2. Installer l'extension (mode développeur)

Chrome Web Store en attente. En attendant la validation Google, installez l'extension en mode développeur depuis le fichier ZIP fourni par Sentinel.

  1. Dans Sentinel, allez dans Paramètres → Clés API et cliquez sur Télécharger l'extension pour obtenir le fichier ZIP.
  2. Extrayez le ZIP dans un dossier permanent sur votre machine (ex. : ~/extensions/sentinel-byo/).
  3. Dans Chrome, ouvrez chrome://extensions/.
  4. Activez le Mode développeur (toggle en haut à droite de la page).
  5. Cliquez sur Charger l'extension non empaquetée et sélectionnez le dossier extrait à l'étape 2.
  6. L'icône Sentinel S apparaît dans la barre d'outils Chrome.

Important : ne supprimez pas le dossier extrait. Chrome charge l'extension depuis ce dossier à chaque démarrage.

3. Créer votre clé API

La clé est affichée une seule fois. Copiez-la immédiatement dans un gestionnaire de mots de passe. Il n'est pas possible de la récupérer ensuite.

  1. Dans Sentinel, allez dans Paramètres → Clés API.
  2. Cliquez sur + Créer une clé API.
  3. Donnez-lui un nom explicite, par exemple Extension Chrome — Poste Marc.
  4. Sélectionnez le périmètre (scope) : extension.
  5. Cliquez sur Créer. La clé au format sk_live_xxxxx... s'affiche.
  6. Copiez la clé immédiatement — elle ne sera plus visible après fermeture de cette fenêtre.

Chaque utilisateur doit générer sa propre clé. Ce modèle par-utilisateur permet la révocation ciblée (si un poste est perdu, révoquez uniquement cette clé sans impacter les autres) et maintient une piste d'audit par user_id.

4. Configurer l'extension

  1. Cliquez sur l'icône S de Sentinel dans la barre d'outils Chrome. Le popup s'ouvre.
  2. Renseignez l'URL Sentinel : https://app.sentinelbriefing.com (valeur par défaut, ne pas modifier sauf installation sur site).
  3. Collez votre clé sk_live_... dans le champ Token API.
  4. Cliquez sur Tester l'auth. Une coche verte confirme que la connexion fonctionne.
  5. Cochez Activer le fetch automatique.
  6. Cliquez sur Enregistrer.

L'extension est maintenant active. Elle va poller Sentinel toutes les 15 minutes pour récupérer les articles en file d'attente.

Médias supportés

L'extension peut accéder aux 17 médias ci-dessous. Les médias marqués Spécifique disposent d'un extracteur DOM dédié (extraction plus fiable et plus complète). Les autres utilisent un extracteur générique (<article> / <main>).

MédiaDomainePaysExtracteur
Le Mondelemonde.fr🇫🇷Spécifique
Les Échoslesechos.fr🇫🇷Spécifique
Le Figarolefigaro.fr🇫🇷Spécifique
Mediapartmediapart.fr🇫🇷Spécifique
La Croixla-croix.com🇫🇷Générique
Libérationliberation.fr🇫🇷Générique
Le Parisienleparisien.fr🇫🇷Générique
Le Nouvel Obsnouvelobs.com🇫🇷Générique
Courrier Internationalcourrierinternational.com🇫🇷Générique
Le Monde Diplomatiquemonde-diplomatique.fr🇫🇷Générique
Le Grand Continentlegrandcontinent.eu🇪🇺Générique
Politico Europepolitico.eu🇪🇺Spécifique
Politico USpolitico.com🇺🇸Spécifique
Financial Timesft.com🇬🇧Spécifique
The New York Timesnytimes.com🇺🇸Spécifique
Foreign Affairsforeignaffairs.com🇺🇸Spécifique
LinkedInlinkedin.com🌐Content script

Pour ajouter un nouveau domaine non listé, contactez l'administrateur Sentinel. L'ajout nécessite une mise à jour de l'extension et une réinstallation.

Comportement de polling

Intervalle de pollingToutes les 15 minutes
Articles par cycleMaximum 5 articles par cycle (limite MV3 service worker)
Délai entre fetches8 secondes entre deux fetches (pour ne pas surcharger les sites cibles)
PrérequisChrome doit être ouvert. Si Chrome est fermé, les fetches reprennent au prochain lancement.
Stockage du tokenchrome.storage.local — chiffré au repos par Chrome.

Vie privée & RGPD

Le modèle BYO a été conçu dès le départ pour ne jamais faire transiter vos identifiants vers nos serveurs. Voici les garanties techniques :

  • Identifiants jamais transmis : les cookies de session des médias (Le Monde, FT, etc.) restent dans votre navigateur. Sentinel ne les voit jamais.
  • Texte uniquement : l'extension extrait le texte structuré des articles et l'envoie à Sentinel via HTTPS. Aucun cookie, aucune donnée de session.
  • Token API chiffré : votre clé sk_live_... est stockée dans chrome.storage.local, chiffré au repos par Chrome. Elle est transmise uniquement à app.sentinelbriefing.com.
  • Domaines whitélistés : l'extension ne peut accéder qu'aux domaines déclarés dans manifest.json → host_permissions. Tout autre domaine est ignoré.
  • Piste d'audit : chaque soumission est tracée avec le user_id de la clé API utilisée, permettant à l'administrateur cabinet de savoir quelle clé a soumis quel contenu.
  • Révocation ciblée : en cas de perte d'un poste, la clé associée peut être révoquée depuis Sentinel sans impacter les autres utilisateurs.

Dépannage

« Tester l'auth » affiche une erreur rouge

Vérifiez que l'URL Sentinel est bien https://app.sentinelbriefing.com (sans slash final) et que la clé sk_live_... est complète et sans espace. Si la clé a été perdue, créez-en une nouvelle depuis Paramètres → Clés API.

Erreur 402 lors de la création de la clé API

Votre compte est en plan Solo ou Team. L'extension nécessite le plan Cabinet (Firm) ou Entreprise. Contactez votre administrateur.

Aucun article ne remonte dans Sentinel

Vérifiez que (1) Chrome est bien ouvert, (2) vous êtes connecté à votre abonnement presse sur le site concerné dans Chrome, (3) « Activer le fetch automatique » est coché dans le popup. Attendez le prochain cycle (max 15 min) ou rouvrez le popup et cliquez « Enregistrer » pour forcer un poll.

Les articles arrivent tronqués ou vides

Le média a probablement refondu son DOM. L'extracteur générique tente de lire <article> ou <main> — si ces balises ont changé, le contenu est partiel. Signalez le problème à votre administrateur Sentinel.

L'icône Sentinel n'apparaît pas dans la barre d'outils

Allez dans chrome://extensions/ et vérifiez que l'extension est bien activée. Si elle n'est pas listée, rechargez-la (cliquez « Charger l'extension non empaquetée » et resélectionnez le dossier). Épinglez l'icône via le menu Extensions (icône puzzle) → épingle.

FAQ

Sentinel voit-il mes mots de passe ?

Non. Vos identifiants ne quittent jamais votre navigateur. L'extension utilise les cookies déjà présents dans Chrome pour accéder aux articles. Seul le texte extrait est transmis à Sentinel, via HTTPS.

L'extension fonctionne-t-elle sur Firefox ?

Pas encore. Le support Firefox (Manifest V2/V3 dual) est prévu dans une version ultérieure. Seul Chrome est supporté actuellement.

Puis-je révoquer l'accès d'un seul poste sans impacter les autres ?

Oui. Chaque utilisateur ayant sa propre clé sk_live_..., la révocation d'une clé n'affecte que le poste associé. Allez dans Paramètres → Clés API → Révoquer.

Que faire si je change d'ordinateur ?

Installez l'extension sur le nouveau poste (étapes 1-4) et générez une nouvelle clé API depuis Paramètres → Clés API. Révoquez l'ancienne clé si l'ancien poste n'est plus utilisé.

L'extension tourne-t-elle si je ferme Chrome ?

Non. Le service worker Manifest V3 ne tourne que si Chrome est ouvert. Fermez Chrome le weekend : les fetches reprennent automatiquement au prochain lancement de Chrome.

L'extension est open-source. Son code source peut être audité par tout utilisateur souhaitant vérifier qu'aucune donnée d'authentification ne transite vers Sentinel.

Extension Chrome, Documentation Sentinel Briefing