nl::Weave::Perfiles::Seguridad::CASE::WeaveCASEAuthDelegate

Se llama al inicio de la validación del certificado.

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

A cada certificado que se cargue en el conjunto de certificados se le asignará un tipo de certificado predeterminado mediante 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 de 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 configurar las marcas de validación adecuadas para suprimir la validación del ciclo de vida del certificado.

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

Las implementaciones deben mantener los recursos asignados durante BeginValidation() hasta que se llame al objeto EndValidation() correspondiente. Las implementaciones garantizan que EndValidation() se llame exactamente una vez por cada llamada exitosa a BeginValidation().

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

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

Codifica una carga útil específica de la aplicación para que se incluya en el mensaje CASE para el par.

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

Se llama al final de la validación del certificado.

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

Genera una firma con la clave privada del nodo local.

Cuando se invocan, las implementaciones deben calcular una firma en el valor de hash determinado con la clave privada del nodo. La firma generada se debe escribir en la forma de una estructura CASE ECDSASignature en la escritura TLV proporcionada con 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.

Se llama 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 se validó correctamente, se establecerá validRes como 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 anclaje de confianza.

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

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

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

Se llama después de que se cargan los certificados de apps similares.

Las implementaciones pueden usar esta llamada para finalizar los certificados de entrada y los criterios de validación que se usarán para validar el certificado de intercambio de tráfico. En el momento de la llamada, los certificados proporcionados por el par se cargaron en el conjunto de certificados (incluido su propio certificado, si está presente). Además, los argumentos subjectDN y subjectKeyId se inicializaron en valores que se usarán para resolver el certificado de 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 para ese certificado.

Durante esta llamada, las implementaciones pueden modificar el contenido del conjunto de certificados, incluida la adición de certificados nuevos. 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 verificaciones 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 valor NULL. Si una implementación desea admitir referencias de certificados, debe agregar un certificado que coincida con el ID de la clave y el DN de la entidad correspondiente al conjunto de certificados antes de regresar.

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