Adding a certified signature field to a PDF in Xamarin

1using (PDFDoc doc = new PDFDoc(docpath))
2{
3  Page page1 = doc.GetPage(1);
4
5  // Create a text field that we can lock using the field permissions feature.
6  TextWidget annot1 = TextWidget.Create(doc, new Rect(50, 550, 350, 600), "asdf_test_field");
7  page1.AnnotPushBack(annot1);
8
9  /**
10   * Create a new signature form field in the PDFDoc. The name argument is
11   * optional; leaving it empty causes it to be auto-generated. However, you may
12   * need the name for later. Acrobat doesn't show digsigfield in side panel if
13   * it's without a widget. Using a Rect with 0 width and 0 height, or setting
14   * the NoPrint/Invisible flags makes it invisible.
15   */
16  DigitalSignatureField certification_sig_field = doc.CreateDigitalSignatureField(cert_field_name);
17  SignatureWidget widgetAnnot = SignatureWidget.Create(doc, new Rect(0, 100, 200, 150), certification_sig_field);
18  page1.AnnotPushBack(widgetAnnot);
19
20  // (OPTIONAL) Add an appearance to the signature field.
21  Image img = Image.Create(doc, appearance_image_path);
22  widgetAnnot.CreateSignatureAppearance(img);
23
24  // Prepare the document locking permission level. It will be applied upon document certification.
25  certification_sig_field.SetDocumentPermissions(DigitalSignatureField.DocumentPermissions.e_annotating_formfilling_signing_allowed);
26
27  // Prepare to lock the text field that we created earlier.
28  string[] fields_to_lock = new string[1];
29  fields_to_lock[0] = "asdf_test_field";
30  certification_sig_field.SetFieldPermissions(DigitalSignatureField.FieldPermissions.e_include, fields_to_lock);
31
32  certification_sig_field.CertifyOnNextSave(private_key_file_path, keyfile_password);
33
34  // (OPTIONAL) Add more information to the signature dictionary.
35  certification_sig_field.SetLocation("Vancouver, BC");
36  certification_sig_field.SetReason("Document certification.");
37  certification_sig_field.SetContactInfo("www.apryse.com");
38
39  // Save the PDFDoc. Once the method below is called, PDFNet will also sign the document using the information provided.
40  doc.Save(outpath, 0);
41}

1A Widget annotation dictionary or Field dictionary shall not
2contain the A or AA keys. The NeedAppearances flag of the
3interactive form dictionary shall either not be present
4or shall be false.

16.3.2 Annotation dictionaries
2
3Except for annotation dictionaries whose Subtype value
4is Popup, all annotation dictionaries shall contain
5the F key. If present, the F key’s Print flag bit shall
6be set to 1 and its Hidden, Invisible, ToggleNoView, and
7NoView flag bits shall be set to 0.
8
9Text annotations should set the NoZoom and NoRotate
10flag bits of the F key to 1.
11
12NOTE The restrictions on annotation flags prevent the
13use of annotations that are hidden or that are viewable
14but not printable. The NoZoom and NoRotate flags are
15permitted, which allows the use of annotation types that
16have the same behaviour as the commonly-used text
17annotation type. By definition, text annotations exhibit
18the NoZoom and NoRotate behaviour even if the flags are
19not set, as described in ISO 32000-1:2008, 12.5.3;
20explicitly setting these flags removes any potential
21ambiguity between the annotation dictionary settings and
22reader behaviour.
23
246.3.3 Annotation Appearances
25
26Every annotation (including those whose Subtype value
27is Widget, as used for form fields), except for the two
28cases listed below, shall have at least one appearance
29dictionary.
30
31-- Annotations where the value of the Rect key consists
32of an array where value 1 is equal to value 3 and value
332 is equal to value 4.
34
35-- Annotations whose Subtype value is Popup or Link.
36
37A conforming reader shall render the appearance dictionary
38without regard to any other keys and values in the
39annotation dictionary and shall ignore the values of
40the C, IC, Border, BS, BE, CA, H, DA, Q, DS, LE, LL,
41LLE, and Sy keys.
42
43NOTE 1 Requiring an appearance dictionary for each
44annotation ensures the reliable rendering of the
45annotations.
46
47For all annotation dictionaries containing an AP key,
48the appearance dictionary that it defines as its value
49shall contain only the N key. If an annotation
50dictionary’s Subtype key has a value of Widget and
51its FT key has a value of Btn, the value of the N
52key shall be an appearance subdictionary otherwise
53the value of the N key shall be an appearance stream.
54
55NOTE 2 In accordance with the requirements of 12.7.4.2.3
56and 12.7.4.2.4 of ISO 32000-1:2008, a Button form field
57needs to have multiple appearance states, each one
58associated with the specific values that the button can take.