# OneLogin

:::info
**Note:** This login method is only available in the licensed Business + Enterprise editions

:::


This guide walks you through setting up SAML with **OneLogin**.

## Create Application


1. In your OneLogin admin navigate to “Applications” and click **Add App**
2. Search for and select “SAML Test Connector (Advanced)”
3. In the Configuration change the “Display Name” and upload an Icon.
4. Ensure `loginURL` is set to `https://yourdomain.com/auth/saml`
5. Click “Save” in the top right


## Parameters


1. Navigate to “Parameters” for the new application in the left menu, you’ll need to setup the custom parameters that will be sent to Outline in order to provision new users. Make sure to check the **Include in SAML assertion** box for each.
2. The following are required:

   
   1. `fName` mapped to first name
   2. `sName` mapped to surname
   3. `email` mapped to a valid email address



 ![Parameters setup in OneLogin](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/292079f8-0319-4111-bb5b-315e8ae8f14e/cd1a5228-891b-4cf8-a69d-86656183de43/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260905%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260905T161500Z&X-Amz-Expires=86400&X-Amz-Signature=f20d97098a45d53d5aacb33375c0a1eb77438ad9f1584991cfb60cd99ae23eb9&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)


## Configure Outline

Now we need to tell Outline where to find our OneLogin application. Two new environment variables must be set inside of `docker.env`. Once the server is restarted, if all is setup correctly you should see a new option to “Continue with OneLogin” on the login screen.

| Environment variable |     |
|----------------------|-----|
| `SAML_SSO_ENDPOINT`  | Copy the value from `SAML 2.0 Endpoint (HTTP)` under the “SSO” tab in the OneLogin application admin. |
| `SAML_CERT`          | Copy the value from `X.509 Certificate` (You’ll need to click “view details” and copy the public key value from the large textbox). In a text editor delete the “-----BEGIN CERTIFICATE-----” and “-----END CERTIFICATE-----” text and all new lines. The resulting cert should be on a single line. |

---

**Documents**

- [License restrictions](https://docs.getoutline.com/s/hosting/doc/license-restrictions-f9aq6uEL3H)
- [Requirements](https://docs.getoutline.com/s/hosting/doc/requirements-ULdYnwi4wG)
- [Installation methods](https://docs.getoutline.com/s/hosting/doc/installation-methods-pSvgz9j0QC)
- [Configuration](https://docs.getoutline.com/s/hosting/doc/configuration-509J4lAzjo)
- [Business + Enterprise](https://docs.getoutline.com/s/hosting/doc/business-enterprise-rv0715NxO3)
- [Backups](https://docs.getoutline.com/s/hosting/doc/backups-KZtPOADCHG)
- [Troubleshooting](https://docs.getoutline.com/s/hosting/doc/troubleshooting-HXckrzCqDJ)