taxii-discovery
TAXII 2.x 서버에 Discovery 요청을 보내 API 루트 목록을 포함한 서버의 일반 정보를 조회합니다. 접속 프로파일에 설정된 TAXII 서버 엔드포인트에 연결하여 서버 정보를 가져옵니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 사용자 권한 |
| 라이선스 사용량 | 라이선스 집계와 무관한 명령어 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
taxii-discovery [profile=profile_name]
옵션
profile=profile_name- 사용할 TAXII 접속 프로파일 이름입니다. 쉼표로 구분하여 여러 프로파일을 지정할 수 있습니다. 생략하면 등록된 TAXII 프로파일 중 사용 가능한 것을 자동으로 선택합니다.
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| profile | 문자열 | 접속 프로파일 이름 |
| title | 문자열 | TAXII 서버 제목 |
| description | 문자열 | TAXII 서버 설명 |
| contact | 문자열 | TAXII 서버 관리자 연락처 |
| api_roots | 배열 | 서버에서 제공하는 API 루트 URL 목록 |
| _error | 문자열 | 오류 발생 시 오류 메시지 |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 201800 | No available TAXII profile found. | 사용 가능한 TAXII 프로파일이 없는 경우 |
| 201801 | Specify valid TAXII profile. | 지정한 TAXII 프로파일 이름이 유효하지 않은 경우 |
설명
TAXII Discovery 엔드포인트에 요청을 보내 서버에서 제공하는 API 루트 목록과 서버의 일반 정보를 가져옵니다. profile 옵션을 생략하면 등록된 TAXII 타입 접속 프로파일 중 사용 가능한 프로파일 전체를 대상으로 조회하여 프로파일별로 각각 한 건의 레코드를 출력합니다. 오류가 발생하면 해당 레코드의 _error 필드에 오류 메시지가 기록됩니다.
사용 예
-
TAXII 서버 일반 정보 조회
taxii-discovery profile="my-taxii"my-taxii접속 프로파일을 사용하여 TAXII 서버의 Discovery 정보를 조회합니다.
호환성
taxii-discovery 명령어는 소나 4.0 이전 버전부터 제공되었습니다.