Objective-C

XAdES XML Signature using ARSS (Aruba Remote Signing Service)

See more Signing in the Cloud Examples

Demonstrates how to sign XML using ARSS (Aruba Remote Signing Service). Objective-C

#import <CkoStringBuilder.h>
#import <CkoCert.h>
#import <CkoJsonObject.h>
#import <CkoXmlDSigGen.h>

BOOL success = NO;

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

// --------------------------------------------------------------------------------
// Also see Chilkat's Online WSDL Code Generator
// to generate code and SOAP Request and Response XML for each operation in a WSDL.
// --------------------------------------------------------------------------------

// Create the XML to be signed.
CkoStringBuilder *sbXml = [[CkoStringBuilder alloc] init];

BOOL bCrlf = YES;
[sbXml AppendLine: @"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\" ?>" crlf: bCrlf];
[sbXml AppendLine: @"<SOAP-ENV:Envelope xmlns:SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\">" crlf: bCrlf];
[sbXml AppendLine: @"    <SOAP-ENV:Header>" crlf: bCrlf];
[sbXml AppendLine: @"        <wsse:Security xmlns:wsse=\"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd\" SOAP-ENV:mustUnderstand=\"1\"></wsse:Security>" crlf: bCrlf];
[sbXml AppendLine: @"    </SOAP-ENV:Header>" crlf: bCrlf];
[sbXml AppendLine: @"    <SOAP-ENV:Body xmlns:SOAP-SEC=\"http://schemas.xmlsoap.org/soap/security/2000-12\" SOAP-SEC:id=\"Body\">" crlf: bCrlf];
[sbXml AppendLine: @"        <z:FooBar xmlns:z=\"http://example.com\" />" crlf: bCrlf];
[sbXml AppendLine: @"    </SOAP-ENV:Body>" crlf: bCrlf];
[sbXml AppendLine: @"</SOAP-ENV:Envelope>" crlf: bCrlf];

// Specify the signing certificate and the ARSS credentials

// Load the certificate used for signing.  The certificate's private key is stored on 
// the Aruba.it server and the signing will happen remotely using the
// ARSS (Aruba Remote Signing Service).
// However, we still need the certificate locally (without private key).
CkoCert *cert = [[CkoCert alloc] init];
success = [cert LoadFromFile: @"qa_data/certs/myCert.cer"];
if (success == NO) {
    NSLog(@"%@",cert.LastErrorText);
    return;
}

// To sign using the Aruba Remote Signing Service, 
// add the following lines of code to specify your authentication credentials,
// and the ID of the certificate w/ private key on the server to be used.
CkoJsonObject *jsonArss = [[CkoJsonObject alloc] init];

// Set the "service" equal to "ARSS" to tell Chilkat to use ARSS for signing.
[jsonArss UpdateString: @"service" value: @"ARSS"];
// Specify the certificate ID, such as "AS0"
// This certificate should match the certificate loaded in the above code.
[jsonArss UpdateString: @"certID" value: @"YOUR_ARSS_CERT_ID"];
[jsonArss UpdateString: @"otpPwd" value: @"YOUR_OTP_PWD"];

// Specifies the OTP authentication environment.
// 
// Common values are:
//   "demoprod" - Demo/Test environment
//   "prod"     - Production environment
// 
// This value is sent to the ARSS service and determines how the OTP
// authentication is validated.  The correct value depends on the type
// of Aruba account and environment that has been provisioned.
// 
// If signing fails with an authentication-related error, verify that
// the typeOtpAuth value matches the environment associated with the
// ARSS account credentials being used.
[jsonArss UpdateString: @"typeOtpAuth" value: @"demoprod"];

[jsonArss UpdateString: @"user" value: @"YOUR_ARSS_USERNAME"];
[jsonArss UpdateString: @"userPWD" value: @"YOUR_ARSS_PASSWORD"];

// The "endpoint" can be specified starting in Chilkat v11.5.0
[jsonArss UpdateString: @"endpoint" value: @"https://app1.firma-remota.it/ArubaSignerService/webresources/signerservice"];

success = [cert SetCloudSigner: jsonArss];

// Prepare for signing...
CkoXmlDSigGen *gen = [[CkoXmlDSigGen alloc] init];

// Indicate where the Signature will be inserted.
gen.SigLocation = @"SOAP-ENV:Envelope|SOAP-ENV:Header|wsse:Security";

// Add a reference to the fragment of the XML to be signed.

// Note: "Body" refers to the XML element having an "id" equal to "Body", where "id" is case insensitive
// and where any namespace might qualify the attribute.  In this case, the SOAP-ENV:Body fragment is signed
// NOT because the tag = "Body", but because it has SOAP-SEC:id="Body"
[gen AddSameDocRef: @"Body" digestMethod: @"sha1" canonMethod: @"EXCL_C14N" prefixList: @"" refType: @""];

// (You can read about the SignedInfoPrefixList in the online reference documentation.  It's optional..)
gen.SignedInfoPrefixList = @"wsse SOAP-ENV";

gen.KeyInfoType = @"X509Data";
gen.X509Type = @"IssuerSerial";

BOOL bUsePrivateKey = YES;
success = [gen SetX509Cert: cert usePrivateKey: bUsePrivateKey];
if (success == NO) {
    NSLog(@"%@",gen.LastErrorText);
    return;
}

// Everything's specified.  Now create and insert the Signature
// (The actual signing of the hash will happen on the Aruba server.)
success = [gen CreateXmlDSigSb: sbXml];
if (success == NO) {
    NSLog(@"%@",gen.LastErrorText);
    return;
}

// Examine the XML with the digital signature inserted
NSLog(@"%@",[sbXml GetAsString]);