Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

nl :: Tejido:: Perfiles: Seguridad:: CASO:: WeaveCASEAuthDelegate

Esto es una clase abstracta.

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

Interfaz abstracta a la que se delegan las acciones de autenticación durante el establecimiento de la sesión CASE .

Resumen

Herencia

Subclases conocidas directas: nl :: Weave :: DeviceManager :: WeaveDeviceManager

Funciones publicas

BeginValidation (const BeginSessionContext & msgCtx, ValidationContext & validCtx, WeaveCertificateSet & certSet)=0
virtual WEAVE_ERROR
Llamado al inicio de la validación del certificado.
EncodeNodeCertInfo (const BeginSessionContext & msgCtx,TLVWriter & writer)=0
virtual WEAVE_ERROR
Codifique la información del certificado CASE para el nodo local.
EncodeNodePayload (const BeginSessionContext & msgCtx, uint8_t *payloadBuf, uint16_t payloadBufSize, uint16_t & payloadLen)
virtual WEAVE_ERROR
Codifique una carga útil específica de la aplicación que se incluirá en el mensaje CASE al par.
EndValidation (const BeginSessionContext & msgCtx, ValidationContext & validCtx, WeaveCertificateSet & certSet)=0
virtual void
Llamado al final de la validación del certificado.
GenerateNodeSignature (const BeginSessionContext & msgCtx, const uint8_t *msgHash, uint8_t msgHashLen,TLVWriter & writer, uint64_t tag)=0
virtual WEAVE_ERROR
Genere una firma usando la clave privada del nodo local.
HandleValidationResult (const BeginSessionContext & msgCtx, ValidationContext & validCtx, WeaveCertificateSet & certSet, WEAVE_ERROR & validRes)=0
virtual WEAVE_ERROR
Llamado con el resultado de la validación del certificado.
OnPeerCertsLoaded (const BeginSessionContext & msgCtx, WeaveDN & subjectDN, CertificateKeyId & subjectKeyId, ValidationContext & validCtx, WeaveCertificateSet & certSet)
virtual WEAVE_ERROR
Se llama después de que se hayan cargado los certificados del par.

Funciones publicas

BeginValidation

virtual WEAVE_ERROR BeginValidation(
  const BeginSessionContext & msgCtx,
  ValidationContext & validCtx,
  WeaveCertificateSet & certSet
)=0

Llamado al inicio de la validación del certificado.

Las implementaciones deben inicializar el objeto WeaveCertificateSet proporcionado con recursos suficientes para manejar la próxima validación del certificado. En este momento, las implementaciones pueden cargar certificados de CA o raíz de confianza en el conjunto de certificados, o esperar hasta que se llame a OnPeerCertsLoaded () .

A cada certificado cargado en el conjunto de certificados se le asignará un tipo de certificado predeterminado por la función de carga. Las implementaciones deben ajustar estos tipos según sea necesario para garantizar el tratamiento correcto del certificado durante la validación y la asignación correcta de WeaveAuthMode para las interacciones CASE .

El contexto de validación proporcionado se inicializará con un conjunto de criterios de validación predeterminados, que la implementación puede modificar según sea necesario. La implementación debe establecer el campo EffectiveTime o establecer los indicadores de validación adecuados para suprimir la validación de la vida útil del certificado.

Si se desean resultados de validación detallados, la implementación puede inicializar los campos CertValidationResults y CertValidationLen.

Se requieren implementaciones para mantener los recursos asignados durante BeginValidation () hasta que se llame al EndValidation () correspondiente. Las implementaciones garantizan que EndValidation () se llamará exactamente una vez por cada llamada exitosa a BeginValidation () .

EncodeNodeCertInfo

virtual WEAVE_ERROR EncodeNodeCertInfo(
  const BeginSessionContext & msgCtx,
  TLVWriter & writer
)=0

Codifique la información del certificado CASE para el nodo local.

Las implementaciones pueden usar esta llamada para anular la codificación predeterminada de la estructura CASE CertificateInformation para el nodo local. Cuando se llama, la implementación debe escribir una estructura CertificateInformation que contenga, como mínimo, el certificado de entidad del nodo local. La implementación puede incluir opcionalmente un conjunto de certificados relacionados y / o anclajes de confianza.

EncodeNodePayload

virtual WEAVE_ERROR EncodeNodePayload(
  const BeginSessionContext & msgCtx,
  uint8_t *payloadBuf,
  uint16_t payloadBufSize,
  uint16_t & payloadLen
)

Codifique una carga útil específica de la aplicación que se incluirá en el mensaje CASE al par.

La implementación de este método es opcional. La implementación predeterminada devuelve una carga útil de longitud cero.

EndValidation

virtual void EndValidation(
  const BeginSessionContext & msgCtx,
  ValidationContext & validCtx,
  WeaveCertificateSet & certSet
)=0

Llamado al final de la validación del certificado.

Las implementaciones pueden usar esta llamada para realizar la limpieza después de que se complete la validación de la certificación. Las implementaciones garantizan que EndValidation () se llamará exactamente una vez por cada llamada exitosa a BeginValidation () .

GenerateNodeSignature

virtual WEAVE_ERROR GenerateNodeSignature(
  const BeginSessionContext & msgCtx,
  const uint8_t *msgHash,
  uint8_t msgHashLen,
  TLVWriter & writer,
  uint64_t tag
)=0

Genere una firma usando la clave privada del nodo local.

Cuando se invoca, las implementaciones deben calcular una firma en el valor hash dado utilizando la clave privada del nodo. La firma generada debe escribirse en forma de una estructura CASE ECDSASignature en la escritura del TLV suministrada utilizando la etiqueta especificada.

En los casos en que la clave privada del nodo se mantiene en un búfer local, la función de utilidad GenerateAndEncodeWeaveECDSASignature () puede ser útil para implementar este método.

HandleValidationResult

virtual WEAVE_ERROR HandleValidationResult(
  const BeginSessionContext & msgCtx,
  ValidationContext & validCtx,
  WeaveCertificateSet & certSet,
  WEAVE_ERROR & validRes
)=0

Llamado con el resultado de la validación del certificado.

Las implementaciones pueden usar esta llamada para inspeccionar, y posiblemente alterar, el resultado de la validación del certificado del par. Si la validación fue exitosa, validRes se establecerá en WEAVE_NO_ERROR. En este caso, el contexto de validación contendrá detalles sobre el resultado. En particular, el campo TrustAnchor se establecerá en el certificado de ancla de confianza.

Si la implementación inicializó los campos CertValidationResults y CertValidationLen dentro de la estructura ValidationContext durante la llamada BeginValidation () , estos campos contendrán resultados de validación detallados para cada certificado en el conjunto de certificados.

Las implementaciones pueden anular esto estableciendo validRes en un valor de error, lo que hace que falle la validación.

Si la validación falló, validRes reflejará el motivo del fallo. Las implementaciones pueden anular el resultado a un valor de error diferente, pero NO DEBEN establecer el resultado en WEAVE_NO_ERROR.

OnPeerCertsLoaded

virtual WEAVE_ERROR OnPeerCertsLoaded(
  const BeginSessionContext & msgCtx,
  WeaveDN & subjectDN,
  CertificateKeyId & subjectKeyId,
  ValidationContext & validCtx,
  WeaveCertificateSet & certSet
)

Se llama después de que se hayan cargado los certificados del par.

Las implementaciones pueden utilizar esta convocatoria para finalizar los certificados de entrada y los criterios de validación que se utilizarán para realizar la validación del certificado del par. En el momento de la llamada, los certificados proporcionados por el par se habrán cargado en el conjunto de certificados (incluido su propio certificado, si está presente). Además, los argumentos subjectDN y subjectKeyId se habrán inicializado a valores que se utilizarán para resolver el certificado del par del conjunto de certificados. Si el par proporcionó su propio certificado (en lugar de una referencia de certificado), el campo EntityCert dentro del argumento validCtx contendrá un puntero a ese certificado.

Durante esta llamada, las implementaciones pueden modificar el contenido del conjunto de certificados, incluida la adición de nuevos certificados. También pueden alterar los argumentos subjectDN, subjectKeyId o validCtx según sea necesario. Lo más importante es que las implementaciones deben ajustar los campos de tipo de certificado con el conjunto de certificados antes de regresar para garantizar el tratamiento correcto de los certificados durante la validación y las comprobaciones de control de acceso posteriores.

NOTA: En el caso de que el par proporcione una referencia de certificado para sí mismo, en lugar de un certificado completo, el campo EntityCert en el contexto de validación contendrá un NULL. Si una implementación desea admitir referencias de certificados, debe agregar un certificado que coincida con el DN del sujeto del par y la identificación de clave al conjunto de certificados antes de regresar.

La implementación de este método es opcional. La implementación predeterminada no hace nada.