kisa-whois-asn
KISA WHOIS 서비스에서 KRNIC이 관리하는 ASN의 등록·할당 정보를 조회합니다.
문법
kisa-whois-asn asn=STRING [profile=STRING] [locale=STRING]
옵션
- asn=STRING
- 필수 옵션. 조회 대상 ASN. 예:
AS9700 - profile=STRING
- 선택 옵션. KISA WHOIS 접속 프로파일 식별자. 미지정 시 등록된 모든 KISA WHOIS 프로파일을 순회하며 각각 한 건씩 조회합니다. 예:
kisa_whois - locale=STRING
- 선택 옵션. 출력 언어.
ko또는en만 허용합니다. 해외 ASN은 레지스트리·국가 코드만 반환됩니다. (기본값:ko)
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| profile | 문자열 | 프로파일 | 조회에 사용된 접속 프로파일 식별자 |
| registry | 문자열 | 관리 기관 | 자원을 관리하는 레지스트리. 예: KISA |
| country | 문자열 | 국가 코드 | ISO 2 국가 코드. 예: KR |
| asn | 문자열 | ASN | ASN. 예: AS9700 |
| as_name | 문자열 | AS 이름 | AS 이름 |
| org_name | 문자열 | 할당기관 | AS 할당 기관명 |
| org_address | 문자열 | 할당기관 주소 | AS 할당 기관 주소 |
| org_postal_code | 문자열 | 할당기관 우편번호 | AS 할당 기관 우편번호 |
| tech_name | 문자열 | 담당자 | 기술 담당자 이름 |
| tech_phone | 문자열 | 담당자 전화번호 | 기술 담당자 전화번호 |
| tech_email | 문자열 | 담당자 이메일 | 기술 담당자 이메일. 예: user@example.com |
오류 코드
파싱 오류
| 오류 메시지 | 원인 | 해결 |
|---|---|---|
| 조회 대상 옵션(domain, ip, asn)을 입력하세요. | asn 옵션 누락 또는 빈 값 | asn= 에 조회할 ASN 지정 |
| 유효하지 않은 locale 입니다. 'ko' 또는 'en'을 사용하세요. | locale 값이 ko/en 이 아님 | locale=ko 또는 locale=en 지정 |
| 사용 가능한 KISA WHOIS 프로파일이 없습니다. | (profile 미지정 시) 등록된 프로파일 없음 | KISA WHOIS 접속 프로파일을 먼저 등록 |
| KISA WHOIS 프로파일 이름을 입력하세요. | 지정한 profile 식별자가 존재하지 않음 | 올바른 프로파일 식별자 지정 |
런타임 오류
런타임 오류 발생 시 쿼리가 중단됩니다. 메시지는 kisa-whois-asn error: 접두사와 함께 표시됩니다.
| 오류 메시지 | 원인 | 해결 |
|---|---|---|
| KISA WHOIS API daily quota exceeded - 일일 호출 제한을 초과하였습니다. | 공공데이터포털 일일 호출 한도 초과 | 다음 날까지 대기하거나 한도 상향 신청 |
| KISA WHOIS API rate limit exceeded - 호출 속도 제한을 초과하였습니다. ... | 단시간 과다 호출로 속도 제한 | 잠시 후 재시도 |
| service_key is not configured for profile: <프로파일> | 프로파일에 service_key 미설정 | 프로파일에 공공데이터포털 인증키 설정 |
| KISA WHOIS API error (<코드>): <메시지> | API가 오류 코드 반환 | 메시지 확인 후 입력값·인증키 점검 |
설명
이 명령어는 공공데이터포털(data.go.kr)이 제공하는 KISA WHOIS OpenAPI(/B551505/whois/as_number)를 호출하여 KRNIC이 관리하는 ASN의 등록·할당 정보를 조회합니다. 호출당 ASN 한 건을 조회해 결과 레코드 한 건을 출력합니다.
locale 값에 따라 AS 이름·기관·담당자 명칭이 한국어/영문으로 반환됩니다. KRNIC 관리 대상이 아닌 해외 ASN은 registry·country 만 채워지고 나머지 필드는 비어 있습니다. profile 옵션을 생략하면 등록된 모든 프로파일을 순회 조회하며, 결과 레코드마다 사용한 프로파일 식별자가 profile 필드에 담깁니다. 공공데이터포털 인증키 단위로 일일 호출 한도·속도 제한이 적용됩니다.
여러 ASN을 한 번에 조회하려면 kisa-whois-asn-batch 명령어를 사용하세요.
사용 예
예시: 출발지 ASN의 운영 기관 확인
상황: 위협 인텔리전스에서 확보한 ASN의 운영 기관과 기술 담당자 정보를 확인합니다.