Intégration SecurityScorecard n8nAutomatiser SecurityScorecard avec n8n.

Renvoie le score de chaque facteur d'une entreprise et le nombre d'issues associées. Plus exploitable qu'un chiffre unique quand il faut décider quoi corriger en premier.

• Scorecard Identifier : l'identifiant principal d'une entreprise ou d'une scorecard, donc un domaine. Depuis un nœud précédent, on l'injecte avec {{ $json.field }}.
• Severity In : filtre optionnel qui ne garde que les issues d'une liste de sévérités séparées par des virgules.
• Return All : activé, n8n enchaîne toutes les pages de facteurs ; désactivé, Limit plafonne le nombre renvoyé.

Même découpage par facteur, mais rejoué sur une période. C'est ce qu'il faut pour parler de tendance et pas d'instantané.

• Scorecard Identifier : le domaine de l'entreprise suivie.
• Date From et Date To : début et fin de la fenêtre d'historique.
• Timing : la granularité des dates, daily, weekly ou monthly.
• Simplify : renvoie une version simplifiée de la réponse au lieu des données brutes, pratique juste avant d'écrire dans un tableur.

Cette fois, ce sont les scores de l'entreprise dans le temps, pas le détail par facteur. Une seule série pour toute la scorecard.

• Scorecard Identifier : le domaine concerné.
• Date From et Date To : les bornes de l'historique.
• Timing : monthly pour une slide de comité, daily quand un dossier est sous surveillance rapprochée.
• Return All : désactivé, c'est Limit qui décide combien de points remontent sur une longue période.

Un appel, une entreprise : ses informations et le résumé de sa scorecard. L'opération à dégainer quand le workflow a besoin de contexte sur un domaine, pas d'une analyse fine.

• Scorecard Identifier : l'identifiant principal de l'entreprise ou de la scorecard, en pratique son domaine. C'est le seul champ demandé.

Demande à SecurityScorecard ce qu'il faudrait faire pour qu'une entreprise atteigne le score visé, et renvoie ce plan d'amélioration.

• Scorecard Identifier : le domaine de l'entreprise pour laquelle le plan est calculé.
• Score : la cible de score, un nombre. C'est ce champ qui distingue cette opération des autres lectures Company.
• Return All : activé, tout le plan remonte ; désactivé, Limit tronque la liste.

La même vue par facteur, mais montée d'un étage : un secteur entier au lieu d'une entreprise. Ça donne un point de comparaison au chiffre d'une société.

• Industry : une liste fermée de 5 choix, food, healthcare, manofacturing, retail et technology. L'orthographe de la valeur manufacturing est celle du nœud, recopie-la telle quelle.
• Simplify : version simplifiée de la réponse plutôt que les données brutes.
• Return All : parcourt tout le jeu de résultats au lieu de s'arrêter à Limit.

La vue sectorielle par facteur étalée dans le temps. Un mouvement observé chez un prestataire se relit alors à l'échelle de son marché.

• Industry : l'une des 5 valeurs proposées par le nœud.
• Date From et Date To : les dates de début et de fin d'historique pour cette opération.
• Simplify : une réponse simplifiée à la place des données brutes.

L'appel le plus léger du nœud : un secteur entre, son score sort, rien d'autre à configurer.

• Industry : unique champ, à choisir parmi food, healthcare, manofacturing, retail ou technology.

Crée une invitation pour une entreprise ou un utilisateur. C'est par là qu'un fournisseur rejoint la plateforme sans passer par une saisie manuelle.

• Email, First Name et Last Name : la personne invitée, les trois sont obligatoires.
• Message : le message destiné à l'invité, obligatoire lui aussi, donc à rédiger pour de vrai.
• Domain : l'un des 9 champs additionnels, le domaine de l'entreprise invitée.
• Grade to Maintain : demande à l'organisation invitée de maintenir un grade minimum.

Crée un portefeuille, le conteneur dans lequel les entreprises seront ensuite ajoutées et suivies.

• Portfolio Name : le nom du portefeuille, seul champ obligatoire.
• Description : texte libre, utile dès que plusieurs portefeuilles portent des noms proches.
• Privacy : private le réserve à son créateur, team l'ouvre aux personnes de l'équipe, shared à toute l'entreprise.

Supprime un portefeuille du compte. Aucune étape de confirmation dans le nœud, c'est donc au workflow d'être sûr de lui.

• Portfolio ID : l'identifiant du portefeuille, pas son nom. Si seul le nom est connu, passe d'abord par Get Many puis transmets l'identifiant avec {{ $json.field }}.

Liste les portefeuilles du compte. C'est l'étape qui permet à la plupart des workflows de traduire un nom de portefeuille en identifiant, celui que réclament toutes les autres opérations Portfolio.

• Return All : activé, n8n pagine sur l'ensemble des portefeuilles ; désactivé, Limit fixe le maximum renvoyé.

Modifie un portefeuille existant au lieu d'en créer un deuxième à côté.

• Portfolio ID : le portefeuille visé par la mise à jour.
• Portfolio Name : obligatoire ici aussi, donc le nom repart à chaque appel, même quand seule la description change.
• Privacy : bascule entre private, team et shared quand un portefeuille cesse d'être une expérimentation personnelle.

Place une entreprise dans un portefeuille pour qu'elle soit suivie avec le reste du groupe.

• Portfolio ID : le portefeuille qui reçoit l'entreprise.
• Domain : le nom de domaine de l'entreprise, c'est lui qui l'identifie ici.

Lit les entreprises contenues dans un portefeuille, avec 5 filtres pour réduire la liste avant qu'elle n'arrive au nœud suivant.

• Portfolio ID : le portefeuille lu.
• Grade, Industry et Issue Type : filtres sur le grade de score de l'entreprise, le secteur et le type d'issue.
• Vulnerability : filtre par vulnérabilité CVE.
• Status : active ou inactive.

Retire une entreprise d'un portefeuille. L'entreprise elle-même n'est pas touchée, seule son appartenance à ce portefeuille prend fin.

• Portfolio ID : le portefeuille que l'entreprise quitte.
• Domain : le nom de domaine de l'entreprise, le même que celui utilisé à l'ajout.

Récupère un rapport déjà généré et transmet le fichier au nœud suivant sous forme de données binaires.

• Report URL : le chemin du fichier ou l'URL HTTPS de téléchargement fournie par l'API SecurityScorecard sur api.securityscorecard.io.
• Put Output File in Field : le nom du champ binaire de sortie où atterrit le fichier. Le nœud d'après le lira sous ce nom exact.

Demande à la plateforme de construire un rapport. Génération et récupération sont deux étapes distinctes, d'où l'enchaînement générer, lister, télécharger qu'on retrouve dans le template public.

• Report : 8 types, de summary et detailed à issues, events-json, partnership, full-scorecard-json, portfolio et scorecard-footprint.
• Scorecard Identifier, Portfolio ID et Date : demandés avec le type.
• Format : csv ou pdf.
• Branding : SecurityScorecard, l'entreprise, ou les deux.

Renvoie la liste des rapports générés récemment. C'est l'étape charnière entre la demande d'un rapport et son téléchargement.

• Return All : activé, toute la liste remonte page après page ; désactivé, Limit la réduit aux plus récents.