Skip to content

Commit 3a6392d

Browse files
committed
Add SSO docs
1 parent 0c08b99 commit 3a6392d

File tree

1 file changed

+56
-2
lines changed
  • fern/products/docs/pages/authentication

1 file changed

+56
-2
lines changed
Lines changed: 56 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,61 @@
11
---
22
title: Single Sign-On
3+
subtitle: Enterprise authentication for secure access to your Fern dashboard
34
---
45

5-
Fern supports SSO so that your docs site is gated for your team and customers.
6+
Fern's Single Sign-On (SSO) is an enterprise feature that enables your organization to authenticate users through your existing identity provider, providing secure access to your Fern dashboard at `dashboard.buildwithfern.com`.
67

7-
<Warning>Docs are coming soon for this page.<br/><br/>Please [book a demo](https://buildwithfern.com/book-demo) or [reach out to us](https://buildwithfern.com/book-demo) to get set up with this feature. </Warning>
8+
## What SSO unlocks
9+
10+
When SSO is enabled for your organization, authenticated users gain access to:
11+
12+
- **User and Organization Management**: Manage team members and organizational settings
13+
- **Analytics Dashboard**: View detailed web analytics and Ask Fern metrics
14+
- **Billing and Subscription Management**: Monitor your plan usage, view invoices, and manage your subscription tier
15+
16+
## How it works
17+
18+
Fern's SSO integration allows your team to use their existing corporate credentials to access the Fern platform. Instead of managing separate Fern accounts, users authenticate through your organization's identity provider and are automatically granted appropriate access to your Fern resources.
19+
20+
### Authentication flow
21+
22+
1. User navigates to [dashboard.buildwithfern.com](https://dashboard.buildwithfern.com)
23+
2. User selects SSO login and enters their organization domain
24+
3. User is redirected to your organization's identity provider
25+
4. After successful authentication, user is redirected back to Fern with appropriate permissions
26+
5. User gains access to dashboard features based on their role
27+
28+
## Supported identity providers
29+
30+
Fern supports SSO integration with any identity provider that implements industry-standard protocols:
31+
32+
- **SAML 2.0**: Compatible with providers like Okta, OneLogin, Azure AD, and others
33+
- **OIDC (OpenID Connect)**: Works with Google Workspace, Auth0, and other OIDC-compliant providers
34+
35+
## Getting started
36+
37+
<Note>
38+
SSO is available as part of the Enterprise plan.
39+
</Note>
40+
41+
To set up SSO for your organization:
42+
43+
1. **Contact Fern Support**: Reach out via Slack or [contact our team](https://buildwithfern.com/contact) to begin the SSO setup process
44+
45+
2. **Provide IdP Information**: Share details about your identity provider configuration, including:
46+
- IdP type (SAML or OIDC)
47+
- Metadata URL or certificate information
48+
- Attribute mappings for user identification
49+
50+
3. **Configure Your IdP**: Add Fern as a service provider in your identity provider with the connection details we provide
51+
52+
4. **Test the Integration**: Work with our team to test the SSO flow and ensure users can successfully authenticate
53+
54+
5. **Go Live**: Once testing is complete, enable SSO for your organization
55+
56+
## Automatic user provisioning
57+
58+
When a user successfully authenticates through SSO:
59+
- Their account is automatically created in Fern if it doesn't exist
60+
- User information is synced from your identity provider
61+
- Appropriate permissions are assigned based on their role

0 commit comments

Comments
 (0)