Chilkat Examples

ChilkatHOME.NET Core C#Android™AutoItCC#C++Chilkat2-PythonCkPythonClassic ASPDataFlexDelphi ActiveXDelphi DLLGoJavaLianjaMono C#Node.jsObjective-CPHP ActiveXPHP ExtensionPerlPowerBuilderPowerShellPureBasicRubySQL ServerSwift 2Swift 3,4,5...TclUnicode CUnicode C++VB.NETVBScriptVisual Basic 6.0Visual FoxProXojo Plugin

Unicode C Examples

Web API Categories

ASN.1
AWS KMS
AWS Misc
Amazon EC2
Amazon Glacier
Amazon S3
Amazon S3 (new)
Amazon SES
Amazon SNS
Amazon SQS
Async
Azure Cloud Storage
Azure Key Vault
Azure Service Bus
Azure Table Service
Base64
Bounced Email
Box
CAdES
CSR
CSV
Certificates
Cloud Signature CSC
Code Signing
Compression
DKIM / DomainKey
DNS
DSA
Diffie-Hellman
Digital Signatures
Dropbox
Dynamics CRM
EBICS
ECC
Ed25519
Email Object
Encryption
FTP
FileAccess
Firebase
GMail REST API
GMail SMTP/IMAP/POP
Geolocation
Google APIs
Google Calendar
Google Cloud SQL
Google Cloud Storage
Google Drive
Google Photos
Google Sheets
Google Tasks
Gzip
HTML-to-XML/Text
HTTP

HTTP Misc
IMAP
JSON
JSON Web Encryption (JWE)
JSON Web Signatures (JWS)
JSON Web Token (JWT)
Java KeyStore (JKS)
MHT / HTML Email
MIME
MS Storage Providers
Microsoft Graph
Misc
NTLM
OAuth1
OAuth2
OIDC
Office365
OneDrive
OpenSSL
Outlook
Outlook Calendar
Outlook Contact
PDF Signatures
PEM
PFX/P12
PKCS11
POP3
PRNG
REST
REST Misc
RSA
SCP
SCard
SFTP
SMTP
SSH
SSH Key
SSH Tunnel
ScMinidriver
SharePoint
SharePoint Online
Signing in the Cloud
Socket/SSL/TLS
Spider
Stream
Tar Archive
ULID/UUID
Upload
WebSocket
XAdES
XML
XML Digital Signatures
XMP
Zip
curl
uncategorized

 

 

 

(Unicode C) Sign PDF using Cloud Signature Consortium API

See more Signing in the Cloud Examples

Demonstrates how to sign a PDF using a CSC provider. (CSC is the acronym for Cloud Signature Consortium.) This example shows the how to sign a PDF using a particular instance of a CSC service providee JCC Payment Systems Ltd, a company based in Cyprus that provides payment processing services. To use a different CSC provider would only require the values of the JSON parameters, such as base URL, client ID, client secret, etc. to be modified.

The Cloud Signature Consortium (CSC) is an international group of organizations and technology providers dedicated to creating and promoting a standardized open API for cloud-based digital signatures. The goal of the consortium is to make remote, legally-binding digital signatures accessible through cloud-based services, ensuring compatibility and interoperability across different platforms, devices, and services.

The CSC develops and maintains an open standard for APIs that allow cloud-based digital signature solutions to be easily integrated into applications and platforms.

These APIs enable users to sign documents using cloud-based certificate authorities (CAs) and trust service providers (TSPs), ensuring legal compliance with digital signature regulations (such as eIDAS in the EU).

Note: This example requires Chilkat v10.0.0 or greater.

Chilkat C/C++ Library Downloads

MS Visual C/C++

Linux/CentOS C/C++

Alpine Linux C/C++

MAC OS X C/C++

armhf/aarch64 C/C++

C++ Builder

iOS C/C++

Android C/C++

Solaris C/C++

MinGW C/C++

#include <C_CkPdfW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkCertW.h>

void ChilkatSample(void)
    {
    HCkPdfW pdf;
    BOOL success;
    HCkJsonObjectW json;
    HCkJsonObjectW jsonCsc;
    HCkCertW cert;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    pdf = CkPdfW_Create();

    // Load a PDF to be signed.
    success = CkPdfW_LoadFile(pdf,L"qa_data/pdf/hello.pdf");
    if (success == FALSE) {
        wprintf(L"%s\n",CkPdfW_lastErrorText(pdf));
        CkPdfW_Dispose(pdf);
        return;
    }

    // Options for signing are specified in JSON.
    json = CkJsonObjectW_Create();

    // Indicate that we want an LTV-enabled signature
    CkJsonObjectW_UpdateBool(json,L"ltvOcsp",TRUE);

    // Define the appearance of the signature.
    CkJsonObjectW_UpdateInt(json,L"page",1);
    CkJsonObjectW_UpdateString(json,L"appearance.y",L"top");
    CkJsonObjectW_UpdateString(json,L"appearance.x",L"left");
    CkJsonObjectW_UpdateString(json,L"appearance.fontScale",L"10.0");
    CkJsonObjectW_UpdateString(json,L"appearance.text[0]",L"Digitally signed by: cert_cn");
    CkJsonObjectW_UpdateString(json,L"appearance.text[1]",L"current_dt");
    CkJsonObjectW_UpdateString(json,L"appearance.text[2]",L"This is an LTV-enabled signature.");

    // --------------------------------------------------------------------
    // Provide the information about the CSC service to be used for signing.
    jsonCsc = CkJsonObjectW_Create();

    // Set the "service" equal to "CSC" to tell Chilkat to use the Cloud Signature Consortium API standard for signing.
    CkJsonObjectW_UpdateString(jsonCsc,L"service",L"CSC");

    // Provide the service's base URL, the user ID, client ID, and client secret.
    // Note: This example requires the CSC service to support the 
    // OAuth2 client credentials (oauth2code authType) method of authentication.

    // This is the base URL for the JCC CSC service.  It should be changed to your CSC provider's base URL.
    CkJsonObjectW_UpdateString(jsonCsc,L"baseUrl",L"https://ras-test.jcc.com.cy/adss/service/ras/csc/v1/");

    CkJsonObjectW_UpdateString(jsonCsc,L"userId",L"YOUR_USER_ID");
    CkJsonObjectW_UpdateString(jsonCsc,L"clientId",L"YOUR_CLIENT_ID");
    CkJsonObjectW_UpdateString(jsonCsc,L"clientSecret",L"YOUR_CLIENT_SECRET");

    // If your user ID has multiple possible credential IDs, you can select one by 
    // specifying the ID or a substring that must be contained within the ID.
    // Otherwise, Chilkat will use the 1st credential ID returned via the "credentials/list" endpoint.
    // ------------------------------------------------------------------------------------------------------------
    // IMPORTANT: Remove this line if you don't have multiple credential IDs, or if you wish to simply use the 1st.
    // ------------------------------------------------------------------------------------------------------------
    CkJsonObjectW_UpdateString(jsonCsc,L"useCredential",L"MY_CREDENTIAL_ID");

    // The SetCloudSigner method will send HTTPS REST requests to the base URL
    // to get information about the CSC service.
    // Specifically, it will do the following internally:
    // 1) Calls the "info" endpoint to get information about the remote service and the list of the API methods it supports.
    // 2) Calls the "oauth2/token" endpoint to get the OAuth2 authorization token via client credentials (using the clientId and clientSecret).
    // 3) Calls the "credentials/list" endpoint to get the list of credentials associated with the userId.
    // 4) Calls the "credentials/info" endpoint to retrieve the credential and return the main identity information 
    //    and the public key certificate or the certificate chain associated to it.
    //    The Chilkat certificate object is loaded with the retrieved certificate.
    cert = CkCertW_Create();
    success = CkCertW_SetCloudSigner(cert,jsonCsc);

    // Tell the pdf object to use the certificate for signing.
    success = CkPdfW_SetSigningCert(pdf,cert);
    if (success == FALSE) {
        wprintf(L"%s\n",CkPdfW_lastErrorText(pdf));
        CkPdfW_Dispose(pdf);
        CkJsonObjectW_Dispose(json);
        CkJsonObjectW_Dispose(jsonCsc);
        CkCertW_Dispose(cert);
        return;
    }

    // This is where a 2FA means of authentication might occur, depending on the CSC provider.
    // For example, in the case of JCC Payment Systems, an authorization request is sent to 
    // the Ascertia GoSign app on your mobile device where you must authorize the request to sign.
    success = CkPdfW_SignPdf(pdf,json,L"qa_output/hello_signed.pdf");
    if (success == FALSE) {
        wprintf(L"%s\n",CkPdfW_lastErrorText(pdf));
        CkPdfW_Dispose(pdf);
        CkJsonObjectW_Dispose(json);
        CkJsonObjectW_Dispose(jsonCsc);
        CkCertW_Dispose(cert);
        return;
    }

    wprintf(L"The PDF has been successfully signed using a CSC cloud signing service.\n");


    CkPdfW_Dispose(pdf);
    CkJsonObjectW_Dispose(json);
    CkJsonObjectW_Dispose(jsonCsc);
    CkCertW_Dispose(cert);

    }

 

© 2000-2024 Chilkat Software, Inc. All Rights Reserved.