빠른 시작
Control Rail을 연동하면 비수탁 멀티시그 지갑을 서비스에 빠르게 붙일 수 있습니다. 이 페이지는 연동에 필요한 세 가지 — 토큰(인증), 기관 /sign, 클라이언트 SDK — 와 첫 거래까지의 흐름을 안내합니다.
Step 1 — 인증 / 토큰
모든 Control Rail API는 bearer 토큰으로 동작합니다. 기관 백엔드가 토큰을 발급(또는 IdP JWT 변환)해 클라이언트에 전달하면, 게이트웨이가 토큰에서 tenant·user·wallet을 식별합니다. 인증 흐름은 어떤 연동 방식이든 항상 동일합니다.
Step 2 — 연동 방식 선택
같은 Control Rail을 세 가지 방식으로 탑재합니다. 붙는 레일(게이트웨이·모듈·어댑터·멀티시그 강제)은 동일하고, 지갑이 기관에 닿는 방식만 다릅니다.
| 방식 | 내용 | 이런 경우 |
|---|---|---|
| ① 모듈 추가 | B2C 안암월렛에 기관 맞춤 모듈을 얹어 그 안에서 제공. | 자체 앱이 없는 경우 |
| ② 전용 월렛 납품 | 모듈을 구성해 기관 전용 월렛을 만들어 납품. | 전용 앱이 필요한 경우 |
| ③ SDK 임베드 | 기관 기존 앱에 SDK로 연결. 자기 앱에 임베드하는 WaaS 방식. | 자체 앱을 보유한 경우 |
/sign 콜백 하나(③은 SDK 연동 추가)뿐입니다.Step 3 — 통합 흐름
방식을 정했다면 다음 순서로 연동합니다. 기관이 구현하는 건 대시보드 설정 · /sign · (③의 경우) SDK 연동이고, 서명 수집·검증·브로드캐스트는 게이트웨이가 합니다.
대시보드 설정
기관 등록 → 공개키·콜백 URL 등록 → (옵션) IP 허용목록 → API 키 발급.
기관 백엔드 — /sign + 토큰
게이트웨이의 서명 요청을 받는 POST /sign 구현(정책 적용 후 기관 서명) + 클라이언트용 토큰 발급.
클라이언트 — 키 생성 · 지갑 생성
SDK로 디바이스 키 생성(generateKey) → POST /v1/wallets로 지갑 생성(공개키 등록).
거래 — prepare → 서명 → submit
prepare로 미서명 tx 수령 → SDK가 멀티사인 서명 → submit으로 제출. 게이트웨이가 /sign·KYT·안암 서명을 모아 정족수를 채웁니다.
결과 — status · hash
체인이 정족수를 최종 강제하고, 같은 응답으로 status·hash가 돌아옵니다. 통과·거절 전부 대시보드에 기록됩니다.