방화벽 및 보안
aicon API 연동 시 필요한 네트워크 및 보안 요구사항을 설명합니다.
HTTPS 필수
프로덕션 환경에서는 HTTPS 요청만 허용됩니다. HTTP로 요청하면 403 에러가 반환됩니다.
{
"status": 403,
"code": "COMMON_HTTPS_REQUIRED",
"message": "HTTPS 요청만 허용됩니다."
}
테스트 환경
로컬 개발 환경에서는 HTTP 요청이 허용될 수 있지만, 프로덕션 연동 전 반드시 HTTPS로 전환하세요.
API 엔드포인트
| 환경 | 엔드포인트 |
|---|---|
| 프로덕션 | https://api.aiconbiz.kr |
모든 API 요청은 위 도메인으로 전송합니다.
방화벽 설정
고객사 → aicon (API 요청)
고객사 서버에서 aicon API로의 아웃바운드 요청을 허용해야 합니다.
| 항목 | 값 |
|---|---|
| 도메인 | api.aiconbiz.kr |
| 포트 | 443 (HTTPS) |
| 프로토콜 | TCP |
허용 IP (선택)
API 키마다 호출할 수 있는 IP를 제한할 수 있습니다. 키가 유출되더라도 등록한 서버 밖에서는 쓸 수 없게 하는 설정입니다. 콘솔의 API > 키 관리에서 키마다 IP 관리 버튼을 눌러 설정합니다(테스트·라이브 따로).
| 항목 | 값 |
|---|---|
| 형식 | IPv4 주소(203.0.113.10) 또는 대역(203.0.113.0/24) |
| 대역 크기 | /24 ~ /32 (대역의 시작 주소로 입력) |
| 개수 | 키 하나에 최대 30개 |
- 호출하는 서버의 공인(외부) IP를 등록하세요. NAT·프록시 뒤라면 나가는 쪽 IP입니다
- 목록에 없는 IP에서 호출하면
403 AUTH_IP_NOT_ALLOWED가 반환됩니다 — 허용 IP로 인한 거절 - 설정을 바꾸면 최대 5분 뒤 반영됩니다
- 제한을 꺼도 목록은 남아 있고, 키를 재발급해도 새 키로 그대로 이어집니다
aicon 아웃바운드 IP
aicon은 NAT Gateway를 사용하며, 모든 아웃바운드 요청은 고정 IP 16.184.63.61에서 발신됩니다.