출력 형식
Noir가 내보낼 수 있는 출력 형식: JSON, YAML, TOML, OpenAPI(OAS), SARIF, HTML 등.
스캔 결과는 다음 단계가 필요로 하는 모양 그대로 내보낼 수 있습니다. 자동화라면 기계가 읽는 형식으로, 리뷰라면 사람이 읽는 형식으로. -f 플래그로 형식을 고릅니다.
형식 선택 가이드
| 사용 사례 | 추천 형식 | 플래그 |
|---|---|---|
| 스크립트/도구 연동 | JSON | -f json |
| CI/CD 보안 리포팅 | SARIF | -f sarif |
| API 문서 생성 | OpenAPI | -f oas3 |
| 빠른 엔드포인트 테스트 | cURL / HTTPie / PowerShell | -f curl |
| 모바일 진입점 실행 | ADB (Android) / simctl (iOS) | -f adb / -f simctl |
| 사람이 읽기 쉬운 검토 | YAML | -f yaml |
| 설정 스타일 출력 | 기타 (TOML) | -f toml |
| Postman으로 가져오기 | 기타 (Postman Collection) | -f postman |
| 시각적 리포트 공유 | HTML | -f html |
| API 구조 시각화 | Mermaid | -f mermaid |
| URL이나 파라미터만 추출 | 기타 (필터) | -f only-url |
형식별 요청 본문 지원
모든 형식이 모든 param_type 을 와이어 본문으로 내리는 것은 아닙니다. 빠른 표입니다 (✅ = 요청 본문/multipart 파트로 출력, ➖ = 엔드포인트 기록에만 남거나 해당 없음):
param_type |
json / yaml / plain |
oas2 / oas3 |
postman |
curl / httpie / powershell / HTML copy-as-curl |
|---|---|---|---|---|
json |
✅ (타입 필드) | ✅ application/json |
✅ raw JSON | ✅ JSON 본문 |
form |
✅ (타입 필드) | ✅ urlencoded 또는 multipart | ✅ urlencoded |
✅ urlencoded 본문 |
file |
✅ (타입 필드) | ✅ multipart format: binary |
✅ formdata file |
✅ multipart 업로드 |
xml |
✅ (타입 필드) | ✅ application/xml |
✅ raw XML (비어 있으면 <name/>) |
➖ 명령에 본문으로 넣지 않음 — OAS / Postman / JSON 사용 |
자세한 내용: cURL, OpenAPI, Postman.
사용 가능한 형식
- HTTP 클라이언트 명령: 엔드포인트 테스트용 cURL, HTTPie, PowerShell 명령. 모바일 딥링크·인텐트·콘텐츠 프로바이더를 실행하는 ADB(Android)·simctl(iOS) 명령도 만들어 줍니다.
- JSON 및 JSONL: 다른 도구나 스크립트로 파이프할 때.
- YAML: 사람이 직접 훑어볼 때 JSON보다 읽기 편한 형식.
- OpenAPI 명세(OAS): 코드에서 생성한 OpenAPI 문서. API 문서화나 보안 도구 임포트에 사용.
- SARIF: CI/CD 보안 대시보드가 받아들이는 표준 형식.
- HTML 리포트: 단일 파일로 완결되는 인터랙티브 HTML 리포트.
- Mermaid 차트: API 구조 다이어그램.
- 추가 형식: TOML, JSONL, Postman 컬렉션, 마크다운 테이블, 출력 필터.