diff --git a/src/pages/docs/configuration/security/azure-sso.md b/src/pages/docs/configuration/security/azure-sso.md index 7277cce2..cce97c71 100644 --- a/src/pages/docs/configuration/security/azure-sso.md +++ b/src/pages/docs/configuration/security/azure-sso.md @@ -38,153 +38,148 @@ You can use the Azure Active Directory Admin Center to enable single sign-on (SS --- + ## **Prerequisites** -**-** Azure Account with Active Directory enabled +- Azure Account with Active Directory enabled -**-** Admin Access to Azure Account +- Admin Access to Azure Account --- -## **I. Adding Testsigma Enterprise Application** - -1. Login to Azure portal using the URL : https://portal.azure.com +## **I. Adding Testsigma Enterprise Application** - You will be taken to the home page as shown below: - ![Azure management portal](https://docs.testsigma.com/images/azure-sso/azure-management-portal.png) +1. Login to [Azure](https://portal.azure.com) portal. +![Azure management portal](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/mazsso.png) -2. Click the **View** button below **“Manage Azure Active Directory”.** +2. Click the **View** button below **“Manage Microsoft Entra ID”.** 3. In the Active Directory Overview page, click on **+ New application** and choose **Enterprise Application** 4. Click on **+ Create your own application** -In the overlay that opens up on the right, enter the name of the app you are integrating, i.e., *Testsigma*. Select option, **‘Integrate any other Application (Non-gallery)’** and click the **Create** button. +In the overlay that opens up on the right, enter the name of the app you are integrating, and select option, **‘Integrate any other Application (Non-gallery)’** and click the **Create** button. - ![Add Testsigma in Azure AD](https://docs.testsigma.com/images/azure-sso/add-new-application-testsigma-azure-ad.png) +![Add Testsigma in Azure AD](https://docs.testsigma.com/images/azure-sso/add-new-application-testsigma-azure-ad.png) - You’ll be taken to the newly added Testsigma overview page. +You’ll be redirected to the newly added Testsigma overview page. - ![Testsigma properties on Azure](https://docs.testsigma.com/images/azure-sso/Testsigma-properties.png) +![Testsigma properties on Azure](https://docs.testsigma.com/images/azure-sso/Testsigma-properties.png) --- + ## **II. Adding Users to the Enterprise Application** - 1. Click the **Assign users and groups card** to add the users in Azure AD to the recently added Testsigma app. +1. Click the **Assign users and groups card** to add the users in **Azure AD** to the recently added Testsigma app. - 2. Click on the **+ Add user/group** on top - ![Add users to enable sign on for Testsigma](https://docs.testsigma.com/images/azure-sso/add-users-azure-sso.png) +2. Click on the **+ Add user/group** on top. +![Add users to enable sign on for Testsigma](https://docs.testsigma.com/images/azure-sso/add-users-azure-sso.png) - 3. In the next page, Add Assignment, click on the **None selected** link to open up the Users overlay. - ![SSO enabled users for login](https://docs.testsigma.com/images/azure-sso/sso-enabled-users-list.png) +3. In the next page, **Add Assignment**, click on the **None selected** link to open up the Users overlay. +![SSO enabled users for login](https://docs.testsigma.com/images/azure-sso/sso-enabled-users-list.png) Select the required users from the Users overlay that opens up on the right. - 4. Click on the **Select** button to pick and finalize the users list. You can find the list of added Users at the left pane under Users. +4. Click on the **Select** button to pick and finalize the users list. You can find the list of added Users at the left pane under Users. - 5. To add assignments to these users, click **Assign**. +5. To add assignments to these users, click **Assign**. --- + ## **III. SAML Configuration on Azure in Testsigma** - 1. Back in Testsigma Overview page on Azure, click option 2 i.e, **Set up single sign on**. +1. Back in Testsigma Overview page on Azure, click option 2 i.e, **Set up single sign on**. ![set up sso login for Testsigma](https://docs.testsigma.com/images/azure-sso/setup-sso-for-login.png) - 2. Select the SAML authentication option. - You will be taken to the Setup Single Sign-on with SAML screen as shown below: - ![SAML configuration settings for Testsigma](https://docs.testsigma.com/images/azure-sso/saml-configuration-settings.png) +2. Select the **SAML authentication** option. +You will be taken to the Setup Single Sign-on with SAML screen as shown below: +![SAML configuration settings for Testsigma](https://docs.testsigma.com/images/azure-sso/saml-configuration-settings.png) - 3. Click on the Edit button on Section **1 - Basic SAML Configuration,** enter the following details, and click Save: +3. Click on the Edit button on Section **1 - Basic SAML Configuration,** enter the following details, and click Save: -   **Entity ID :** https://app.testsigma.com/saml//metadata + - **Entity ID :** https://app.testsigma.com/saml/<id>/metadata -   **Reply URL :** https://app.testsigma.com/saml//callback + - **Reply URL :** https://app.testsigma.com/saml/<id>/callback -   **Sign on URL :** (Leave it empty) + - **Sign on URL :** (Leave it empty) -   **Relay State :** https://app.testsigma.com/saml//callback + - **Relay State :** https://app.testsigma.com/saml/<id>/callback -   **Logout URL :** (Leave it empty) + - **Logout URL :** (Leave it empty) [[info | NOTE:]] -|*You need to replace the **** with the SAML token identifier for your account. To get your **id**, you need to follow the steps below*. - - Back in your Testsigma account, navigate to **Settings > Security**. Choose the SAML card and click **Proceed**. - ![Choose identity provider as SAML](https://docs.testsigma.com/images/azure-sso/choose-identity-provider-saml.png) - - You will see an exclusive SAML token identifier for your account. - ![Configuration id for saml configuration on Azure](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/saml.png) +| You need to replace the **<id>** with the SAML token identifier for your account. To get your **id**, you need to follow the steps below. +| - Back in your Testsigma account, navigate to **Settings > Security**. Choose the SAML card and click **Proceed**. +| ![Choose identity provider as SAML](https://docs.testsigma.com/images/azure-sso/choose-identity-provider-saml.png) +| - You will see an exclusive SAML token identifier for your account. \ +| ![Configuration id for saml configuration on Azure](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/saml.png) - 4. You need to put this identifier in place of **\** in Step 3 and click Save. +4. You need to put this identifier in place of **\** in Step 3 and click **Save**. ![Fill in basic configuration details for saml configuration](https://docs.testsigma.com/images/azure-sso/fill-saml-configuration-settings-basic-details.png) - 5. Click on the Edit button of Section 2 - **User Attributes & Claims**. Under **Required claim**, click the Claim name/Claim value. +5. Click on the Edit button of Section 2 - **User Attributes & Claims**. Under **Required claim**, click the Claim name/Claim value. - 6. In the Manage Claim page that now appears, select **Source attribute** as **user.email** from the dropdown. - ![Key/value-pairs attached to the user in Azure AD](https://docs.testsigma.com/images/azure-sso/manage-claim-azure-ad.png) +6. In the Manage Claim page that now appears, select **Source attribute** as **user.userprincipalname** from the dropdown. + ![Key/value-pairs attached to the user in Azure AD](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/ssoazure.png) - 7. Click **Save** and go back to the previous SAML-based Sign-on page. +7. Click **Save** and go back to the previous SAML-based Sign-on page. - 8. Click on the Edit button for section 3 - **SAML Signing Certificate,** enter the following details, and click Save: +8. Click on the Edit button for section 3 - **SAML Signing Certificate,** enter the following details, and click Save: -   **Signing Option:** SAML response and assertion + - **Signing Option:** SAML response and assertion -   **Signing Algorithm:** SHA-256 + - **Signing Algorithm:** SHA-256 - That's all the configuration you need to perform on Azure App for SAML-based Sign-on. +That's all the configuration you need to perform on Azure App for SAML-based Sign-on. - 9. Now, navigate back to the SAML Sign-on page - Download the XML file, **‘Federation Metadata XML’** by clicking the **Download** link under Section 3 - SAML Signing Certificate. - ![downloaded SAML certificate](https://docs.testsigma.com/images/azure-sso/download-saml-certificate.png) +9. Now, navigate back to the SAML Sign-on page +Download the XML file, **‘Federation Metadata XML’** by clicking the **Download** link under Section 3 - SAML Signing Certificate. +![Downloaded SAML certificate](https://docs.testsigma.com/images/azure-sso/download-saml-certificate.png) - 10. Open the XML File and copy the value under the key **EntityDescriptor > Signature > KeyInfo > X509Data > X509Certificate** - ![downloaded SAML certificate](https://docs.testsigma.com/images/azure-sso/downloaded-saml-certificate.png) +10. Open the XML File and copy the value under the key **EntityDescriptor > Signature > KeyInfo > X509Data > X509Certificate** +![Downloaded SAML certificate](https://docs.testsigma.com/images/azure-sso/downloaded-saml-certificate.png) - You can just search for **\** and copy the value between first occurrence of **\** and **\** - - 11. Note down the following values from **Section 4 - Set Up Testsigma App**. +You can just search for **\** and copy the value between first occurrence of **\** and **\** -   **Azure AD Identifier** +11. Note down the following values from **Section 4 - Set Up Testsigma App**. + - **Azure AD Identifier** + - **Login URL** -   **Login URL** - - We will use the **X509Certificate** value, also the values above in Testsigma app in the next section. +We will use the **X509Certificate** value, also the values above in Testsigma app in the next section. --- + ## **IV. Azure Specific SAML Configuration in Testsigma** Inside your Testsigma account, navigate to **Settings>Security** - 1. Click **Proceed** under SAML - Enter the following details: +1. Click **Proceed** under **SAML** and enter the following details: + - **Entity ID:** Same as **Microsoft Entra Identifier** (obtained from Section 4 in Azure SAML Setup page) + - **SSO URL:** Same as **Login URL** (obtained from Section 4 in Azure SAML Setup page) + - **SAML certificate:** Downloaded **\** value (obtained in previous section from downloaded XML file). +This value resides within the tag: **\\** Paste this value. -* **Entity ID:** same as **Azure AD Identifier** (obtained from Section 4 in Azure SAML Setup page) -* **SSO URL:** same as **Login URL** (obtained from Section 4 in Azure SAML Setup page) -* **SAML certificate:** downloaded **\** value (obtained in previous section from downloaded XML file). -This value resides within the tag: **\\** -Paste this value. -![Azure Specific SAML Configuration On Testsigma](https://docs.testsigma.com/images/azure-sso/azure-saml-configuration-testsigma.png) +![Azure Specific SAML Configuration On Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/mazcreds.png) -
-2. Click the **Confirm** button to finalize the changes. - -SAML will now be enabled, -Let’s test the SSO. +2. Click the **Confirm** button to finalize the changes. SAML will now be enabled. + --- + ## **V. Test the SAML Config** - 1. On Section 5 of the Single Sign-On option, you will find the option to test. Click - **Test**. +1. On Section 5 of the Single Sign-On option, you will find the option to test. Click **Test**. - 2. To test the sign-in, click on the **‘Sign in as current user’** option. +2. To test the sign-in, click on the **‘Sign in as current user’** option. This will test the SAML-based login with the currently logged-in user. -![Test Testsigma SIngle Sign On](https://docs.testsigma.com/images/azure-sso/test-testsigma-sso.png) +![Test Testsigma Single Sign On](https://docs.testsigma.com/images/azure-sso/test-testsigma-sso.png) + +This will automatically log you into Testsigma. -This will automatically log you into Testsigma. \ No newline at end of file +--- \ No newline at end of file diff --git a/src/pages/docs/runs/test-locally-hosted-applications.md b/src/pages/docs/runs/test-locally-hosted-applications.md index db7aaf28..5ae9e64f 100644 --- a/src/pages/docs/runs/test-locally-hosted-applications.md +++ b/src/pages/docs/runs/test-locally-hosted-applications.md @@ -37,8 +37,9 @@ Login to https://app.testsigma.com and go to **Settings > Testsigma IP** info to ![Testsigma IPs](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/ipwhitelisting.png) -- **Testsigma Server IP:** Whitelisting this IP will allow you to access the Testsigma server where the testing activities are hosted. -- **Testsigma Lab IPs:** Whitelisting these IP ranges will allow you to access Testsigma Labs, where test executions happen. +- **Testsigma Server IP:** Whitelisting this IP will allow you to access the Testsigma server, where the test executions happen on Testsigma's very own device cloud infrastructure. +- +- **Testsigma Lab IPs:** Whitelisting these IP ranges will allow you to access Testsigma Labs, where all the account's test assets and data are hosted and stored.