# Single sign-on extension for Amazon WorkSpaces Secure Browser
<a name="extension"></a>

Amazon WorkSpaces Secure Browser offers an extension for single sign-on with Chrome and Firefox browsers on desktop computers. If your administrator has enabled the extension, the web portal will ask you to install the extension when you sign in. 

Amazon WorkSpaces Secure Browser built the extension to enable single sign-on to websites during your session. For example, if you sign into your web portal using a SAML 2.0 identity provider (such as Okta or Ping), and you visit a website during your session that uses the same identity provider, the extension can make it easier to access the website by removing additional sign-in prompts.

You aren’t required to install the extension to access your web portal, but it can improve your experience by reducing the number of times you are asked to enter your username and password.

When you sign in, the extension locates the cookies your administrator listed for your session. All of the data that the extension locates is encrypted at rest and during transit. None of this data is stored in your local browser. When you end your session, all of your session data (such as open tabs, files downloaded, and cookies delivered to or created during the session) is deleted. 

**Topics**
+ [Single sign-on extension compatibility for Amazon WorkSpaces Secure Browser](extension-compatibility.md)
+ [Installing the single sign-on extension for Amazon WorkSpaces Secure Browser](extension-install.md)
+ [Troubleshooting the single sign-on extension for Amazon WorkSpaces Secure Browser](extension-troubleshooting.md)

# Single sign-on extension compatibility for Amazon WorkSpaces Secure Browser
<a name="extension-compatibility"></a>

The single sign-on extension works with the following devices and browsers:
+ Devices
  + Laptops
  + Desktop computers
+ Browsers
  + Google Chrome
  + Mozilla Firefox

# Installing the single sign-on extension for Amazon WorkSpaces Secure Browser
<a name="extension-install"></a>

To install the single sign-on extension, follow these steps.

When you sign into the portal, follow the prompt to install the extension for your Chrome or Firefox browser. You only have to do this one time for each web browser.

If you switch devices, switch to a different browser on the same device, or delete the extension from your local browser, you'll see a prompt to install the extension when you start your next session.

To ensure that the extension works as expected, use the extension in a normal browsing window, instead of Incognito (Chrome) or Private Browsing (Firefox). 

# Troubleshooting the single sign-on extension for Amazon WorkSpaces Secure Browser
<a name="extension-troubleshooting"></a>

While using the single sign-on extension, you might encounter the following issue.

 If you have the extension installed, but you're still being asked to sign in during your session, follow these steps:

1. Make sure that you have the Amazon WorkSpaces Secure Browser extension installed on your browser. If you deleted your browser data, you might have removed the extension by accident. 

1. Make sure that you are not Incognito (Chrome) or Private Browsing (Firefox). These modes can cause issues with extensions. 

1. If the issue persists, contact your portal administrator for additional help.