A PDF dokumentumok az információmegosztás széles körben használt fájlformátumai közé tartoznak. Általában bizalmas és jogi értékkel bírnak, például szerződés. A fájlok sértetlenségének biztosítása és a hamisítás elkerülése érdekében digitális aláírásokat adunk hozzá. Azt is biztosítja, hogy a dokumentumot a szerzőn kívül más nem módosította, és ellenőrzi, hogy a szerző az, akire számítunk, és nem valaki más.
A PDF-ban lévő digitális aláírás megegyezik a papíralapú dokumentumok tinta-aláírásával, de sokkal biztonságosabb. Ez az információ egy dokumentumba kerül, és a népszerű PDF olvasók ellenőrizhetik, hogy a dokumentumot nem módosította-e ismeretlen személy. Ebben a cikkben a PDF dokumentumok online digitális aláírásának részleteiről fogunk beszélni PHP-ben.
- Az API elérése a cURL paranccsal
- Az API elérése a PHP SDK-n keresztül
- Olvassa el az Aláírás mezőt
- Aláírási mezők hozzáadása PHP segítségével
Az API elérése a cURL paranccsal
API-jaink a REST architektúra alapelvei szerint épülnek fel, így cURL parancsokkal is elérhetők. Felhívjuk figyelmét, hogy API-jainkat csak felhatalmazott személyek érhetik el, ezért az API-khoz való hozzáférés előtt először fel kell keresnie az Aspose.Cloud dashboard oldalt, és ha rendelkezik GitHub- vagy Google-fiókkal, egyszerűen regisztráljon. Ellenkező esetben kattintson az Új fiók létrehozása gombra, és adja meg a szükséges információkat. Most jelentkezzen be az irányítópultra a hitelesítési adatokkal, és bontsa ki az Alkalmazások részt az irányítópulton, és görgessen lefelé az Ügyfél hitelesítő adatai szakasz felé, hogy megtekinthesse az ügyfél-azonosítót és az ügyféltitkot.
Most a következő lépés a JSON Web Token (JWT) létrehozása, hogy az API-k elérhetők legyenek a parancssoron keresztül. Ugyanazt a JWT-jogkivonatot használják az API-k eléréséhez cURL-parancsokon keresztül.
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"
Az API elérése a PHP SDK-n keresztül
Annak érdekében, hogy megkönnyítsük PHP-ügyfeleinknek a PDF-fájlokat programozottan PHP kódon keresztül feldolgozni, kifejlesztettük az Aspose.PDF Cloud SDK-t PHP-hez, amely az Aspose.PDF Cloud API köré épül fel. Ugyanazt az SDK-t használhatjuk a digitális aláírások feldolgozására és a kapcsolódó műveletek végrehajtására. Az SDK letölthető a Composer és a GitHub oldalról.
Most megvitatjuk az Aspose.PDF Cloud SDK for PHP telepítésének lépéseit a zeneszerzőn keresztül. Már tudjuk, hogy a Composer használata ajánlott az SDK-val és a projektfüggőségek kezelésére. Tehát miután konfiguráltuk a zeneszerzőt a rendszeren, próbálja meg a következő paranccsal telepíteni az Aspose.PDF Cloud SDK for PHP-t.
composer require aspose/pdf-sdk-php
Olvassa el az aláírási mezőket
Az API lehetővé teszi a PDF dokumentumokban már elérhető aláírási mezőkhöz társított tulajdonságok olvasását. Az aláírásmező elolvasásához két lehetőség van.
- Olvassa be az aláírási mezőket a dokumentum adott oldaláról a GetPageSignatureFields API segítségével
- Olvassa el a dokumentum aláírási mezőjét név szerint a GetSignatureField API segítségével
Az aláírási mezők beolvasásához a dokumentum adott oldaláról próbálja meg a következő cURL parancsot használni. Kérjük, vegye figyelembe, hogy a következő parancsban a BlankWithSignature.pdf a forrás PDF-fájl:
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>"
Most, hogy az adott Aláírás mezőhöz tartozó tulajdonságokat olvassa el a dokumentumon, próbálja meg a következő parancsot használni, ahol egy adott aláírási mező nevét adjuk meg argumentumként.
curl -X GET "https://api.aspose.cloud/v3.0/pdf/BlankWithSignature.pdf/fields/signature/Signature1" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
Az alábbiakban bemutatott részletek és lépések elmagyarázzák, hogyan kérhetjük le az aláírásmező részleteit a PDF-dokumentumok bizonyos oldalairól PHP-kóddal.
protected $pdfApi;
// Töltse le az alkalmazáskulcsot és az alkalmazás SID-jét a https://dashboard.aspose.cloud/ webhelyről
$appSid = '';
$appKey = '';
$host = 'https://api.aspose.cloud/v3.0';
// konfigurációs objektum
$this->config = new Configuration();
$this->config->setAppKey($appKey);
$this->config->setAppSid($appSid);
$this->config->setHost($host);
// PdfApi példány létrehozása
$this->pdfApi = new PdfApi(null, $this->config);
// a bemeneti PDF dokumentum neve
$name = 'BlankWithSignature.pdf';
// töltse fel a fájlt a felhőtárhelyre
$this->uploadFile($name);
// oldalszám a dokumentumban
$pageNumber = 1;
// hívja meg az API metódust az aláírási mezők lekéréséhez a dokumentumból
$response = $this->pdfApi->getPageSignatureFields($name, $pageNumber, null, $this->tempFolder);
$this->assertEquals(200, $response->getCode());
A megadott kód megmutatja, hogy a PDF fájl egyes aláírási mezőinek információi hogyan kérhetők le.
protected $pdfApi;
// Szerezze be az alkalmazáskulcsot és az alkalmazás SID-jét a https://dashboard.aspose.cloud/ webhelyről
$appSid = '';
$appKey = '';
$host = 'https://api.aspose.cloud/v3.0';
// konfigurációs objektum
$this->config = new Configuration();
$this->config->setAppKey($appKey);
$this->config->setAppSid($appSid);
$this->config->setHost($host);
// PdfApi példány létrehozása
$this->pdfApi = new PdfApi(null, $this->config);
// a bemeneti PDF dokumentum neve
$name = 'BlankWithSignature.pdf';
// PDF feltöltése felhőtárhelyre
$this->uploadFile($name);
// aláírás mező az információk lekéréséhez
$fieldName = 'Signature1';
// hívja meg az API-t az aláírásmező részleteinek lekéréséhez
$response = $this->pdfApi->getSignatureField($name, $fieldName, null, $this->tempFolder);
$this->assertEquals(200, $response->getCode());
Aláírási mezők hozzáadása PHP segítségével
Az Aspose.PDF Cloud SDK for PHP lehetőséget kínál az aláírási mezők PDF-dokumentumhoz való hozzáadására is. Az alábbi kódrészlet lehetővé teszi az aláírási mező hozzáadását a PDF-fájlhoz.
protected $pdfApi;
// Töltse le az alkalmazáskulcsot és az alkalmazás SID-jét a https://dashboard.aspose.cloud/ webhelyről
$appSid = '';
$appKey = '';
$host = 'https://api.aspose.cloud/v3.0';
// konfigurációs objektum
$this->config = new Configuration();
$this->config->setAppKey($appKey);
$this->config->setAppSid($appSid);
$this->config->setHost($host);
// PdfApi példány létrehozása
$this->pdfApi = new PdfApi(null, $this->config);
// a bemeneti PDF dokumentum neve
$name = 'BlankWithSignature.pdf';
// fájl feltöltése felhőtárhelyre
$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');
// oldalindex, ahol az aláírási mezőt hozzá kell adni
$field->setPageIndex(1);
$field->setSignature($signature);
// adja meg a téglalap alakú régiót az Aláírás mezőben
$field->setRect(new Aspose\PDF\Model\Rectangle(['llx' => 100, 'lly' => 100, 'urx' => 160, 'ury' => 140]));
// hívja meg az API-t aláírásmező hozzáadásához
$response = $this->pdfApi->postSignatureField($name, $field, null, $this->tempFolder);
$this->assertEquals(200, $response->getCode());
Következtetés
Ebben a blogban a PDF dokumentumokon belüli digitális aláírások használatának koncepcióit tárgyaltuk. Megtanultuk, hogyan lehet lekérni a meglévő aláírási mezőkkel kapcsolatos információkat, valamint hogyan lehet új aláírási mezőket hozzáadni a dokumentumhoz. Felhívjuk figyelmét, hogy az Aspose.PDF Cloud SDK for PHP nyílt forráskódú, és a teljes forráskód letölthető a GitHub tárhelyről.
Kérjük, próbálja meg API-jainkat használni, és ha bármilyen problémába ütközik, kérjük, vegye fel a kapcsolatot az ingyenes ügyfélszolgálati fórumokon.