콘텐츠로 이동

Direct API Integration

Direct API 연동은 애플리케이션이 코드에서 명시적으로 DADP 런타임을 호출하는 방식이다. Wrapper처럼 JDBC 경계를 자동 개입하는 모델이 아니라, 보호 시점과 대상 범위를 애플리케이션이 직접 결정한다.

연동 특성

  • 애플리케이션 서비스 코드에서 명시적 호출
  • helper 또는 공통 라이브러리 사용 가능
  • 호출 시점과 데이터 범위를 코드에서 직접 제어
  • 최종 실행은 Engine API를 사용

적합한 상황

  • 보호 범위가 JDBC 경계와 일치하지 않을 때
  • 요청 단위로 암복호화 시점을 세밀하게 통제해야 할 때
  • 애플리케이션이 이미 공통 라이브러리 중심 구조를 갖고 있을 때

운영상 주의점

  • 요청 본문 계약과 오류 처리를 애플리케이션이 책임진다.
  • 같은 애플리케이션 안에서도 어느 데이터가 Direct API를 타는지 기준이 명확해야 한다.
  • Hub 조회 경로와 Engine 실행 경로를 혼동하면 진단이 어려워진다.