C
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).Chilkat C Downloads
#include <C_CkStringBuilder.h>
#include <C_CkCert.h>
#include <C_CkJsonObject.h>
#include <C_CkXmlDSigGen.h>
void ChilkatSample(void)
{
BOOL success;
HCkStringBuilder sbXml;
BOOL bCrlf;
HCkCert cert;
HCkJsonObject jsonArss;
HCkXmlDSigGen gen;
BOOL bUsePrivateKey;
success = FALSE;
// 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.
sbXml = CkStringBuilder_Create();
bCrlf = TRUE;
CkStringBuilder_AppendLine(sbXml,"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\" ?>",bCrlf);
CkStringBuilder_AppendLine(sbXml,"<SOAP-ENV:Envelope xmlns:SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\">",bCrlf);
CkStringBuilder_AppendLine(sbXml," <SOAP-ENV:Header>",bCrlf);
CkStringBuilder_AppendLine(sbXml," <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>",bCrlf);
CkStringBuilder_AppendLine(sbXml," </SOAP-ENV:Header>",bCrlf);
CkStringBuilder_AppendLine(sbXml," <SOAP-ENV:Body xmlns:SOAP-SEC=\"http://schemas.xmlsoap.org/soap/security/2000-12\" SOAP-SEC:id=\"Body\">",bCrlf);
CkStringBuilder_AppendLine(sbXml," <z:FooBar xmlns:z=\"http://example.com\" />",bCrlf);
CkStringBuilder_AppendLine(sbXml," </SOAP-ENV:Body>",bCrlf);
CkStringBuilder_AppendLine(sbXml,"</SOAP-ENV:Envelope>",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).
cert = CkCert_Create();
success = CkCert_LoadFromFile(cert,"qa_data/certs/myCert.cer");
if (success == FALSE) {
printf("%s\n",CkCert_lastErrorText(cert));
CkStringBuilder_Dispose(sbXml);
CkCert_Dispose(cert);
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.
jsonArss = CkJsonObject_Create();
// Set the "service" equal to "ARSS" to tell Chilkat to use ARSS for signing.
CkJsonObject_UpdateString(jsonArss,"service","ARSS");
// Specify the certificate ID, such as "AS0"
// This certificate should match the certificate loaded in the above code.
CkJsonObject_UpdateString(jsonArss,"certID","YOUR_ARSS_CERT_ID");
CkJsonObject_UpdateString(jsonArss,"otpPwd","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.
CkJsonObject_UpdateString(jsonArss,"typeOtpAuth","demoprod");
CkJsonObject_UpdateString(jsonArss,"user","YOUR_ARSS_USERNAME");
CkJsonObject_UpdateString(jsonArss,"userPWD","YOUR_ARSS_PASSWORD");
// The "endpoint" can be specified starting in Chilkat v11.5.0
CkJsonObject_UpdateString(jsonArss,"endpoint","https://app1.firma-remota.it/ArubaSignerService/webresources/signerservice");
success = CkCert_SetCloudSigner(cert,jsonArss);
// Prepare for signing...
gen = CkXmlDSigGen_Create();
// Indicate where the Signature will be inserted.
CkXmlDSigGen_putSigLocation(gen,"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"
CkXmlDSigGen_AddSameDocRef(gen,"Body","sha1","EXCL_C14N","","");
// (You can read about the SignedInfoPrefixList in the online reference documentation. It's optional..)
CkXmlDSigGen_putSignedInfoPrefixList(gen,"wsse SOAP-ENV");
CkXmlDSigGen_putKeyInfoType(gen,"X509Data");
CkXmlDSigGen_putX509Type(gen,"IssuerSerial");
bUsePrivateKey = TRUE;
success = CkXmlDSigGen_SetX509Cert(gen,cert,bUsePrivateKey);
if (success == FALSE) {
printf("%s\n",CkXmlDSigGen_lastErrorText(gen));
CkStringBuilder_Dispose(sbXml);
CkCert_Dispose(cert);
CkJsonObject_Dispose(jsonArss);
CkXmlDSigGen_Dispose(gen);
return;
}
// Everything's specified. Now create and insert the Signature
// (The actual signing of the hash will happen on the Aruba server.)
success = CkXmlDSigGen_CreateXmlDSigSb(gen,sbXml);
if (success == FALSE) {
printf("%s\n",CkXmlDSigGen_lastErrorText(gen));
CkStringBuilder_Dispose(sbXml);
CkCert_Dispose(cert);
CkJsonObject_Dispose(jsonArss);
CkXmlDSigGen_Dispose(gen);
return;
}
// Examine the XML with the digital signature inserted
printf("%s\n",CkStringBuilder_getAsString(sbXml));
CkStringBuilder_Dispose(sbXml);
CkCert_Dispose(cert);
CkJsonObject_Dispose(jsonArss);
CkXmlDSigGen_Dispose(gen);
}