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
httpethttpssont 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 dont169.254.169.254, CGNAT, IPv6 ULA, adresses IPv4 mappées.- Les notations inhabituelles, comme
0x7f.1ou2130706433, 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-AgentetRefererpeuvent être fixés vers la cible.CookieetAuthorizationsont exclus, car les réponses sont mises en cache par adresse. - Ce qui vient d’une page reste une donnée :
/htmlest servi en texte brut, le champhtmlde/oembedn’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.mddonnent 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.