medcrypt::guardian::utilities::InitializeFiles

Overview

This is the storage for initialization files used to initialize Guardian.

Requirements:

• All const char* inputs should be set to the beginning of the loaded buffer.

• All size_t inputs should be set to the size of the data loaded in the buffer.

Usage example:

• See GetInitializeFilesFromPath() and DeleteInitializeFileBuffers() in FileHelpers.h for an example of how to use.

Include:

#include <InitializeFiles.h>

Syntax:

struct medcrypt::guardian::utilities::InitializeFiles;

Structure members

• TrustStore: Root certificate authority trust store

• TrustStoreSize: Device private identity and keys

• PrivateIdentity: Device private identity and keys

• PrivateIdentitySize: Size of the PrivateIdentity data

• CertifiedProfile: Device certified profile and certificates

• CertifiedProfileSize: Size of the CertifiedProfile data

• CertifiedCertificateRevocations: Certificate revocation list

• CertifiedCertificateRevocationsSize: Size of the CertifiedCertificateRevocations data

Member details

TrustStore variable

• Description: Root certificate authority TrustStore file buffer for validating certificates.

• Type: const char*

• Syntax:

const char * TrustStore;

TrustStoreSize variable

• Description: Size of the TrustStore file buffer.

• Type: size_t

• Syntax:

size_t TrustStoreSize;

PrivateIdentity variable

• Description: Device private identity containing cryptographic keys.

• Type: const char*

• Security: Must be kept secure and never transmitted.

• Syntax:

const char * PrivateIdentity;

PrivateIdentitySize variable

• Description: Size of the PrivateIdentity file buffer.

• Type: size_t

• Syntax:

size_t PrivateIdentitySize;

CertifiedProfile variable

• Description: Device certified profile containing certificates and configuration.

• Type: const char*

• Syntax:

const char * CertifiedProfile;

CertifiedProfileSize variable

• Description: Size of the CertifiedProfile file buffer.

• Type: size_t

• Syntax:

size_t CertifiedProfileSize;

CertifiedCertificateRevocations variable

• Description: File buffer for Certificate Revocation List (CRL).

• Type: const char*

• Syntax:

const char * CertifiedCertificateRevocations;

CertifiedCertificateRevocationsSize variable

• Description: Size of the CertifiedCertificateRevocations data in bytes.

• Type: size_t

CertifiedCertificateRevocationsSize variable

• Description: File buffer size for Certificate Revocation List (CRL).

• Type: const char*

• Syntax:

size_t CertifiedCertificateRevocationsSize;

Related classes

• Guardian class: Uses InitializeFiles in Initialize() function

• ProvisionFiles struct: Similar file structure used for provisioning operations

• ProvisionOnlineFiles struct: File structure used for online provisioning

Debugging and logging

Guardian does not create log files. Instead, logging is controlled by the application:

• Guardian logs to stdout and stderr, which appear in the terminal/CLI of the running application during execution. Look for specific error codes or connection failures in the output.

• Custom logging: Use SetLoggingCallback to redirect log messages to a callback function, stopping terminal output and allowing custom log handling

• Log control: Applications can control log level and verbosity.

• Guardian Cloud UI: Check the Guardian Cloud interface for additional error details and provisioning status.