SendCEMRequest Method
Sends a Certificate Exchange Messaging (CEM) request.
Syntax
as2sender.sendCEMRequest(requestId, [callback])
Callback
The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).
The callback for this method is defined as:
function(err){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'err' has 2 properties which hold detailed information:
err.code err.message
Remarks
This method send the Certificate Exchange Messaging (CEM) request with the details specified in CEMDetails.
Certificate Exchange Messaging (CEM) allows for new certificates to be sent to a recipient and be automatically updated. This removes the requirement to manually send new certificates to a partner via email or other means. When both sides support this functionality updating certificates can be accomplished in a short period of time.
To prepare a CEM request populate the CEMDetails collection with at least one certificate. For instance if the certificate of the application will be updated soon, the CEMDetails may be populated with the corresponding public certificate to be sent to your partner. CEMDetails should only contain public certificates.
Set CEMRespondByDate to the date by which you expect a response. The format is of the XML standard dateTime type expressed in local time with UTC offset. For instance: "2005-08-31T00:21:00-05:00".
Optionally set CEMCertId to a friendly identifier that the partner may use to help understand the purpose of the new certificate. For instance "New.Encryption.Cert.2014".
Set CEMResponseURL to the publicly accessible URL where the CEM response will be sent after the partner processes it.
The RequestId parameter uniquely identifies this CEM request and must be saved for use later when receiving the CEM response.
When calling this method the applicable CEMDetails properties are: