RSA BSAFE Cert-C	Certificate Components for C
		Crypto-C 6.2.1 Developer's Guide
		Search

---

bcert.h

Go to the documentation of this file.

/* $Id: bcert.h,v 1.6 2005/01/25 06:32:18 tjh Exp $ */
/*
* Copyright (c) RSA Security Inc., 1999-2002.  All rights reserved.
* This work contains proprietary, confidential, and trade secret
* information of RSA Security Inc.  Use, disclosure or reproduction
* without the express written authorization of RSA Security Inc. is
* prohibited.
*/

#ifndef _BCERT_H_
#define _BCERT_H_ 1

#include "certc.h"

#ifdef __cplusplus
extern "C" {
#endif

extern char * CALL_CONV BCERT_VERSION;

/* If generating documentation then do not include the aliases for the 
 * base structures otherwise doxygen will rename the new structure name 
 * to the legacy BCERT name
 */
#ifndef DOC_PROTO

/* Use PKCS10_OBJ */
typedef POINTER CERT_REQUEST_OBJ;

/* Use PKCS10_FIELDS */
typedef PKCS10_FIELDS CERT_REQUEST_FIELDS;

typedef POINTER APPL_CTX;

#endif /* !DOC_PROTO */

/* Use PKCS10_* replacements */
#define CERT_REQUEST_VERSION_1 0
#define CERT_REQUEST_VERSION_2 1 /* not actually supported!! */
#define DEFAULT_CERT_REQUEST_VERSION CERT_REQUEST_VERSION_1

extern unsigned char ET_POLICY_CONSTRAINTS[];
#define ET_POLICY_CONSTRAINTS_LEN 3

/* Policy Constraints extension.  This extension uses OID {id-ce 34}
   which has been deprecated in the X.509 specification.  It was defined
   in an interim working document and never made it into the final
   standard.
*/
typedef struct POLICY_CONSTRAINTS {
  unsigned int certPolicyCount;     /* number of certificate policy
                                       in certPolicies */
  ITEM *certPolicies;               /* points to an array of 'certPolicyCount' */
                                    /* elements, where each element is a policy OID */
  int requireExplicitPolicy;        /* number of certs to skip before constraints
                                       apply.  To omit, set to NOT_IN_USE   */
  int inhibitPolicyMapping;         /* number of certs to skip before constraints
                                       apply; to omit, set to NOT_IN_USE */
} POLICY_CONSTRAINTS;

/* @deprecated Use C_CreatePKCS10Object(). */
int C_CreateCertRequestObject (
  CERT_REQUEST_OBJ       *certRequestObject);/* (out) cert req obj to be created */

/* @deprecated Use C_DestroyPKCS10Object(). */
void C_DestroyCertRequestObject (
  CERT_REQUEST_OBJ       *certRequestObject);    /* cert req obj to destroy */

/* @deprecated Use C_GetPKCS10Fields(). */
int C_GetCertRequestFields (
  CERT_REQUEST_OBJ       certRequestObject,  /* (in)  cert req obj     */
  CERT_REQUEST_FIELDS    *certRequestFields);/* (out) extracted fields */

/* @deprecated Use C_SetPKCS10Fields(). */
int C_SetCertRequestFields (
  CERT_REQUEST_OBJ       certRequestObject,  /* (mod) cert req obj           */
  CERT_REQUEST_FIELDS    *certRequestFields);/* (in)  cert req fields to set */

/* @deprecated Use C_GetPKCS10DER(). */
int C_GetCertRequestDER (
  CERT_REQUEST_OBJ       certRequestObject,
  unsigned char          **der,
  unsigned int           *derLen);

/* @deprecated Use C_SetPKCS10BER(). */
int C_SetCertRequestBER (
  CERT_REQUEST_OBJ       certRequestObject,
  unsigned char          *ber,
  unsigned int           berLen);

/* @deprecated Use C_SignPKCS10(). */
int C_SignCertRequest (
  CERT_REQUEST_OBJ       certRequestObject,
  B_KEY_OBJ              subjectPrivateKey,
  B_ALGORITHM_OBJ        randomObject,
  int                    signatureAlgorithm,
  unsigned char          *digest,
  unsigned int           *digestLen,
  unsigned int           maxDigestLen,
  A_SURRENDER_CTX        *surrenderContext);

/* @deprecated Use C_VerifyPKCS10Signature(). */
int C_VerifyCertRequestSignature (
  CERT_REQUEST_OBJ       certRequestObject,
  unsigned char          *digest,
  unsigned int           *digestLen,
  unsigned int           maxDigestLen,
  A_SURRENDER_CTX        *surrenderContext);

/* @deprecated */
int C_DecomposePKCSCertRequestBER (
  CERT_OBJ               certObject,
  ATTRIBUTES_OBJ         attributesObject,
  unsigned char          *certRequestBER,
  unsigned int           certRequestBERLen,
  unsigned char          *digest,
  unsigned int           *digestLen,
  A_SURRENDER_CTX        *surrenderContext);

/* @deprecated */
int C_InitializeApplContext (
  APPL_CTX          *applContext);      /* (out) application context */

/* @deprecated */
void C_FinalizeApplContext (
  APPL_CTX          *applContext);      /* application context */

#if 0
The following functions are supported via the same function definitions.
The preferred method to call these functions is with a CERTC_CTX but for
backward compatibility, they will take an APPL_CTX. Calling these with
APPL_CTX is deprecated.

/* @deprecated */
int C_GetExtensionTypeInfo (
  APPL_CTX          applContext,        /* application context */
  unsigned char     *type,              /* extension OID */
  unsigned int      typeLen,            /* extension OID length */
  EXTENSION_TYPE_INFO *info);           /* extension definition */

/* @deprecated */
int C_RegisterExtensionType (
  APPL_CTX          applContext,        /* application context */
  EXTENSION_TYPE_INFO *info);           /* extension definition */

/* @deprecated */