C++

Sign Manifest File to Generate a Passbook .pkpass file

See more Digital Signatures Examples

Demonstrates how to create a Passbook .pkpass archive by creating a signature of a manifest file and then zipping to a .pkpass archive.

Note: Chilkat also has the capability to do everything in-memory (no files would be involved). If this is of interest, please send email to support@chilkatsoft.com

C++

#include <CkJsonObject.h>
#include <CkCrypt2.h>
#include <CkZip.h>
#include <CkStringBuilder.h>
#include <CkXmlCertVault.h>
#include <CkCert.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    // ---------------------------------------------------------------------------------------------
    // Note: Chilkat also has the capability to do everything in-memory (no files would be involved).  
    // See this example:  Sign Manifest File to Generate a Passbook .pkpass in Memory
    // ---------------------------------------------------------------------------------------------

    // First create the manifest.json

    CkJsonObject manifest;
    CkCrypt2 crypt;

    CkZip zip;
    zip.NewZip("qa_data/p7s/pass-wallet/example.pkpass");
    // Set the AppendFromDir property to prevent that relative paths from being stored in the .pkpass archive.
    zip.put_AppendFromDir("qa_data/p7s/pass-wallet/");

    crypt.put_HashAlgorithm("sha1");
    // Return hashes as lowercase hex.
    crypt.put_EncodingMode("hexlower");

    const char *fileHash = 0;
    const char *filePath = 0;
    filePath = "qa_data/p7s/pass-wallet/icon.png";
    fileHash = crypt.hashFileENC(filePath);
    zip.AddFile("icon.png",false);
    manifest.UpdateString("\"icon.png\"",fileHash);

    filePath = "qa_data/p7s/pass-wallet/icon@2x.png";
    fileHash = crypt.hashFileENC(filePath);
    zip.AddFile("icon@2x.png",false);
    manifest.UpdateString("\"icon@2x.png\"",fileHash);

    filePath = "qa_data/p7s/pass-wallet/logo.png";
    fileHash = crypt.hashFileENC(filePath);
    zip.AddFile("logo.png",false);
    manifest.UpdateString("\"logo.png\"",fileHash);

    filePath = "qa_data/p7s/pass-wallet/logo@2x.png";
    fileHash = crypt.hashFileENC(filePath);
    zip.AddFile("logo@2x.png",false);
    manifest.UpdateString("\"logo@2x.png\"",fileHash);

    filePath = "qa_data/p7s/pass-wallet/pass.json";
    fileHash = crypt.hashFileENC(filePath);
    zip.AddFile("pass.json",false);
    manifest.UpdateString("\"pass.json\"",fileHash);

    CkStringBuilder sbJson;
    manifest.EmitSb(sbJson);
    const char *manifestPath = "qa_data/p7s/pass-wallet/manifest.json";
    sbJson.WriteFile(manifestPath,"utf-8",false);
    zip.AddFile("manifest.json",false);

    // Make sure we have the Apple WWDR intermediate certificate available for 
    // the cert chain in the signature.
    CkXmlCertVault certVault;
    CkCert appleWwdrCert;
    success = appleWwdrCert.LoadByCommonName("Apple Worldwide Developer Relations Certification Authority");
    if (success != true) {
        std::cout << "The Apple WWDR intermediate certificate is not installed." << "\r\n";
        std::cout << "It is available at https://developer.apple.com/certificationauthority/AppleWWDRCA.cer" << "\r\n";
        std::cout << "You may alternatively load the .cer like this..." << "\r\n";
        success = appleWwdrCert.LoadFromFile("qa_data/certs/AppleWWDRCA.cer");
        if (success == false) {
            std::cout << appleWwdrCert.lastErrorText() << "\r\n";
            return;
        }

    }

    certVault.AddCert(appleWwdrCert);
    crypt.UseCertVault(certVault);

    // Use a digital certificate and private key from a PFX file (.pfx or .p12).
    const char *pfxPath = "qa_data/pfx/cert_test123.pfx";
    const char *pfxPassword = "test123";

    CkCert cert;
    success = cert.LoadPfxFile(pfxPath,pfxPassword);
    if (success == false) {
        std::cout << cert.lastErrorText() << "\r\n";
        return;
    }

    // Provide the signing cert (with associated private key).
    success = crypt.SetSigningCert(cert);
    if (success == false) {
        std::cout << crypt.lastErrorText() << "\r\n";
        return;
    }

    // Specify the signed attributes to be included.
    // (These attributes appear to not be necessary, but we're including
    // them just in case they become necessary in the future.)
    CkJsonObject jsonSignedAttrs;
    jsonSignedAttrs.UpdateInt("contentType",1);
    jsonSignedAttrs.UpdateInt("signingTime",1);
    crypt.put_SigningAttributes(jsonSignedAttrs.emit());

    // Sign the manifest JSON file to produce a file named "signature".
    const char *sigPath = "qa_data/p7s/pass-wallet/signature";

    // Create the "signature" file.
    success = crypt.CreateP7S(manifestPath,sigPath);
    if (success == false) {
        std::cout << crypt.lastErrorText() << "\r\n";
        return;
    }

    zip.AddFile("signature",false);

    // ---------------------------------------------------------------------------------------------
    // Note: Chilkat also has the capability to do everything in-memory (no files would be involved).  
    // If this is of interest, please send email to support@chilkatsoft.com
    // ---------------------------------------------------------------------------------------------

    // Create the .pkipass archive (which is a .zip archive containing the required files).
    success = zip.WriteZipAndClose();
    if (success == false) {
        std::cout << zip.lastErrorText() << "\r\n";
        return;
    }

    std::cout << "Success." << "\r\n";
    }