Autres

Algolia DocSearch

PréférencesSite officiel

Moteur de recherche hébergé et gratuit pour la documentation open source, basé sur un crawler Algolia et un widget JavaScript autocomplete qui enregistre les requêtes et les clics.

Présentation

Que fait Algolia DocSearch ?

Qu'est ce qu'Algolia DocSearch

Algolia DocSearch est un programme gratuit proposé par Algolia SAS, société française d'infrastructure de recherche, qui permet aux projets open source d'ajouter une recherche rapide et tolérante aux fautes de frappe à leur documentation. Un crawler indexe périodiquement les pages publiques et un petit widget JavaScript (docsearch.js ou le composant React) affiche un menu d'autocomplétion qui appelle l'API de recherche Algolia à chaque frappe.

Données collectées par le widget

Chaque requête est transmise à Algolia avec l'adresse IP, le user agent, le referer et des informations de timing. Lorsque Algolia Insights ou l'analytique de clics est activée, le widget stocke un identifiant anonyme dans le localStorage (clé aa-anonymous-user-id) et envoie des événements de clic et de conversion. Ces données nourrissent les statistiques et le classement dynamique.

Implications RGPD et ePrivacy

Le simple fait de taper une requête et de recevoir des résultats peut reposer sur l'intérêt légitime, mais le stockage de l'identifiant anonyme et l'envoi d'événements comportementaux relèvent de l'article 82 de la Loi Informatique et Libertés et du RGPD et exigent un consentement préalable. L'adresse IP étant une donnée personnelle, une fiche de traitement et une durée de conservation doivent être documentées.

Transferts internationaux

Bien qu'Algolia soit française, son réseau distribué couvre plusieurs continents. Les requêtes peuvent être acheminées vers le cluster le plus proche et certaines fonctions corporate sont gérées par Algolia Inc. aux États Unis. Les transferts s'appuient sur les clauses contractuelles types et sur le Data Privacy Framework. Un routage exclusivement européen peut être demandé sur les offres payantes.

Étapes pratiques de conformité

Désactivez l'analytique de clics par défaut, conditionnez le widget à un consentement, mentionnez Algolia dans la politique de confidentialité comme sous traitant, signez l'accord de traitement Algolia et configurez le crawler pour exclure les pages contenant des données personnelles.

Conformité

Algolia DocSearch et le RGPD

Algolia DocSearch est classé dans la catégorie « Préférences ». Sur un site qui vise des visiteurs européens, il ne doit se charger qu'après le consentement du visiteur, et doit figurer dans votre politique de cookies.

Base légale
The search box itself can run on legitimate interests (Art. 6(1)(f) GDPR) when used purely to deliver requested results, but the storage of the aa-anonymous-user-id token, click and conversion analytics, and the transmission of IP plus query content for analytics purposes require prior consent (Art. 6(1)(a) GDPR and Art. 5(3) ePrivacy Directive) because they involve storage on the terminal and behavioural analysis.
Niveau de risque
medium
Textes applicables
GDPR, ePrivacy Directive (Cookie Law), CCPA, French Data Protection Act

Analyse d'impact (AIPD)

Une AIPD complète n'est généralement pas obligatoire pour DocSearch sur une documentation publique, mais il convient de tenir un registre des traitements au titre de l'article 30 du RGPD, d'évaluer la durée de conservation des journaux de requêtes et d'analyser l'impact de l'activation des analyses de clics qui peuvent profiler des utilisateurs authentifiés.

Exemple de texte pour votre bannière

Avec votre accord, nous utilisons Algolia DocSearch pour proposer la recherche sur cette documentation. Chaque requête est transmise aux serveurs Algolia avec votre adresse IP et un identifiant anonyme afin d'améliorer la pertinence des résultats et de mesurer les articles les plus consultés.
Cookies et traceurs

Ce que Algolia DocSearch dépose et contacte

Méthode de suivi
Client side JavaScript widget (docsearch.js or @docsearch/react) that loads on documentation sites, queries the Algolia Search API via XHR/fetch using a public search only API key, builds an autocomplete dropdown, and sends each keystroke to Algolia servers. The Algolia crawler periodically scrapes the documentation pages and pushes structured records into the Algolia index. The widget collects query strings, click and conversion events, user agent, IP address, and may set a local storage anonymous user token (aa-anonymous-user-id) when analytics or click analytics are enabled.
Localisation des serveurs
France (Algolia SAS headquartered in Paris) with production search clusters distributed worldwide (Amazon Web Services and bare metal in Europe, North America, Asia Pacific). Open source projects using the free DocSearch program are usually allocated to EU clusters; commercial Algolia customers can pin to specific regions including Frankfurt, Paris, Dublin, or US East.
Mode sans cookie disponible
Oui
Transfert de données hors UE
While Algolia is a French company, its search clusters span multiple regions and queries are typically routed via the closest distributed search network (DSN) node. For DocSearch on open source projects the default region is EU, but Algolia Inc. (the US subsidiary) may process billing, support, and aggregated analytics data in the United States. Algolia relies on Standard Contractual Clauses and the EU US Data Privacy Framework for any transatlantic flows. Customers can contractually request EU only routing on paid plans.

Cookies déposés (4)

NomTypeDuréeFinalité
aa-anonymous-user-idlocalStoragePersistent until clearedAnonymous identifier stored by Algolia Insights to attribute click and conversion events to a session.
_ALGOLIAlocalStoragePersistentCaches Algolia client configuration and recent query suggestions for the autocomplete component.
docsearch-recent-searcheslocalStoragePersistentStores the most recent queries typed by the user so they appear in the suggestions panel on next visit.
docsearch-favorite-searcheslocalStoragePersistentStores queries the user has marked as favourite directly from the DocSearch modal.

Domaines tiers contactés (5)

  • *.algolia.net
  • *.algolianet.com
  • insights.algolia.io
  • crawler.algolia.com
  • cdn.jsdelivr.net
Questions

Questions fréquentes sur Algolia DocSearch

Une question qui n'est pas dans la liste ? Écrivez-nous, on répond vite.

DocSearch dépose t il des cookies ?

DocSearch ne pose pas de cookies HTTP. Il utilise le localStorage pour conserver un identifiant anonyme (aa-anonymous-user-id) lorsque Algolia Insights ou l'analytique de clics est activée, ce qui est équivalent à un cookie au regard de l'article 82 de la Loi Informatique et Libertés.

Le consentement est il obligatoire ?

Oui pour la fonction analytique. La recherche pure peut reposer sur l'intérêt légitime, mais le stockage de l'identifiant anonyme et l'envoi d'événements de clic exigent un consentement préalable au titre de l'article 82 de la Loi Informatique et Libertés et du RGPD.

Quelle base légale retenir ?

L'intérêt légitime (article 6(1)(f) du RGPD) couvre la requête de recherche elle même. La couche analytique, dont l'aa-anonymous-user-id, repose sur le consentement (article 6(1)(a) du RGPD et article 82 de la Loi Informatique et Libertés).

Y a t il des transferts vers les États Unis ?

Possible. Algolia est française mais son réseau mondial achemine les requêtes vers le cluster le plus proche, et Algolia Inc. aux États Unis gère le support et la facturation. Les clauses contractuelles types et le Data Privacy Framework s'appliquent.

Faut il une AIPD ?

Une AIPD complète n'est pas requise pour une documentation publique. Tenez un registre article 30, documentez la conservation des journaux et réévaluez si l'analytique de clics est activée sur un portail authentifié.

Comment mettre en oeuvre DocSearch en conformité ?

Chargez docsearch.js seulement après le consentement pour les cookies d'analyse, désactivez Insights par défaut, signez l'accord de traitement Algolia, mentionnez Algolia comme sous traitant dans la politique de confidentialité et excluez le contenu privé du crawler.

Existe t il des alternatives ?

Des solutions auto hébergées comme Typesense, Meilisearch ou Elasticsearch avec interface personnalisée existent. Lunr.js ou Pagefind offrent une recherche entièrement côté client, sans envoi de requête à un tiers.

Comment mettre à jour la politique cookies ?

Ajoutez une entrée mentionnant Algolia DocSearch, indiquez la clé localStorage aa-anonymous-user-id, les finalités (recherche, analyse, classement), la durée de conservation et un lien vers la politique de confidentialité et l'accord de traitement Algolia.

Mettez votre site en conformité aujourd'hui.

Gratuit jusqu'à 25 000 sessions par mois. Sans carte bancaire, sans engagement.