--- myst: html_meta: "description lang=en": "Kasm Workspaces web browser extension for single click Browser isolation." "keywords": "Kasm, How to, How-to, Browser Isolation, Chrome, Firefox, Extension, Right Click, Security, Malware" "property=og:locale": "en_US" --- ```{title} Kasm Extension ``` # Open In Isolation Browser Extension The Kasm Open-In Isolation browser extension provides a browser context-menu option for opening a link or selected text in an isolated Kasm Session. Allowing a user that is navigating the web to easily open untrusted links with the malware protection and anonymization that Kasm Isolation provides. ```{figure} /images/open_in_extension/right_click.webp :align: center **Right Click Option for Kasm** ``` This guide explains how to set up the Kasm Extension to work with an existing Kasm Workspaces deployment. ## Download Links [Chrome Extension](https://chrome.google.com/webstore/detail/kasm-open-in-isolation/pamimfbchojeflegdjgijcgnoghgfemn?hl=en-US) [Firefox Extension](https://addons.mozilla.org/en-US/firefox/addon/kasm-open-in-isolation) ## Setting Kasm User Settings Navigate to the user profile settings on your Kasm deployment by logging into your Kasm Workspaces deployment, clicking on your user icon and clicking "Profile". ```{figure} /images/open_in_extension/profile.webp :align: center **Edit Profile** ``` Scroll down and change the Default Workspace Image to the desired browser image. ```{figure} /images/open_in_extension/drop_down.webp :align: center **Default Workspace Image Setting** ``` ```{note} Alternatively an Admin may setup a {doc}`Casting Config ` with the "Allow Resume" and "Allow Dynamic Kasm Url Parameter" settings enabled. The key from the cast config can be entered in the browser extension settings. ``` ## Configuring Extension For **Firefox** the settings for the extension can be accessed by going to , selecting the Kasm Extension and clicking on "Preferences" for. ```{figure} /images/open_in_extension/firefox.webp :align: center **Firefox Options** ``` For **Chrome** the options can be accessed through the menu shown in the screenshot below. ```{figure} /images/open_in_extension/chrome.webp :align: center **Chrome Options** ``` ## Configuration Options ```{figure} /images/open_in_extension/settings.webp :align: center **Extension Options** ``` | Option | Details | | :----: | :----: | | Kasm URL | This is the full URL for Kasm Workspaces, no special paths are needed simply the URL | | Open Method | "Use Go" will open a new Workspace on init, "Use Cast Key" will send the URL to a casting endpoint. Using the casting settings "Allow Dynamic Kasm URL Parameter" and "Allow Resume" can give the user a stateful browser session surviving client restarts [more information for casting](../guide/casting.md) | | Open In | "New Tab" will open the link or text in a new tab while "New Window" will open a new browser window configured without any clutter in the title bar to provide a progressive web application experience | | Search Engine | When opening selected text from a web page if the extension determines the text is not a URL it will be passed to a search engine, select the search engine you prefer here from our list of options or use a custom endpoint | | Replace Text | Allows any number of text strings to be replaced before passing it to the Workspace | ### Text Replacement Text replacement will replace any string in the find field with the string in the replace field. This supports [RegExp](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp) in the find field and the text is processed clientside before deciding how to send it to the Workspace. This can be useful for taking text that is not in standard hyperlink format and converting it into a usable URL and land directly on the URL instead of searching for it. Real world examples: | Find | Replace | Details | | :----: | :----: |--- | | `/your_string/g` | `your_replace` | This will replace all instances of the match inside your selection instead of just the first one | | `/^www/` | `https://www` | This will prepend `https://` to any text selected and if the URL is valid will go directly to that page, IE selecting and opening `www.kasmweb.com` will open `https://www.kasmweb.com` on the Workspace | | `/\[\.\]/g` | `.` | Revert standard URL defanging to change all instances of `[.]` to `.` | | `hxxp` | `http` | Revert standard URL defanging to change `hxxp` to `http` | | `/\[\:\]/g` | `:` | Revert standard URL defanging to change all instances of `[:]` to `:` | | `hXXp` | `http` | Revert standard URL defanging to change `hXXp` to `http` |