설치 매뉴얼
Note
KISA WHOIS 앱은 2026년 6월 30일 기준, 공공데이터포털에서 제공하는 KISA WHOIS OpenAPI 서비스를 기반으로 개발 됐습니다.
개요
공공데이터포털에서 제공하는 KISA WHOIS OpenAPI 서비스를 통해 한국인터넷진흥원이 관리하는 한국 도메인(.kr, .한국), IP 주소, ASN의 등록 및 할당 정보를 조회합니다. 쿼리 명령어를 사용하기 위해 공공데이터포털에서 인증키를 발급받고, 로그프레소에 접속 프로파일을 등록해야 합니다.
적용 범위
Note
소나 4.0.2308.0 이상, KISA WHOIS API v1.0에서 동작합니다. 공공데이터포털 OpenAPI 개발계정이 필요합니다.
요구 사항
| 항목 | 요구사항 | 비고 |
|---|---|---|
| 외부 서비스 계정 | 공공데이터포털(data.go.kr) 회원 계정 | 무료 회원가입 |
| 발급 필요 자격증명 | KISA WHOIS OpenAPI 일반 인증키 (서비스 키) | 공공데이터포털 마이페이지에서 발급 |
| 네트워크 허용 | HTTPS/443 (소나 → apis.data.go.kr, Outbound) | 방화벽 정책 반영 필요 |
| 일일 호출 제한 | 엔드포인트당 10,000건/일 | 개발계정 기준. 운영계정은 활용사례 등록 시 증가 가능 |
공공데이터포털 설정
Note
공공데이터포털에서 KISA WHOIS API 인증키를 발급합니다. 이 단계가 누락되면 로그프레소에서 WHOIS 조회를 실행할 수 없습니다.
단계 1: 회원가입
공공데이터포털 계정이 없다면 회원가입 페이지에서 가입 후 진행합니다.
단계 2: 인증키 발급
-
공공데이터포털에 로그인합니다.
-
KISA WHOIS OpenAPI 상세 페이지에서 활용신청 버튼을 클릭합니다.
- OpenAPI 개발계정 신청 화면에서 활용목적을 입력하고 상세기능정보를 선택한 뒤 신청 버튼을 클릭합니다.
- 마이페이지 > 데이터 활용 > 개발계정 상세보기에서 발급된 일반 인증키를 확인합니다. 이 인증키를 로그프레소 접속 프로파일의 서비스 키에 입력합니다.
Tip
인증키는 신청 즉시 자동 승인됩니다. 활용기간은 2년이며, 만료 전 갱신할 수 있습니다.
로그프레소 접속 프로파일 설정
접속 프로파일 추가
시스템 > 접속 프로파일에서 추가를 클릭하고 아래 값을 입력합니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 이름 | 접속 프로파일을 식별할 고유한 이름 |
| 필수 | 식별자 | 로그프레소 쿼리 등에서 사용할 접속 프로파일의 고유 식별자 (예: kisa_whois) |
| 필수 | 유형 | KISA WHOIS 선택 |
| 필수 | 서비스 키 | 공공데이터포털 마이페이지에서 발급받은 일반 인증키 |
| 선택 | HTTP 프록시 | 호스트:포트 (프록시 사용 환경에서만 입력) |
| 선택 | 연결 타임아웃 (초) | 기본값: 30 |
| 선택 | 읽기 타임아웃 (초) | 기본값: 60 |
설치 후 검증
아래 쿼리로 접속 프로파일이 올바르게 설정되었는지 확인합니다.
- 정상: 도메인 등록정보(등록인, 등록일, 만료일, 네임서버 등)가 조회됩니다.
- 비정상: 에러 발생 시 접속 프로파일의 서비스 키, 네트워크 도달(HTTPS/443 → apis.data.go.kr)을 재확인합니다.