ISSAC-API (VID)

주민등록번호, 사업자등록번호 등을 이용한 신원확인 더 자세히 ...

ISSAC-API (VID)에 대한 협력 다이어그램:

함수
WA_SDK_API ISSAC_RETURN FUNCCALL	ISSAC_VID_VerifyVID (CERTIFICATE *certificate, PRIVATEKEY *priKey, char *idn)
	인증서의 소유자의 식별번호 확인 더 자세히 ...
WA_SDK_API ISSAC_RETURN FUNCCALL	ISSAC_VID_GetRandomNum (void *rdNum, int *rdNum_len, int rdNum_alloc_len, PRIVATEKEY *prikey)
	개인키에서 R값을 추출한다. 더 자세히 ...
WA_SDK_API ISSAC_RETURN FUNCCALL	ISSAC_VID_CompareInputVID_WithCert (CERTIFICATE *certificate, char *idn, void *rdNum, int rdNum_len)
	개인키에서 추출한 R값을 이용해 인증서의 VID가 맞는지 확인한다. 더 자세히 ...
WA_SDK_API ISSAC_RETURN FUNCCALL	ISSAC_VID_GetVID_FromCert (int *hashAlg, void *vid, int *vid_len, int vid_alloc_len, CERTIFICATE *certificate)
	인증서에서 VID를 가져온다. 더 자세히 ...

상세한 설명

주민등록번호, 사업자등록번호 등을 이용한 신원확인

함수 문서화

ISSAC_VID_VerifyVID()

WA_SDK_API ISSAC_RETURN FUNCCALL ISSAC_VID_VerifyVID	(	CERTIFICATE *	certificate,
		PRIVATEKEY *	priKey,
		char *	idn
	)

인증서의 소유자의 식별번호 확인

반환값

ISSAC_SUCCESS : 성공

ER_INVALID_INPUT : 입력값 오류

ER_VID_FAIL_TO_GET_RANDNUM_FROM_PRIVATEKEY : 개인키에서 R값을 찾지 못함

ER_VID_FAIL_TO_COMPARE_VID : VID 검증 실패 (인증서에 VID 가 없거나 일치하지 않음)

매개변수

certificate	[IN] 신원확인 대상의 인증서
priKey	[IN] R값이 포함된 개인키
idn	[IN] 식별번호 (주민등록번호 또는 사업자등록번호)

ISSAC_VID_GetRandomNum()

WA_SDK_API ISSAC_RETURN FUNCCALL ISSAC_VID_GetRandomNum	(	void *	rdNum,
		int *	rdNum_len,
		int	rdNum_alloc_len,
		PRIVATEKEY *	prikey
	)

개인키에서 R값을 추출한다.

주의

R 값은 신원확인을 위한 매우 핵심적인 데이터이다. 유출 시 인증서를 폐지해야 하니 관리에 유의하도록 한다.

반환값

ISSAC_SUCCESS : 성공

ER_INVALID_INPUT : 입력값 오류

ER_INSUFFICIENT_ALLOC_LEN : 버퍼 크기 부족

ER_VID_FAIL_TO_GET_RANDNUM_FROM_PRIVATEKEY : 개인키에서 R값을 찾지 못함

매개변수

rdNum	[OUT] R값 버퍼
rdNum_len	[OUT] 실제 R값 크기
rdNum_alloc_len	[IN] R값 버퍼 크기
prikey	[IN] R값이 포함된 개인키

예제

issacapi/vid/sample_vid_basic.c.

ISSAC_VID_CompareInputVID_WithCert()

WA_SDK_API ISSAC_RETURN FUNCCALL ISSAC_VID_CompareInputVID_WithCert	(	CERTIFICATE *	certificate,
		char *	idn,
		void *	rdNum,
		int	rdNum_len
	)

개인키에서 추출한 R값을 이용해 인증서의 VID가 맞는지 확인한다.

반환값

ISSAC_SUCCESS : 성공

ER_INVALID_INPUT : 입력값 오류

ER_VID_FAIL_TO_COMPARE_VID : VID 비교 실패 (인증서에 VID 가 없거나 일치하지 않음)

매개변수

certificate	[IN] 신원확인 대상의 인증서
idn	[IN] 식별번호 (주민등록번호 또는 사업자등록번호)
rdNum	[IN] 개인키에서 추출한 R값
rdNum_len	[IN] R값의 크기

예제

issacapi/vid/sample_vid_basic.c.

ISSAC_VID_GetVID_FromCert()

WA_SDK_API ISSAC_RETURN FUNCCALL ISSAC_VID_GetVID_FromCert	(	int *	hashAlg,
		void *	vid,
		int *	vid_len,
		int	vid_alloc_len,
		CERTIFICATE *	certificate
	)

인증서에서 VID를 가져온다.

반환값

ISSAC_SUCCESS : 성공

ER_INVALID_INPUT : 입력값 오류

ER_INSUFFICIENT_ALLOC_LEN : 버퍼 크기 부족

ER_VID_FAIL_TO_GET_VID_FROM_CERTIFICATE : 인증서에서 VID를 찾지 못함

매개변수

hashAlg	[OUT] 사용된 해시 알고리즘 [ ISSACAPI_SHA1, ISSACAPI_SHA256, ISSACAPI_SHA384, ISSACAPI_SHA512, ISSACAPI_HAS160 ]
vid	[OUT] VID 버퍼
vid_len	[OUT] 실제 VID 크기
vid_alloc_len	[IN] VID 버퍼 크기
certificate	[IN] 신원확인 대상의 인증서