CryptoManager
Sign
Disponible desde la versión 8.2.
Variante de sintaxis: Los datos de la firma se guardan en un archivo
Sintaxis:
Sign(<DatosIniciales>, <DatosSalida>, <Certificado>, <TipoFirma>)
Parámetros:
<DatosIniciales> (obligatorio)
Tipo: String, BinaryData, Stream, MemoryStream, FileStream.
Datos iniciales para firmar.
Los datos pueden estar ubicados en un archivo (en este caso se especifica el nombre del archivo) o representados como BinaryData.
<DatosSalida> (obligatorio)
Tipo: String, Stream, MemoryStream, FileStream.
Nombre del archivo o un stream, al cual se descargan los datos firmados.
Si Undefined, el resultado del método se devolverá en el valor de retorno del tipo BinaryData.
<Certificado> (opcional)
Tipo: CryptoCertificate.
Certificado de criptografía utilizado.
Si no se especifica, el almacén de certificados personales debe contener exactamente 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: CAdEST.
Descripción de la variante del método:
Los datos firmados se escriben en un archivo. Devuelve Undefined.
Valor devuelto:
Tipo: Undefined, BinaryData.
Cuando se guarda la firma en un archivo, devuelve Undefined.
Descripción:
Crea la firma en formato CMS (basado en PKCS#7) y la devuelve como BinaryData o la guarda en un archivo.
La firma se crea mediante algoritmos que se establecen mediante las propiedades HashAlgorithm y SignAlgorithm.
El archivo fuente no se incluye en los datos de la firma.
Los certificados pueden incluirse en los datos de la firma dependiendo de la propiedad IncludeCertificatesInSignature.
Si no se indica el certificado, se utiliza el único certificado personal instalado para la firma.
Este método requiere la instalación de la extensión de criptografía para funcionar en el cliente web. En el cliente web, el método solo es compatible con el navegador Internet Explorer, si la configuración utiliza llamadas síncronas para las extensiones y complementos de la plataforma.
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.
Nota:
Se produce una situación de error cuando no se instalan certificados personales.
Se produce una situación de error cuando el certificado utilizado para la firma no está vinculado con el contenedor de claves.
Véase también:
CryptoManager, método BeginSigning
CryptoManager, método SignAsync
Disponible desde:
Disponible desde la versión 8.2.
Descripción cambiada en la versión 8.3.24.
