Restful API

Documentation Index

Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt

Use this file to discover all available pages before exploring further.

​

1. 문서 개요

​

1.1 목적

Argos Identity가 제공하는 Restful API (UI 미포함, 서버-서버 통신 방식)의 네트워크 통신 구조와 데이터 보안 정책을 정리한 자료입니다.

​

1.2 대상 독자

• 고객사의 정보보호·보안 검토 담당자
• API 통합을 진행하는 백엔드 개발팀
• 컴플라이언스 / 감사 부서

​

1.3 범위

• 고객사 서버 → Argos API 의 통신 구조
• TLS, 인증, 권한 부여, 페이로드 보안
• 멀티테넌트 격리, 감사, 컴플라이언스

---

​

2. 서비스 카테고리 소개

Restful API는 Argos가 제공하는 4종 카테고리 중 하나로, UI 없이 고객사 서버가 직접 호출하는 Server-to-Server API 입니다.

​

2.1 주요 특징

• 표준 REST 규약 (GET / POST / PATCH / DELETE)
• JSON 기반 요청/응답
• 회사 자체 커스텀 도메인 + ACM 발급 TLS 인증서
• 프로젝트 단위 API Key 발급 및 검증

​

2.2 적용 사례

• 고객사가 자체 UI를 운영하면서 KYC 결과 데이터만 Argos로부터 조회·관리
• 백오피스/관리 도구에서 KYC 제출 데이터를 일괄 조작
• 외부 데이터 연동 (마이그레이션, 동기화)

​

2.3 주요 엔드포인트 예시

(전체 엔드포인트 명세는 별도 API 문서 참조)

---

​

3. 네트워크 통신 흐름

​

3.1 호출 구조

​

3.2 통신 단계

---

​

4. 통신 프로토콜 및 규약

​

4.1 전송 계층

• TLS 1.2 이상 강제 (API Gateway 보안 정책)
• AWS Certificate Manager (ACM) 발급 인증서 사용 (자동 갱신)
• Argos 자체 도메인 (Route 53 관리)

​

4.2 HTTP 요청 형식

​

4.3 필수 요청 헤더

---

​

5. 데이터 암호화

​

5.1 전송 중 (필수)

• HTTPS / TLS 1.2+ 강제
• TLS 종료는 AWS API Gateway가 담당
• API Gateway → 핸들러 구간도 AWS 내부 TLS

​

5.2 페이로드 암호화 (옵션, 프로젝트별 활성)

민감 데이터를 추가 보호하려는 고객사는 다음 옵션을 활성화할 수 있습니다.

​

5.3 저장 시

• 모든 데이터는 DynamoDB 서버측 암호화
• 민감 식별 필드는 AES-256 + AWS KMS Customer-managed Key 로 애플리케이션 계층 추가 암호화
• 객체 스토리지(이미지)는 AWS S3 SSE-KMS 로 암호화

---

​

6. 인증 및 인가

​

6.1 1차 인증 — API Gateway API Key

모든 Restful API 호출은 AWS API Gateway 단계에서 API Key 검증을 통과해야 서버리스 핸들러까지 도달할 수 있습니다.

​

6.2 2차 인증 (옵션) — IP 화이트리스트

추가 보안이 필요한 프로젝트는 IP Allowlist 를 활성화할 수 있습니다.

• 프로젝트별 허용 IP 범위 등록
• AWS Lambda Authorizer 가 클라이언트 IP를 화이트리스트와 대조
• 불일치 시 IAM Deny Policy 반환 → API Gateway가 거부
• 화이트리스트가 비어 있으면 IP 제한 없음 (API Key만으로 인증)

​

6.3 API Key 관리 권장 사항

• API Key는 절대 클라이언트(브라우저, 모바일 앱)에 노출하지 말 것
• 서버 측 비밀(Secret) 저장소(AWS Secrets Manager 등)에 보관
• 누출 의심 시 Argos에 즉시 통보 후 재발급 요청

---

​

7. 무결성 및 위·변조 방지

---

​

8. 접근 통제 및 격리

​

8.1 네트워크 계층

• 외부 진입점은 AWS API Gateway 만으로 한정 (서버리스 핸들러는 외부 직접 도달 불가)
• API Gateway는 AWS 관리형 DDoS 보호(AWS Shield Standard) 자동 적용

​

8.2 환경 분리

• Live / Test 환경 API 분리 (별도 API Key, 별도 도메인, 별도 데이터)
• 환경 간 데이터 이동은 명시적 마이그레이션 절차로만 수행

​

8.4 Rate Limiting

• AWS API Gateway Usage Plan 으로 API Key 별 호출 한도 설정
• Burst / Quota 단위로 호출 제어
• 한도 초과 시 429 Too Many Requests 응답

---

​

9. 컴플라이언스

​

9.1 Argos Identity 보유 인증

• ISO/IEC 27001 — 정보보호관리체계 국제표준 인증

​

9.2 AWS 인프라 인증 (상속)

Restful API 인프라(AWS API Gateway, Lambda, DynamoDB, Route 53, ACM, CloudFront 등)는 다음 인증을 상속합니다:

• SOC 1 / SOC 2 / SOC 3
• ISO 27001 / 27017 / 27018
• PCI-DSS Level 1
• HIPAA Eligible
• FedRAMP Moderate

​

9.3 데이터 주체 권리 대응

• 개인정보 보호법 / GDPR 기반 데이터 주체 권리 요청(열람·정정·삭제·이전) 대응 절차 운영
• DELETE 엔드포인트는 제출 데이터의 개인정보 영구 삭제

---

​

부록 A. 용어 정리

---

​

부록 B. 문의

본 문서에 대한 기술적 질의는 Argos Identity 영업/기술 지원 채널로 연락주시기 바랍니다.