website/docs: add login page source note to all source docs (#14667)

* Updates all source documents with note on how to add source to login page

* Updated the wording on the guide itself

* Updated wording on notes

* Fixes capitalization on header

* Fixed broken links in google docs
This commit is contained in:
Dewi Roberts
2025-05-27 18:31:23 +01:00
committed by GitHub
parent 0d18c1d797
commit 154fba12e0
12 changed files with 33 additions and 12 deletions

View File

@ -15,12 +15,13 @@ Sources are in the following general categories:
For instructions to add a specific source, refer to the documentation links in the left navigation pane.
### Add Sources to Default Login Page
### Add sources to default login page
To have sources show on the default login screen you will need to add them to the flow. The process below assumes that you have not created or renamed the default stages and flows.
1. In the Admin interface, navigate to the **Flows** section.
2. Click on **default-authentication-flow**.
3. Click the **Stage Bindings** tab.
4. Chose **Edit Stage** for the _default-authentication-identification_ stage.
5. Under **Sources** you should see the additional sources that you have configured. Click all applicable sources to have them displayed on the Login page.
1. Log in to authentik as an admin, and open the authentik Admin interface.
2. Navigate to **Flows and Stages** > **Flows**.
3. Click the **default-authentication-flow**.
4. Click the **Stage Bindings** tab.
5. Click **Edit Stage** on the **default-authentication-identification** stage.
6. Under **Source settings**, add sources to **Selected sources** to have them displayed on the authentik login page.

View File

@ -68,5 +68,5 @@ The following placeholders are used in this guide:
Save, and you now have Apple as a source.
:::note
For more details on how-to have the new source display on the Login Page see [here](../../index.md#add-sources-to-default-login-page).
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../index.md#add-sources-to-default-login-page).
:::

View File

@ -129,3 +129,7 @@ client_secret=<application_client_secret>
```
The JWT returned from the request above can be used with authentik to exchange it for an authentik JWT.
:::note
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../index.md#add-sources-to-default-login-page).
:::

View File

@ -380,3 +380,7 @@ return True
```
Now bind this policy to the chosen enrollment and authentication flows for the Discord OAuth source.
:::note
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../index.md#add-sources-to-default-login-page).
:::

View File

@ -69,5 +69,5 @@ Finally, you need to publish the Facebook app.
You now have Facebook as a source. Verify by checking that appears on the **Directory -> Federation & Social login** page in authentik.
:::note
For more details on how to display the new source on the authentik Login page refer to [Add Sources to default Login form](../../index.md#add-sources-to-default-login-page).
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../index.md#add-sources-to-default-login-page).
:::

View File

@ -99,3 +99,7 @@ return user_matched
If a user is not member of the chosen organisation, they will see this message
![](./github_org_membership.png)
:::note
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../index.md#add-sources-to-default-login-page).
:::

View File

@ -101,3 +101,7 @@ return False
Afterwards, edit the source's enrollment flow (by default _default-source-enrollment_), expand the policies bound to the first stage (_default-source-enrollment-prompt_), and bind the policy created above. Make sure the newly created policy comes before _default-source-enrollment-if-username_. Afterwards, any new logins will automatically have their google email address used as their username.
This can be combined with disallowing users from changing their usernames, see [Configuration](../../../../../sys-mgmt/settings.md#allow-users-to-change-username).
:::note
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../../index.md#add-sources-to-default-login-page).
:::

View File

@ -202,3 +202,7 @@ This may take a few minutes to propagate, so try logging in again after a short
- [Setting up SAML with Google Workspace](https://support.google.com/a/answer/6087519)
- [SAML app error messages](https://support.google.com/a/answer/6301076)
- [SAML authentication flow](https://infosec.mozilla.org/guidelines/iam/saml.html)
:::note
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../../index.md#add-sources-to-default-login-page).
:::

View File

@ -49,5 +49,5 @@ Here is an example of a complete authentik Mailcow OAuth Source
Save, and you now have Mailcow as a source.
:::note
For more details on how-to have the new source display on the Login Page see [here](../../index.md#add-sources-to-default-login-page).
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../index.md#add-sources-to-default-login-page).
:::

View File

@ -22,7 +22,7 @@ Add _Plex_ as a _source_
Save, and you now have Plex as a source.
:::note
For more details on how-to have the new source display on the Login Page see [here](../../index.md#add-sources-to-default-login-page).
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../index.md#add-sources-to-default-login-page).
:::
## Plex source property mappings

View File

@ -55,5 +55,5 @@ Here is an example of a complete authentik Twitch OAuth Source
Save, and you now have Twitch as a source.
:::note
For more details on how-to have the new source display on the Login Page see [here](../../index.md#add-sources-to-default-login-page).
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../index.md#add-sources-to-default-login-page).
:::

View File

@ -43,5 +43,5 @@ You will need to create a new project, and OAuth credentials in the Twitter Deve
5. **Consumer Secret:** Your Client Secret from step 25
:::note
For more details on how-to have the new source display on the Login Page see [here](../../index.md#add-sources-to-default-login-page).
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../index.md#add-sources-to-default-login-page).
:::