설치 매뉴얼
사전 요구 사항
접속 프로파일을 생성하기 전에 대상 REST API의 엔드포인트 URL과 인증 정보를 준비하세요.
프로파일 설정
http 타입의 접속 프로파일을 생성하고 다음 항목을 설정하세요:
| 설정 항목 | 필수 | 설명 |
|---|---|---|
| 엔드포인트 | O | Base URL (예: https://api.example.com) |
| 인증 방식 | O | 인증 유형: Bearer, Basic, None 중 선택 |
| 토큰 | 조건부 | Bearer 토큰 또는 API 키. 인증 방식이 Bearer일 때 필수 |
| 헤더명 | X | 인증 헤더명 (예: X-API-Key). 미지정 시 Authorization: Bearer {token} 사용 |
| 사용자명 | 조건부 | 사용자명. 인증 방식이 Basic일 때 필수 |
| 비밀번호 | 조건부 | 비밀번호. 인증 방식이 Basic일 때 필수 |
| HTTP 프록시 | X | HTTP 프록시 (IP:PORT 형식) |
| 접속 타임아웃 | X | 접속 타임아웃 초 (기본값: 30) |
| 읽기 타임아웃 | X | 읽기 타임아웃 초 (기본값: 30) |
| TLS 검증 | X | TLS 인증서 검증 여부 (기본값: false) |
토큰과 비밀번호는 암호화하여 저장됩니다.
인증 방식별 설정 예시
Bearer (기본 헤더)
헤더명을 지정하지 않으면 Authorization: Bearer {token} 헤더를 전송합니다. GitHub, Slack, OpenAI 등에 적합합니다.
| 설정 항목 | 값 |
|---|---|
| 엔드포인트 | https://api.github.com |
| 인증 방식 | Bearer |
| 토큰 | ghp_xxxxxxxxxxxx |
Bearer (커스텀 헤더)
헤더명을 지정하면 {header_name}: {token} 헤더를 전송합니다. AbuseIPDB(Key), VirusTotal(x-apikey) 등에 적합합니다.
| 설정 항목 | 값 |
|---|---|
| 엔드포인트 | https://api.abuseipdb.com |
| 인증 방식 | Bearer |
| 토큰 | your-api-key |
| 헤더명 | Key |
Basic
Authorization: Basic base64(username:password) 헤더를 전송합니다. Jira, Zendesk 등에 적합합니다.
| 설정 항목 | 값 |
|---|---|
| 엔드포인트 | https://your-instance.atlassian.net |
| 인증 방식 | Basic |
| 사용자명 | user@example.com |
| 비밀번호 | your-api-token |
None
인증 헤더를 추가하지 않습니다. CISA KEV 등 공개 API에 적합합니다.
| 설정 항목 | 값 |
|---|---|
| 엔드포인트 | https://www.cisa.gov |
| 인증 방식 | None |