Connectors

Connectors help import reported data from other data sources, such as ATLAS Case studies, NIST CVEs, AIID incidents.

Currently, avidtools supports the connector to MITRE ATLAS case study and NIST CVEs.

`avidtools.connectors`.atlas

import_case_study(case_study_id)[source]

Import a case study from the MITRE ATLAS website and return an yaml object.

Parameters:: case_study_id (str) – Identifier of the case studies to be imported. Has the format AML.CSXXXX
Returns:: case_study – Dictionary containing the imported case study.
Return type:: dict

convert_case_study(case_study)[source]

Convert a case study in the ATLAS schema into an AVID report object.

Parameters:: case_study (dict) – Dictionary containing the imported case study.
Returns:: report – an AVID report object containing information in the case study.
Return type:: Report

import_cve(cve_id)[source]

Import a CVE from the NVD API and return a JSON dump object.

Parameters:: cve_id (str) – Identifier of the CVE to be imported. Has the format CVE-2XXX-XXXXX
Returns:: cve – JSON dump object containing the imported CVE information.
Return type:: nvdlib.classes.CVE

convert_cve(cve)[source]

Convert a CVE into an AVID report object.

Parameters:: cve (nvdlib.classes.CVE) – JSON dump object containing the imported CVE information.
Returns:: vuln – an AVID vulnerability object containing information in the CVE.
Return type:: Vulnerability