SecureBlackbox 2020 Kotlin Edition

Questions / Feedback?

Profile Property

Specifies a pre-defined profile to apply when creating the signature.

Syntax

public var profile: String?

Default Value

""

Remarks

Advanced signatures come in many variants, which are often defined by parties that needs to process them or by local standards. SecureBlackbox profiles are sets of pre-defined configurations which correspond to particular signature variants. By specifying a profile, you are pre-configuring the component to make it produce the signature that matches the configuration corresponding to that profile. 

Supported profiles:

"ES.Factura"Spanish Factura Electronica
"BR.AD_RB_v2_3"Brazilian signature with Basic Reference (AD-RB) version 2.3
"BR.AD_RB_v2_4"Brazilian signature with Basic Reference (AD-RB) version 2.4
"BR.AD_RT_v2_3"Brazilian signature with Time Reference (AD-RT) version 2.3
"BR.AD_RT_v2_4"Brazilian signature with Time Reference (AD-RT) version 2.4
"BR.AD_RV_v2_3"Brazilian signature with References for Validation (AD-RV) version 2.3
"BR.AD_RV_v2_4"Brazilian signature with References for Validation (AD-RV) version 2.4
"BR.AD_RC_v2_3"Brazilian signature with Complete References (AD-RC) version 2.3
"BR.AD_RC_v2_4"Brazilian signature with Complete References (AD-RC) version 2.4
"BR.AD_RA_v2_3"Brazilian signature with References for Archiving (AD-RA) version 2.3
"BR.AD_RA_v2_4"Brazilian signature with References for Archiving (AD-RA) version 2.4
"XAdES.BASELINE-B"XAdES B-B level (ETSI TS 103 171 v2.1.1 Baseline Profile)
"XAdES.BASELINE-T"XAdES B-T level
"XAdES.BASELINE-LT"XAdES B-LT level
"XAdES.BASELINE-LTA"XAdES B-LTA level
"XAdES.BASELINE-E-B"Extended XAdES B-B level (ETSI EN 319 132-1 v1.1.1 Building Blocks and Baseline, ETSI EN 319 132-2 v1.1.1 extended XAdES)
"XAdES.BASELINE-E-T"Extended XAdES B-T level
"XAdES.BASELINE-E-LT"Extended XAdES B-LT level
"XAdES.BASELINE-E-LTA"Extended XAdES B-LTA level
"XAdES.CounterSignature"Adds XAdES countersignature (supported in XML and XAdES signer control)

"ES.Factura" profile equivalent to the following settings:

using (XMLReference Ref = new XMLReference())
{
  Ref.ID = "Reference-1";
  Ref.TargetXMLElement = "";
  Ref.UseEnvelopedSignatureTransform = true;
  Control.References.Add(Ref);
}

using (XMLReference Ref = new XMLReference())
{
  Ref.URI = "#KeyInfo-1";
  Control.References.Add(Ref);
}

Control.XAdESVersion = XadessignerXAdESVersions.xav132;
Control.XAdESForm = XadessignerXAdESForms.xafEPES;
Control.Config("KeyInfoDetails=certificate");
Control.Config("KeyInfoID=KeyInfo-1");
Control.Config("ClaimedRoleText=emisor");
Control.Config("SigPolicyId=http://www.facturae.es/politica_de_firma_formato_facturae/politica_de_firma_formato_facturae_v3_1.pdf");
Control.Config("SigPolicyDescription=Pol" + "\u00ED" + "tica de Firma FacturaE v3.1");
Control.Config("SigPolicyHash=3a18b197aba90fa6aff0dee912f0c006110bea13");
Control.Config("SigPolicyHashAlgorithm=SHA1");
Control.Config("DataObjectFormatObjectReference=#Reference-1");
Control.Config("DataObjectFormatMimeType=text/xml");
Control.Config("DataObjectFormatDescription=Factura electr" + "\u00F3" + "nica");

"XAdES.BASELINE-B" profile equivalent to the following settings:

using (XMLReference Ref = new XMLReference())
{
  Ref.ID = "Reference-1";
  Ref.TargetXMLElement = "";
  Ref.UseEnvelopedSignatureTransform = true;
  Control.References.Add(Ref);
}

Control.XAdESVersion = XadessignerXAdESVersions.xav141;
Control.XAdESForm = XadessignerXAdESForms.xafBES;
Control.Config("DataObjectFormatObjectReference=#Reference-1");
Control.Config("DataObjectFormatMimeType=text/xml");

"XAdES.BASELINE-T" profile extends "XAdES.BASELINE-B" profile with the following settings:

Control.XAdESForm = XadessignerXAdESForms.xafT;
Control.TimestampServer = "https://freetsa.org/tsr";

"XAdES.BASELINE-LT" profile extends "XAdES.BASELINE-T" profile with the following settings:

Control.XAdESForm = XadessignerXAdESForms.xafXL;
Control.Config("RefsTimestampType=none");
Control.Config("ValidationDataRefsDetails=none");

"XAdES.BASELINE-LTA" profile extends "XAdES.BASELINE-LT" profile with the following settings:

Control.XAdESForm = XadessignerXAdESForms.xafA;

"XAdES.BASELINE-E-B" profile equivalent to the following settings:

using (XMLReference Ref = new XMLReference())
{
  Ref.ID = "Reference-1";
  Ref.TargetXMLElement = "";
  Ref.UseEnvelopedSignatureTransform = true;
  Control.References.Add(Ref);
}

Control.XAdESVersion = XadessignerXAdESVersions.xav141;
Control.XAdESForm = XadessignerXAdESForms.xafExtendedBES;
Control.Config("DataObjectFormatObjectReference=#Reference-1");
Control.Config("DataObjectFormatMimeType=text/xml");

"XAdES.BASELINE-E-T" profile extends "XAdES.BASELINE-E-B" profile with the following settings:

Control.XAdESForm = XadessignerXAdESForms.xafExtendedT;
Control.TimestampServer = "https://freetsa.org/tsr";

"XAdES.BASELINE-E-LT" profile extends "XAdES.BASELINE-E-T" profile with the following settings:

Control.XAdESForm = XadessignerXAdESForms.xafExtendedXL;
Control.Config("RefsTimestampType=none");
Control.Config("ValidationDataRefsDetails=none");

"XAdES.BASELINE-E-LTA" profile extends "XAdES.BASELINE-E-LT" profile with the following settings:

Control.XAdESForm = XadessignerXAdESForms.xafExtendedA;

"XAdES.CounterSignature" profile allows to add XAdES countersignature to the existent XAdES-BES or EPES signature. Use XMLElement property to specify existent XAdES signature. Sample code:

Control.Profile = "XAdES.CounterSignature";
Control.EnableXAdES = false;

Copyright (c) 2022 /n software inc. - All rights reserved.
SecureBlackbox 2020 Kotlin Edition - Version 20.0 [Build 8063]