Skip to content

Créer un fichier de ressources

Un fichier de ressources est un fichier CSV qui liste des outils et services OSINT. Il peut être importé lors de la création d'une investigation ou depuis la bibliothèque de ressources, et exporté à tout moment.

À quoi ça sert ?

Plutôt que de créer vos ressources une par une dans l'interface, vous pouvez préparer votre propre catalogue d'outils en CSV et l'importer en une seule opération. Pratique pour partager un jeu d'outils avec une équipe ou migrer depuis un autre outil.

Format du fichier

Le fichier doit être délimité par des virgules (,) et encodé en UTF-8.

Colonnes requises

ColonneObligatoireDescription
nameOuiNom de la ressource
typeOui"website" ou "script" (inclut les logiciels)
descriptionNonDescription courte
urlNonURL sans https:// ni http://
queryUrlNonURL avec placeholder
genericNon"yes" pour tous les types, "no" pour des types spécifiques
typesTargetedNonListe des types d'entités ciblés

Exemple de fichier

csv
name,type,description,url,queryUrl,generic,typesTargeted
Google,website,Search engine,google.com,google.com/search?q={{value}},yes,
SocialScan,script,Find accounts by username,,,,clh6rf805twci0bujhft9fc5m
Epieos,website,Email investigation,epieos.com,epieos.com/results?q={{value}},no,clh6r9r6wtvwa0buj4osvepjb
Shodan,website,Search engine for devices,shodan.io,shodan.io/search?query={{value}},no,clh6sgxq9tww10buuhzho55jg

Le champ queryUrl

Le queryUrl permet d'ouvrir automatiquement l'outil avec la valeur de l'entité sélectionnée. Utilisez le placeholder qui sera remplacé par la valeur de l'entité au moment du clic.

Exemples :

  • google.com/search?q= — recherche Google avec la valeur
  • epieos.com/results?q= — recherche Epieos avec l'email
  • shodan.io/search?query= — recherche Shodan avec l'IP

Ne pas inclure https:// dans l'URL — l'application l'ajoute automatiquement.

Le champ typesTargeted

Ce champ détermine pour quels types d'entités la ressource apparaît dans le panneau de détail.

Pour obtenir les IDs des types :

  1. Ouvrez Menu principal → Sélecteur de types
  2. Sélectionnez le ou les types souhaités (Ctrl+Clic pour plusieurs)
  3. Utilisez le bouton Copier le texte (ou Copier pour Excel si vous travaillez dans un tableur)
  4. Collez les IDs dans la colonne typesTargeted

Importer le fichier

Au moment de créer une investigation

Dans la boîte de dialogue de création, un bouton permet d'associer un jeu de ressources. Vous pouvez créer un nouveau jeu en important votre CSV.

Depuis la bibliothèque de ressources

  1. Allez sur Ressources
  2. Cliquez sur Import
  3. Sélectionnez votre fichier CSV

Les ressources importées sont ajoutées à votre bibliothèque sans écraser les ressources existantes portant un nom différent.

Exporter vos ressources

Pour exporter vos ressources personnalisées en CSV (afin de les sauvegarder ou partager) :

  1. Allez sur Ressources
  2. Cliquez sur Export

Le CSV généré respecte exactement le format attendu pour une réimportation ultérieure.

Conseils

  • Commencez par exporter vos ressources existantes pour avoir un exemple concret du format attendu
  • Testez votre queryUrl en ouvrant manuellement l'URL dans un navigateur avec une valeur réelle à la place de
  • Pour les ressources génériques (utilisables avec tous les types d'entités), mettez generic à "yes" et laissez typesTargeted vide

Guide utilisateur Osintracker