Aller au contenu principal

Lire les failles sur ton propre OSV

Un contrôle de faille de Compass (par exemple CVE-2021-23337) lit la faille sur OSV. Par défaut, Astrolabe lit le service public, https://api.osv.dev : tu n'as rien à faire. N'ajoute la connexion OSV que si ton entreprise fait tourner sa propre copie d'OSV, par exemple parce qu'Astrolabe n'a pas accès à Internet. Il n'y a aucun jeton à saisir.

Avant de commencer​

Le plugin Stack technique est allumé : voir Allumer un plugin. Tu connais l'adresse de ta copie d'OSV, par exemple https://osv.acme.example.

🔌 Ajouter la connexion​

  1. Dans la barre latérale de gauche, en bas, clique sur Administration.

  2. Sous PLATEFORME, clique sur Connexions de l'entreprise.

  3. Sur la carte OSV, marquée Non configurée, clique sur Configurer.

  4. En haut, clique sur Ajouter la connexion.

  5. Dans le formulaire, laisse Nom à OSV. Dans Adresse d'OSV, remplace https://api.osv.dev par l'adresse de ta copie, par exemple https://osv.acme.example.

  6. Clique sur Tester la connexion. Le formulaire dit La connexion fonctionne : la source a accepté les identifiants.

  7. Clique sur Ajouter. Astrolabe redémarre tout seul : compte entre 30 secondes et une minute.

La liste montre OSV, avec l'hôte de ta copie, la provenance Administration et l'état Connectée.

👀 Quand OSV ne répond plus​

Astrolabe revérifie OSV toutes les quelques minutes, que tu aies ajouté la connexion ou gardé le service public. Quand il ne répond pas, Administration › Problèmes montre une ligne OSV avec l'hôte et la cause, par exemple osv.acme.example refuse la connexion. Vérifie le port, et que le service tourne. Clique sur Corriger : la connexion OSV s'ouvre.

❓ Questions​

Ai-je besoin de cette connexion pour que les contrôles de faille marchent ? Non. Sans elle, Astrolabe lit https://api.osv.dev. Ne l'ajoute que pour une copie dans ton réseau.

Que devient un contrôle pendant qu'OSV ne répond pas ? Le contrôle dit Non mesuré : il ne compte ni pour ni contre le composant. Il est remesuré au calcul suivant, dès qu'OSV répond.

🛠 Dépannage​

Ce que tu voisCe qu'il faut faire
Après Tester la connexion : l'hôte que tu as écrit suivi de a refusé la connexion. Vérifie le port, et que le service tourne.Vérifie le port dans Adresse d'OSV, et demande à l'équipe qui fait tourner ta copie d'OSV si elle est démarrée.
Après Tester la connexion : Aucun serveur ne répond au nom suivi de l'hôte que tu as écritVérifie l'orthographe de Adresse d'OSV avec l'adresse que tu ouvres dans ton navigateur. Si elle est juste, Astrolabe ne voit pas ce serveur : préviens l'administrateur de ton réseau.
Une ligne OSV avec l'hôte api.osv.dev dans Administration › ProblèmesAstrolabe ne joint pas l'OSV public. Demande à l'administrateur de ton réseau d'ouvrir https://api.osv.dev, ou ajoute la connexion à ta propre copie avec les étapes ci-dessus.

✅ C'est tout !

La suite : Contrôler une faille dans une campagne.