-
Notifications
You must be signed in to change notification settings - Fork 472
Setting Domain Specific & Global Rules
This is a community-provided guide. Community-provided guides may or may not reflect my opinion of how to optimally use uMatrix. Feel free to contribute a guide.
The example below demonstrates how to create rules within uMatrix for either Domain Specific Rules or Global Rules which allows a user to achieve desired site functionality (e.g. The user wants to be able to always play embedded youtube videos on a website)
For the steps below we will use an example website which has a youtube video embedded on the page.
- Select the Domain
From the uMatrix panel in the top left corner, make sure the selection is a blue domain which should show the website domain you are currently on.
- Whitelist Rules
Select the rules you want to allow from the 3rd party domain.
In example above we are allowing scripts and frames to load from 'www.youtube.com' on 'digg.com' only.
- Save the Rules
Click the unlocked padlock icon from the uMatrix panel to permanently save the new rules you have just allowed.
Alternative Method
Open the uMatrix dashboard and click on the 'My rules' tab. Make your temporary rules permanent by committing them by clicking on the button.
The above method to make rules permanent is an alternative approach to clicking the padlock icon from the uMatrix Panel
- Refresh the Page
Click the icon in the uMatrix Panel to refresh the example website and test if the rules you have set allow the desired site behavior.
- Repeat Steps 1-4 as Needed
Repeat Steps 1-4 until the website functions in the desired manner -- For this example, we want the youtube video to fully load and allow playback in the example website.
Scripts for domains 'www.youtube.com', 'youtubei.youtube.com' & 's.ytimage.com' as well as XHR requests for 'googlevideo.com' & 'www.youtube.com' and frames for 'www.youtube.com' have now been allowed on 'digg.com' only.
Rules you set following the steps above should now only apply to the selected website.' (In this example, digg.com)
For the steps below we will use an example website which has a youtube video embedded on the page.
- Select the Global Domain
From the uMatrix panel in the top left corner click the blue domain which should show the website domain you are currently on and select '*' instead of the domain you are currently on.
- Whitelist Rules
Select the rules you want to allow from the 3rd party domain.
In example above we are globally allowing scripts and frames to load from 'www.youtube.com'
- Save the Rules
Click the unlocked padlock icon from the uMatrix panel to permanently save the new rules you have just allowed.
Alternative Method
Open the uMatrix dashboard and click on the 'My rules' tab. Make your temporary rules permanent by committing them by clicking on the button.
The above method to make rules permanent is an alternative approach to clicking the padlock icon from the uMatrix Panel
- Refresh the Page
Click the icon in the uMatrix Panel to refresh the example website and test if the rules you have set allow the desired site behavior.
- Repeat Steps 1-4 as Needed
Repeat Steps 1-4 until the website functions in the desired manner -- For this example, we want the youtube video to fully load and allow playback in the example website.
Scripts for domains 'www.youtube.com', 'youtubei.youtube.com' & 's.ytimage.com' as well as XHR requests for 'googlevideo.com' & 'www.youtube.com' and frames for 'www.youtube.com' have now been globally allowed.
Please keep in mind that out of the box, uMatrix is a powerful third party script blocker that may impact the full functionality of many websites. Because of this it is designed and intended to be used by advanced users.
uMatrix: Point and click matrix to filter net requests according to source, destination and type.