WorkOS Docs Homepage
Integrations
DashboardSign In

miniOrange

Learn how to configure a connection to miniOrange via SAML.

Each SSO Identity Provider requires specific information to create and configure a new Connection. Often, the information required to create a Connection will differ by Identity Provider.

To create a miniOrange SAML Connection, you’ll need an IdP Metadata URL.

Start by logging in to your WorkOS dashboard and browse to the “Organizations” tab on the left hand navigation bar.

Select the organization you’d like to configure a miniOrange SAML Connection for, and select “Manually Configure Connection” under “Identity Provider”.

A screenshot showing the Manual Configure Connection option in the WorkOS Dashboard.

Select “miniOrange SAML” from the Identity Provider dropdown, enter a descriptive name for the connection, and then select the “Create Connection” button.

A screenshot showing a miniOrange connection being created in the WorkOS Dashboard.

WorkOS provides the ACS URL, SP Entity ID and SP Metadata URL. They’re readily available in your Connection Settings in the WorkOS Dashboard. For this configuration, you should only need to use the SP Metadata URL, but other fields are provided should you choose to do a more manual configuration.

A screenshot showing the Service Provider Details provided by WorkOS for a miniOrange connection in the WorkOS Dashboard.

Next, provide the IdP Metadata URL. Normally, this information will come from the organization's IT Management team when they set up your application’s SAML 2.0 configuration in their miniOrange admin dashboard. But, should that not be the case during your setup, the next steps will show you how to obtain it.

Log in to miniOrange, go to the admin dashboard and select “Apps” on the left side navigation. If your application is already created, select it from the list of applications and move to Step 2. Otherwise, select “Add Application”.

A screenshot showing where to select Add Application in the miniOrange dashboard.

Under “SAML/WS-FED”, select “Create App”.

A screenshot showing where to select Create App in the miniOrange dashboard.

Search for “custom” in the search box and select “Custom SAML App”.

A screenshot showing where to select Custom SAML App in the miniOrange dashboard.

Under the “Basic Settings” tab of the SAML app, select “Import SP Metadata”.

A screenshot highlighting the "Import SP Metadata" button in the miniOrange Dashboard.

Give the SAML app a descriptive name under “App Name”. Under “SP Metadata”, select “URL” and input the SP Metadata URL from your SSO Connection settings in the WorkOS Dashboard. Then, hit “Import”.

A screenshot showing how to enter an App name and input a metadata URL in the miniOrange dashboard.

Make sure that you have the “Sign Assertion” field toggled on.

A screenshot showing the "Sign Assertion" toggle activated in the miniOrange dashboard.

Select “Next”.

A screenshot highlighting the "Next" button in the miniOrange dashboard.

Under the “Attribute Mapping” section of the SAML app, select “Add Attribute”.

A screenshot showing where to select "Add Attribute" in the miniOrange dashboard.

Map the following four attributes as shown below, and the select “Save”.

  • idUsername
  • emailE-Mail Address
  • firstNameFirst Name
  • lastNameLast Name
A screenshot showing how to input user attribute mapping in the miniOrange dashboard.

Users can automatically be assigned roles within your application by sending their group memberships. To enable this, set up a group attribute statement following the guidance below.

This feature is currently in beta, contact customer support for more information.

On your SAML app's Settings page, scroll down to "Attributes" and add a new attribute. Set the attribute's name to groups and map it to the "User Groups" field. Click "Save".

A screenshot showing how to add a groups attribute in the miniOrange dashboard.

Back on the “Apps” tab of the miniOrange Dashboard, click “Select” next to the app you’ve created. From the dropdown, select “Metadata”.

A screenshot highlighting where to select "Metadata" in the miniOrange dashboard.

Under the “INFORMATION REQUIRED TO SET MINIORANGE AS IDP” section, click the icon next to “Metadata URL” to copy it to your clipboard.

A screenshot showing where to copy the Metadata URL in the miniOrange dashboard.

In the Connection settings in the WorkOS Dashboard, click “Edit Metadata Configuration”.

A screenshot highlighting the "Edit Metadata Configuration" button in a Connection details view in the WorkOS Dashboard.

Paste the Metadata URL from miniOrange into the “Metadata URL” field and select “Save Metadata Configuration”.

A screenshot showing how to input the Metadata URL into the Connection in the WorkOS Dashboard.

Your Connection will then be linked and good to go!