Ψηφιακή υπογραφή εγγράφων PDF σε απευθείας σύνδεση χρησιμοποιώντας το PHP Cloud SDK

PDF τα έγγραφα είναι μεταξύ των μορφών αρχείων που χρησιμοποιούνται ευρέως για την κοινή χρήση πληροφοριών. Συνήθως έχουν εμπιστευτική και νομική αξία, όπως μια σύμβαση. Προκειμένου να διασφαλίσουμε την ακεραιότητα των αρχείων και να αποφύγουμε τυχόν πλαστές, προσθέτουμε ψηφιακές υπογραφές. Διασφαλίζει επίσης ότι ένα έγγραφο δεν έχει τροποποιηθεί από κάποιον άλλο εκτός από τον συντάκτη του και επαληθεύει ότι ο συντάκτης είναι αυτός που περιμένουμε και όχι κάποιος άλλος.

Μια ψηφιακή υπογραφή σε ένα PDF είναι το ισοδύναμο μιας υπογραφής μελανιού σε ένα έντυπο έγγραφο, αλλά είναι πολύ πιο ασφαλής. Αυτή η πληροφορία τοποθετείται μέσα σε ένα έγγραφο και οι δημοφιλείς αναγνώστες PDF μπορούν να ελέγξουν ότι το έγγραφο δεν έχει τροποποιηθεί από άγνωστο άτομο. Σε αυτό το άρθρο, θα συζητήσουμε τις λεπτομέρειες σχετικά με τον τρόπο ψηφιακής υπογραφής εγγράφων PDF στο διαδίκτυο στην PHP.

• Πρόσβαση στο API χρησιμοποιώντας την εντολή cURL
• Πρόσβαση στο API μέσω του PHP SDK
• Διαβάστε το πεδίο υπογραφής
• Προσθέστε πεδία υπογραφής χρησιμοποιώντας PHP

Πρόσβαση στο API χρησιμοποιώντας την εντολή cURL

Τα API μας είναι κατασκευασμένα σύμφωνα με τις αρχές της αρχιτεκτονικής REST, ώστε να είναι προσβάσιμα και μέσω εντολών cURL. Λάβετε υπόψη ότι τα API μας είναι προσβάσιμα μόνο σε εξουσιοδοτημένα άτομα, επομένως πριν αποκτήσετε πρόσβαση στα API, πρέπει πρώτα να επισκεφτείτε το Aspose.Cloud dashboard και εάν έχετε λογαριασμό GitHub ή Google, απλώς Εγγραφείτε. Διαφορετικά, κάντε κλικ στο κουμπί Δημιουργία νέου λογαριασμού και δώστε τις απαιτούμενες πληροφορίες. Τώρα συνδεθείτε στον πίνακα εργαλείων χρησιμοποιώντας διαπιστευτήρια και αναπτύξτε την ενότητα Εφαρμογές από τον πίνακα εργαλείων και μετακινηθείτε προς τα κάτω προς την ενότητα Διαπιστευτήρια πελάτη για να δείτε στοιχεία Client ID και Client Secret.

Τώρα το επόμενο βήμα είναι να δημιουργήσετε JSON Web Token (JWT) έτσι ώστε τα API να είναι προσβάσιμα μέσω της γραμμής εντολών. Το ίδιο διακριτικό JWT χρησιμοποιείται για πρόσβαση σε API μέσω εντολών cURL.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=a41d01ef-dfd5-4e02-ad29-bd85fe41e3e4&client_secret=d87269aade6a46cdc295b711e26809af" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
copy

Πρόσβαση στο API μέσω του PHP SDK

Προκειμένου να διευκολύνουμε τους πελάτες μας PHP που επιθυμούν να επεξεργάζονται αρχεία PDF μέσω προγραμματισμού μέσω κώδικα PHP, έχουμε αναπτύξει το Aspose.PDF Cloud SDK για PHP το οποίο είναι ένα περιτύλιγμα γύρω από το Aspose.PDF Cloud API. Μπορούμε να χρησιμοποιήσουμε το ίδιο SDK για την επεξεργασία ψηφιακών υπογραφών και την εκτέλεση σχετικών λειτουργιών. Το SDK είναι διαθέσιμο για λήψη από το Composer και το GitHub.

Τώρα θα συζητήσουμε τα βήματα για την εγκατάσταση του Aspose.PDF Cloud SDK για PHP μέσω του συνθέτη. Γνωρίζουμε ήδη ότι το Composer συνιστάται για χρήση με το SDK και για τη διαχείριση των εξαρτήσεων του έργου σας. Αφού λοιπόν διαμορφώσουμε τον συνθέτη στο σύστημά σας, δοκιμάστε να χρησιμοποιήσετε την ακόλουθη εντολή για να εγκαταστήσετε το Aspose.PDF Cloud SDK για PHP.

composer require aspose/pdf-sdk-php
copy

Διαβάστε τα πεδία υπογραφής

Το API σάς δίνει τη δυνατότητα να διαβάζετε τις ιδιότητες που σχετίζονται με πεδία υπογραφής που είναι ήδη διαθέσιμα σε έγγραφα PDF. Για να διαβάσετε το πεδίο υπογραφής, έχετε δύο επιλογές.

• Διαβάστε τα πεδία υπογραφής από τη συγκεκριμένη σελίδα του εγγράφου χρησιμοποιώντας το GetPageSignatureFields API
• Διαβάστε το πεδίο υπογραφής εγγράφου ανά όνομα χρησιμοποιώντας το GetSignatureField API

Για να διαβάσετε τα πεδία υπογραφής από μια συγκεκριμένη σελίδα του εγγράφου, δοκιμάστε να χρησιμοποιήσετε την ακόλουθη εντολή cURL. Σημειώστε ότι στην ακόλουθη εντολή, το BlankWithSignature.pdf είναι το αρχείο προέλευσης PDF:

curl -X GET "https://api.aspose.cloud/v3.0/pdf/BlankWithSignature.pdf/page/1/fields/signature" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"
copy

Τώρα για να διαβάσετε ιδιότητες που σχετίζονται με το συγκεκριμένο πεδίο Υπογραφή πάνω από το έγγραφο, δοκιμάστε να χρησιμοποιήσετε την ακόλουθη εντολή όπου παρέχουμε το όνομα ενός συγκεκριμένου πεδίου υπογραφής είναι ένα όρισμα.

curl -X GET "https://api.aspose.cloud/v3.0/pdf/BlankWithSignature.pdf/fields/signature/Signature1" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"
copy

Οι λεπτομέρειες και τα βήματα που δίνονται παρακάτω εξηγούν πώς μπορούμε να ανακτήσουμε λεπτομέρειες πεδίου υπογραφής από ορισμένες σελίδες εγγράφων PDF χρησιμοποιώντας κώδικα PHP.

protected $pdfApi;
// Λάβετε το κλειδί εφαρμογής και το SID εφαρμογής από τη διεύθυνση https://dashboard.aspose.cloud/
$appSid = '';
$appKey = '';
$host = 'https://api.aspose.cloud/v3.0';

// αντικείμενο διαμόρφωσης
$this->config = new Configuration();
$this->config->setAppKey($appKey);
$this->config->setAppSid($appSid);
$this->config->setHost($host);

// δημιουργήστε ένα παράδειγμα PdfApi
$this->pdfApi = new PdfApi(null, $this->config);

// όνομα του εισαγόμενου εγγράφου PDF
$name = 'BlankWithSignature.pdf';
// μεταφορτώστε το αρχείο στο χώρο αποθήκευσης cloud 
$this->uploadFile($name);

// αριθμός σελίδας στο έγγραφο
$pageNumber = 1;

// καλέστε τη μέθοδο API για να ανακτήσετε πεδία υπογραφής από το έγγραφο
$response = $this->pdfApi->getPageSignatureFields($name, $pageNumber, null, $this->tempFolder);
$this->assertEquals(200, $response->getCode());
copy

Ο κωδικός που δίνεται δείχνει πώς μπορούν να ανακτηθούν πληροφορίες για ορισμένα πεδία υπογραφής μέσα στο αρχείο PDF.

protected $pdfApi;
// Λάβετε το κλειδί εφαρμογής και το SID εφαρμογής από τη διεύθυνση https://dashboard.aspose.cloud/
$appSid = '';
$appKey = '';
$host = 'https://api.aspose.cloud/v3.0';

// αντικείμενο διαμόρφωσης
$this->config = new Configuration();
$this->config->setAppKey($appKey);
$this->config->setAppSid($appSid);
$this->config->setHost($host);

// δημιουργήστε ένα παράδειγμα PdfApi
$this->pdfApi = new PdfApi(null, $this->config);

// όνομα του εισαγόμενου εγγράφου PDF
$name = 'BlankWithSignature.pdf';
// μεταφορτώστε PDF στο χώρο αποθήκευσης cloud
$this->uploadFile($name);

// πεδίο υπογραφής για ανάκτηση πληροφοριών
$fieldName = 'Signature1';

// καλέστε το API για να ανακτήσετε τις λεπτομέρειες του πεδίου υπογραφής
$response = $this->pdfApi->getSignatureField($name, $fieldName, null, $this->tempFolder);
$this->assertEquals(200, $response->getCode());
copy

Προσθέστε πεδία υπογραφής χρησιμοποιώντας PHP

Το Aspose.PDF Cloud SDK για PHP προσφέρει επίσης τις δυνατότητες προσθήκης των πεδίων υπογραφής σε έγγραφο PDF. Δίνεται παρακάτω, το απόσπασμα κώδικα σάς δίνει τη δυνατότητα να προσθέσετε το πεδίο υπογραφής στο αρχείο PDF.

 protected $pdfApi;
// Λάβετε το κλειδί εφαρμογής και το SID εφαρμογής από τη διεύθυνση https://dashboard.aspose.cloud/
$appSid = '';
$appKey = '';
$host = 'https://api.aspose.cloud/v3.0';

// αντικείμενο διαμόρφωσης
$this->config = new Configuration();
$this->config->setAppKey($appKey);
$this->config->setAppSid($appSid);
$this->config->setHost($host);

// δημιουργήστε ένα παράδειγμα PdfApi
$this->pdfApi = new PdfApi(null, $this->config);

// όνομα του εισαγόμενου εγγράφου PDF
$name = 'BlankWithSignature.pdf';

// μεταφορτώστε το αρχείο στο χώρο αποθήκευσης cloud
$this->uploadFile($name);

$signatureFileName = '33226.p12';
$this->uploadFile($signatureFileName);

$folder = $this->tempFolder;

$signature = new Aspose\PDF\Model\Signature();
$signature->setAuthority('Nayyer Shahbaz');
$signature->setContact('nayyer.shahbaz@aspose.com');
$signature->setDate('08/01/2012 12:15:00.000 PM');
$signature->setFormFieldName('Signature1');
$signature->setLocation('Australia');
$signature->setPassword('sIikZSmz');
$signature->setRectangle(new Aspose\PDF\Model\Rectangle(['llx' => 100, 'lly' => 100, 'urx' => 0, 'ury' => 0]));
$signature->setSignaturePath($folder . '/' . $signatureFileName);
$signature->setSignatureType(Aspose\PDF\Model\SignatureType::PKCS7);
$signature->setVisible(true);
$signature->setShowProperties(false);

$field = new Aspose\PDF\Model\SignatureField();
$field->setPartialName('sign1');
// ευρετήριο σελίδας όπου πρέπει να προστεθεί το πεδίο υπογραφής
$field->setPageIndex(1);
$field->setSignature($signature);
// καθορίστε την ορθογώνια περιοχή για το πεδίο Υπογραφή
$field->setRect(new Aspose\PDF\Model\Rectangle(['llx' => 100, 'lly' => 100, 'urx' => 160, 'ury' => 140]));

// καλέστε το API για να προσθέσετε το πεδίο υπογραφής
$response = $this->pdfApi->postSignatureField($name, $field, null, $this->tempFolder);
$this->assertEquals(200, $response->getCode());
copy

Σύναψη

Σε αυτό το ιστολόγιο, έχουμε συζητήσει τις έννοιες της εργασίας με ψηφιακές υπογραφές σε έγγραφα PDF. Μάθαμε πώς να ανακτούμε τις πληροφορίες που σχετίζονται με τα υπάρχοντα πεδία υπογραφής καθώς και πώς να προσθέτουμε νέα πεδία υπογραφής στο έγγραφο. Λάβετε υπόψη ότι το Aspose.PDF Cloud SDK για PHP είναι ανοιχτού κώδικα και ο πλήρης πηγαίος κώδικας μπορεί να ληφθεί από το αποθετήριο GitHub.

Δοκιμάστε να χρησιμοποιήσετε τα API μας και σε περίπτωση που αντιμετωπίσετε κάποιο πρόβλημα, μη διστάσετε να επικοινωνήσετε μέσω δωρεάν φόρουμ υποστήριξης πελατών.