SignRequest Event

This event signifies the processing of an atomic signing request.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
virtual int FireSignRequest(DCAuthSignRequestEventParams *e);

typedef struct {
  const char *Hash;
  int lenHash;
  const char *Username;
  int Allow;
  int reserved;
} DCAuthSignRequestEventParams;

Unicode (Windows)
virtual INT FireSignRequest(DCAuthSignRequestEventParams *e);

typedef struct {
  LPCSTR Hash;
  INT lenHash;
  LPCWSTR Username;
  BOOL Allow;
  INT reserved;
} DCAuthSignRequestEventParams;

- (void)onSignRequest:(NSData*)hash :(NSString*)username :(int*)allow;

#define EID_DCAUTH_SIGNREQUEST 9

virtual INT SECUREBLACKBOX_CALL FireSignRequest(LPSTR &lpHash, INT &lenHash, LPSTR &lpszUsername, BOOL &bAllow);

Remarks

Subscribe to this event to be notified of every signature request processed by the DC server. Note that any one request coming from the requestor may contain multiple individual signature requests (so-called 'batching'). This event is a good mechanism to track signature requests for accountability purposes, and provide basic access control over the signing operations. The Hash parameter contains the hash that is going to be signed. Username contains the HTTP user name of the connected user. Set Allow to false to stop the request from being served. Use the SignRequestCompleted event to track completion of the initiated operation.