Możesz elektronicznie podpisywać swoje dokumenty za pomocą podpisów cyfrowych programowo w chmurze. Podpisy cyfrowe służą do sprawdzania autentyczności i integralności dokumentów. Umożliwia również dołączenie do dokumentu kodu, który pełni rolę podpisu. Ten artykuł skupi się na tym, jak podpisywać dokumenty podpisami cyfrowymi przy użyciu interfejsu API REST w Node.js.
W tym artykule zostaną omówione następujące tematy:
- Interfejs API REST podpisu dokumentu i zestaw SDK Node.js
- Podpisuj dokumenty Word za pomocą interfejsu API REST w Node.js
- Podpisuj dokumenty PDF za pomocą interfejsu API REST w Node.js
- Weryfikuj podpisy cyfrowe za pomocą interfejsu API REST w Node.js
Interfejs API REST podpisu dokumentu i zestaw SDK Node.js
Do podpisywania plików PDF i DOCX będę używać API Node.js SDK of GroupDocs.Signature Cloud. Umożliwia tworzenie, weryfikowanie i wyszukiwanie różnego rodzaju podpisów, takich jak podpisy graficzne, kody kreskowe, QR-Code, podpisy tekstowe, cyfrowe i pieczątkowe. Podpisy te można łatwo zastosować w przenośnych lub prostych dokumentach, arkuszach kalkulacyjnych, prezentacjach i obrazach w obsługiwanych formatach plików. Interfejs API można zintegrować z istniejącymi aplikacjami Node.js. Udostępnia również zestawy SDK .NET, Java, PHP, Android, Ruby i Python jako członkowie rodziny podpisów dokumentów dla Cloud API.
Możesz zainstalować GroupDocs.Signature Cloud w swoim projekcie Node.js za pomocą następującego polecenia w konsoli:
npm install groupdocs-signature-cloud --save
Przed wykonaniem wspomnianych kroków uzyskaj swój identyfikator klienta i klucz tajny z panelu nawigacyjnego. Po uzyskaniu identyfikatora i tajnego kodu dodaj kod, jak pokazano poniżej:
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";
Podpisuj dokumenty Word za pomocą interfejsu API REST w Node.js
Możesz podpisywać dokumenty programu Word za pomocą podpisów cyfrowych w chmurze, wykonując proste czynności wymienione poniżej:
- Prześlij pliki do chmury
- Podpisuj dokumenty Word za pomocą podpisów cyfrowych za pomocą Node.js
- Pobierz podpisany plik
Prześlij dokument
Najpierw prześlij dokument programu Word do chmury, korzystając z przykładowego kodu podanego poniżej:
var resourcesFolder = 'C:\\Files\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
// skonstruuj FileApi
var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);
// utwórz żądanie przesłania pliku
var request = new groupdocs_signature_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
fileApi.uploadFile(request)
});
W rezultacie przesłany plik Word będzie dostępny w sekcji plików pulpitu nawigacyjnego w chmurze. Użyj powyższego przykładowego kodu, aby przesłać plik obrazu certyfikatu i podpisu do chmury.
Podpisuj dokumenty Word za pomocą podpisów cyfrowych za pomocą Node.js
Możesz programowo podpisywać swoje pliki DOCX podpisami cyfrowymi, wykonując czynności podane poniżej:
- Utwórz wystąpienie SignApi
- Utwórz instancję FileInfo
- Ustaw ścieżkę pliku DOCX
- Utwórz instancję SignDigitalOptions
- Ustaw SignatureType na Digital
- Ustaw ImageFilePath i CertificateFilePath
- Podaj hasło
- Ustaw pozycję podpisu
- Utwórz instancję SignSettings
- Przypisz SignDigitalOptions i SaveOptions do SignSettings
- Utwórz CreateSignaturesRequest
- Uzyskaj wyniki, wywołując metodę SignApi.createSignatures().
Poniższy przykład kodu pokazuje, jak podpisać dokument programu Word za pomocą podpisów cyfrowych przy użyciu interfejsu API REST w Node.js.
// zainicjować api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);
// utwórz informacje o pliku
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.docx";
// zdefiniuj opcje cyfrowe znaku
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";
// ustawić pozycję podpisu na stronie
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";
// ustaw stronę, aby pokazać podpisy
opts.page = 1;
// zdefiniuj ustawienia znaku
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];
// zdefiniuj opcje zapisu
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.docx";
// utwórz prośbę o podpis
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);
console.log("Output file link: " + response.downloadUrl);
Pobierz podpisany plik
Powyższy przykładowy kod zapisze podpisany plik Word w chmurze. Możesz go pobrać, korzystając z przykładowego kodu podanego poniżej:
// skonstruuj FileApi
var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);
// utwórz żądanie pobrania pliku
let request = new groupdocs_signature_cloud.DownloadFileRequest("signedDigital_sample.docx", myStorage);
let response = await fileApi.downloadFile(request);
// zapisz plik w katalogu roboczym
fs.writeFile("C:\\Files\\signedDigital_sample.docx", response, "binary", function (err) { });
Podpisuj dokumenty PDF za pomocą podpisów cyfrowych za pomocą Node.js
Możesz programowo podpisywać dokumenty PDF podpisami cyfrowymi, wykonując poniższe czynności:
- Utwórz wystąpienie SignApi
- Utwórz instancję FileInfo
- Ustaw ścieżkę pliku PDF
- Utwórz instancję SignDigitalOptions
- Ustaw SignatureType na Digital
- Ustaw ImageFilePath i CertificateFilePath
- Podaj hasło
- Utwórz instancję SignSettings
- Przypisz SignDigitalOptions i SaveOptions do SignSettings
- Utwórz CreateSignaturesRequest
- Uzyskaj wyniki, wywołując metodę SignApi.createSignatures().
Poniższy przykład kodu pokazuje, jak podpisać dokument PDF za pomocą podpisów cyfrowych przy użyciu interfejsu API REST w Node.js.
// zainicjować api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);
// utwórz informacje o pliku
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";
// zdefiniuj opcje cyfrowe znaku
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;
// zdefiniuj opcje znaku
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];
// zdefiniuj opcje zapisu
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.pdf";
// utwórz prośbę o podpis
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);
console.log("Output file link: " + response.downloadUrl);
Weryfikuj podpisy cyfrowe za pomocą interfejsu API REST w Node.js
Podpisy cyfrowe można łatwo zweryfikować programowo, wykonując poniższe czynności:
- Utwórz wystąpienie SignApi
- Utwórz instancję FileInfo
- Ustaw ścieżkę pliku DOCX
- Utwórz instancję VerifyDigitalOptions
- Ustaw SignatureType na Digital
- Utwórz instancję VerifySettings
- Przypisz VerifyDigitalOptions i FileInfo do VerifySettings
- Utwórz VerifySignaturesRequest
- Uzyskaj wyniki, wywołując metodę SignApi.verifySignatures().
- Pokaż wyniki
Poniższy przykład kodu pokazuje, jak weryfikować podpisy cyfrowe przy użyciu interfejsu API REST w Node.js.
// zainicjować api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);
// utwórz informacje o pliku
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "signedDigital_sample.docx";
// zdefiniuj opcje weryfikacji
let opts = new groupdocs_signature_cloud.VerifyDigitalOptions();
opts.signatureType = groupdocs_signature_cloud.OptionsBase.SignatureTypeEnum.Digital;
// zdefiniuj ustawienia weryfikacji
let settings = new groupdocs_signature_cloud.VerifySettings();
settings.fileInfo = fileInfo;
settings.options = [opts];
// utwórz prośbę o weryfikację podpisu
let request = new groupdocs_signature_cloud.VerifySignaturesRequest(settings);
let response = await signApi.verifySignatures(request);
// Pokaż wyniki
if (response.isSuccess) {
console.log("Successfully verified!");
}
else{
console.log("Not verified!");
}
Wypróbuj online
Wypróbuj następujące bezpłatne narzędzie do podpisywania dokumentów online, które zostało opracowane przy użyciu powyższego interfejsu API. https://products.groupdocs.app/signature/
Wniosek
W tym artykule nauczyłeś się podpisywać dokumenty programu Word za pomocą podpisów cyfrowych w chmurze. Nauczyłeś się również podpisywać dokumenty PDF podpisami cyfrowymi za pomocą REST API w Node.js. Ponadto nauczyłeś się, jak programowo przesłać plik Word do chmury, a następnie pobrać podpisany plik z chmury. Możesz dowiedzieć się więcej o GroupDocs.Signature Cloud API korzystając z dokumentacji. Udostępniamy również sekcję Informacje o interfejsach API, która umożliwia wizualizację naszych interfejsów API i interakcję z nimi bezpośrednio w przeglądarce. W przypadku jakichkolwiek niejasności prosimy o kontakt na forum.