CryptoManager.SignAsync

CryptoManager

SignAsync

Disponible desde la versión 8.3.18.

Variante de sintaxis: Datos de firma en el valor de retorno

Sintaxis:

SignAsync(<DatosIniciales>, <Certificado>, <TipoFirma>)

Parámetros:

<DatosIniciales> (obligatorio)

Tipo: String, BinaryData, Stream, MemoryStream, FileStream.
Datos fuente para firmar.
Los datos pueden estar en un archivo (en este caso, se especifica el nombre del archivo) o representados como BinaryData, Stream, MemoryStream o FileStream.

<Certificado> (opcional)

Tipo: CryptoCertificate.
Certificado de criptografía utilizado.
Si no se especifica el parámetro, el almacén de certificados personales debe contener solo un certificado. De lo contrario, se generará una excepción.

<TipoFirma> (opcional)

Tipo: CryptoSignatureType.
Tipo de firma de criptografía.
{macros: Tipos de firma admitidos}
Valor predeterminado: CryptoSignatureType.CAdESBES.

Descripción de la variante del método:

Inicia la generación de una firma en formato CMS (basada en PKCS#7) y la devuelve como BinaryData o la guarda en un archivo.
Las propiedades HashAlgorithm y SignAlgorithm definen los algoritmos de firma.
El archivo fuente no se incluye en los datos de firma.
La propiedad IncludeCertificatesInSignature especifica si se incluyen los certificados en la firma.
Si no se especifica un certificado, se utiliza un certificado personal para la firma.
Si el método se completa correctamente, el objeto Promise contiene los BinaryData de la firma.

Variante de sintaxis: Los datos se guardan en un archivo

Sintaxis:

SignAsync(<DatosIniciales>, <DatosSalida>, <TipoFirma>)

Parámetros:

<DatosIniciales> (obligatorio)

Tipo: String, BinaryData, Stream, MemoryStream, FileStream.
Datos fuente para la firma.
Los datos pueden estar almacenados en un archivo (en este caso, se especifica el nombre del archivo) o presentados como BinaryData, Stream, MemoryStream o FileStream.

<DatosSalida> (obligatorio)

Tipo: String.
Nombre de un archivo al que se exportarán los datos firmados.
Si se especifica Undefined, el resultado del método se devolverá en el valor de retorno del tipo BinaryData.

<TipoFirma> (opcional)

Tipo: CryptoSignatureType.
Tipo de firma de criptografía.
{macros: Tipos de firma admitidos}
Valor predeterminado: CAdESBES.

Descripción de la variante del método:

Los datos firmados se guardan en un archivo.

Valor devuelto:

Tipo: Promise.
El resultado de la ejecución de la promesa es los datos firmados del tipo BinaryData o el nombre de un archivo al que se exportan los datos.
Las propiedades HashAlgorithm y SignAlgorithm definen los algoritmos de firma.
El archivo fuente no se incluye en los datos de firma.
La propiedad IncludeCertificatesInSignature especifica si se incluyen los certificados en la firma.
Si no se especifica un certificado, se utilizará un certificado personal.
Después de completar, se llama a un procedimiento especificado en el parámetro &CallbackDescription.

Descripción:

Función asíncrona. Crea una firma en formato PKCS#7.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, servidor, cliente grueso, conexión externa, aplicación móvil (cliente), aplicación móvil (servidor), servidor independiente móvil.

Véase también:

CryptoManager, método Sign
CryptoManager, método BeginSigning

Disponible desde:

Disponible desde la versión 8.3.18.