Switch Evidence Source#

Functions for creating switch evidence sources.

Functions#

void nvat_switch_evidence_source_free(nvat_switch_evidence_source_t *switch_evidence_source)

nvat_rc_t nvat_switch_evidence_source_from_json_file(nvat_switch_evidence_source_t *out_source, const char *file_path)

Create a nvat_switch_evidence_source that will read existing evidence from the given source file.

nvat_rc_t nvat_switch_evidence_source_nscq_create(nvat_switch_evidence_source_t *out_source)

Create a nvat_switch_evidence_source that will collect evidence from all NVSwitches accessible from the system via NSCQ.

Functions#

void nvat_switch_evidence_source_free(
nvat_switch_evidence_source_t *switch_evidence_source,
)#
nvat_rc_t nvat_switch_evidence_source_from_json_file(
nvat_switch_evidence_source_t *out_source,
const char *file_path,
)#

Create a nvat_switch_evidence_source that will read existing evidence from the given source file.

The source file must be a JSON file with the following schema: 

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "version": {
        "type": "string",
        "description": "The version of the evidence format.",
        "enum": ["1.0"]
      },
      "arch": {
        "type": "string",
        "description": "The switch architecture of the evidence.",
        "enum": ["LS10"]
      },
      "nonce": {
        "type": "string",
        "description": "The nonce used to collect the evidence.",
        "format": "hex"
      },
      "evidence": {
        "type": "string",
        "description": "The base64-encoded evidence.",
        "format": "base64"
      },
      "certificate": {
        "type": "string",
        "description": "The base64-encoded certificate chain.",
        "format": "base64"
      }
    }
  }
}

Parameters:

  • out_source – A pointer to the evidence source that will return the evidence from the file.

  • file_path – The path to the file to deserialize the evidence from.

nvat_rc_t nvat_switch_evidence_source_nscq_create(
nvat_switch_evidence_source_t *out_source,
)#

Create a nvat_switch_evidence_source that will collect evidence from all NVSwitches accessible from the system via NSCQ.