Skip to main content

Azure SAML

SAML plugin is available in ReportPortal on the Plugins page.

If you have a pre-created Internal user, you can't log in by SAML using their credentials (Email or Name).

Login to ReportPortal via Azure SAML is available starting from version 5.7 (SAML Okta was implemented in versions before 5.7).

Azure SAML is a useful authorization method for big companies with 100+ employees, especially if this organization is already presented in Azure service. The main benefit here is no need for manual account creation. Users can log in to the ReportPortal using Azure SAML in an uncomplicated way: select login with SAML, then choose Azure, and upon login users’ data is synchronized with ReportPortal automatically.

If your organization is using Azure SAML and some employees left, there is no need to remove their accounts from ReportPortal and from other Azure applications – just clearing their accounts in Azure will be enough.

To configure authorization via Azure SAML we need to synchronize Azure and ReportPortal.

Firstly, configure SAML on Azure side.

Configure SAML on Azure side

  1. Log in to Azure portal using your organization creds.
  2. Click App Services.
  1. Click View in the Manage Azure Active Directory section.
  1. Click Manage Tenants.

Create organization in Azure

  1. If you haven’t configured organization in Azure yet, click Create.
note

if you have configured organization in Azure, please, go to step 9.

  1. Select a tenant type (Azure Active Directory) and click Next: Configuration > button.
  1. Fill in the necessary fields and click Next: Review + create > button.
  1. Pass the Captcha verification and click the Create button.

Create your application in Azure

  1. After the creation of an organization go to the Enterprise Applications section.
  1. Click New application.
  1. Click Create your own application.
  1. Enter the name of your application, choose Integrate any other application you don't find in the gallery (Non-gallery) bullet and click Create button.

Assign users to the application in Azure

  1. Assign users (e.g., yourself) to this application. Please, follow the next screenshots:

Configure Single sign-on on Azure

  1. Go to the Single sign-on section.
  1. Choose SAML.

Basic SAML Configuration

  1. Configure Basic SAML Configuration settings as follows:

Add Azure attributes

  1. Edit Attributes & Claims settings and add email, firstName and lastName attributes (default Azure attributes have ugly format). Please follow the next screenshots:

SAML configuration is completed on Azure side after adding these attributes.

Ensure that your Advanced SAML claims options match those shown in the screenshots below.

Lastly, configure SAML on ReportPortal side.

Configure SAML on ReportPortal side

  1. Log in to ReportPortal as Admin.
  2. Open Menu at the bottom and choose Administrate section.
  1. Select Plugins.
  1. Open SAML.
  1. Click the Add integration button.

Synchronize Azure SAML and ReportPortal

  1. Synchronize Azure SAML and ReportPortal as follows:

Finally, you can log in to ReportPortal using Azure SAML.