RSA BSAFE Cert-C

PKI_CRS_INIT_PARAMS Reference

When you register the Cert-C CRS PKI service provider, the corresponding handlerParams should point to a PKI_CRS_INIT_PARAMS structure. Or, if you use C_RegisterService() to register the Cert- C CRS PKI service provider, the corresponding params should point to a PKI_CRS_INIT_PARAMS structure.

Data Fields

configURL

The data item configURL is a pointer to a NUL-terminated unsigned character array that contains a URL used to locate the configuration information for this service-provider instance. Currently, the only protocol that may be used to specify the location of the configuration data is file. For example, configURL may point to a string such as file:///var/opt/CRS/config/crs.cfg or file:///C:/CRS/config/crs.cfg.

The contents of the resource pointed to by configURL are name=value lines of text. The names that this service provider recognizes are dest, http.proxy, and profile. All other entries are ignored.

dest is used to specify the location of one or more CRS auto-responders.

http.proxy is used to specify an address and port number of a non-transparent HTTP proxy that exists between the application and the CRS auto-responder. This value should be formatted as address:port.

profile is used to specify the particular CRS profile that is implemented by the responder; there may be subtle differences between one CRS implementation and another. This service provider has been tested with VeriSign OnSite, RSA Keon Certificate Server 5.5, and RSA Keon Certificate Authority 6.0 responders. If this optional entry is left unspecified, it defaults to VeriSign.

For example, the contents of the configuration file located at file:///var/opt/CRS/config/crs.cfg might be:

      dest=http://onsite.verisign.com/cgi-bin/crs.exe
      http.proxy = proxy1.mycompany.com:80
      http.proxy = proxy2.mycompany.com:80
      profile = VeriSign

handle Upon return, contains a service-provider handle for optional use with the S_CRS_ProvideProofOfPossession() function.

#include <crs.h>

00129 typedef struct PKI_CRS_INIT_PARAMS {
00130   unsigned char *configURL;  /* (in)  URL for configuration information */
00131   POINTER        handle;     /* (out) service provider handle           */
00132 } PKI_CRS_INIT_PARAMS, *P_PKI_CRS_INIT_PARAMS;