quaxar-asm-seed-add-batch
입력 행의 시드 타입과 값 필드를 사용해 S2W 퀘이사(Quaxar) ASM 서비스에 신규 시드를 일괄 등록합니다.
문법
quaxar-asm-seed-add-batch profile=STRING
옵션
- profile=STRING
- 필수 옵션. QUAXAR 접속 프로파일 식별자. 쓰기 동작이므로 프로파일을 정확히 하나만 지정해야 합니다.
입력 필드
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| seed_type | 문자열 | Y | 등록할 시드 타입. IP, DOMAIN, CIDR. type 필드로 대체 가능 |
| type | 문자열 | N | seed_type이 없을 때 사용하는 대체 필드 |
| value | 문자열 | Y | 등록할 시드 값. 예: example.com, 192.0.2.0/24 |
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| result | 문자열 | 결과 | 등록 성공 시 OK |
| _error | 문자열 | 오류 | 등록 실패 시 실패 사유 (성공 시 미포함) |
오류 코드
파싱 오류
| 오류 메시지 | 원인 | 해결 |
|---|---|---|
| 퀘이사 프로파일 이름을 입력하세요. | profile 옵션 누락 | profile 옵션에 프로파일 코드 지정 |
| 배치 명령어는 프로파일을 하나만 지정해야 합니다. | profile을 둘 이상 지정 | 프로파일을 정확히 하나만 지정 |
| 사용 가능한 퀘이사 프로파일이 없습니다. | 등록된 퀘이사 접속 프로파일 없음 | 퀘이사 접속 프로파일을 먼저 등록 |
런타임 오류
행 단위 실패는 파이프라인을 중단하지 않고 해당 행의 _error 필드로 흘려보냅니다.
| 오류 메시지 | 원인 | 해결 |
|---|---|---|
| seed_type(type) or value field not found | 입력 행에 seed_type/type 또는 value 없음 | 두 필드를 모두 채워 입력 |
| quaxar asm api error: status=..., message=... | ASM API가 등록 요청에 오류 응답 | 시드 값 형식, 프로파일 권한 확인 |
설명
Caution
쓰기 명령어입니다. 입력 행마다 퀘이사 ASM에 신규 시드를 등록하며, 등록된 시드는 이후 스캔 대상이 됩니다. 실행 전 입력 파이프라인이 의도한 시드만 포함하는지 확인하세요.
quaxar-asm-seed-add-batch는 입력으로 들어온 각 행의 seed_type(없으면 type)과 value 필드를 읽어 신규 시드로 등록하는 배치 명령어입니다. 시드 타입 값은 대문자로 정규화되어 전송됩니다. 두 필드 중 하나라도 없으면 해당 행은 등록하지 않고 _error 필드에 사유를 담아 그대로 흘려보냅니다. 개별 행 실패가 전체 파이프라인을 중단시키지 않으므로, 실행 후 _error 필드로 실패 행을 선별할 수 있습니다.
쓰기 동작이므로 프로파일을 정확히 하나만 지정해야 합니다.
사용 예
예시: CSV 목록으로 시드 일괄 등록
상황: 신규 관리 대상 도메인·IP 대역 목록을 파일에서 읽어 퀘이사 ASM 시드로 한 번에 등록하려는 상황입니다.
예상 결과:
| seed_type | value | result |
|---|---|---|
| DOMAIN | example.com | OK |
| CIDR | 192.0.2.0/24 | OK |
결과 해석: result가 OK이면 등록에 성공한 행입니다. _error 필드가 채워진 행만 걸러 실패 원인을 확인하고 재시도할 수 있습니다.