Geo-blocking
Block Access to a Real-time Stream Based on Geographic Boundaries
Geo-blocking refers to the action of restricting access to certain content based on the geographical location of the user. Filtering can be allowed or denied by countries as well as IP addresses. Geo-blocking enables content providers to adhere to specific licensing agreements and distribution rights, protect copyrighted material, or service another layer of privacy when working on private content.
You can set geo-blocking in either your publish token or subscribe token. Geo-location in both tokens refers to the location from which viewers can watch a stream. If you restrict access to a stream in some countries using the publish token, people from those countries will not be able to watch the streamed content, even if the stream is unauthenticated and does not require the subscribe token. Geo-blocking does not impact broadcasting.
Geo-blocking in the dashboard
There are some settings you can use when configuring geo-blocking.
- Allow countries lets you specify one or more countries by name that should be permitted to broadcast or view a stream.
- Deny countries lets you specify one or more countries that should be prohibited from broadcasting or viewing a stream.
End viewers that will be blocked from content will see a message in the player stating Country not allowed when trying to access the viewer. You can test this by blocking the country from which you are based to access the secure viewer link.
How-to allow or block countries for all tokens
You can define token defaults that are applied account wide as a global configuration. They can be overridden on a per-token basis
Log into your account Streaming Dashboard, click on Settings in the left-side menu.
Navigate to the Token defaults tab.
Select from the countries you want to allow or deny from the alphabetical dropdown list.
Applied to All Tokens
Enabling geo-blocking account wide will have all previous and future publish tokens enabled with this feature. To disable it simply erase the specified countries and the new conditions will be updated.
How-to allow or block countries for a specific token
Getting Started
If you haven't already, begin by following the Getting Started tutorial to create a Dolby.io application and start your first broadcast. You will need to have a publishing token.
Open the Streaming section of the Dolby.io Dashboard and select an existing token or + Create
a new one.
Toggle the Geo-blocking setting to enable it for a token.
For a new token, you can do this by selecting the Advanced tab during creation and toggling the Geo-blocking to be Enabled.
Select from the countries you want to allow or deny from the alphabetical dropdown list.
Block by IP Address or Domain
You can also deny access to content if you know the domain name or ip address that will be used to broadcast or view a stream.
Learn more
Learn more by exploring the developer blog and code samples.
Updated 8 months ago