pangolin_mirror/docs-v2
1
0
Fork 0
mirror of https://github.com/fosrl/docs-v2.git synced 2026-03-10 12:46:42 +00:00
Code Issues Packages Projects Releases Wiki Activity

update idp docs

Browse Source
This commit is contained in:
miloschwartz
2025-09-15 20:53:21 -07:00
parent da6fa5afbd
commit d03670a17f
14 changed files with 185 additions and 145 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
manage/identity-providers/pocket-id.mdx
View File

@@ -1,9 +1,9 @@
---
title: "Pocket ID SSO"
title: "Pocket ID"
description: "Configure Pocket ID Single Sign-On using OpenID Connect"
---
The following steps will integrate **Pocket ID** with **Pangolin SSO** using OpenID Connect (OIDC).
The following steps will integrate Pocket ID with Pangolin SSO using OpenID Connect (OIDC).
## Prerequisites
@@ -19,7 +19,7 @@ In Pocket ID, create a new OIDC Client.
</Step>
<Step title="Configure Callback URL">
Set "Callback URLs" to `https://<your-pangolin-domain>/auth/idp/<idp-id>/oidc/callback`.
Leave blank or set a placeholder. We will come back to this step after creating the IdP and we know the redirect URL.
</Step>
<Step title="Keep Defaults">
@@ -40,9 +40,9 @@ After you have created the OIDC Client, take note of the following fields from t
## Configuring Identity Providers in Pangolin
In Pangolin, go to the **Server Admin** section. Select "Identity Providers" before proceeding with the "Add Identity Provider" button.
In Pangolin, go to “Identity Providers” and click “Add Indentity Provider”. Select the OAuth2/OIDC provider option.
**Name** should be set to something memorable (eg. Pocket ID). The **Provider Type** should be set to the default `OAuth2/OIDC`.
"Name" should be set to something memorable (eg. Pocket ID). The "Provider Type" should be set to the default `OAuth2/OIDC`.
### OAuth2/OIDC Configuration (Provider Credentials and Endpoints)
@@ -66,14 +66,14 @@ In the OAuth2/OIDC Configuration, you'll need the following fields:
## Token Configuration
You should leave all of the paths default. In the **Scopes** field, add `openid profile email`.
You should leave all of the paths default. In the "Scopes" field, add `openid profile email`.
<Note>
Set the **Identifier Path** to "preferred_username" for Pocket ID integration.
Set the "Identifier Path" to `preferred_username` for Pocket ID integration.
</Note>
When you're done, click "Create Identity Provider"! Then, copy the Redirect URL in the "General" tab as you will now need this for your **Pocket ID OIDC client**.
When you're done, click "Create Identity Provider"! Then, copy the Redirect URL in the "General" tab as you will now need this for your Pocket ID OIDC client.
## Returning to Pocket ID
Lastly, you'll need to return to your **Pocket ID OIDC client** in order to add the redirect URI created by Pangolin. Add the URI to **Callback URLs**, then save your changes! Your configuration should now be complete. You'll now need to add an external user to Pangolin, or if you have "Auto Provision Users" enabled, you can now log in using Pocket ID SSO.
Lastly, you'll need to return to your Pocket ID OIDC client in order to add the redirect URI created by Pangolin. Add the URI to "Callback URLs", then save your changes! Your configuration should now be complete. You'll now need to add an external user to Pangolin, or if you have "Auto Provision Users" enabled, you can now log in using Pocket ID SSO.