환경변수 경계

이 페이지는 Billing Authority·Integrations API를 채택할 때의 변수 이름과 소유 경계를 설명합니다. 모든 제품이 이 변수를 가져야 하는 것은 아닙니다. 실제 값은 문서, 이슈, 채팅, 저장소에 남기지 않습니다.

제품 서버

LEYSYS_CONTROL_PLANE_URL=https://control.example.invalid
LEYSYS_CONTROL_PLANE_SERVICE_TOKEN=replace-in-secret-store
LEYSYS_INTEGRATIONS_URL=https://integrations.example.invalid
LEYSYS_INTEGRATIONS_SERVICE_TOKEN=replace-in-secret-store

예시는 의도적으로 .invalid 도메인과 가상 값만 사용합니다. 실제 endpoint와 token은 승인된 secret store에서 주입합니다.

제품별로 필요한 서비스 변수만 둡니다. 결제만 쓰는 제품에 integrations credential을 배포하지 않습니다.

브라우저·모바일 공개 환경변수

다음 형태로 service token을 만들지 않습니다.

VITE_LEYSYS_CONTROL_PLANE_SERVICE_TOKEN
NEXT_PUBLIC_LEYSYS_INTEGRATIONS_SERVICE_TOKEN
NUXT_PUBLIC_PROVIDER_SECRET

브라우저는 제품 server의 인증된 endpoint를 통해 checkout을 시작하거나 자신의 entitlement를 조회합니다.

승인된 실행 주체 전용

PG secret, webhook credential, Barobill/Popbill key, provider connection, service-role key는 승인된 실행 주체의 secret store에만 둡니다. 중앙 서비스를 채택하면 해당 서비스가, 제품 소유 adapter를 채택하면 해당 제품 서버가 소유합니다. 실제 변수 이름과 주입 방법은 소유 런타임의 배포 문서가 정하며 이 사이트가 회사 전체의 provider별 환경변수를 만들지 않습니다.

로그

• token, authorization header, billing key를 기록하지 않습니다.
• provider 원문을 제품 로그에 기록하지 않습니다.
• account ID와 document ID는 운영상 필요한 최소 범위에서 pseudonymization 정책을 적용합니다.
• idempotency key와 operation ID는 감사 추적이 가능하도록 보존하되 접근을 제한합니다.