ციფრული ხელმოწერა PDF ფაილებს

PDF დოკუმენტები ინფორმაციის გაზიარებისთვის ფართოდ გამოყენებული ფაილის ფორმატებს შორისაა. მათ ჩვეულებრივ აქვთ კონფიდენციალური და იურიდიული ღირებულება, როგორიცაა კონტრაქტი. ფაილების მთლიანობის უზრუნველსაყოფად და ყოველგვარი გაყალბების თავიდან ასაცილებლად, ჩვენ ვამატებთ ციფრულ ხელმოწერებს. ის ასევე უზრუნველყოფს, რომ დოკუმენტი არ არის შეცვლილი ვინმეს მიერ მისი ავტორის გარდა და ადასტურებს, რომ ავტორი არის ის, ვისაც ველით და არა ვინმე სხვას.

ციფრული ხელმოწერა PDF-ში არის მელნის ხელმოწერის ექვივალენტი ქაღალდის დოკუმენტზე, მაგრამ ის ბევრად უფრო უსაფრთხოა. ეს ინფორმაცია მოთავსებულია დოკუმენტის შიგნით და პოპულარულ PDF მკითხველს შეუძლია შეამოწმოს, რომ დოკუმენტი არ არის შეცვლილი უცნობი პირის მიერ. ამ სტატიაში ჩვენ განვიხილავთ დეტალებს, თუ როგორ უნდა მოაწეროთ PDF დოკუმენტები ციფრულად ონლაინ PHP-ში.

API-ზე წვდომა cURL ბრძანების გამოყენებით

ჩვენი API აგებულია REST არქიტექტურის პრინციპების შესაბამისად, ასე რომ, მათზე წვდომა შესაძლებელია cURL ბრძანებების საშუალებით. გთხოვთ, გაითვალისწინოთ, რომ ჩვენი API ხელმისაწვდომია მხოლოდ ავტორიზებული პირებისთვის, ამიტომ API-ებზე წვდომამდე ჯერ უნდა ეწვიოთ Aspose.Cloud dashboard-ს და თუ გაქვთ GitHub ან Google ანგარიში, უბრალოდ დარეგისტრირდით. წინააღმდეგ შემთხვევაში, დააწკაპუნეთ ღილაკზე Create a new Account და მიაწოდეთ საჭირო ინფორმაცია. ახლა შედით საინფორმაციო დაფაზე რწმუნებათა სიგელების გამოყენებით და გააფართოვეთ აპლიკაციების განყოფილება დაფიდან და გადადით ქვემოთ კლიენტის სერთიფიკატების განყოფილებისკენ, რომ ნახოთ კლიენტის ID და კლიენტის საიდუმლო დეტალები.

ახლა შემდეგი ნაბიჯი არის 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"

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

წაიკითხეთ ხელმოწერის ველები

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>"

ახლა იმისათვის, რომ წაიკითხოთ თვისებები, რომლებიც დაკავშირებულია ხელმოწერის გარკვეულ ველთან დოკუმენტზე, გთხოვთ, სცადოთ შემდეგი ბრძანების გამოყენება, სადაც ჩვენ მივაწოდებთ კონკრეტული ხელმოწერის ველის სახელს არგუმენტად.

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

ქვემოთ მოცემული დეტალები და ნაბიჯები განმარტავს, თუ როგორ შეგვიძლია ხელმოწერის ველის დეტალების მოძიება 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';
// ატვირთეთ ფაილი ღრუბლოვან საცავში 
$this->uploadFile($name);

// გვერდის ნომერი დოკუმენტში
$pageNumber = 1;

// გამოიძახეთ API მეთოდი დოკუმენტიდან ხელმოწერის ველების მოსაძიებლად
$response = $this->pdfApi->getPageSignatureFields($name, $pageNumber, null, $this->tempFolder);
$this->assertEquals(200, $response->getCode());

მოცემული კოდი გვიჩვენებს, თუ როგორ შეიძლება ინფორმაციის მიღება 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 ღრუბლოვან საცავში
$this->uploadFile($name);

// ხელმოწერის ველი ინფორმაციის მისაღებად
$fieldName = 'Signature1';

// დარეკეთ API ხელმოწერის ველის დეტალების მოსაძიებლად
$response = $this->pdfApi->getSignatureField($name, $fieldName, null, $this->tempFolder);
$this->assertEquals(200, $response->getCode());

დაამატეთ ხელმოწერის ველები PHP-ის გამოყენებით

Aspose.PDF Cloud SDK PHP-სთვის ასევე გთავაზობთ შესაძლებლობას, დაამატოთ ხელმოწერის ველები PDF დოკუმენტში. ქვემოთ მოცემული კოდის ფრაგმენტი საშუალებას გაძლევთ დაამატოთ ხელმოწერის ველი 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';

// ატვირთეთ ფაილი ღრუბლოვან საცავში
$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());

დასკვნა

ამ ბლოგში განვიხილეთ ციფრული ხელმოწერებით მუშაობის ცნებები PDF დოკუმენტებში. ჩვენ ვისწავლეთ როგორ მოვიძიოთ ინფორმაცია არსებული ხელმოწერის ველებთან და როგორ დავამატოთ ხელმოწერის ახალი ველები დოკუმენტში. გთხოვთ, გაითვალისწინოთ, რომ Aspose.PDF Cloud SDK PHP-სთვის არის ღია წყარო და სრული კოდის ჩამოტვირთვა შესაძლებელია GitHub საცავიდან.

გთხოვთ, სცადოთ ჩვენი API-ების გამოყენება და თუ რაიმე პრობლემა შეგექმნათ, გთხოვთ, მოგერიდებათ დაუკავშირდეთ უფასო მომხმარებელთა მხარდაჭერის ფორუმებს.