Adobe 22002486 Digital Signature User Guide - Page 81

Property, Description

Page 81 highlights

Acrobat 9 Family of Products Security Feature User Guide Controlling Signing with Seed Values Specifying Certificate Properties for Signing 81 Table 11 Seed values: certSpec properties Property Type Description flags number issuer array of certificate objects keyUsage array of integers oid array of strings A set of bit flags controlling which of the following properties of this object are required. The value is the logical OR of the following values, which are set if the corresponding property is required: 1: subject 2: issuer 4: oid 8: subjectDN (Acrobat 8 and later) 16: issuerDN (Acrobat 8 and later) 32: keyUsage (Acrobat 8 and later) 64: url (Acrobat 8 and later) If this field is not present, all properties are optional. Usage: 1 specifies subject, 3 specifies subject and issuer, and 6 specifies issuer and oid. That is, values can be added. If this field is not present, all properties are optional. One or more issuers that are acceptable for signing. The issuer can be a root or intermediate root certificate. Access to the physical, DER-encoded certificate is required. It is identified by a path to a discrete file in the format of ["/c/test/root.cer"]. (Acrobat 8.0) Integers in HEX or decimal that specify the keyUsage extension that must be present in the signing certificate. Each integer is constructed as follows: There are two bits used for each keyUsage type (defined in RFC 3280) starting from the least significant bit: digitalSignature(bits 2,1) nonRepudiation(4,3) keyEncipherment(6,5) dataEncipherment(8,7) keyAgreement(10,9) keyCertSign(12,11) cRLSign(14,13) encipherOnly(16,15) decipherOnly(18,17) The value of the two bits have the following semantics: 00: The corresponding keyUsage is not allowed. 01: The corresponding keyUsage is required. 10 and 11: The state of the corresponding keyUsage doesn't matter. For example, if it's required that keyUsage must require digitalSignature and the state of all other's doesn't matter, then the corresponding integer would be 0x7FFFFFFD. That is, to represent digitalSignature, set 01 for bits 2 and 1 respectively, and set 11 for all other keyUsage types. One or more policy OIDs that must be present in the signing certificate's policy. The OID is part of the value of the certificate's certificate policy field. This property is only applicable if the issuer property is present. oid and issuer can be used together to specify a certificate that has the selected policy.

  • 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
Specifying Certificate Properties for Signing
81
Table 11
Seed values: certSpec properties
Property
Type
Description
flags
number
A set of bit flags controlling which of the following properties of this object are
required. The value is the logical OR of the following values, which are set if the
corresponding property is required:
1
: subject
2
: issuer
4
: oid
8
: subjectDN (Acrobat 8 and later)
16
: issuerDN (Acrobat 8 and later)
32
: keyUsage (Acrobat 8 and later)
64
: url (Acrobat 8 and later)
If this field is not present, all properties are optional.
Usage: 1 specifies
subject
, 3 specifies
subject
and
issuer
, and 6 specifies
issuer
and
oid
. That is, values can be added. If this field is not present, all
properties are optional.
issuer
array of
certificate
objects
One or more issuers that are acceptable for signing. The issuer can be a root or
intermediate root certificate. Access to the physical, DER-encoded certificate is
required. It is identified by a path to a discrete file in the format of
[
"/c/test/root.cer"
].
keyUsage
array of
integers
(Acrobat 8.0) Integers in HEX or decimal that specify the
keyUsage
extension that
must be present in the signing certificate. Each integer is constructed as follows:
There are two bits used for each keyUsage type (defined in RFC 3280) starting from the
least significant bit:
digitalSignature(bits 2,1)
nonRepudiation(4,3)
keyEncipherment(6,5)
dataEncipherment(8,7)
keyAgreement(10,9)
keyCertSign(12,11)
cRLSign(14,13)
encipherOnly(16,15)
decipherOnly(18,17)
The value of the two bits have the following semantics:
00
: The corresponding keyUsage is not allowed.
01
: The corresponding keyUsage is required.
10 and 11
: The state of the corresponding keyUsage doesn’t matter.
For example, if it’s required that keyUsage must require
digitalSignature
and
the state of all other’s doesn’t matter, then the corresponding integer would be
0x7FFFFFFD. That is, to represent digitalSignature, set 01 for bits 2 and 1 respectively,
and set 11 for all other keyUsage types.
oid
array of
strings
One or more policy OIDs that must be present in the signing certificate’s policy. The
OID is part of the value of the certificate’s certificate policy field. This property is only
applicable if the issuer property is present.
oid
and
issuer
can be used together to
specify a certificate that has the selected policy.