Geo-Fencing & IP Restriction Rules
Enforce geographic broadcasting boundaries and IP whitelists to satisfy content licensing rights, regulatory compliance, and broadcast exclusivity agreements.
Geo-Blocking Middleware (GeoBlockMiddleware)
When an HTTP request or WebSocket handshake arrives, the GeoBlockMiddlewareinspects the client IP against the configured GeoIP lookup provider and evaluates the tenant's country policy:
Stream Creation with Geo-FencingAuth
Enforce ISO 3166-1 alpha-2 geographical boundaries on live stream playback.
Payload Example
{
"title": "Australia-Only Live Match",
"geo_allow_countries": ["AU", "NZ"],
"geo_block_countries": []
}Status Codes
- Name
201- Type
- HTTP
- Description
- Stream created with active geo-fence
- Name
451- Type
- HTTP
- Description
- Unavailable For Legal Reasons (geo-blocked client)
Request
POST/v1/stream/channels
Response 201
Enforcement Behavior: Viewers connecting from non-whitelisted countries receive an immediate
451 Unavailable For Legal Reasons response, and the WebRTC SDP offer is rejected prior to establishing media tracks.