BIZSIREN 실명확인서비스 개발 가이드 서울신용평가정보㈜ 신용조회부 (TEL 3449-1663, FAX 3449-1533)
실명확인서비스 개발 가이드 (목차) 1.실명확인서비스 요청화면 작업 (회원사.서버작업) ① 실명확인 요청 정보 전송처리 ② 실명확인 결과 정보 수신처리 ③ 실명확인 Sample 화면 ④ 실명확인 Sample 소스 ⑤ 실명확인 요청 샘플 화면 ⑥ 실명확인 샘플화면 2. 인증서 설치 방법 (bizsiren 접속방법) 3. 실명확인 도메인 등록 신청 및 요청경로 추가/삭제,정보변경 작업 ① 로그인 후 인증서 암호 확인 ② 등록된 승인도메인 및 경로확인 ③ 도메인 등록신청 ④ 요청경로 추가/삭제 ⑤ 도메인삭제신청 ⑥ 정보변경 4. 조회기록 열람 ① 조회기록 열람방법 ② 등록 도메인별 실명확인 발생건수 확인방법 5. 실명확인 요청 서비스 추가인증방식(IP인증,ID/비밀번호(SSL인증))
실명확인서비스 개발 가이드 (서비스 구성도) 사용자의 실명확인 요청 회원사SYSTEM BIZSIREN SYSTEM 실시간 실명확인서비스 결과값 제공 1번 값: 실명확인 정상처리 2번 값: 주민번호와 성명 불일치 3번 값: DB미등록 4번 값: 주민번호 로직 오류 5번 값: SYSTEM 장애 Web service DATABASE 주민등록번호 성 명 실명확인처리결과 관련 안내 및 공지 (회원사) pop-up window web-page link
1- ① 실명확인서비스 개발 가이드 (실명확인 요청정보 전송처리) 1- ① 실명확인서비스 개발 가이드 (실명확인 요청정보 전송처리) 전송 방식 - 회원사 웹페이지(요청경로)에서 주민등록번호와 성명을 입력받아 서울신용평가 action url 로 실명확인 요청 Parameter를 post방식으로 넘겨준다. • action url : https://name.siren24.com/servlet/name_check 실명확인 요청 Parameter - id : 회원사 ID (대문자, 서울신용평가정보에서 부여, 연결 작업 시 통보) - ok_url : 실명확인 후 결과값을 전송 받을 프로그램 URL(회원사에서 개발) - jumin1 : 주민번호 앞자리(숫자 6자리) - jumin2 : 주민번호 뒷자리(숫자 7자리) - name : 성 명(한글2~10자리) 실명확인 요청 서비스 인증 - 실명확인 요청 화면 URL Check를 통해서 사전에 등록된 URL을 통한 요청인 경우만 서비스가 제공되고 있습니다.
1- ② 실명확인서비스 개발 가이드 (실명확인 결과정보 수신처리) 1- ② 실명확인서비스 개발 가이드 (실명확인 결과정보 수신처리) 실명확인처리 후 회원사가 실명확인 요청 Parameter에서 지정한 ok_url(회원사에서 개발)로 실명확인 결과를 Post 방식으로 넘겨드리므로, 각각의 결과값에 따라 해당화면으로 넘어가도록 각 회원사의 서버에 맞도록 php 나 asp 등으로 프로그램 작업을 해주시면 됩니다. 실명확인 결과 정보 Parameter Name - jumin1 : 주민번호 앞자리 - jumin2 : 주민번호 뒷자리 - name : 성 명 - result : 결과코드(1자리) 결과코드 설명 - 1 : 정상 ( 입력된 주민번호의 성명이 실명확인 DB의 성명과 일치 ) - 2 : 오류 ( 입력된 주민번호의 성명이 실명확인 DB의 성명과 불일치 ) ( 주민번호가 숫자가 아닌 경우, 주민번호가 13자리가 아닌 경우 ) ( 성명이 한글이 아닌 경우, 성명이 2~10자 아닌 경우 ) - 3 : 없음 ( 입력된 주민번호와 성명이 실명확인 DB에 없는 경우 ) - 4 : 주민번호오류 ( 입력된 주민번호의 조합이 오류인 경우:생년이 70년생이후인 경우만 ) - 5 : 시스템에러
1- ③, ④ 실명확인서비스 개발 가이드 (실명확인 sample 화면 및 소스) 주소 : http://name.siren24.com/name/name_sample.htm 위의 샘플 화면에는 주민번호 조합 check로직과 성인여부 check로직이 Script로 처리되어 있으니 필요하시면 참고 하시기 바랍니다. • 실명확인 고객센터 POP-UP 창에 대해서는 영업담당자와 협의하시기 바랍니다. 실명확인 요청 Sample 소스 <form action="https://name.siren24.com/servlet/name_check" method=post> <input type=hidden name=id value="회원사아이디(대문자)"> <input type=hidden name=ok_url value="실명확인 후 결과값을 전송 받을 프로그램 URL"> 주민번호 : <input type=text name=jumin1 size=6 maxlength=6> - <input type=text name=jumin2 size=7 maxlength=7> 이 름 : <input type=text name=name size=10 maxlength=20> <input type="submit" > </form>
1- ⑤ 실명확인서비스 개발 가이드 (실명확인 요청샘플 화면) 실명확인 요청샘플화면
실명확인 후 - 정상처리 샘플화면 ( 결과값 1에 해당 ) 회원가입 및 게시판 화면 1- ⑥ 실명확인서비스 개발 가이드 (실명확인 샘플화면) 실명확인 후 - 정상처리 샘플화면 ( 결과값 1에 해당 ) 회원가입 및 게시판 화면
실명확인 후 - 실명오류 샘플화면 ( 결과값 2 에 해당 ) 실명확인 후 - 실명확인불가화면 ( 결과값 3 에 해당 ) 1- ⑥ 실명확인서비스 개발 가이드 (실명확인 샘플화면) 실명확인 후 - 실명오류 샘플화면 ( 결과값 2 에 해당 ) 실명확인 후 - 실명확인불가화면 ( 결과값 3 에 해당 ) ☞ 실명확인 서비스를 이용하고 있는 일부 회원사중 실명확인서비스 제공자표시 및 실명확인이 되지 않는 개인에 대한 해 결방법에 관하여 안내가 되고있지 않습니다. 샘플화면과 같이 실명확인 실패에 대한 이유에 대해 개인들이 쉽게 이해할수 있도록 화면을 구성해 주시면 감사하겠습니다. (더 자세한 사항은 아래 팩스나 이메일을 통해 문의해 주시기 바랍니다.) SIREN24 고객센터 : http://www.siren24.com/siren24/sse/jsp/sse01s_j09.jsp (링크로 걸어주시기 바랍니다.) 팩스(FAX : 02-3449-1678) , 이메일(E-mail : credit@siren24.com, name@siren24.com)
실명확인 오류화면 삽입 문구 ( 결과값 4 해당 ) 실명확인 오류화면 삽입 문구 ( 결과값 5 해당 ) 1- ⑥ 실명확인서비스 개발 가이드 (실명확인 샘플화면) 실명확인 오류화면 삽입 문구 ( 결과값 4 해당 ) 실명확인 오류화면 삽입 문구 ( 결과값 5 해당 )
① http://www.bizsiren.com 에 접속후 회원 아이디와 비밀번호 입력후 로그인한다. 2- ① 인증서 설치 및 로그인(bizsiren 접속방법) ① http://www.bizsiren.com 에 접속후 회원 아이디와 비밀번호 입력후 로그인한다.
2-②, ③ 인증서 설치 ③ 인증서 ID및 이름을 확인후 확인버튼을 클릭한다. ② 로그인 후 인증센터에서 인증서발급 버튼을 클릭한다. (인증서를 발급 받았을 경우에는 인증서 login 버튼을 클릭한다. ③ 인증서 ID및 이름을 확인후 확인버튼을 클릭한다.
2- ④ , ⑤ 인증서 설치방법 ④ “인증서 암호”와 “인증서 암호 확인” 에 사용할 “인증서 암호”를 입력한다 2- ④ , ⑤ 인증서 설치방법 ④ “인증서 암호”와 “인증서 암호 확인” 에 사용할 “인증서 암호”를 입력한다 (인증서 암호는 숫자, 영문조합으로 8자리 이상을 입력한다.) ⑤ 발행된 인증서를 확인후 설치버튼을 클릭한다.
2- ⑥ 인증서 설치 및 로그인 ⑥ 인증서 발급결과 확인후 확인 버튼을 클릭한다. 2- ⑥ 인증서 설치 및 로그인 ⑥ 인증서 발급결과 확인후 확인 버튼을 클릭한다. ⑥ 인증서 발급결과 확인후 확인 버튼을 클릭한다. ⑦ 인증서 발급후 BIZSIREN 인증서 LOGIN 버튼을 클릭 인증서 암호를 입력후 확인버튼을 누른다.
3- ①, ② 실명확인 도메인 등록 신청 및 요청경로 추가/삭제,정보변경 ② 해당 기업회원명으로 등록된 승인도메인 및 경로확인 ◈ 승인된 도메인은 링크되어 있으므로 클릭시 해당 페이지로 자동연결 됩니다. ① 로그인 후 메인화면 좌측 하단에 실명확인 메뉴에서 도메인관리 메뉴를 클릭한다. ③ ④ ⑤ ⑥
3- ③ 실명확인 도메인 등록 신청 ③ 도메인 등록신청 메뉴 클릭후 등록할 도메인과 기타 정보를 입력후 신청버튼을 누른다. (등록된 도메인은 bizsiren 에서 승인절차 확인을거친후 처리되며 등록 처리된 도메인에 대해서는 웹마스터와 개발담당자 에게 메일로 통보해 드립니다.) ◈ 도메인 등록기준: 이차 도메인 및 포트번호가 붙는 경우 별도의 도메인으로 등록 합니다. Ex) http://www.siren24.com, http://name.siren24.com , http://www.siren24.com:8888 ,http://211.222.10.3 등은 모두 개별도메인으로 취급합니다.
3- ④, 요청경로 추가/삭제 ④ 등록신청한 도메인에대해 승인처리 확인후 해당 도메인에 대해 실명확인 요청경로 (실명확인 웹페이지 주소) 를 도메인 과 이용목적에 맞게 추가/삭제 할수있다. (도메인 경로추가시 해당경로를 정확히 입력후 경로추가 버튼을 클릭한다. 또한 등록된경로 또한 삭제버튼 클릭을통해 삭제할수 있다.) ◈ 경로기재 방법: 경로 추가시 “ / ” 는 자동으로 셋팅 되며, 등록된 경로는 변경할수 없으므로 오류등록시 삭제후 재 등록해 주시기 바랍니다. 또한 해당 도메인 및 등록된 경로는 모두 링크되어 있으므로 클릭시 해당 페이지로 자동 연결 되며, 경로 클릭시 실명확인 서비스가 시행되는 화면으로 자동 연결됩니다.
3- ⑤ ,⑥ 실명확인 도메인 삭제 및 정보변경 ⑤ 등록된 도메인중 삭제 요청시 삭제 요청사유를 등록후 확인 버튼을 누른다. (삭제 신청등록된 도메인은 bizsiren 에서 승인절차 확인을 거친후 처리되며 삭제 처리된 도메인에 대해서는 웹마스터와 개발담당자에게 메일로 통보해 드립니다.) ⑥ 등록된 도메인에 대한 기본정보 변경시 변경된 내용을 입력후 확인 버튼을 클릭한다. (수정된 내용으로 정상 등록 된다.).
① 로그인 후 좌측하단에 조회기록 열람 버튼을 누르고 조회기간을 선택한 후 해당 아이디를 클릭하여 조회한다. 4- ① 조회기록 열람방범 ① 로그인 후 좌측하단에 조회기록 열람 버튼을 누르고 조회기간을 선택한 후 해당 아이디를 클릭하여 조회한다. ② ③ ①
4- ② 등록 도메인별 실명확인 발생건수 확인 ② 회원사명 클릭시 등록된 도메인별 발생건수를 확인할수 있다
5 실명확인 요청 서비스 추가인증방식(IP인증,ID/비밀번호(SSL인증)) 실명확인 요청 화면 URL Check를 통해서 사전에 등록된 URL을 통한 요청인 경우만 서비스가 제공되고 있습니다. 하지만, 실명확인 요청 화면 URL Check 를 통한 인증방식이 아닌 IP인증 및 SSL을 이용할 경우에는 추가적으로 실명확인요청 Parameter 값을 추가해 주셔야 합니다. action URL : https://name.siren24.com/servlet/name_check 실명확인 요청 Parameter - id : 회원사 ID (대문자, 서울신용평가정보에서 부여, 연결 작업 시 통보) - pw : 회원사에게 발급된 pw (서울신용평가정보에서 부여, 연결 작업 시 통보) - service_no : SIREN24에 등록된 요청경로 번호(경로등록시 자동생성, ex : 001001) - ok_url : 실명확인 후 결과값을 전송 받을 프로그램 URL(회원사에서 개발) - jumin1 : 주민번호 앞자리(숫자 6자리) - jumin2 : 주민번호 뒷자리(숫자 7자리) - name : 성 명(한글2~10자리) -추가할 Parameter 값 < service_no : SIREN24에 등록된 요청경로 번호(경로등록시 자동생성, ex : 001001)>