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]);