Adobe 22002486 Digital Signature User Guide - Page 68

Changes Across Releases

Page 68 highlights

Acrobat 9 Family of Products Security Feature User Guide Controlling Signing with Seed Values Changes Across Releases 68  Seed values should not be set on signed documents and cannot be set on certified documents after the document is certified. They are primarily used to configure fields on documents that are not yet signed.  Setting a seed value often causes Acrobat to not display or use its default settings. For example, default reasons are stored in a registry list, and specifying signing reasons with a seed value overrides that list.  Seed value properties include those listed in Table 8. Note that certspec and timeStampspec are objects that have multiple properties. 5.1.1 Changes Across Releases Each Acrobat release results in support for additional seed values as shown in Table 7. Table 7 Seed values: Changes across releases Seed value First support for seed value 67 8 9 certspec filter flags Specifies that certain certificates must be used for a particular signature field. 6.0-7.x: Supports subject, issuer, and oid. 8.x: Adds support for subjectDN, issuerDN, keyUsage, url, and urlType The language-independent name of the security handler to be used when signing. A set of bit flags controlling which properties are required. 6.0-7.x: 1: filter, 2: subFilter, 4: version, and 8: reasons. 8.0: 16: legalAttestations, 32: shouldAddRevInfo, and 64: digestMethod. XX X X XX X X XX X X legalAttestations mdp reasons subFilter timeStampspec version digestMethod A list of legal attestations that the user can use when creating an MDP (certification) signature. X X X X Can be used to force a certification signature as well as to control permitted document changes. X X X X A list of reasons that the user is allowed to use when signing. XX X X 8.0: Supports disabling signing reasons. An array of acceptable signature formats. XX X X Specifies a timestamp server using the url and flags properties. XX X X The signature handler version to be used to sign the signature field. Valid values are 1 and 2. X X X X 8.0: Must be set to 2 if this seed value object contains Acrobat 8-specific content marked as required. The algorithm used to created the message digest. XX X X 6.0-7.x: MD5, SHA1. 8.0: Adds support for SHA256, SHA384, SHA512, and RIPEMD160. Note: SHA256, SHA384, and SHA512 are not supported in Windows CAPI until Acrobat 9.1, and not supported in Windows at all prior to XP-SP3. shouldAddRevInfo lockDocument Controls how the application does certificate and chain revocation checking. Allows the author to add a Lock Document checkbox to the signing dialog so a signer can lock the document at the time of signing. XX X appearanceFilter A text string naming the appearance required to be used when signing the signature field. X

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189

Acrobat 9 Family of Products
Controlling Signing with Seed Values
Security Feature User Guide
Changes Across Releases
68
Seed values should not be set on signed documents and cannot be set on certified documents after
the document is certified. They are primarily used to configure fields on documents that are not yet
signed.
Setting a seed value often causes Acrobat to not display or use its default settings. For example, default
reasons are stored in a registry list, and specifying signing reasons with a seed value overrides that list.
Seed value properties include those listed in
Table 8
. Note that
certspec
and
timeStampspec
are
objects that have multiple properties.
5.1.1
Changes Across Releases
Each Acrobat release results in support for additional seed values as shown in
Table 7
.
Table 7
Seed values: Changes across releases
Seed value
First support for seed value
6
7
8
9
certspec
Specifies that certain certificates must be used for a particular signature field.
6.0-7.x
: Supports subject, issuer, and oid.
8.x
: Adds support for subjectDN, issuerDN, keyUsage, url, and urlType
X
X
X
X
filter
The language-independent name of the security handler to be used when signing.
X
X
X
X
flags
A set of bit flags controlling which properties are required.
6.0-7.x
: 1: filter, 2: subFilter, 4: version, and 8: reasons.
8.0
: 16: legalAttestations, 32: shouldAddRevInfo, and 64: digestMethod.
X
X
X
X
legalAttestations
A list of legal attestations that the user can use when creating an MDP (certification) signature.
X
X
X
X
mdp
Can be used to force a certification signature as well as to control permitted document changes.
X
X
X
X
reasons
A list of reasons that the user is allowed to use when signing.
8.0
: Supports disabling signing reasons.
X
X
X
X
subFilter
An array of acceptable signature formats.
X
X
X
X
timeStampspec
Specifies a timestamp server using the
url
and
flags
properties.
X
X
X
X
version
The signature handler version to be used to sign the signature field. Valid values are 1 and 2.
8.0
: Must be set to 2 if this seed value object contains Acrobat 8-specific content marked as
required.
X
X
X
X
digestMethod
The algorithm used to created the message digest.
6.0-7.x
: MD5, SHA1.
8.0
: Adds support for SHA256, SHA384, SHA512, and RIPEMD160.
Note
: SHA256, SHA384, and SHA512 are not supported in Windows CAPI until Acrobat 9.1, and
not supported in Windows at all prior to XP-SP3.
X
X
X
X
shouldAddRevInfo
Controls how the application does certificate and chain revocation checking.
X
X
lockDocument
Allows the author to add a Lock Document checkbox to the signing dialog so a signer can lock
the document at the time of signing.
X
appearanceFilter
A text string naming the appearance required to be used when signing the signature field.
X