Acrobat Digital Signature API Reference - Adobe Partners

More documents

Recommendations

Info

1 Digital Signature Overview Understanding the Process Handling Document Open and Close Operations When the user opens a document, DigSig calls your plug-ins to notify them of the new document by calling DSDocOpenProc; you might allocate some storage or choose to automatically validate any of their respective signatures in the document. Auto-validation may produce significant delays if it must read all of a large document from a CD-ROM or over a network, or if it must access a signature registry or authority over a network. Therefor, Adobe software only accesses signatures at user request. When the user closes a document, DigSig calls DSDocCloseProc. Understanding the Process The steps in this section are suggestions that describe the interactions of a digital signature plug-in. (The SignDoc sample plug-in provided with this SDK is a more complete example.) Dialogs and Signature Gathering 1. DigSig calls your dsNewSigDataProc, a callback that begins the process. – Your plug-in interacts with the user, and allows the user to cancel if they want to do so. – Your plug-in acquires the signature itself in a method-specific way. All information is saved in memory, without altering the document itself. This allows a later backout. – If dsNewSigData does not cancel, DigSig prepares the document for saving: It first calls dsUnValidateSig on every signature in the document to put any overprinting/underprinting in canonical form. It then counts how many pages and fields have changed since any prior signature and records this. – For a first signature, DigSig does the SaveAs dialog, allowing the user to select filename, optimization, and encryption. The user may cancel. Other than fatal errors, such as out-of-disk-space, this is the last chance to stop the process. Saving a Document 1. DigSig calls Xxxx.DSCommitSignProc to update the document with the actual signature. Your DSCommitSignProc callback must: – create the signature dictionary, possibly using information in the signature field /DV dictionary, perhaps using the /ByteRange and /Contents keys. – point /V in the signature field dictionary to this. Then create the /AP /N value in the signature annotation dictionary, using a method-specific visible representation of the signature, including a symbol signifying “unvalidated signature.” – optionally allocate dynamic storage for a marked array, an array of “marked” COS objects that it cares about. 18 Acrobat Digital Signature API Reference
Digital Signature Overview Understanding the Process 1 – return a marked array that includes at least the /ByteRange and /Contents value objects. 2. DigSig inserts the /Changes array from step 1. 3. DigSig saves the PDF document to a file. For each Cos object in the marked array, DigSig records the object’s byte offset and length in the file as written. The saved file may have objects encrypted by the Acrobat standard encryption handler, if the user so chooses. 4. The very first time a document is signed, DigSig may rename the file and may invoke the Optimizer, Linearizer, and Garbage Collector. Upon return from the save, all COS objects are invalid, including those in the marked array. – All PD-level objects except the PDDoc are invalid. Signing methods must not depend on saving any such state between dsCommitSign and dsFinishSign. In particular, the byte offsets and lengths in the marked array are valid upon entry to doSign, but the Cos objects are not. The order of entries is unchanged, however, these Cos objects will be rewritten by DigSig as CosNull before calling dsFinishSign. Finishing the Process 1. DigSig calls dsFinishSign, passing back in the marked array. Your DSFinishSignProc must: – Calculate the /ByteRange that it desires, using the byte offsets and lengths in the marked array. – Overwrite the marked /ByteRange value in the saved file, using the DigSigOverwriteIntArray or DigSigOverwriteBytes callback. – Overwrite any other marked Cos objects it wants to. – Calculate any document digest that it desires, using the DigSigFileGetEOF, DigSigFileSetPos, and DigSigFileRead callbacks; or it may use the DigSigMD5ByteRange callback. – Obscure or encrypt this digest in a method-specific way. – Overwrite the marked /Contents value in the saved file, using DigSigOverwriteHexstring or DigSigOverwriteBytes. – Optionally delete dynamic storage for the marked array the plug-in returns. 2. DigSig calls dsFreeSigData, which may free up any remaining storage. Acrobat Digital Signature API Reference 19
Page 1 and 2: c Acrobat Digital Signature API Ref
Page 3: Acrobat SDK Documentation Roadmap G
Page 6 and 7: Contents PSUnregisterHandler . . .
Page 8 and 9: Contents Chapter 5 Digital Signatur
Page 10 and 11: Contents DSAPXObjEntryRec. . . . .
Page 12 and 13: Preface Audience ● ● Digital Si
Page 14 and 15: Preface Conventions Used in This Bo
Page 16 and 17: 1 Digital Signature Overview Digita
Page 20 and 21: 1 Digital Signature Overview Unders
Page 22 and 23: 1 Digital Signature Overview Unders
Page 24 and 25: 2 PubSec Methods General PubSec Met
Page 34 and 35: 2 PubSec Methods PubSec Acrobat Add
Page 36 and 37: 2 PubSec Methods PubSec Acrobat Add
Page 38 and 39: 2 PubSec Methods Digital Signature
Page 50 and 51: 3 PubSec Callbacks PSExportDataProc
Page 52 and 53: 3 PubSec Callbacks PSGetBoolPropert
Page 54 and 55: 3 PubSec Callbacks PSGetDirInfo ACC
Page 56 and 57: 3 PubSec Callbacks PSGetImplicitRec
Page 58 and 59: 3 PubSec Callbacks PSGetLogoProc AC
Page 60 and 61: 3 PubSec Callbacks PSImportDataProc
Page 62 and 63: 3 PubSec Callbacks PSOpenCMSEnvelop
Page 64 and 65: 3 PubSec Callbacks PSPerformOperati
Page 66 and 67: 3 PubSec Callbacks PSSessionReadyPr
Page 68 and 69:
3 PubSec Callbacks PSSetDirInfo ACC
Page 70 and 71:
3 PubSec Callbacks PSSigCreateAPNXO
Page 72 and 73:
3 PubSec Callbacks PSSigGetSigValue
Page 74 and 75:
3 PubSec Callbacks PSSigValGetAPLab
Page 76 and 77:
3 PubSec Callbacks PSSigValidateDia
Page 78 and 79:
3 PubSec Callbacks PSSigValidateSup
Page 80 and 81:
4 PubSec Declarations Header File P
Page 82 and 83:
4 PubSec Declarations DirConnection
Page 84 and 85:
Page 86 and 87:
4 PubSec Declarations DirectoryInfo
Page 88 and 89:
4 PubSec Declarations DSAPFile type
Page 90 and 91:
4 PubSec Declarations DSPropertyTyp
Page 92 and 93:
4 PubSec Declarations DSSaveType ty
Page 94 and 95:
4 PubSec Declarations kDSSigValText
Page 96 and 97:
4 PubSec Declarations PSDataBuffer
Page 98 and 99:
4 PubSec Declarations destType The
Page 100 and 101:
4 PubSec Declarations PSExportDataT
Page 102 and 103:
4 PubSec Declarations PSImportDataE
Page 104 and 105:
4 PubSec Declarations PSImportDataT
Page 106 and 107:
4 PubSec Declarations PSPerformOpTy
Page 108 and 109:
4 PubSec Declarations kPSOpTypePoli
Page 110 and 111:
4 PubSec Declarations PSSigDataBuff
Page 112 and 113:
4 PubSec Declarations PSSigDialogSt
Page 114 and 115:
4 PubSec Declarations PSSigMethod t
Page 116 and 117:
4 PubSec Declarations PSSigGetSigVa
Page 118 and 119:
4 PubSec Declarations PSSigSigPropP
Page 120 and 121:
4 PubSec Declarations PSSigTrust De
Page 122 and 123:
4 PubSec Declarations reqRevokeChec
Page 124 and 125:
4 PubSec Declarations bModalParent
Page 126 and 127:
4 PubSec Declarations PSSigValSuppo
Page 128 and 129:
4 PubSec Declarations PubSecHandler
Page 130 and 131:
Page 132 and 133:
4 PubSec Declarations 132 Acrobat D
Page 134 and 135:
5 Digital Signature Methods DigSigA
Page 136 and 137:
Page 138 and 139:
Page 140 and 141:
Page 142 and 143:
5 Digital Signature Methods DigSigC
Page 144 and 145:
Page 146 and 147:
Page 148 and 149:
Page 150 and 151:
Page 152 and 153:
Page 154 and 155:
Page 156 and 157:
5 Digital Signature Methods DigSigD
Page 158 and 159:
5 Digital Signature Methods DigSigD
Page 160 and 161:
5 Digital Signature Methods DigSigE
Page 162 and 163:
5 Digital Signature Methods DigSigF
Page 164 and 165:
5 Digital Signature Methods DigSigF
Page 166 and 167:
5 Digital Signature Methods DigSigG
Page 168 and 169:
5 Digital Signature Methods DigSigG
Page 170 and 171:
5 Digital Signature Methods DigSigH
Page 172 and 173:
5 Digital Signature Methods DigSigI
Page 174 and 175:
5 Digital Signature Methods DigSigM
Page 176 and 177:
5 Digital Signature Methods DigSigO
Page 178 and 179:
5 Digital Signature Methods DigSigO
Page 180 and 181:
5 Digital Signature Methods DigSigR
Page 182 and 183:
5 Digital Signature Methods DigSigR
Page 184 and 185:
5 Digital Signature Methods DigSigU
Page 186 and 187:
5 Digital Signature Methods DigSigU
Page 188 and 189:
5 Digital Signature Methods DigSigV
Page 190 and 191:
6 Digital Signature Callbacks DSCan
Page 192 and 193:
6 Digital Signature Callbacks DSCom
Page 194 and 195:
6 Digital Signature Callbacks DSDoc
Page 196 and 197:
6 Digital Signature Callbacks DSFin
Page 198 and 199:
6 Digital Signature Callbacks DSGet
Page 200 and 201:
6 Digital Signature Callbacks DSGet
Page 202 and 203:
6 Digital Signature Callbacks DSNew
Page 204 and 205:
6 Digital Signature Callbacks DSNot
Page 206 and 207:
6 Digital Signature Callbacks DSPro
Page 208 and 209:
6 Digital Signature Callbacks DSReV
Page 210 and 211:
6 Digital Signature Callbacks DSUnV
Page 212 and 213:
6 Digital Signature Callbacks 212 A
Page 214 and 215:
6 Digital Signature Callbacks 214 A
Page 216 and 217:
7 Digital Signature Declarations Di
Page 218 and 219:
7 Digital Signature Declarations ds
Page 220 and 221:
7 Digital Signature Declarations le
Page 222 and 223:
7 Digital Signature Declarations DS
Page 224 and 225:
Page 226 and 227:
7 Digital Signature Declarations He
Page 228 and 229:
Page 230 and 231:
Page 232 and 233:
7 Digital Signature Declarations He
Page 234 and 235:
Page 236 and 237:
Page 238 and 239:
Page 240 and 241:
Page 242:
8 Digital Signature’s Use of Core
show all

Acrobat Digital Signature API Reference - Adobe Partners

Create successful ePaper yourself

Delete template?

Save as template?