ClawOps APIMobile Gateways

모바일 게이트웨이 콜홈 enroll (익명 · enroll 토큰 인증)

View as Markdown
박스 control-agent 가 로컬 생성한 WireGuard 공개키로 콜홈한다. 인증은 계정 세션이 아니라 `Authorization: Bearer <enroll_token>`(발급받은 1회용 토큰). 성공 시 터널 IP 를 할당하고 게이트웨이를 등록(status=active)한 뒤, 박스가 wg0.conf 를 완성할 터널 설정을 반환한다. 개인키는 박스 밖으로 나가지 않는다(공개키만 전송).

Request

This endpoint expects an object.
wgPubkeystringRequired

박스가 로컬 생성한 WireGuard 공개키(base64 44자).

msisdnstringOptional

박스 휴대폰 E.164/국내번호(관측/표시용, 신뢰하지 않음).

Response

enroll 성공 — 터널 설정

tunnelIpstring

할당된 터널 /32 주소(박스 [Interface] Address).

tunnelCidrstring
kamailioIpstring

SIP 시그널링 대상(박스 AllowedIPs + pjsip 트렁크 host).

rtpengineIpstring
rtpPortRangestring
wgGwEndpointstring

WireGuard 게이트웨이 endpoint(공인 IP:51820). 박스 [Peer] Endpoint.

wgGwPubkeystring

WireGuard 게이트웨이 공개키. 박스 [Peer] PublicKey.

keepaliveinteger

PersistentKeepalive(초). NAT 뒤 개시 유지.

Errors

400
Bad Request Error
401
Unauthorized Error
409
Conflict Error
503
Service Unavailable Error