WHOIS Open API 사용키 발급받기

안녕하세요. 언제나 휴일의 언휴예요.

개발을 하거나 시스템을 관리하다 보면 https://ehpub.co.kr과 같은 도메인 이름의 소유자가 누구이며 웹 서버가 어디에 위치하고 IP 주소는 무엇인지 등을 궁금해 할 때가 있습니다. 이러한 정보는 KISA(한국인터넷진흥원)에서 WHOIS 서비스를 사용하면 확인할 수 있습니다.

[그림 1] WHOIS 서비스에서 ehpub.co.kr 도메인 정보 조회 결과

그리고 WHOIS 서비스는 프로그램 방식으로 접근할 수 있게 Open API를 제공하고 있어요. 여기에서는 WHOIS Open API 서비스를 사용하기 위해 필요한 API 인증키 발급신청 방법을 알아볼게요.

먼저 KISA(한국인터넷진흥원)의 웹 사이트 주소는 https://whois.kisa.or.kr 입니다. 현재(2018년 6월) 메인 화면에서는 도메인 주소 검색 및 WHOIS OpenAPI를 선택할 수 있어요. 앞에서 도메인 검색 결과 화면을 보았는데 여러분도 한 번 실험해 보세요.

그리고 여기에서 실질적인 실습을 위해 WHOIS OpenAPI를 선택하세요.

[그림 2] KISA 홈에서 도메인 검색 및 WHOIS Open API

WHOIS OpenAPI 서비스 웹 페이지에서 서비스를 사용하기 위해 필요한 키를 발급받을 수 있어요. 사용할 이의 이메일 주소와 사용목적 및 동의 체크박스를 설정 후에 발급신청 버튼을 누르세요.

[그림 3] WHOIS OpenAPI 사용 키 발급신정

등록에 사용한 이메일 계정에 도착한 메일을 확인하세요. 사용할 키와 인증페이지 URL을 포함한 내용을 확인할 수 있어요. 키를 복사하여 인증페이지 URL로 이동하세요.

[그림 4] 이메일에 도착한 사용 키 확인 및 인증 페이지로 이동하기

이동한 페이지에 복사한 사용 키를 입력하여 등록 버튼을 누르면 인증 받을 수 있어요.

[그림 5] 사용 키 등록하여 인증받기

정상적으로 등록하면 다음과 같은 화면을 볼 수 있어요.

[그림 6] 인증 완료 화면

 그리고 같은 화면에 Open API 서비스를 사용할 때 사용할 요청 URL과 인자로 전달할 요청 변수에 관해 나오고 있어요.

요청 URL은 크게 인터넷주소 검새요청 URL과 IP주소/AS번호 국가코드 검색요청 URL로 나눌 수 있고 요청한 결과를 XML 방식 혹은 JSON 방식으로 선택할 수 있습니다.

그리고 요청 변수에는 query와 key, answer가 있어요. 예를 들어, ehpub.co.kr에 관한 인터넷주소 검색요청 URL을 XML방식으로 질의한다면 다음처럼 URL과 요청 변수를 취합하여 쿼리 문자열을 사용합니다.

http://whoid.kisa.or.kr/openapi/whois.jsp?query=ehpub.co.kr&key=발급받은Key값&answer=xml

[그림 7] 검색 요청 URL 및 요청 변수

다음은 웹 브라우저에 쿼리 문자열을 입력하여 WHOIS OpenAPI를 xml 방식으로 검색 요청하였을 때의 결과 화면입니다.

[그림 8] WHOIS OpenAPI 쿼리 문자열 실행 결과