Task XML - Sign
The XML - Sign Task adds an XML digital signature to the XML files that its File filter selects, using a certificate from the VisualCron certificate store.
The Main settings, Flow, On error, Conditions and TimeOut tabs are the same for every Task; see Job - Tasks.
With the default Save to.. option Same folder but use file mask and the default File mask *, the signed file gets the name of the source file in the same folder, so it replaces the source file. Same file also replaces the source file. To keep the source files, set a different File mask, such as *_signed.xml, or save to a different folder.
With "HMAC", the default Signature method, the signing key is made from the certificate itself and not from its private key, so anyone who has a copy of the certificate can create a signature that matches. To sign with the private key of the certificate, select "Signature".
When the File filter finds no file, no error is raised, and the Task reports success. To have it fail the Task, select "All errors" on the On error tab; see Task - On Error.
Sign: File filter tab

The File filter selects the files to sign; see File Filter. The Credential of the File filter is used to read and save the files.
Sign: Destination tab

XML sign parameters
- Signature type: Where the signature is placed. The default is "Enveloped"
- "Enveloped": The signature is added inside the signed document
- "Enveloping": The signed document is placed inside the signature
- "Detached": The saved file contains only the signature
- Canonicalization method: How the XML is converted to its canonical form before it is signed. The options are "Canonical" (the default), "Canonical with comments", "Canonical v1.1", "Canonical with comments v1.1", "Exclusive canonical", "Exclusive canonical with comments" and "Minimal canonical"
- Signature method: Select "HMAC" (the default) or "Signature", then select the algorithm in the list next to it. The list next to the option that is not selected is not available
- "HMAC": "MD5", "SHA1" (the default), "SHA224", "SHA256", "SHA384", "SHA512" or "RIPEMD160"
- "Signature": "DSS", "RSA SHA1" (the default), "RSA MD5", "RSA SHA256", "RSA SHA384", "RSA SHA512" or "RSA RIPEMD160"
Certificate
- Certificate: The certificate to sign with. Select a certificate in the list, or click the icon next to it to open Manage Certificates, where a certificate is selected, imported or created; see Global - Certificates. With "Signature", the certificate must include a private key
- Include public key: When selected, the certificate is included in the signature, so that the receiver can check the signature without a copy of it
- Key name: A text that identifies the key to the receiver, written to the
KeyNameelement of the signature. It can be a key name, a key index, a distinguished name or an e-mail address. White space in the text is kept
Save to..
- Same file: The signed file replaces the source file
- Same folder but use file mask: The default. The signed file is saved in the folder of the File filter, with the name that File mask gives
- Different folder and use file mask: The signed file is saved in Folder, with the name that File mask gives
- Folder: The destination folder. Available with Different folder and use file mask
- File mask: The name of the signed file.
*keeps the name of the source file. Available with both file mask options
Output and errors
- The output of the Task contains the path of each signed file. When several files are signed, the paths follow each other without a separator
- The files are signed one by one. When a file cannot be signed, for example because the certificate is not found, the Task fails, and the remaining files are not signed