IOSOR 가이드
API 임베딩 대 화이트 레이블 파트너 포털 비교
메시징을 임베딩하는 SaaS 제품은 ISV 서피스에 유지됩니다. 화이트 레이블 파트너 포털은 Partner 아래에 유지되며, 브랜드, 키, 운영 소유권을 혼합하지 마십시오.
SaaS 제품이 메시징 기능을 직접 임베딩할 때 최종 사용자는 IOSOR 콘솔을 전혀 열지 않습니다. 사용자는 ISV UI 내부에서 Send를 클릭하며, ISV가 API 키, 웹훅 및 선불 지갑을 소유합니다. 이 경로가 임베딩(Embed) 방식입니다. 반면 화이트 레이블 파트너 포털은 다릅니다. 파트너 관리자는 Partner 서피스에서 작업하며, 브랜드가 노출되지 않는 UI, 테넌트 격리 및 상위 레일 명칭을 절대 유출하지 않는 게이트를 사용합니다.
많은 팀이 두 개념을 혼동합니다. ISV 소개 자료에 파트너 포털 캡처 화면을 넣거나, SaaS 제품 내부에서 IOSOR 스타일의 오류 메시지를 노출하는 경우가 이에 해당합니다. 임베딩은 귀사의 제품이 고객에게 보이는 유일한 화면임을 의미합니다. 파트너 포털은 리셀러를 위한 브랜드화된 포털로, 동일하게 화이트 레이블이 적용되고 격리되어 있지만 소유권 매핑이 다릅니다. 첫 번째 주에는 단 하나의 화면을 선택하십시오.
임베딩을 통한 SaaS 제품 내 메시징 유지
임베딩 구조는 API 키, 이뎀포턴시(Idempotency) 키, 웹훅 수신기를 ISV 엔지니어링 조직 하위에 배치합니다. 최종 사용자의 작업은 ISV 선불 지갑을 사용하는 서버 측 전송으로 매핑됩니다. SaaS UI는 대기 중, 전송됨, 실패와 같은 제품 자체 상태만 표시하며, 상위 인프라 브랜드를 노출하거나 고객에게 두 번째 콘솔 로그인을 요구하지 않습니다.
프로덕션 키를 보관하는 마이크로서비스를 명확히 문서화하십시오. 키 교체는 ISV의 주기적인 절차에 따릅니다. 제품 팀이 지원 목적으로 파트너 포털 형태의 조회를 요청하더라도 서피스 게이트 원칙에 따라 거절해야 합니다. 해당 요청은 Partner 서피스에 속하며 SaaS 내부의 단축키로 처리되어서는 안 됩니다.
파트너 포털은 별도의 화이트 레이블 서피스로 유지
파트너 포털은 하위 테넌트, 수익 배분, 브랜드 안전 내보내기를 관리하는 리셀러 관리자를 위해 제공됩니다. 화면은 Partner 서피스 게이트를 엄격히 준수합니다. 알림 메시지, API 오류, 웹훅, CSV 열 이름에 상위 브랜드가 노출되지 않습니다. 라이브 카탈로그는 운영 볼트와 일치합니다. 파트너 관리자는 ISV의 최종 사용자가 아닙니다.
속도를 높이기 위해 파트너 포털을 SaaS 제품 내부에 iframe으로 삽입하지 마십시오. 이는 신뢰 모델을 혼합하고 운영 상태 언어를 유출시킵니다. Partner 작업은 독립된 URL과 전용 권한 아래에 유지하십시오.
소유권 분리: 제품 화면 대 파트너 화면
| 결정 항목 | 임베딩 (Embed) | 파트너 포털 |
|---|---|---|
| UI 대상 | ISV 최종 사용자 | 파트너 관리자 |
| 키 보관 위치 | ISV 시크릿 | 운영 볼트 |
| 브랜드 언어 | SaaS 제품 문구 | 화이트 레이블 문구 |
| 지갑 소유자 | ISV 선불 계정 | 동일 계정 또는 격리 |
| 접근 제어 게이트 | 개발자 런칭 습관 | 파트너 서피스 게이트 |
이 비교표를 런칭 티켓에 게시하십시오. 영업 팀은 지정된 담당자가 확정되기 전에 첫 주부터 두 가지 화면을 모두 제공하겠다고 약속해서는 안 됩니다.
브랜드 경로가 혼합된 하이브리드 데모 거부
SaaS 전송 버튼과 파트너 포털 캡처 화면을 한 슬라이드에 함께 배치하면 구매자에게 잘못된 기대감을 주게 됩니다. 구매자가 애플리케이션에 일회용 비밀번호(OTP)를 임베딩하려는 경우, 임베딩 경로만 데모하고 Partner 관련 문서는 참고용으로만 제공하십시오.
관련 운영 경로
IOSOR로 시작하기
콘솔의 ISV 보안 볼트에서 제품 웹훅 수신기를 구성하고, API 키는 백엔드 서버에만 엄격하게 보관하십시오. 리셀러 관리자 권한을 부여하기 전에 파트너 인터페이스 관문을 적용하여 상위 브랜드가 DLR 페이로드나 CSV 내보내기에 유출되지 않도록 하십시오. 스테이징 환경과 프로덕션 환경 모두에서 제품 화면과 파트너 화면을 분리하여 유지하십시오.
IOSOR 핵심 요약
API를 통해 메시징을 내장하면 엔드유저 트래픽과 상태 정보가 개발팀의 서버 사이드 키를 기반으로 SaaS 제품 UI 내에 완전히 유지됩니다. 동시에, 화이트라벨 파트너 포털은 리셀러 관리자가 상위 인프라 세부 정보를 노출하지 않고 하위 테넌트 구조, 요금 배포, 브랜드 격리 내보내기를 관리하는 용도로만 존재합니다.
API 키, 웹훅 수신기, 상태 렌더링을 기본 제품 코드베이스 내부에 격리하십시오. 하이브리드 영업 데모를 시연하거나 파트너 관리 화면을 제품 네이티브 메시징 흐름과 혼합하지 마십시오. 이러한 경계를 모호하게 만들면 브랜드가 유출되고 테넌트 거버넌스가 어긋나게 됩니다.
이 가이드가 도움이 되었나요?
관련 가이드
- 최종 사용자 전송은 여전히 단일 선불 원장에서 차감됩니다
임베디드 전송은 여전히 ISV 선불 지갑을 차감합니다. 제품이 자금을 지원하지 않는 두 번째 원장을 만들지 마세요. 보류, 재시도, 멱등성은 정직하게 유지되어야 합니다.
- 임베디드 테넌트 한도 초과 시 전송을 즉시 중단해야 하는 이유
ISV 제품 내의 공정 사용 한도는 한도 도달 시 가짜 API 200 전달 성공을 반환하지 않고 해당 테넌트의 전송을 엄격하게 하드 중단해야 합니다.