이 글은 KCB OKNAME 휴대폰 인증과 아이핀 인증을 신청하고 사용하는 대상자에 한해서 쓴 글입니다.

 

https://sir.kr/main/service/b_cert.php

https://sir.kr/main/service/b_ipin.php

 

KCB 에서 신규 ROOT CA 변경 인증서 안내 메일을 확인해 보니

 

https://www.ok-name.co.kr/oknm/notice/202003_SSL/html/intro.html

 

본문에 아래와 같은 내용이 있었습니다.

 

 

현재 그누보드5와 영카트5에는 okcert3 미만의 구모듈이 들어가 있습니다. 따라서 언젠일지 모르지만 현재 KCB OKNAME 본인인증을 사용하는 분들은 점진적 종료 예정이니 여기에 대응을 해 주셔야 합니다.

 

위에서 언급한 okcert3 모듈은 서버에 extension=okcert3.so 를 설치 및 설정 해야 되는 모듈입니다.

따라서 웹호스팅 환경에서는 okcert3 모듈을 사용할수 없습니다.

( 웹호스팅 환경은 모듈 설치를 할수 없는 환경입니다 )

 

okcert3 미만의 구 모듈은 설치 및 설정 과정이 없어서 웹호스팅 환경에서 사용이 가능했지만,

okcart3 모듈은 extension=okcert3.so 을 설치하는 과정이 있어서 웹호스팅 환경에서 사용이 불가능합니다.

 

구버전 모듈이 언제 종료될지 모르기 때문에 앞으로 웹호스팅에서 사이트를 운영하시는 분은,

kcb okname 본인인증 신청을 하지 않으셨으면 합니다. ( NHN_KCP 휴대폰 본인인증을 추천드립니다. )

 

아래부터는 일반서버에서 okcert3 모듈을 적용하는 방법입니다.

 

okcert3 모듈 적용을 원하시면, 본문에 첨부한 첨부 파일을 받아서

그누보드5 설치된 경로의 /plugin/okname/ 폴더 안의 내용을 다 지우고 첨부 파일의 파일들을 덮어쓰기 해 주시면 됩니다.

 

okcert3 모듈을 사용하려면 아래와 같은 요구사항이 필요합니다.

 

1. 회원사코드 ( KCB 와 계약시 발급됩니다. )

2. 라이센스파일 ( KCB 와 계약시 요청해서 발급받아야 합니다. )

3. 서버에 okcert3 모듈 설치 ( KCB와 계약시 요청해서 발급 받습니다. 리눅스 환경은 okcert3.so 파일 이며 윈도우 환경에서는 okcert3.dll 등록 )

 

okcert3 모듈은 아래와 같이 실제 운영하는 환경을 자세히 알려주셔야 해당 서버 환경에 맞는 okcert3 모듈을 전달 받습니다.

1) OS ( 서버운영체제 )

2) OS bit ( 서버OS가 32비트인지 64비트인지 )

3) PHP 버전

4) Thread safety 설정 값(enable/disable)

5) glibc버전 ( 운영체제가 리눅스 인 경우에만 확인가능 )

 

위의 값들은 PHPINFO() 실행시 알수 있는 값들이 있습니다.

 

OSbit

 

PHP 버전

 

 

Thread safety 설정 값

 

 

glibc 버전은 리눅스인 경우에는 쓰면 됩니다.

조회 명령어 getconf -a | grep libc

 

 

 

위의 환경들을 KCB 측에 잘 전달을 해야 해당 서버환경에 맞는 서버에 okcert3 모듈을 받을수 있습니다.

 

발급받은 okcert3 모듈 설치는

리눅스 와 윈도우용이 따로 있으며 아래 방법을 참고하여 해 주시면 됩니다.

( KCB 에서 모듈을 받았다면 본인확인서비스_PHP 모듈가이드 에도 나와 있습니다. )

 

phpinfo()

에서 extension_dir 을 검색 후 해당 위치를 확인합니다.

 

 

리눅스 :

 

해당 extension_dir 위치에

 

발급받은 okcert3.so 파일을 업로드 합니다.

 

Thread safety 가 enable 이면

okcert3.so_2.0.1_ext_linux64_glibc2.17__7.3ts 이런 형태의 파일이며 ( 뒤에 ts가 붙음 )

 

Thread safety 가 disable 이면

okcert3.so_2.0.1_ext_linux64_glibc2.17__7.3 이런 형태의 파일입니다.

 

okcert3.so_2.0.1_ext_linux64_glibc2.17__7.3 파일이름을 그대로 업로드 했다면

 

php.ini 에서는 extension=okcert3.so_2.0.1_ext_linux64_glibc2.17__7.3

 

또는 파일이름을 okcert3.so 으로 수정해서 올렸다면

php.ini 에서는 extension=okcert3.so

 

으로 수정합니다.

 

서버 재시작 을 하면 phpinfo() 에서 okcert3 항목이 보인다면 모듈이 정상적으로 설치된 것입니다.

 

 

 

윈도우 :

 

윈도우는 확장명이 dll 인 파일을 업로드하여 설치합니다.

 

윈도우 환경에서 발급받은 파일은 아래와 같을겁니다.

libcurl.dll

okcert3_2.0.1_x64_7.2.dll

okcert3_2.0.1_x64_7.2TS.dll

 

위에서 TS 는 Thread safety 가 enable 환경이면 적용해야 할 파일입니다.

 

extension_dir 위치에 해당 파일을 업로드 후

 

php.ini 에서

 

extension=libcurl.dll
extension=okcert3_2.0.1_x64_7.2TS.dll

 

이렇게 추가 후에 서버 재시작시 phpinfo() 에서 okcert3 항목이 보인다면 잘 설치가 된것입니다.

 

 

 

윈도우 서버의 경우 위와 같이 잘 설치가 되었더라도 실제로 본인인증 하면

ret : 4001 오류가 일어날수 있습니다.

ret : 4001 오류내용은 okcert3 메뉴얼에 없는 내용인데, 왜 일어나는지는 저도 잘 모르겠습니다.

 

xampp 프로그램을 예로 들면 아래 링크 프로그램을 실행하면 잘 동작이 되지만 ( PHP 버전 7.2.31 xampp )

 

https://www.apachefriends.org/xampp-files/7.2.31/xampp-windows-x64-7.2.31-0-VC15-installer.exe

 

다른 버전의 xampp 프로그램을 설치시 같은 xampp 프로그램이라 하더라도 ret : 4001 오류가 일어나는 것을 확인했습니다.

 

 

발급받은 라이센스파일은 아래 파일 형태이며

서버내 웹경로로 접근할수 없는 경로에 위치해 있어야 합니다.

 

휴대폰 인증 라이센스 파일 : 회원사코드_IDS_01_PROD_AES_license.dat

아이핀 인증 라이센스 파일 : 회원사코드_TIS_01_PROD_AES_license.dat

 

이 게시물의 첨부파일인 gnuboard5.okcert3.plugin.tar.gz 파일의 압축을 풀어서

/plugin/okname/okcert.config.php 파일의 9번째 줄에

 

$license_path 변수에 해당 라이센스 파일이 위치한 경로를 입력해 주시면 됩니다.

 

위의 과정을 다 했다면 okcert3 본인인증 모듈이 동작 될것입니다.