Node.js'de REST API kullanarak Belgeleri Dijital İmzalarla İmzalayın

Belgelerinizi bulut üzerinde programlı olarak dijital imzalarla elektronik olarak imzalayabilirsiniz. Dijital imzalar, belgelerin gerçekliğini ve bütünlüğünü doğrulamak için kullanılır. Ayrıca belgenize imza işlevi gören bir kod eklemenizi sağlar. Bu makale, Node.js’de bir REST API kullanarak belgelerin dijital imzalarla nasıl imzalanacağına odaklanacaktır.

Bu yazıda aşağıdaki konular ele alınacaktır:

Belge İmzası REST API ve Node.js SDK

PDF ve DOCX dosyalarını imzalamak için GroupDocs.Signature Cloud]3 API’sinin [Node.js SDK’sını] kullanacağım. Görüntü, ‎barkod, QR-Kodu, metin tabanlı, dijital ve damga imzaları gibi çeşitli imza türlerini oluşturmanıza, doğrulamanıza ve aramanıza olanak tanır. Bu imzalar, taşınabilir veya basit belgelere, elektronik tablolara, sunumlara ve desteklenen dosya biçimlerindeki görüntülere kolayca uygulanabilir. API’yi mevcut Node.js uygulamalarınıza entegre edebilirsiniz. Ayrıca Cloud API için belge imza ailesi üyeleri olarak .NET, Java, PHP, Android, Ruby ve Python SDK’ları sağlar.

Konsolda aşağıdaki komutu kullanarak GroupDocs.Signature Cloud’u Node.js projenize yükleyebilirsiniz:

npm install groupdocs-signature-cloud --save

Lütfen belirtilen adımları izlemeden önce Müşteri Kimliğinizi ve Sırrınızı kontrol panelinden alın. Kimliğinizi ve sırrınızı aldıktan sonra, kodu aşağıda gösterildiği gibi ekleyin:

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

Node.js’de REST API kullanarak Word Belgelerini İmzalayın

Aşağıda belirtilen basit adımları izleyerek Word belgelerini Bulut üzerinde dijital imzalarla imzalayabilirsiniz:

Belgeyi Yükle

Öncelikle aşağıda verilen kod örneğini kullanarak Word belgesini Buluta yükleyin:

var resourcesFolder = 'C:\\Files\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
  // FileApi'yi inşa et
  var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);
  // dosya yükleme isteği oluştur
  var request = new groupdocs_signature_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
  fileApi.uploadFile(request)
});

Sonuç olarak, yüklenen Word dosyası, bulut üzerindeki kontrol panelinizin dosyalar bölümünde mevcut olacaktır. Sertifika ve imza görüntü dosyasını Bulut’a yüklemek için lütfen yukarıdaki kod örneğini kullanın.

Node.js kullanarak Word Belgelerini Dijital İmzalarla İmzalayın

DOCX dosyalarınızı aşağıda verilen adımları izleyerek programlı olarak dijital imzalarla imzalayabilirsiniz:

  • SignApi’nin bir örneğini oluşturun
  • FileInfo örneğini oluşturun
  • DOCX dosya yolunu ayarlayın
  • SignDigitalOptions’ın bir örneğini oluşturun
  • SignatureType’ı Dijital olarak ayarlayın
  • ImageFilePath ve CertificateFilePath’i ayarlayın
  • Parolayı sağlayın
  • İmza konumunu ayarla
  • SignSettings’in bir örneğini oluşturun
  • SignDigitalOptions ve SaveOptions’ı SignSettings’e atayın
  • CreateSignaturesRequest’i oluşturun
  • SignApi.createSignatures() yöntemini çağırarak sonuçları alın

Aşağıdaki kod örneği, Node.js’de bir REST API kullanarak bir Word belgesinin dijital imzalarla nasıl imzalanacağını gösterir.

// api'yi başlat
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// dosya bilgisi oluştur
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// işaret dijital seçeneklerini tanımlayın
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";

// bir sayfada imza konumunu ayarlama
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";

// imzaları göstermek için sayfayı ayarla
opts.page = 1;

// işaret ayarlarını tanımla
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// kaydetme seçeneklerini tanımla
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.docx";

// imza isteği oluştur
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);

console.log("Output file link: " + response.downloadUrl);
Node.js kullanarak Word Belgelerini Dijital İmzalarla İmzalayın

Node.js kullanarak Word Belgelerini Dijital İmzalarla İmzalayın

İmzalı Dosyayı İndirin

Yukarıdaki kod örneği, imzalanmış Word dosyasını buluta kaydedecektir. Aşağıda verilen kod örneğini kullanarak indirebilirsiniz:

// FileApi'yi inşa et
var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);

// indirme dosyası isteği oluştur
let request = new groupdocs_signature_cloud.DownloadFileRequest("signedDigital_sample.docx", myStorage);
let response = await fileApi.downloadFile(request);

// dosyayı çalışma dizinine kaydet
fs.writeFile("C:\\Files\\signedDigital_sample.docx", response, "binary", function (err) { });

Node.js kullanarak PDF Belgelerini Dijital İmzalarla İmzalayın

Dijital imzalı PDF belgelerini aşağıdaki adımları izleyerek programlı olarak imzalayabilirsiniz:

  • SignApi’nin bir örneğini oluşturun
  • FileInfo örneğini oluşturun
  • PDF dosya yolunu ayarla
  • SignDigitalOptions’ın bir örneğini oluşturun
  • SignatureType’ı Dijital olarak ayarlayın
  • ImageFilePath ve CertificateFilePath’i ayarlayın
  • Parolayı sağlayın
  • SignSettings’in bir örneğini oluşturun
  • SignDigitalOptions ve SaveOptions’ı SignSettings’e atayın
  • CreateSignaturesRequest’i oluşturun
  • SignApi.createSignatures() yöntemini çağırarak sonuçları alın

Aşağıdaki kod örneği, Node.js’de bir REST API kullanarak dijital imzalarla bir PDF belgesinin nasıl imzalanacağını gösterir.

// api'yi başlat
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// dosya bilgisi oluştur
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";

// işaret dijital seçeneklerini tanımlayın
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;

// işaret seçeneklerini tanımla
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// kaydetme seçeneklerini tanımla
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.pdf";

// imza isteği oluştur
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);

console.log("Output file link: " + response.downloadUrl);
Node.js kullanarak PDF Belgelerini Dijital İmzalarla İmzalayın

Node.js kullanarak PDF Belgelerini Dijital İmzalarla İmzalayın

Node.js’de bir REST API kullanarak Dijital İmzaları Doğrulayın

Aşağıda verilen adımları izleyerek dijital imzaları programlı olarak kolayca doğrulayabilirsiniz:

  • SignApi’nin bir örneğini oluşturun
  • FileInfo örneğini oluşturun
  • DOCX dosya yolunu ayarlayın
  • theVerifyDigitalOptions örneğini oluşturun
  • SignatureType’ı Dijital olarak ayarlayın
  • VerifySettings’in bir örneğini oluşturun
  • VerifyDigitalOptions ve FileInfo’yu VerifySettings’e atayın
  • VerifySignaturesRequest’i oluşturun
  • SignApi.verifySignatures() yöntemini çağırarak sonuçları alın
  • sonuçları göster

Aşağıdaki kod örneği, Node.js’de bir REST API kullanarak dijital imzaların nasıl doğrulanacağını gösterir.

// api'yi başlat
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// dosya bilgisi oluştur
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "signedDigital_sample.docx";

// doğrulama seçeneklerini tanımlayın
let opts = new groupdocs_signature_cloud.VerifyDigitalOptions();
opts.signatureType = groupdocs_signature_cloud.OptionsBase.SignatureTypeEnum.Digital;

// doğrulama ayarlarını tanımla
let settings = new groupdocs_signature_cloud.VerifySettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// imza doğrulama isteği oluştur
let request = new groupdocs_signature_cloud.VerifySignaturesRequest(settings);
let response = await signApi.verifySignatures(request);

// sonuçları göster
if (response.isSuccess) {
  console.log("Successfully verified!");
}
else{
  console.log("Not verified!");
}
Node.js'de bir REST API kullanarak Dijital İmzaları Doğrulayın

Node.js’de bir REST API kullanarak Dijital İmzaları Doğrulayın

Çevrimiçi Deneyin

Lütfen yukarıdaki API kullanılarak geliştirilen aşağıdaki ücretsiz çevrimiçi belge imza aracını deneyin. https://products.groupdocs.app/signature/

Çözüm

Bu yazıda, Word belgelerini bulutta dijital imzalarla nasıl imzalayacağınızı öğrendiniz. Node.js’de bir REST API kullanarak PDF belgelerini dijital imzalarla nasıl imzalayacağınızı da öğrendiniz. Ayrıca, bir Word dosyasını programlı olarak buluta nasıl yükleyeceğinizi ve ardından imzalı dosyayı buluttan nasıl indireceğinizi öğrendiniz. Belgeleri kullanarak GroupDocs.Signature Cloud API hakkında daha fazla bilgi edinebilirsiniz. Ayrıca, API’lerimizi doğrudan tarayıcı aracılığıyla görselleştirmenize ve bunlarla etkileşimde bulunmanıza olanak tanıyan bir API Referansı bölümü de sağlıyoruz. Herhangi bir belirsizlik durumunda, lütfen forumda bizimle iletişime geçmekten çekinmeyin.

Ayrıca bakınız