Integración SecurityScorecard n8nAutomatiza SecurityScorecard con n8n.

Devuelve la puntuación de cada factor de una empresa y el número de issues que hay detrás. Sirve mucho más para decidir por dónde empezar que una cifra única.

• Scorecard Identifier: el identificador principal de una empresa o scorecard, es decir un dominio. Si viene de un nodo anterior, se inyecta con {{ $json.field }}.
• Severity In: filtro opcional que se queda solo con los issues de una lista de severidades separadas por comas.
• Return All: activado, n8n recorre todas las páginas de factores; desactivado, Limit pone el tope.

El mismo desglose por factor, pero repetido sobre un periodo. Es lo que hace falta para hablar de tendencia y no de foto fija.

• Scorecard Identifier: el dominio de la empresa que se sigue.
• Date From y Date To: inicio y fin de la ventana de histórico.
• Timing: la granularidad de las fechas, daily, weekly o monthly.
• Simplify: devuelve una versión simplificada de la respuesta en lugar de los datos en bruto, cómodo justo antes de escribir en una hoja de cálculo.

Aquí lo que llega son las puntuaciones de la empresa a lo largo del tiempo, sin desglose por factor. Una serie para toda la scorecard.

• Scorecard Identifier: el dominio en cuestión.
• Date From y Date To: los límites del histórico.
• Timing: monthly para una diapositiva de comité, daily cuando un caso está bajo vigilancia estrecha.
• Return All: desactivado, es Limit quien decide cuántos puntos llegan en un periodo largo.

Una llamada, una empresa: su información y el resumen de su scorecard. Es la operación a la que acudir cuando el flujo necesita contexto sobre un dominio, no un análisis a fondo.

• Scorecard Identifier: el identificador principal de la empresa o de la scorecard, en la práctica su dominio. Es el único campo que pide la operación.

Pregunta a SecurityScorecard qué haría falta para que una empresa llegue a la puntuación que le indicas, y devuelve ese plan de mejora.

• Scorecard Identifier: el dominio de la empresa para la que se calcula el plan.
• Score: el objetivo de puntuación, un número. Este campo es lo que separa esta operación de las demás lecturas de Company.
• Return All: activado, llega el plan entero; desactivado, Limit recorta la lista.

La misma vista por factores, pero un piso más arriba: un sector entero en vez de una empresa. Así la cifra de una compañía tiene con qué compararse.

• Industry: lista cerrada de 5 opciones, food, healthcare, manofacturing, retail y technology. Ojo con la grafía del valor de manufacturing, que es la del propio nodo y hay que copiar tal cual, porque cualquier otra escritura no existe en el desplegable.
• Simplify: respuesta simplificada.
• Return All: recorre todo el conjunto de resultados en vez de parar en Limit.

La vista sectorial por factores estirada en el tiempo. Un movimiento visto en un proveedor se lee entonces a escala de su mercado.

• Industry: uno de los 5 valores que ofrece el nodo.
• Date From y Date To: las fechas de inicio y fin del histórico en esta operación.
• Simplify: una respuesta simplificada en lugar de los datos en bruto.

La llamada más ligera del nodo: entra un sector, sale su puntuación, y no hay nada más que configurar.

• Industry: campo único, a elegir entre food, healthcare, manofacturing, retail o technology.

Crea una invitación para una empresa o un usuario. Es la vía por la que un proveedor entra en la plataforma sin que nadie lo dé de alta a mano.

• Email, First Name y Last Name: la persona invitada, los tres obligatorios.
• Message: el mensaje para quien recibe la invitación, también obligatorio, así que toca escribirlo de verdad.
• Domain: uno de los 9 campos adicionales, el dominio de la empresa invitada.
• Grade to Maintain: pide a la organización invitada que mantenga un grade mínimo.

Crea una cartera, el contenedor donde después se añaden y se vigilan las empresas.

• Portfolio Name: el nombre de la cartera, único campo obligatorio.
• Description: texto libre, útil en cuanto varias carteras tienen nombres parecidos.
• Privacy: private la deja visible solo para ti, team para la gente de tu equipo, shared para toda la empresa.

Borra una cartera de la cuenta. El nodo no pide confirmación, de modo que la certeza tiene que estar en el propio flujo.

• Portfolio ID: el identificador de la cartera, no su nombre. Si solo se conoce el nombre, pasa antes por Get Many y arrastra el identificador con {{ $json.field }}.

Lista las carteras de la cuenta. Es el paso con el que la mayoría de flujos convierten un nombre de cartera en el identificador que piden todas las demás operaciones de Portfolio.

• Return All: activado, n8n pagina por todas las carteras; desactivado, Limit fija el máximo devuelto.

Modifica una cartera que ya existe en lugar de crear otra al lado.

• Portfolio ID: la cartera a la que apunta la actualización.
• Portfolio Name: aquí también es obligatorio, así que el nombre viaja en cada llamada aunque solo cambie la descripción.
• Privacy: se salta entre private, team y shared cuando una cartera deja de ser un experimento personal.

Mete una empresa dentro de una cartera para que se vigile junto al resto del grupo.

• Portfolio ID: la cartera que recibe la empresa.
• Domain: el nombre de dominio de la empresa, que es lo que la identifica aquí.

Lee las empresas que hay dentro de una cartera, con 5 filtros para recortar la lista antes de que llegue al nodo siguiente.

• Portfolio ID: la cartera que se lee.
• Grade, Industry e Issue Type: filtros por grade de la empresa, por sector y por tipo de issue.
• Vulnerability: filtro por vulnerabilidad CVE.
• Status: active o inactive.

Saca una empresa de una cartera. La empresa no se toca, lo que termina es su pertenencia a esa cartera.

• Portfolio ID: la cartera de la que sale la empresa.
• Domain: el nombre de dominio de la empresa, el mismo que se usó al añadirla.

Recupera un informe ya generado y entrega el archivo al nodo siguiente como datos binarios.

• Report URL: la ruta del archivo o la URL HTTPS de descarga que da la API de SecurityScorecard en api.securityscorecard.io.
• Put Output File in Field: el nombre del campo binario de salida donde cae el archivo. El nodo posterior lo lee con ese nombre exacto.

Pide a la plataforma que construya un informe. Generar y recuperar son pasos separados, y por eso la plantilla pública encadena generar, listar y descargar.

• Report: 8 tipos, desde summary y detailed hasta issues, events-json, partnership, full-scorecard-json, portfolio y scorecard-footprint.
• Scorecard Identifier, Portfolio ID y Date: se piden junto al tipo.
• Format: csv o pdf.
• Branding: SecurityScorecard, la empresa, o ambas.

Devuelve la lista de informes generados recientemente. Es la bisagra entre pedir un informe y descargarlo.

• Return All: activado, la lista entera llega página a página; desactivado, Limit la deja en los más recientes.