Ви можете програмно підписати свої документи цифровими підписами в хмарі. Цифрові підписи використовуються для підтвердження автентичності та цілісності документів. Це також дає змогу приєднати до документа код, який діє як підпис. У цій статті мова піде про те, як підписувати документи цифровими підписами за допомогою REST API у Node.js.
У цій статті будуть розглянуті такі теми:
- API REST підпису документа та SDK Node.js
- Підписуйте документи Word за допомогою REST API у Node.js
- Підписуйте PDF-документи за допомогою REST API у Node.js
- Перевірте цифрові підписи за допомогою REST API у Node.js
API REST підпису документа та SDK Node.js
Для підписання файлів PDF і DOCX я буду використовувати API Node.js SDK GroupDocs.Signature Cloud. Він дає змогу створювати, перевіряти та шукати різні типи підписів, як-от зображення, штрих-код, QR-код, текстові підписи, цифрові підписи та підписи на штампі. Ці підписи можна легко застосувати до портативних або простих документів, електронних таблиць, презентацій і зображень підтримуваних форматів файлів. Ви можете інтегрувати API у свої існуючі програми Node.js. Він також надає пакети SDK .NET, Java, PHP, Android, Ruby та Python як члени сімейства підписів документів для Cloud API.
Ви можете встановити GroupDocs.Signature Cloud у свій проект Node.js за допомогою такої команди в консолі:
npm install groupdocs-signature-cloud --save
Будь ласка, отримайте свій ідентифікатор клієнта та секрет із інформаційної панелі, перш ніж виконувати вказані дії. Отримавши ідентифікатор і секрет, додайте код, як показано нижче:
global.clientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
global.clientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
global.myStorage = "";
const config = new groupdocs_signature_cloud.Configuration(clientId, clientSecret);
config.apiBaseUrl = "https://api.groupdocs.cloud";
Підписуйте документи Word за допомогою REST API у Node.js
Ви можете підписувати документи Word за допомогою цифрових підписів у хмарі, виконавши прості дії, наведені нижче:
- Завантажте файли в хмару
- Підписуйте документи Word цифровими підписами за допомогою Node.js
- Завантажити підписаний файл
Завантажте документ
По-перше, завантажте документ Word у хмару, використовуючи наведений нижче приклад коду:
var resourcesFolder = 'C:\\Files\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
// побудувати FileApi
var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);
// створити запит на завантаження файлу
var request = new groupdocs_signature_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
fileApi.uploadFile(request)
});
У результаті завантажений файл Word буде доступний у розділі файлів вашої інформаційної панелі в хмарі. Скористайтеся наведеним вище зразком коду, щоб завантажити файл із зображенням сертифіката та підпису в хмару.
Підписуйте документи Word цифровими підписами за допомогою Node.js
Ви можете програмно підписувати свої файли DOCX цифровими підписами, виконавши наведені нижче дії.
- Створіть екземпляр SignApi
- Створіть екземпляр FileInfo
- Встановіть шлях до файлу DOCX
- Створіть екземпляр SignDigitalOptions
- Встановіть для SignatureType значення Digital
- Установіть ImageFilePath і CertificateFilePath
- Введіть пароль
- Встановіть позицію підпису
- Створіть екземпляр SignSettings
- Призначте SignDigitalOptions і SaveOptions до SignSettings
- Створіть CreateSignaturesRequest
- Отримайте результати, викликавши метод SignApi.createSignatures().
У наведеному нижче прикладі коду показано, як підписати документ Word цифровими підписами за допомогою REST API у Node.js.
// ініціалізувати api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);
// створити інформацію про файл
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.docx";
// визначте параметри цифрового знака
let opts = new groupdocs_signature_cloud.SignDigitalOptions();
opts.signatureType = groupdocs_signature_cloud.OptionsBase.SignatureTypeEnum.Digital;
opts.imageFilePath = "signature.jpg";
opts.certificateFilePath = "certificate.pfx";
opts.password = "1234567890";
// встановити позицію підпису на сторінці
opts.left = 350;
opts.top = 450;
opts.width = 200;
opts.height = 100;
opts.location_measure_type = "Pixels";
opts.size_measure_type = "Pixels";
opts.rotation_angle = 0;
opts.horizontal_alignment = "None";
opts.vertical_alignment = "None";
opts.margin = new groupdocs_signature_cloud.Padding();
opts.margin.all = 5;
opts.margin_measure_type = "Pixels";
// налаштувати сторінку для показу підписів
opts.page = 1;
// визначити параметри знака
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];
// визначити параметри збереження
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.docx";
// створити запит на підпис
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);
console.log("Output file link: " + response.downloadUrl);
Підписуйте документи Word цифровими підписами за допомогою Node.js
Завантажте підписаний файл
Наведений вище приклад коду збереже підписаний файл Word у хмарі. Ви можете завантажити його за допомогою зразка коду, наведеного нижче:
// побудувати FileApi
var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);
// створити запит на завантаження файлу
let request = new groupdocs_signature_cloud.DownloadFileRequest("signedDigital_sample.docx", myStorage);
let response = await fileApi.downloadFile(request);
// зберегти файл у робочу директорію
fs.writeFile("C:\\Files\\signedDigital_sample.docx", response, "binary", function (err) { });
Підписуйте PDF-документи цифровими підписами за допомогою Node.js
Ви можете програмно підписати PDF-документи цифровими підписами, виконавши наведені нижче дії.
- Створіть екземпляр SignApi
- Створіть екземпляр FileInfo
- Встановіть шлях до файлу PDF
- Створіть екземпляр SignDigitalOptions
- Встановіть для SignatureType значення Digital
- Установіть ImageFilePath і CertificateFilePath
- Введіть пароль
- Створіть екземпляр SignSettings
- Призначте SignDigitalOptions і SaveOptions до SignSettings
- Створіть CreateSignaturesRequest
- Отримайте результати, викликавши метод SignApi.createSignatures().
У наведеному нижче прикладі коду показано, як підписати PDF-документ цифровими підписами за допомогою REST API у Node.js.
// ініціалізувати api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);
// створити інформацію про файл
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";
// визначте параметри цифрового знака
let opts = new groupdocs_signature_cloud.SignDigitalOptions();
opts.signatureType = groupdocs_signature_cloud.OptionsBase.SignatureTypeEnum.Digital;
opts.imageFilePath = "signature.jpg";
opts.certificateFilePath = "certificate.pfx";
opts.password = "1234567890";
opts.allPage = true;
// визначити параметри знака
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];
// визначити параметри збереження
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.pdf";
// створити запит на підпис
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);
console.log("Output file link: " + response.downloadUrl);
Підписуйте PDF-документи цифровими підписами за допомогою Node.js
Перевірте цифрові підписи за допомогою REST API у Node.js
Ви можете легко перевірити цифрові підписи програмним шляхом, виконавши наведені нижче дії.
- Створіть екземпляр SignApi
- Створіть екземпляр FileInfo
- Встановіть шлях до файлу DOCX
- Створіть екземпляр VerifyDigitalOptions
- Встановіть для SignatureType значення Digital
- Створіть екземпляр VerifySettings
- Призначте параметри VerifyDigitalOptions і FileInfo параметрам VerifySettings
- Створіть VerifySignaturesRequest
- Отримайте результати, викликавши метод SignApi.verifySignatures().
- Покажіть результати
У наведеному нижче прикладі коду показано, як перевірити цифрові підписи за допомогою REST API у Node.js.
// ініціалізувати api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);
// створити інформацію про файл
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "signedDigital_sample.docx";
// визначити параметри перевірки
let opts = new groupdocs_signature_cloud.VerifyDigitalOptions();
opts.signatureType = groupdocs_signature_cloud.OptionsBase.SignatureTypeEnum.Digital;
// визначити параметри перевірки
let settings = new groupdocs_signature_cloud.VerifySettings();
settings.fileInfo = fileInfo;
settings.options = [opts];
// створити запит на перевірку підпису
let request = new groupdocs_signature_cloud.VerifySignaturesRequest(settings);
let response = await signApi.verifySignatures(request);
// показати результати
if (response.isSuccess) {
console.log("Successfully verified!");
}
else{
console.log("Not verified!");
}
Перевірте цифрові підписи за допомогою REST API у Node.js
Спробуйте онлайн
Будь ласка, спробуйте наведений нижче безкоштовний онлайн-інструмент для підписання документів, розроблений за допомогою вищезазначеного API. https://products.groupdocs.app/signature/
Висновок
У цій статті ви дізналися, як підписувати документи Word за допомогою цифрових підписів у хмарі. Ви також дізналися, як підписувати PDF-документи цифровими підписами за допомогою REST API у Node.js. Крім того, ви навчилися програмним шляхом завантажити файл Word у хмару, а потім завантажити підписаний файл із хмари. Ви можете дізнатися більше про GroupDocs.Signature Cloud API, використовуючи документацію. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. У разі будь-яких неясностей зв’яжіться з нами на форумі.