mirror of
https://github.com/fosrl/docs-v2.git
synced 2026-02-08 05:56:45 +00:00
add login page docs
This commit is contained in:
@@ -59,7 +59,8 @@
|
|||||||
"group": "Access Control",
|
"group": "Access Control",
|
||||||
"pages": [
|
"pages": [
|
||||||
"manage/access-control/rules",
|
"manage/access-control/rules",
|
||||||
"manage/access-control/forwarded-headers"
|
"manage/access-control/forwarded-headers",
|
||||||
|
"manage/access-control/login-page"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
|
|||||||
BIN
images/org-auth-page.png
Normal file
BIN
images/org-auth-page.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 116 KiB |
BIN
images/set-org-auth-page-domain.png
Normal file
BIN
images/set-org-auth-page-domain.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 56 KiB |
50
manage/access-control/login-page.mdx
Normal file
50
manage/access-control/login-page.mdx
Normal file
@@ -0,0 +1,50 @@
|
|||||||
|
---
|
||||||
|
title: "Custom Login Page"
|
||||||
|
description: "Configure a custom authentication page URL for your organization"
|
||||||
|
---
|
||||||
|
|
||||||
|
<Note>
|
||||||
|
Custom auth pages are only available in managed self-hosted nodes or in the cloud.
|
||||||
|
</Note>
|
||||||
|
|
||||||
|
Custom organization authentication pages let you serve the login page at your own domain instead of the default `pangolin.fossorial.io`. This provides better user experience and brand consistency.
|
||||||
|
|
||||||
|
<iframe
|
||||||
|
className="w-full aspect-video rounded-xl"
|
||||||
|
src="https://www.youtube.com/embed/fD-NpigE4Vw?si=M5BBiqoKRWSZNGU1"
|
||||||
|
title="YouTube video player"
|
||||||
|
frameBorder="0"
|
||||||
|
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
|
||||||
|
allowFullScreen
|
||||||
|
></iframe>
|
||||||
|
|
||||||
|
## Benefits
|
||||||
|
|
||||||
|
**For Resource Authentication:**
|
||||||
|
- Users are redirected to your custom domain for login
|
||||||
|
- Familiar domain builds trust and security awareness
|
||||||
|
- Consistent branding throughout the authentication flow
|
||||||
|
|
||||||
|
**For Identity Provider Integration:**
|
||||||
|
- Centralized login page for your organization
|
||||||
|
- Choose between multiple login methods (Google, Azure, etc.)
|
||||||
|
- Platform SSO: login once, access all Pangolin resources
|
||||||
|
- Direct access to the Pangolin management dashboard
|
||||||
|
|
||||||
|
<Frame>
|
||||||
|
<img src="/images/org-auth-page.png" />
|
||||||
|
</Frame>
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
1. Go to **Settings** in your organization sidebar
|
||||||
|
2. Use the domain picker to select your custom domain
|
||||||
|
3. Save your changes
|
||||||
|
|
||||||
|
<Note>
|
||||||
|
You need to add a custom domain to your organization first. Free domains (`*.tunneled.to`, `*.hostlocal.app`, etc.) cannot be used for auth pages. [Learn how to add domains](/manage/domains#adding-domains)
|
||||||
|
</Note>
|
||||||
|
|
||||||
|
<Frame>
|
||||||
|
<img src="/images/set-org-auth-page-domain.png" />
|
||||||
|
</Frame>
|
||||||
@@ -81,6 +81,10 @@ Integrate with Microsoft's enterprise identity platform to allow users to authen
|
|||||||
|
|
||||||
In the Community Edition, identity providers are created and managed via the Server Admin UI rather than the organization settings.
|
In the Community Edition, identity providers are created and managed via the Server Admin UI rather than the organization settings.
|
||||||
|
|
||||||
|
## Custom Login Page
|
||||||
|
|
||||||
|
You can [configure a custom login page](/manage/access-control/login-page) for your organization to be served at a domain of your choice. The log in page for every resource will be served at this URL. Additionally, you can visit this url to log in to the organization itself to access the Pangolin dashboard. This is particularly useful for identity providers because it creates a place for your users to go to select the identity provider of choice to access the Pangolin dashboard.
|
||||||
|
|
||||||
## Auto Provisioning
|
## Auto Provisioning
|
||||||
|
|
||||||
See [Auto Provision](/manage/identity-providers/auto-provisioning) for more information on how to automatically provision users and assign orgs and roles in Pangolin when they log in using an external identity provider.
|
See [Auto Provision](/manage/identity-providers/auto-provisioning) for more information on how to automatically provision users and assign orgs and roles in Pangolin when they log in using an external identity provider.
|
||||||
|
|||||||
Reference in New Issue
Block a user