Skip to content

website/integrations: add OneUptime SAML integration guide#21534

Open
M-Slanec wants to merge 4 commits intogoauthentik:mainfrom
M-Slanec:add-oneuptime-integration
Open

website/integrations: add OneUptime SAML integration guide#21534
M-Slanec wants to merge 4 commits intogoauthentik:mainfrom
M-Slanec:add-oneuptime-integration

Conversation

@M-Slanec
Copy link
Copy Markdown
Contributor

Details

This adds an integration guide for logging into OneUptime with SAML.

closes #21533


Checklist

  • Local tests pass (ak test authentik/)
  • The code has been formatted (make lint-fix)

If an API change has been made

  • The API schema and clients have been updated (make gen)

If changes to the frontend have been made

  • The code has been formatted (make web)

If applicable

  • The documentation has been updated
  • The documentation has been formatted (make docs)

@M-Slanec M-Slanec requested a review from a team as a code owner April 10, 2026 04:46
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 10, 2026

Deploy Preview for authentik-integrations ready!

Name Link
🔨 Latest commit 77a64d1
🔍 Latest deploy log https://app.netlify.com/projects/authentik-integrations/deploys/69dd86f65c63e2000885cb0e
😎 Deploy Preview https://deploy-preview-21534--authentik-integrations.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 10, 2026

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit 77a64d1
🔍 Latest deploy log https://app.netlify.com/projects/authentik-docs/deploys/69dd86f6c4164e0008917a46
😎 Deploy Preview https://deploy-preview-21534--authentik-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@codecov
Copy link
Copy Markdown

codecov bot commented Apr 10, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.20%. Comparing base (be85fbc) to head (77a64d1).

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #21534      +/-   ##
==========================================
- Coverage   92.21%   92.20%   -0.01%     
==========================================
  Files        1032     1032              
  Lines       59660    59660              
  Branches     2537     2537              
==========================================
- Hits        55015    55012       -3     
- Misses       4580     4583       +3     
  Partials       65       65              
Flag Coverage Δ
conformance 37.03% <ø> (+<0.01%) ⬆️
e2e 42.38% <ø> (+0.45%) ⬆️
integration 33.44% <ø> (-0.52%) ⬇️
rust 60.50% <ø> (ø)
unit 91.89% <ø> (+<0.01%) ⬆️
unit-migrate 91.98% <ø> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@dewi-tik dewi-tik marked this pull request as draft April 10, 2026 07:19
@dewi-tik
Copy link
Copy Markdown
Contributor

Seems like you had an issue with the commit because it's just an empty file.

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 13, 2026

Deploy Preview for authentik-storybook ready!

Name Link
🔨 Latest commit 77a64d1
🔍 Latest deploy log https://app.netlify.com/projects/authentik-storybook/deploys/69dd86f65c63e2000885cb0a
😎 Deploy Preview https://deploy-preview-21534--authentik-storybook.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@M-Slanec M-Slanec marked this pull request as ready for review April 13, 2026 20:58
@dominic-r dominic-r self-requested a review April 13, 2026 23:56
@dominic-r dominic-r requested a review from dewi-tik April 14, 2026 00:12
@dominic-r dominic-r force-pushed the add-oneuptime-integration branch from 6fc6ece to 77a64d1 Compare April 14, 2026 00:14
@dominic-r dominic-r requested a review from PeshekDotDev April 14, 2026 03:33
@dominic-r dominic-r added the area:docs Features or issues related to Docusaurus label Apr 14, 2026
Copy link
Copy Markdown
Contributor

@PeshekDotDev PeshekDotDev left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should be able to explain the slug and then set those values in oneuptime at the first time we configure. It cleans up some of the process a bit. I'm pretty sure we do something similar in some other integration guides

3. Click **Create SSO** and configure the following settings:
- **Name**: enter a descriptive name, such as `authentik`.
- **Sign On URL**: temporarily set to `https://placeholder.invalid/sso`.
- **Issuer**: temporarily set to `https://placeholder.invalid/issuer`.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's set this as the https://authentik.company/application/saml/<application_slug>/metadata/ like below

2. Navigate to **Project Settings** > **Authentication** > **SSO**.
3. Click **Create SSO** and configure the following settings:
- **Name**: enter a descriptive name, such as `authentik`.
- **Sign On URL**: temporarily set to `https://placeholder.invalid/sso`.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's just set this as the https://authentik.company/application/saml/<application_slug>/sso/binding/redirect/ that we know it will have to be. Then we can remove lines 78-87. I'm pretty sure we have some setups for something like this in the docs that we should be able to follow

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Features or issues related to Docusaurus

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add SAML integration guide for oneuptime

4 participants