Direct API Integration¶
Direct API 연동은 애플리케이션이 코드에서 명시적으로 DADP 런타임을 호출하는 방식이다. Wrapper처럼 JDBC 경계를 자동 개입하는 모델이 아니라, 보호 시점과 대상 범위를 애플리케이션이 직접 결정한다.
연동 특성¶
- 애플리케이션 서비스 코드에서 명시적 호출
- helper 또는 공통 라이브러리 사용 가능
- 호출 시점과 데이터 범위를 코드에서 직접 제어
- 최종 실행은 Engine API를 사용
적합한 상황¶
- 보호 범위가 JDBC 경계와 일치하지 않을 때
- 요청 단위로 암복호화 시점을 세밀하게 통제해야 할 때
- 애플리케이션이 이미 공통 라이브러리 중심 구조를 갖고 있을 때
운영상 주의점¶
- 요청 본문 계약과 오류 처리를 애플리케이션이 책임진다.
- 같은 애플리케이션 안에서도 어느 데이터가 Direct API를 타는지 기준이 명확해야 한다.
- Hub 조회 경로와 Engine 실행 경로를 혼동하면 진단이 어려워진다.