Upgrade Method
Upgrades existing CAdES to a new level.
Syntax
cadessigner.upgrade(toLevel, [callback])
Callback
The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).
The callback for this method is defined as:
function(err){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'err' has 2 properties which hold detailed information:
err.code err.message
Remarks
CMS Advanced Electronic Signatures (CAdES) standard defines a number of different 'levels' of signatures which can be used for different purposes. Use this method to upgrade CAdES to a new level specified by ToLevel. Signatures can normally be upgraded from less sophisticated levels (BES, EPES) to more sophisticated (T, XL, A).
Supported levels:
| cslUnknown | 0 | Unknown signature level |
| cslBES | 1 | BES (Basic Electronic Signature) |
| cslEPES | 2 | EPES (Electronic Signature with an Explicit Policy) |
| cslT | 3 | T (Timestamped) |
| cslC | 4 | C (T with revocation references) |
| cslXType1 | 5 | X Type 1 (C with an ES-C timestamp) |
| cslXType2 | 6 | X Type 2 (C with a CertsAndCRLs timestamp) |
| cslXLType1 | 7 | XL Type 1 (C with revocation values and an ES-C timestamp) |
| cslXLType2 | 8 | XL Type 2 (C with revocation values and a CertsAndCRLs timestamp) |
| cslBaselineB | 9 | Baseline B (B-B, basic) |
| cslBaselineT | 10 | Baseline T (B-T, timestamped) |
| cslBaselineLT | 11 | Baseline LT (B-LT, long-term) |
| cslBaselineLTA | 12 | Baseline LTA (B-LTA, long-term with archived timestamp) |
| cslExtendedBES | 13 | Extended BES |
| cslExtendedEPES | 14 | Extended EPES |
| cslExtendedT | 15 | Extended T |
| cslExtendedC | 16 | Extended C |
| cslExtendedXType1 | 17 | Extended X Type 1 |
| cslExtendedXType2 | 18 | Extended X Type 2 |
| cslExtendedXLType1 | 19 | Extended XL Type 1 |
| cslExtendedXLType2 | 20 | Extended XL Type 2 |
| cslExtendedA | 21 | Extended A |
| cslA | 22 | A (archived) |