Skip to content

Commit

Permalink
Merge pull request #495 from apivideo/geo-restriction-docs
Browse files Browse the repository at this point in the history
Add georestrictions guide
  • Loading branch information
szekelyzol authored Nov 12, 2024
2 parents 7e3e348 + 98027ef commit 7a6e4ec
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 0 deletions.
35 changes: 35 additions & 0 deletions delivery/geo-restrictions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
title: Geo-restrictions
meta:
description: Secure your videos and live streams by blocking or allowing countries where your content is accessible.
---
# Geo-restrictions

This feature enables you to control exactly where your video content can be accessed, allowing better compliance and enabling targeted content delivery. Next to [domain referrer restrictions](/delivery/domain-referrer) and [private videos](/delivery/video-privacy-access-management), geographic restrictions add another layer that helps you manage and protect your video content.

## How it works

You define a list of countries where users should be allowed to access your content. api.video then creates a whitelist that allows video delivery only for viewers in the countries on your list.

<Callout pad="2" type="info">
The whitelist grants access only to those countries that are on the list. Every other country is restricted.
</Callout>

Viewers who try to access your content from restricted locations will see an error message in the video player. Direct URLs that point to video assets will return `403 - Forbidden`.

## Request access

To apply geo-restrictions, get in touch with our support team directly via the chat box, or send your request [via email](mailto:[email protected]).

Make sure you provide these details:

* the projects where you want to apply geo-restrictions
* a list of countries where you want to allow access to your videos, for each affected project

<Callout pad="2" type="info">
Geo-restrictions work on a project-level. This means that the restriction applies to every video in a project.
</Callout>

## Implementation

Our team first confirms the countries and projects where you want to apply geo-restrictions. Implementation is quick, and we will inform you when the restrictions are in place.
2 changes: 2 additions & 0 deletions delivery/navigation.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@
href: /delivery/using-custom-domains.md
- label: Domain referrer restrictions
href: /delivery/domain-referrer.md
- label: Geo-restrictions
href: /delivery/geo-restrictions.md
- label: In-stream ads
href: /delivery/ads.md
- label: Private videos
Expand Down

0 comments on commit 7a6e4ec

Please sign in to comment.