nl::Weave::Profiles::Security::CertProvisioning::WeaveCertProvEngine

#include <src/lib/profiles/security/WeaveCertProvisioning.h>

Implementa la lógica principal del objeto del protocolo de aprovisionamiento de certificados de Weave.

Resumen

Constructores y destructores
WeaveCertProvEngine(void)

Tipos públicos
@246{
  kReqType_GetInitialOpDeviceCert = 0,
  kReqType_RotateOpDeviceCert = 1
} 		enum
EventCallback)(void *appState, EventType eventType, const InEventParam &inParam, OutEventParam &outParam) typedef
void(*
Esta función es la devolución de llamada de la aplicación que se invoca en los eventos de la API de Certificate Provisioning Engine.
EventType{
  kEvent_PrepareAuthorizeInfo = 1,
  kEvent_ResponseReceived = 2,
  kEvent_CommunicationError = 3
} 		enum
State{
  kState_NotInitialized = 0,
  kState_Idle = 1,
  kState_PreparingBinding = 2,
  kState_RequestInProgress = 3
} 		enum

Atributos públicos
AppState
void *
Un puntero a datos específicos de la aplicación.

Funciones públicas
AbortCertificateProvisioning(void)
void
Detiene cualquier intercambio de GetCertificate en curso.
GenerateGetCertificateRequest(PacketBuffer *msgBuf, uint8_t reqType, bool doMfrAttest)
Genera el mensaje GetCertificateRequest.
GetBinding(void) const
Muestra un puntero al objeto Binding asociado con WeaveCertProvEngine.
GetEventCallback(void) const
Devuelve un puntero a la función de devolución de llamada de eventos de la API configurada actualmente en el objeto WeaveCertProvEngine.
GetMfrAttestDelegate(void) const
Devuelve un puntero al objeto delegado de certificación del fabricante configurado actualmente en el objeto WeaveCertProvEngine.
GetOpAuthDelegate(void) const
Muestra un puntero al objeto delegado de autenticación operativa configurado actualmente en el objeto WeaveCertProvEngine.
GetReqType(void) const
uint8_t
Recupera el tipo de solicitud actual.
GetState(void) const
Recupera el estado actual del objeto WeaveCertProvEngine.
Init(Binding *binding, WeaveNodeOpAuthDelegate *opAuthDelegate, WeaveNodeMfrAttestDelegate *mfrAttestDelegate, EventCallback eventCallback, void *appState)
Inicializa un objeto WeaveCertProvEngine para preparar el envío del mensaje de solicitud de certificado.
ProcessGetCertificateResponse(PacketBuffer *msgBuf)
Procesa el mensaje GetCertificateResponse.
SetBinding(Binding *binding)
void
Establece el objeto de vinculación en el objeto WeaveCertProvEngine.
SetEventCallback(EventCallback eventCallback)
void
Configura la función de devolución de llamada del evento de la API en el objeto WeaveCertProvEngine.
SetMfrAttestDelegate(WeaveNodeMfrAttestDelegate *mfrAttestDelegate)
void
Establece el objeto delegado de certificación del fabricante en el objeto WeaveCertProvEngine.
SetOpAuthDelegate(WeaveNodeOpAuthDelegate *opAuthDelegate)
void
Configura el objeto delegado de autenticación operativa en el objeto WeaveCertProvEngine.
Shutdown(void)
void
Cierra un objeto WeaveCertProvEngine inicializado previamente.
StartCertificateProvisioning(uint8_t reqType, bool doMfrAttest)
Inicia el protocolo de aprovisionamiento de certificados.

Structs
nl::Weave::Profiles::Security::CertProvisioning::WeaveCertProvEngine::InEventParam

Parámetros de entrada para el evento de la API de Weave Certificate Provisioning.

nl::Weave::Profiles::Security::CertProvisioning::WeaveCertProvEngine::OutEventParam

Parámetros de resultado del evento de la API de Weave Certificate Provisioning.

Tipos públicos

@246

 @246
Propiedades
kReqType_GetInitialOpDeviceCert

El tipo de solicitud Get Certificate es para obtener el certificado operativo inicial.

kReqType_RotateOpDeviceCert

El tipo de solicitud Get Certificate es para rotar el certificado operativo actual.

EventCallback

void(* EventCallback)(void *appState, EventType eventType, const InEventParam &inParam, OutEventParam &outParam)

Esta función es la devolución de llamada de la aplicación que se invoca en los eventos de la API de Certificate Provisioning Engine.

Detalles
Parámetros
[in] appState
Es un puntero a la información de estado definida por la aplicación asociada con el objeto del motor.
[in] eventType
Es el ID del evento que pasa la devolución de llamada del evento.
[in] inParam
Es la referencia de los parámetros de evento de entrada que pasa la devolución de llamada del evento.
[in] outParam
Es la referencia de los parámetros de evento de salida que pasa la devolución de llamada del evento.

EventType

 EventType
Propiedades
kEvent_CommunicationError

Se produjo un error de comunicación mientras se enviaba una GetCertificateRequest o se esperaba una respuesta.

kEvent_PrepareAuthorizeInfo

Se le solicita a la aplicación que prepare la carga útil para GetCertificateRequest.

kEvent_ResponseReceived

Se recibió un mensaje GetCertificateResponse del par.

Estado

 State
Propiedades
kState_Idle

El objeto del motor está inactivo.

kState_NotInitialized

No se inicializó el objeto del motor.

kState_PreparingBinding

El objeto del motor está esperando que la vinculación esté lista.

kState_RequestInProgress

Se envió un mensaje GetCertificateRequest y el objeto del motor está esperando una respuesta.

Atributos públicos

AppState

void * AppState

Un puntero a datos específicos de la aplicación.

Funciones públicas

AbortCertificateProvisioning

void AbortCertificateProvisioning(
  void
)

Detiene cualquier intercambio de GetCertificate en curso.

GenerateGetCertificateRequest

WEAVE_ERROR GenerateGetCertificateRequest(
  PacketBuffer *msgBuf,
  uint8_t reqType,
  bool doMfrAttest
)

Genera el mensaje GetCertificateRequest.

Este método genera la estructura Weave GetCertificateRequest codificada en el formato TLV de Weave.

Cuando se forma el mensaje GetCertificateRequest, el método realiza una solicitud a la aplicación a través de las funciones WeaveNodeOpAuthDelegate y WeaveNodeMfrAttestDelegate, y el evento de la API de PrepareAuthorizeInfo, para preparar la carga útil del mensaje.

Detalles
Parámetros
[in] msgBuf
Un puntero al objeto packageBuffer que contiene el mensaje GetCertificateRequest.
[in] reqType
Obtén el tipo de solicitud de certificado.
[in] doMfrAttest
Es una marca booleana que indica si la solicitud debe incluir datos de certificación del fabricante.
Valores de retorno
WEAVE_NO_ERROR
Si GetCertificateRequest se generó correctamente.

GetBinding

Binding * GetBinding(
  void
) const

Muestra un puntero al objeto Binding asociado con WeaveCertProvEngine.

GetEventCallback

EventCallback GetEventCallback(
  void
) const

Devuelve un puntero a la función de devolución de llamada de eventos de la API configurada actualmente en el objeto WeaveCertProvEngine.

GetMfrAttestDelegate

WeaveNodeMfrAttestDelegate * GetMfrAttestDelegate(
  void
) const

Devuelve un puntero al objeto delegado de certificación del fabricante configurado actualmente en el objeto WeaveCertProvEngine.

GetOpAuthDelegate

WeaveNodeOpAuthDelegate * GetOpAuthDelegate(
  void
) const

Muestra un puntero al objeto delegado de autenticación operativa configurado actualmente en el objeto WeaveCertProvEngine.

GetReqType

uint8_t GetReqType(
  void
) const

Recupera el tipo de solicitud actual.

GetState

State GetState(
  void
) const

Recupera el estado actual del objeto WeaveCertProvEngine.

Init

WEAVE_ERROR Init(
  Binding *binding,
  WeaveNodeOpAuthDelegate *opAuthDelegate,
  WeaveNodeMfrAttestDelegate *mfrAttestDelegate,
  EventCallback eventCallback,
  void *appState
)

Inicializa un objeto WeaveCertProvEngine para preparar el envío del mensaje de solicitud de certificado.

Detalles
Parámetros
[in] binding
Un objeto Binding que se usará para establecer la comunicación con el nodo del par.
[in] opAuthDelegate
Es un puntero a un objeto delegado de autenticación operativa que se usará para crear y firmar con las credenciales operativas del nodo.
[in] mfrAttestDelegate
Es un puntero a un objeto delegado de certificación del fabricante que se usará para crear y firmar la solicitud con las credenciales aprovisionadas del fabricante del nodo.
[in] eventCallback
Es un puntero a una función a la que llamará el objeto WeaveCertProvEngine para entregar eventos de API a la aplicación.
[in] appState
Es un puntero a un objeto definido por la aplicación que se volverá a pasar a la aplicación cada vez que se produzca un evento de la API.

ProcessGetCertificateResponse

WEAVE_ERROR ProcessGetCertificateResponse(
  PacketBuffer *msgBuf
)

Procesa el mensaje GetCertificateResponse.

Este método procesa la estructura Weave GetCertificateResponse codificada en el formato TLV de Weave.

Cuando se completa correctamente el procesamiento del mensaje GetCertificateResponse, el método realiza una llamada a la aplicación, a través del evento de la API ResponseReceived, para entregar el resultado.

Si falla el procesamiento del mensaje GetCertificateResponse, el método realiza una llamada a la aplicación, a través del evento de la API de CommunicationError, para informar el error.

Detalles
Parámetros
[in] msgBuf
Un puntero al objeto PacketBuffer que contiene el mensaje GetCertificateResponse.
Valores de retorno
WEAVE_NO_ERROR
Si el mensaje GetCertificateResponse se procesó correctamente.

SetBinding

void SetBinding(
  Binding *binding
)

Configura el objeto de vinculación en el objeto WeaveCertProvEngine.

SetEventCallback

void SetEventCallback(
  EventCallback eventCallback
)

Establece la función de devolución de llamada de eventos de la API en el objeto WeaveCertProvEngine.

SetMfrAttestDelegate

void SetMfrAttestDelegate(
  WeaveNodeMfrAttestDelegate *mfrAttestDelegate
)

Establece el objeto delegado de certificación del fabricante en el objeto WeaveCertProvEngine.

SetOpAuthDelegate

void SetOpAuthDelegate(
  WeaveNodeOpAuthDelegate *opAuthDelegate
)

Configura el objeto delegado de autenticación operativa en el objeto WeaveCertProvEngine.

Cierre

void Shutdown(
  void
)

Cierra un objeto WeaveCertProvEngine inicializado previamente.

Ten en cuenta que solo se puede llamar a este método si se llamó al método Init() anteriormente.

StartCertificateProvisioning

WEAVE_ERROR StartCertificateProvisioning(
  uint8_t reqType,
  bool doMfrAttest
)

Inicia el protocolo de aprovisionamiento de certificados.

Este método inicia el proceso de envío de un mensaje GetCertificateRequest al servicio de AC. Si se recibe un mensaje GetCertificateResponse correspondiente, se entregará a la aplicación a través del evento de la API ResponseReceived.

Si el objeto Binding no está en el estado Listo cuando se llama a este método, se realizará una solicitud al método Binding::RequestPrepare() para iniciar la preparación a pedido. La operación de solicitud esperará hasta que se complete este proceso. Se ignorarán las llamadas a StartCertificateProvisioning() que tengan una solicitud previa en proceso.

Detalles
Parámetros
[in] reqType
Obtén el tipo de solicitud de certificado.
[in] doMfrAttest
Es una marca booleana que indica si el protocolo debe incluir datos de certificación del fabricante.
Valores de retorno
WEAVE_NO_ERROR
Si StartCertificateProvisioning() se procesó correctamente.

WeaveCertProvEngine

 WeaveCertProvEngine(
  void
)