Ký tài liệu bằng chữ ký số bằng API REST trong Node.js

Bạn có thể ký điện tử tài liệu của mình bằng chữ ký điện tử được lập trình trên đám mây. Chữ ký điện tử được sử dụng để xác nhận tính xác thực và tính toàn vẹn của tài liệu. Nó cũng cho phép bạn đính kèm một mã với tài liệu của bạn để đóng vai trò là chữ ký. Bài viết này sẽ tập trung vào cách ký tài liệu bằng chữ ký số bằng API REST trong Node.js.

Các chủ đề sau đây sẽ được đề cập trong bài viết này:

Chữ ký tài liệu API REST và SDK Node.js

Để ký các tệp PDF và DOCX, tôi sẽ sử dụng API Node.js SDK của GroupDocs.Signature Cloud. Nó cho phép bạn tạo, xác minh và tìm kiếm nhiều loại chữ ký khác nhau như hình ảnh, ‎mã vạch, Mã QR, chữ ký dựa trên văn bản, kỹ thuật số và tem. Những chữ ký này có thể dễ dàng được áp dụng trong các tài liệu di động hoặc đơn giản, bảng tính, bản trình bày và hình ảnh của các định dạng tệp được hỗ trợ. Bạn có thể tích hợp API vào các ứng dụng Node.js hiện có của mình. Nó cũng cung cấp SDK .NET, Java, PHP, Android, Ruby và Python dưới dạng các thành viên họ chữ ký tài liệu cho Cloud API.

Bạn có thể cài đặt GroupDocs.Signature Cloud cho dự án Node.js của mình bằng lệnh sau trong bảng điều khiển:

npm install groupdocs-signature-cloud --save

Vui lòng lấy Mã khách hàng và Bí mật của bạn từ bảng điều khiển trước khi làm theo các bước được đề cập. Khi bạn có ID và bí mật của mình, hãy thêm mã như hình bên dưới:

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

Ký tài liệu Word bằng API REST trong Node.js

Bạn có thể ký các tài liệu Word bằng chữ ký điện tử trên Đám mây bằng cách thực hiện theo các bước đơn giản được đề cập bên dưới:

Tải lên tài liệu

Đầu tiên, tải tài liệu Word lên Đám mây bằng ví dụ mã được cung cấp bên dưới:

var resourcesFolder = 'C:\\Files\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
  // xây dựng FileApi
  var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);
  // tạo yêu cầu tệp tải lên
  var request = new groupdocs_signature_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
  fileApi.uploadFile(request)
});

Do đó, tệp Word đã tải lên sẽ có sẵn trong phần tệp của trang tổng quan của bạn trên đám mây. Vui lòng sử dụng mẫu mã ở trên để tải tệp hình ảnh chứng chỉ và chữ ký lên Đám mây.

Ký tài liệu Word bằng chữ ký số bằng Node.js

Bạn có thể ký các tệp DOCX của mình bằng chữ ký điện tử theo chương trình bằng cách thực hiện theo các bước dưới đây:

  • Tạo một phiên bản của SignApi
  • Tạo một phiên bản của FileInfo
  • Đặt đường dẫn tệp DOCX
  • Tạo một phiên bản của SignDigitalOptions
  • Đặt SignatureType thành Digital
  • Đặt ImageFilePath và CertificateFilePath
  • cung cấp mật khẩu
  • Đặt vị trí chữ ký
  • Tạo một phiên bản của SignSettings
  • Gán SignDigitalOptions và SaveOptions cho SignSettings
  • Tạo CreateSignaturesRequest
  • Nhận kết quả bằng cách gọi phương thức SignApi.createSignatures()

Ví dụ mã sau đây cho biết cách ký tài liệu Word bằng chữ ký điện tử bằng cách sử dụng API REST trong Node.js.

// khởi tạo api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// tạo thông tin tập tin
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// xác định tùy chọn kỹ thuật số dấu hiệu
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";

// đặt vị trí chữ ký trên một trang
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";

// đặt trang để hiển thị chữ ký
opts.page = 1;

// xác định cài đặt dấu hiệu
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// xác định tùy chọn lưu
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.docx";

// tạo yêu cầu chữ ký
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);

console.log("Output file link: " + response.downloadUrl);
Ký tài liệu Word bằng chữ ký số bằng Node.js

Ký tài liệu Word bằng chữ ký số bằng Node.js

Tải xuống tệp đã ký

Mẫu mã trên sẽ lưu tệp Word đã ký trên đám mây. Bạn có thể tải xuống bằng cách sử dụng mẫu mã được cung cấp bên dưới:

// xây dựng FileApi
var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);

// tạo yêu cầu tệp tải xuống
let request = new groupdocs_signature_cloud.DownloadFileRequest("signedDigital_sample.docx", myStorage);
let response = await fileApi.downloadFile(request);

// lưu tệp vào thư mục làm việc
fs.writeFile("C:\\Files\\signedDigital_sample.docx", response, "binary", function (err) { });

Ký tài liệu PDF bằng chữ ký số bằng Node.js

Bạn có thể ký các tài liệu PDF bằng chữ ký điện tử theo chương trình bằng cách thực hiện theo các bước dưới đây:

  • Tạo một phiên bản của SignApi
  • Tạo một phiên bản của FileInfo
  • Đặt đường dẫn tệp PDF
  • Tạo một phiên bản của SignDigitalOptions
  • Đặt SignatureType thành Digital
  • Đặt ImageFilePath và CertificateFilePath
  • cung cấp mật khẩu
  • Tạo một phiên bản của SignSettings
  • Gán SignDigitalOptions và SaveOptions cho SignSettings
  • Tạo CreateSignaturesRequest
  • Nhận kết quả bằng cách gọi phương thức SignApi.createSignatures()

Ví dụ mã sau đây cho biết cách ký tài liệu PDF bằng chữ ký điện tử bằng cách sử dụng API REST trong Node.js.

// khởi tạo api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// tạo thông tin tập tin
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";

// xác định tùy chọn kỹ thuật số dấu hiệu
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;

// xác định tùy chọn dấu hiệu
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// xác định tùy chọn lưu
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.pdf";

// tạo yêu cầu chữ ký
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);

console.log("Output file link: " + response.downloadUrl);
Ký tài liệu PDF bằng chữ ký số bằng Node.js

Ký tài liệu PDF bằng chữ ký số bằng Node.js

Xác minh Chữ ký số bằng API REST trong Node.js

Bạn có thể dễ dàng xác minh chữ ký điện tử theo chương trình bằng cách thực hiện theo các bước dưới đây:

  • Tạo một phiên bản của SignApi
  • Tạo một phiên bản của FileInfo
  • Đặt đường dẫn tệp DOCX
  • Tạo một phiên bản củaVerifyDigitalOptions
  • Đặt SignatureType thành Digital
  • Tạo một phiên bản của VerifySettings
  • Chỉ định VerifyDigitalOptions và FileInfo cho VerifySettings
  • Tạo VerifySignaturesRequest
  • Nhận kết quả bằng cách gọi phương thức SignApi.verifySignatures()
  • Hiển thị kết quả

Ví dụ mã sau đây cho biết cách xác minh chữ ký số bằng API REST trong Node.js.

// khởi tạo api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// tạo thông tin tập tin
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "signedDigital_sample.docx";

// xác định tùy chọn xác minh
let opts = new groupdocs_signature_cloud.VerifyDigitalOptions();
opts.signatureType = groupdocs_signature_cloud.OptionsBase.SignatureTypeEnum.Digital;

// xác định cài đặt xác minh
let settings = new groupdocs_signature_cloud.VerifySettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// tạo yêu cầu xác minh chữ ký
let request = new groupdocs_signature_cloud.VerifySignaturesRequest(settings);
let response = await signApi.verifySignatures(request);

// hiển thị kết quả
if (response.isSuccess) {
  console.log("Successfully verified!");
}
else{
  console.log("Not verified!");
}
Xác minh Chữ ký số bằng API REST trong Node.js

Xác minh Chữ ký số bằng API REST trong Node.js

Thử trực tuyến

Vui lòng thử công cụ chữ ký tài liệu trực tuyến miễn phí sau đây, được phát triển bằng cách sử dụng API ở trên. https://products.groupdocs.app/signature/

Phần kết luận

Trong bài viết này, bạn đã học cách ký tài liệu Word bằng chữ ký điện tử trên đám mây. Bạn cũng đã học cách ký tài liệu PDF bằng chữ ký điện tử bằng cách sử dụng API REST trong Node.js. Ngoài ra, bạn đã học cách lập trình tải lên tệp Word trên đám mây và sau đó tải xuống tệp đã ký từ đám mây. Bạn có thể tìm hiểu thêm về GroupDocs.Signature Cloud API bằng cách sử dụng tài liệu. Chúng tôi cũng cung cấp phần Tham khảo API cho phép bạn hình dung và tương tác trực tiếp với các API của chúng tôi thông qua trình duyệt. Trong trường hợp có bất kỳ sự mơ hồ nào, vui lòng liên hệ với chúng tôi trên diễn đàn.

Xem thêm