Вы можете программно подписывать свои документы цифровыми подписями в облаке. Цифровые подписи используются для проверки подлинности и целостности документов. Это также позволяет вам прикрепить код к вашему документу, который действует как подпись. В этой статье основное внимание будет уделено тому, как подписывать документы цифровыми подписями с помощью REST API в Node.js.
В этой статье должны быть раскрыты следующие темы:
- Подпись документа REST API и Node.js SDK
- Подписывайте документы Word с помощью REST API в Node.js
- Подписывайте PDF-документы с помощью REST API в Node.js
- Проверка цифровых подписей с помощью REST API в Node.js
Подпись документа REST API и Node.js SDK
Для подписи файлов 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
- Установите тип подписи на цифровой
- Установите 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
- Установите тип подписи на цифровой
- Установите 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
- Установите тип подписи на цифровой
- Создайте экземпляр 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, который позволяет вам визуализировать наши API и взаимодействовать с ними непосредственно через браузер. В случае возникновения каких-либо неясностей, пожалуйста, свяжитесь с нами на форуме.