Sur cette page

Sécurité

Une API qui visite des adresses fournies par ses utilisateurs est une cible classique. Voici ce que le logiciel fait, et ce qu’il ne fait pas.

La menace : SSRF

Dans une attaque SSRF, quelqu’un demande au serveur de lire une adresse qu’il ne peut pas atteindre lui-même : un service interne, l’interface d’administration d’un routeur, ou le service de métadonnées d’un hébergeur cloud.

Ce qui est couvert

  • Seuls http et https sont acceptés, sans identifiants dans l’adresse, sur une liste de ports autorisés (80 et 443 par défaut).
  • localhost, les noms internes et toute adresse non routable publiquement sont refusés : plages privées, bouclage, lien local dont 169.254.169.254, CGNAT, IPv6 ULA, adresses IPv4 mappées.
  • Les notations inhabituelles, comme 0x7f.1 ou 2130706433, sont normalisées avant le contrôle.
  • Un seul enregistrement DNS privé suffit à refuser un nom d’hôte.
  • En HTTP, la résolution DNS validée est épinglée à la connexion, et chaque redirection est revalidée.
  • Dans le navigateur, deux couches : chaque requête émise par la page est interceptée et validée, et Chromium n’a pour seule sortie réseau qu’un proxy interne à l’API. À chaque connexion, redirections comprises, ce proxy applique la politique, résout le nom lui-même et se connecte à l’adresse qu’il vient de valider.
  • L’API n’exécute aucun code fourni par l’appelant. Les seules entrées « programmables » sont des sélecteurs CSS, bornés.
  • Seuls Accept-Language, User-Agent et Referer peuvent être fixés vers la cible. Cookie et Authorization sont exclus, car les réponses sont mises en cache par adresse.
  • Ce qui vient d’une page reste une donnée : /html est servi en texte brut, le champ html de /oembed n’est jamais interprété, les CSV neutralisent les formules.

Ce qui ne l’est pas

  • Le contenu des pages lues n’est pas filtré : traitez toute réponse comme une donnée non fiable, et ne l’injectez jamais telle quelle dans du HTML.
  • L’API ne vérifie pas que vous avez le droit de lire, copier ou conserver une page. Cette responsabilité est la vôtre.
  • Le proxy de validation vit dans le même processus que l’API : il ne remplace pas un filtrage de sortie au niveau du réseau (pare-feu, VPC), qui reste recommandé en défense en profondeur.
  • Un rendu exécute le JavaScript de la page dans Chromium. La protection porte sur les destinations joignables, pas sur ce que fait la page une fois chargée.
  • Les compteurs de quota ne sont pas une protection contre un déni de service distribué.
  • Le README du dépôt et SECURITY.md donnent le détail.

Ce site

  • Il ne charge aucun script tiers et ne dépose aucun cookie.
  • Les réponses de l’API n’y sont jamais interprétées comme du HTML : elles sont affichées comme du texte.
  • La clé d’API saisie dans le bac à sable reste en mémoire dans l’onglet ; elle n’est ni enregistrée ni ajoutée aux liens de partage.

Signaler une faille

Écrivez à contact@kayzen-lyon.fr plutôt que d’ouvrir un ticket public. Le fichier /.well-known/security.txt reprend ce contact.

Raccourcis clavier

CtrlKou/
Ouvrir la recherche et les commandes
?
Afficher cette aide
←→
Passer d’un onglet à l’autre
Ctrl↵
Lancer la requête dans le bac à sable
Esc
Fermer un panneau ou un menu

Les raccourcis à une seule touche se désactivent dans les options d’accessibilité.