issacapi_cmp_v3.h

이 파일의 문서화 페이지로 가기

/*
   Copyright (C) 2002 PENTA SECURITY SYSTEMS, INC.
   All rights reserved
 
   THIS IS UNPUBLISHED PROPRIETARY
   SOURCE CODE OF PENTA SECURITY SYSTEMS, INC.
   The copyright notice above does not evidence any actual or intended
   publication of such source code.
 
   Filename : issacapi_cmp_v3.h
*/
 
#ifndef _issacapi_cmp_v3_h
#define _issacapi_cmp_v3_h
 
#include "wasdk_public.h"
 
#include "issacapi_bs_definitions.h"
 
#ifndef WIN32
#define SOCKET         int
#define INVALID_SOCKET (-1)
#define SOCKET_ERROR   (-1)
#define closesocket(s) close(s)
#else
#include <winsock2.h>
#endif
 
 
 
typedef struct _PKIMESSAGE {
    void  *message;
} PKIMESSAGE;
 
typedef struct _PKICONTEXT {
    void  *context;
} PKICONTEXT;
 
typedef struct _PKIKEYPOLICIES {
    int   size;     
    void *policies;
} PKIKEYPOLICIES;
 
typedef struct _PKICERTREQS {
    int    size;
    void  *certreqs;
} PKICERTREQS;
 
typedef struct _PKICERTREPS {
    int    size;        
    void  *certreps;
} PKICERTREPS;
 
typedef struct _PKICERTREVREQS {
    int    size;
    void  *certrevreqs;
} PKICERTREVREQS;
 
typedef struct _PKICERTREVREPS {
    int    size;        
    void  *certrevreps;
} PKICERTREVREPS;
 
typedef enum {
    ER_CP_INVALID_USER_DN = 20000, 
    ER_CP_INVALID_USER_ID,         
    ER_CP_TOO_SMALL_MSG_BUF,       
    ER_CP_INVALID_AUTH_CERT,       
    ER_CP_CANNOT_DECODE_MSG,       
    ER_CP_INVALID_MSG_SIG          
} ISSACAPI_CP_RETURN;
 
typedef enum {
    ISSACAPI_PKIMESSAGE_IR = 0,
    ISSACAPI_PKIMESSAGE_IP,
    ISSACAPI_PKIMESSAGE_CR,
    ISSACAPI_PKIMESSAGE_CP,
    ISSACAPI_PKIMESSAGE_KUR,
    ISSACAPI_PKIMESSAGE_KUP,
    ISSACAPI_PKIMESSAGE_KRR,
    ISSACAPI_PKIMESSAGE_KRP,
    ISSACAPI_PKIMESSAGE_RR,
    ISSACAPI_PKIMESSAGE_RP,
    ISSACAPI_PKIMESSAGE_CCR,
    ISSACAPI_PKIMESSAGE_CCP,
    ISSACAPI_PKIMESSAGE_CKUANN,
    ISSACAPI_PKIMESSAGE_CANN,
    ISSACAPI_PKIMESSAGE_RANN,
    ISSACAPI_PKIMESSAGE_CRLANN,
    ISSACAPI_PKIMESSAGE_CONF,
    ISSACAPI_PKIMESSAGE_GENM,
    ISSACAPI_PKIMESSAGE_GENP,
    ISSACAPI_PKIMESSAGE_ERROR
} ISSACAPI_PKIMESSAGE_TYPE;
 
typedef enum {
    ISSACAPI_CMP_PKISTATUS_ACCEPTED = 0,
    ISSACAPI_CMP_PKISTATUS_GRANTEDWITHMODS = 1,
    ISSACAPI_CMP_PKISTATUS_REJECTION = 2
} ISSAC_CMP_PKISTATUS;
 
typedef enum {
    ISSAC_API_REVOC_REASON_unused               = 0x8000,
    ISSAC_API_REVOC_REASON_keyCompromise        = 0x4000,
    ISSAC_API_REVOC_REASON_cACompromise         = 0x2000,
    ISSAC_API_REVOC_REASON_affiliationChanged   = 0x1000,
    ISSAC_API_REVOC_REASON_superseded           = 0x0800,
    ISSAC_API_REVOC_REASON_cessationOfOperation = 0x0400,
    ISSAC_API_REVOC_REASON_certificateHold      = 0x0200
} ISSAC_API_REVOCATION_REASON;
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIMESSAGE_Create(
    PKIMESSAGE *pkimsg  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIMESSAGE_Delete(
    PKIMESSAGE *pkimsg  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIMESSAGE_GetMsgType(
    int *msg_type,      
    char *err_str,      
    int err_str_max,    
    PKIMESSAGE  *pkimsg 
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIMESSAGE_GetSenderId(
    char *sender_id,    
    int sender_id_max,  
    PKIMESSAGE *pkimsg  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIMESSAGE_GetSenderName(
    char *sender_name,      
    int sender_name_max,    
    PKIMESSAGE *pkimsg      
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICONTEXT_Create(
    PKICONTEXT *pkictx  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICONTEXT_Delete(
    PKICONTEXT *pkictx  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIKEYPOLICIES_Create(
    PKIKEYPOLICIES *key_policy  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIKEYPOLICIES_Delete(
    PKIKEYPOLICIES *key_policy  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIKEYPOLICIES_Read_File(
    PKIKEYPOLICIES *key_policy, 
    const char *filename        
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIKEYPOLICIES_Write_File(
    const char *filename,       
    PKIKEYPOLICIES *key_policy  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIKEYPOLICIES_Read_Memory(
    PKIKEYPOLICIES *key_policy, 
    const void *buffer,         
    int buffer_len              
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIKEYPOLICIES_Write_Memory(
    void *buffer,               
    int *buffer_len,            
    int buffer_alloc_len,       
    PKIKEYPOLICIES *key_policy  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIKEYPOLICIES_Get(
    char *name,                     
    int name_max,                   
    char *id,                       
    int id_max,                     
    int *algorithm,                 
    int *key_bit_len,               
    char *parameter,                
    int parameter_len,              
    PKIKEYPOLICIES *key_policies,   
    int index                       
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIKEYPOLICIES_GetExt(
    int *valid_year,                
    int *valid_month,               
    int *valid_day,                 
    int *valid_hour,                
    char *ldap_att,                 
    int ldap_att_max,               
    char *extensions,               
    int extensions_max,             
    int *ra_issuance_allowed,       
    PKIKEYPOLICIES *key_policies,   
    int index                       
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIKEYPOLICIES_Add(
    PKIKEYPOLICIES *key_policies,   
    const char *name,               
    const char *id,                 
    int algorithm,                  
    int key_bit_len,                
    const char *parameter           
);
 
/**********************************************************************/
/* 인증서 생성 요청(PKICERTREQS) */
/**********************************************************************/
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREQS_Create(
    PKICERTREQS *pkicertreqs    
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREQS_Delete(
    PKICERTREQS *pkicertreqs    
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREQS_AddCertReq(
    PRIVATEKEY *privatekey,         
    PKICERTREQS *pkicertreqs,       
    PKIKEYPOLICIES *pkikeypolicies, 
    int keypolicy_index,            
    CERTIFICATE *old_cert,          
    PRIVATEKEY *old_key,            
    CERTIFICATE *ca_cert            
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREQS_AddCertReqEx_UDK(
    PRIVATEKEY *privatekey,     
    PKICERTREQS *pkicertreqs,   
    int algorithm,              
    int key_bit_len,            
    char *parameter,            
    char *key_policy_id,        
    CERTIFICATE *old_cert,      
    PRIVATEKEY *old_key_unused, 
    CERTIFICATE *ca_cert,       
    char *inputVal,             
    int inputLen                
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREQS_AddCertReqEx(
    PRIVATEKEY *privatekey,     
    PKICERTREQS *pkicertreqs,   
    int algorithm,              
    int key_bit_len,            
    char *parameter,            
    char *key_policy_id,        
    CERTIFICATE *old_cert,      
    PRIVATEKEY *old_key_unsued, 
    CERTIFICATE *ca_cert        
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREQS_SetSubject(
    PKICERTREQS *pkicertreqs,   
    const char *pSubjectName    
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREQS_SetResidentNumber(
    PKICERTREQS *pkicertreqs,   
    const char *pResidentNumber 
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREQS_GetResidentNumber(
    char *pResidentNumber,      
    int residentNumber_max,     
    PKICERTREQS *pkicertreqs    
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREQS_SetEncryptedVID(
    PKICERTREQS *pkicertreqs,   
    PRIVATEKEY *privatekey,     
    int index,                  
    const char *pIdn,           
    CERTIFICATE *ca_cert        
);
 
// /// @brief PKICERTREQS의 내용을 해석한다  : CA용 - 미구현
// /// 
// /// @return @ref ISSAC_SUCCESS : 성공
// ISSAC_RETURN FUNCCALL
// ISSAC_PKICERTREQS_Resolve(
//     PRIVATEKEY *privatekey,     ///< 
//     CERTTEMPLATE *certtemplate, ///< 
//     PKICERTREQS *pkicertreqs,   ///< 
//     int index,                  ///< 
//     CERTIFICATE *ca_cert        ///< 
// );
 
 
/**********************************************************************/
/* 인증서 생성 응답 */
/**********************************************************************/
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREPS_Create(
    PKICERTREPS *pkicertreps    
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREPS_Delete(
    PKICERTREPS *pkicertreps    
);
 
// /// @brief PKICERTREPS 에 신규 발행된 인증서를 추가 : CA용 - 미구현
// /// 
// /// @return @ref ISSAC_SUCCESS : 성공
// WA_SDK_API ISSAC_RETURN FUNCCALL
// ISSAC_PKICERTREPS_Add(
//     PKICERTREPS *pkicertreps,   ///< 
//     CERTIFICATE *certificate,   ///< 
//     int index                   ///< 
// );
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREPS_Resolve(
    CERTIFICATE *certificate,   
    char *err_message,          
    int errmsg_max,             
    PKICERTREPS *pkicertreps,   
    int index                   
);
 
 
/**********************************************************************/
/* 인증서 폐지 요청 */
/**********************************************************************/
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREVREQS_Create(
    PKICERTREVREQS *pkicertreqs 
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREVREQS_Delete(
    PKICERTREVREQS *pkicertreqs 
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREVREQS_Add(
    PKICERTREVREQS *pkicertrevreqs, 
    CERTIFICATE *certificate,       
    int revocation_reason           
);
 
 
// /// @brief PKICERTREVREQS의 내용을 획득 : CA용 - 미구현
// /// 
// /// @return @ref ISSAC_SUCCESS : 성공
// WA_SDK_API ISSAC_RETURN FUNCCALL
// ISSAC_PKICERTREVREQS_Resolve(
//     char *serial,                   ///< 
//     int serial_max,                 ///< 
//     int *revocation_reason,         ///< 
//     PKICERTREVREQS *pkicertreps,    ///< 
//     int index                       ///< 
// );
 
/**********************************************************************/
/* 인증서 폐지 응답 */
/**********************************************************************/
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREVREPS_Create(
    PKICERTREVREPS *pkicertrevreps  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREVREPS_Delete(
    PKICERTREVREPS *pkicertrevreps  
);
 
// /// @brief 폐지한 인증서를 PKICERTREVREPS에 추가 : CA용 - 미구현
// /// 
// /// @return @ref ISSAC_SUCCESS : 성공
// WA_SDK_API ISSAC_RETURN FUNCCALL
// ISSAC_PKICERTREVREPS_Add(
//     PKICERTREVREPS *pkicertrevreps, ///< 
//     int status                      ///< 
// );
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKICERTREVREPS_Resolve(
    int *revocation_status,         
    char *err_str,                  
    int err_str_max,                
    PKICERTREVREPS *pkicertreps,    
    int index                       
);
 
 
/**********************************************************************/
/* 인증서 등록 */
/**********************************************************************/
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_MakeInitialReq(
    PKIMESSAGE *pkimsg,             
    PKICONTEXT *pkictx,             
    PKICERTREQS *pkicertreqs,       
    CERTIFICATE *sender_cert,       
    PRIVATEKEY *sender_key,         
    const char *sender_id,          
    const char *sender_authcode,    
    CERTIFICATE *recip_cert         
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_ResolveInitialReq(
    PKICERTREQS *pkicertreqs,   
    PKICONTEXT *pkictx,         
    PKIMESSAGE *pkimsg,         
    CERTIFICATE *recip_cert,    
    CERTIFICATE *sender_cert,   
    char *sender_authcode,      
    time_t nowTime              
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_MakeInitialRep(
    PKIMESSAGE *pkimsg,         
    PKICONTEXT *pkictx,         
    PKICERTREPS *pkicertreps,   
    CERTIFICATE *sender_cert,   
    PRIVATEKEY *sender_key      
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_ResolveInitialRep(
    PKICERTREPS *pkicertreps,   
    PKIMESSAGE *pkimsg,         
    PKICONTEXT *pkictx,         
    time_t nowTime              
);
 
 
/**********************************************************************/
/* 인증서 갱신 */
/**********************************************************************/
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_MakeKeyUpdateReq(
    PKIMESSAGE *pkimsg,         
    PKICONTEXT *pkictx,         
    PKICERTREQS *pkicertreqs,   
    CERTIFICATE *sender_cert,   
    PRIVATEKEY *sender_key,     
    CERTIFICATE *recip_cert     
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_ResolveKeyUpdateReq(
    PKICERTREQS *pkicertreqs,   
    PKICONTEXT *pkictx,         
    PKIMESSAGE *pkimsg,         
    CERTIFICATE *recip_cert,    
    CERTIFICATE *sender_cert,   
    time_t nowTime              
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_MakeKeyUpdateRep(
    PKIMESSAGE *pkimsg,         
    PKICONTEXT *pkictx,         
    PKICERTREPS *pkicertreps,   
    CERTIFICATE *sender_cert,   
    PRIVATEKEY *sender_key      
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_ResolveKeyUpdateRep(
    PKICERTREPS *pkicertreps,   
    PKIMESSAGE *pkimsg,         
    PKICONTEXT *pkictx,         
    time_t nowTime              
);
 
 
/**********************************************************************/
/* 인증서 폐지 */
/**********************************************************************/
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_MakeRevocationReq(
    PKIMESSAGE *pkimsg,             
    PKICONTEXT *pkictx,             
    PKICERTREVREQS *pkicertrevreqs, 
    CERTIFICATE *sender_cert,       
    PRIVATEKEY *sender_key,         
    CERTIFICATE *recip_cert         
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_ResolveRevocationReq(
    PKICERTREVREQS *pkicertrevreqs, 
    PKIMESSAGE *pkimsg,             
    PKICONTEXT *pkictx,             
    CERTIFICATE *recip_cert,        
    CERTIFICATE *sender_cert,       
    time_t nowTime                  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_MakeRevocationRep(
    PKIMESSAGE *pkimsg,             
    PKICONTEXT *pkictx,             
    PKICERTREVREPS *pkicerrevtreps, 
    CERTIFICATE *sender_cert,       
    PRIVATEKEY *sender_key          
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_ResolveRevocationRep(
    PKICERTREVREPS *pkicertrevreps, 
    PKIMESSAGE *pkimsg,             
    PKICONTEXT *pkictx,             
    time_t nowTime                  
);
 
/**********************************************************************/
/* 공용 CONFIRM message */
/**********************************************************************/
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_MakeConfirm(
    PKIMESSAGE *pkimsg, 
    PKICONTEXT *pkictx  
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_ResolveConfirm(
    PKIMESSAGE *pkimsg,         
    PKICONTEXT *pkictx,         
    CERTIFICATE *recip_cert,    
    CERTIFICATE *sender_cert,   
    char *sender_authcode,      
    time_t nowTime              
);
 
/**********************************************************************/
/* 공용 ERROR message */
/**********************************************************************/
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_MakeError(
    PKIMESSAGE *pkimsg,         
    PKICONTEXT *pkictx,         
    int status,                 
    const char *status_msg,     
    int error_code,             
    const char *error_msg,      
    CERTIFICATE *sender_cert,   
    PRIVATEKEY *sender_key      
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_ResolveError(
    int *status,        
    char *status_msg,   
    int status_msg_max, 
    int *err_code,      
    char *err_msg,      
    int err_msg_max,    
    PKIMESSAGE *pkimsg, 
    PKICONTEXT *pkictx, 
    time_t nowTime      
);
 
 
 
/**********************************************************************/
/* 키 정책관련 message */
/**********************************************************************/
 
/********************************************************************/
/* PKIKEYPOLICIES message */
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_MakeKeyPoliciesReqMsg(
    PKIMESSAGE *pkimsg,         
    PKICONTEXT *pkictx,         
    char *user_id,              
    char *user_authcode,        
    CERTIFICATE *user_cert,     
    PRIVATEKEY *user_key,       
    int rauser_flag,            
    CERTIFICATE *recip_cert,    
    CERTIFICATE *ca_cert        
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_ResolveKeyPoliciesReqMsg(
    char *requester_id,         
    int requester_id_max,       
    PKICONTEXT *pkictx,         
    PKIMESSAGE *pkimsg,         
    CERTIFICATE *recip_cert,    
    CERTIFICATE *sender_cert,   
    char *sender_authcode       
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_MakeKeyPoliciesResMsg(
    PKIMESSAGE *pkimsg,             
    PKICONTEXT *pkictx,             
    PKIKEYPOLICIES *key_policies,   
    CERTIFICATE *sender_cert,       
    PRIVATEKEY *sender_key          
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_CMP_ResolveKeyPoliciesResMsg(
    PKIKEYPOLICIES *key_policies,   
    PKIMESSAGE *pkimsg,             
    PKICONTEXT *pkictx              
);
 
 
/**********************************************************************/
/* Network 처리 */
/**********************************************************************/
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_SOCKET_Init();
 
WA_SDK_API SOCKET FUNCCALL
ISSAC_SOCKET_Connect(
    const char *ip, 
    int port        
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_SOCKET_Connect2(
    const char *ip, 
    int port,       
    SOCKET *pSocket 
);
 
WA_SDK_API SOCKET FUNCCALL
ISSAC_SOCKET_CreateAcceptSock(
    int port    
);
 
WA_SDK_API SOCKET FUNCCALL
ISSAC_SOCKET_Accept(
    SOCKET sock 
);
 
WA_SDK_API void FUNCCALL
ISSAC_SOCKET_Close(
    SOCKET sock 
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIMESSAGE_Send(
    SOCKET sock,            
    PKIMESSAGE *pPKIMessage 
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIMESSAGE_SendError(
    SOCKET sock,            
    const char *pszErrorMsg 
);
 
WA_SDK_API ISSAC_RETURN FUNCCALL
ISSAC_PKIMESSAGE_Receive(
    PKIMESSAGE *pPKIMessage,    
    SOCKET sock,                
    char *pszErrorMsgBuf,       
    int nMaxBufLen              
);
 
 
/**********************************************************************/
/* 공용 기타 */
/**********************************************************************/
 
WA_SDK_API char *FUNCCALL
GetVersionString(
    int *pMajorVersion, 
    int *pMinorVersion  
);
 
 
 
#endif /* _issacapi_cmp_h */