website/docs: Add OIDC auth integration with Nextcloud #7406

sdimovv · 2023-11-01T20:09:37Z

Details

Adds detailed docs on setting up OIDC authentication with Nextcloud. Includes tips and warnings against common pitfalls when setting up different configurations

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 has been updated (make gen-build)

If changes to the frontend have been made

The code has been formatted (make web)
The translation files have been updated (make i18n-extract)

If applicable

The documentation has been updated
The documentation has been formatted (make website)

netlify · 2023-11-01T20:09:43Z

✅ Deploy Preview for authentik-storybook canceled.

Name	Link
🔨 Latest commit	`ff0cf52`
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-storybook/deploys/655e198675b1680008564e0d

netlify · 2023-11-01T20:11:19Z

✅ Deploy Preview for authentik ready!

Name	Link
🔨 Latest commit	`ff0cf52`
🔍 Latest deploy log	https://app.netlify.com/sites/authentik/deploys/655e1986c009fa0008d2ba77
😎 Deploy Preview	https://deploy-preview-7406--authentik.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	1 paths audited Performance: 94 (🔴 down 3 from production) Accessibility: 90 (no change from production) Best Practices: 100 (no change from production) SEO: 80 (no change from production) PWA: - View the detailed breakdown and full score reports

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

codecov · 2023-11-01T20:15:59Z

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (345022f) 92.17% compared to head (ff0cf52) 92.64%.
Report is 205 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #7406      +/-   ##
==========================================
+ Coverage   92.17%   92.64%   +0.47%     
==========================================
  Files         587      588       +1     
  Lines       28895    29140     +245     
==========================================
+ Hits        26634    26997     +363     
+ Misses       2261     2143     -118

Flag	Coverage Δ
e2e	`50.71% <ø> (+1.39%)`	⬆️
integration	`25.93% <ø> (-0.09%)`	⬇️
unit	`89.71% <ø> (+0.11%)`	⬆️

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.

Signed-off-by: sdimovv <36302090+sdimovv@users.noreply.github.com>

sdimovv · 2023-11-14T20:46:50Z

@BeryJu can I get a merge please :D

rissson · 2023-11-16T15:36:13Z

Do you mind moving the OIDC section below the SAML one as it requires an additional nextcloud app to be installed? Also, let's add a quick sentence stating there are two different protocols that can be configured and linking to the specific section for each of them.

sdimovv · 2023-11-16T15:51:08Z

Do you mind moving the OIDC section below the SAML one as it requires an additional nextcloud app to be installed? Also, let's add a quick sentence stating there are two different protocols that can be configured and linking to the specific section for each of them.

I can add the section about the different protocols, no problem. However, I think you misunderstood what is required for SAML. Both auth methods require the installation of an additional app in Nextcloud. Both apps are "official", that is provided by the Nexcloud devs. However, neither of them comes installed with vanilla Nextcloud install. So the "extra" requirements for both are the same.

That being said I can still move it below SAML if you insist. I put it first since I believe most people will want to set up OIDC, as it is generally more popular than SAML.

rissson · 2023-11-17T12:47:32Z

Ah I misremembered then, it's fine as it is then!

sdimovv · 2023-11-20T18:57:37Z

@rissson
Does this need anything else to get merged?

tanberry

There's what I think is a typo that needs to be fixed... autorization --> authorization

website/integrations/services/nextcloud/index.md

rissson · 2023-11-20T19:24:06Z

Apart from the typo raised by Tana, all good for me

Signed-off-by: sdimovv <36302090+sdimovv@users.noreply.github.com>

sdimovv · 2023-11-21T17:03:27Z

Typo fixed. Let me know if there are more. Otherwise this can be merged.

rissson · 2023-11-22T13:57:36Z

@BeryJu could you force-merge this?

Signed-off-by: Jens Langhammer <jens@goauthentik.io>

* main: (47 commits) web: bump the wdio group in /tests/wdio with 2 updates (#7702) events: fix lint (#7700) events: add better fallback for sanitize_item to ensure everything can be saved as JSON (#7694) web: bump the wdio group in /tests/wdio with 4 updates (#7696) events: include user agent in events (#7693) web: fix labels on group view page (#7677) website/docs: Add OIDC auth integration with Nextcloud (#7406) web: fix locale (#7689) core: bump python from 3.11.5-bookworm to 3.12.0-bookworm (#7048) translate: Updates for file web/xliff/en.xlf in zh_TW (#7688) web: bump pyright from 1.1.336 to 1.1.337 in /web (#7681) core: bump sentry-sdk from 1.35.0 to 1.36.0 (#7683) website: bump prism-react-renderer from 2.2.0 to 2.3.0 in /website (#7685) web: bump the sentry group in /web with 2 updates (#7679) web: bump rollup from 4.5.0 to 4.5.1 in /web (#7680) web: bump @types/codemirror from 5.60.14 to 5.60.15 in /web (#7682) web: bump the wdio group in /tests/wdio with 2 updates (#7684) website: bump react-tooltip from 5.23.0 to 5.24.0 in /website (#7686) core: bump goauthentik.io/api/v3 from 3.2023103.4 to 3.2023104.1 (#7687) website/blog: Blog on security (#7671) ...

* main: (219 commits) web: bump the wdio group in /tests/wdio with 2 updates (#7702) events: fix lint (#7700) events: add better fallback for sanitize_item to ensure everything can be saved as JSON (#7694) web: bump the wdio group in /tests/wdio with 4 updates (#7696) events: include user agent in events (#7693) web: fix labels on group view page (#7677) website/docs: Add OIDC auth integration with Nextcloud (#7406) web: fix locale (#7689) core: bump python from 3.11.5-bookworm to 3.12.0-bookworm (#7048) translate: Updates for file web/xliff/en.xlf in zh_TW (#7688) web: bump pyright from 1.1.336 to 1.1.337 in /web (#7681) core: bump sentry-sdk from 1.35.0 to 1.36.0 (#7683) website: bump prism-react-renderer from 2.2.0 to 2.3.0 in /website (#7685) web: bump the sentry group in /web with 2 updates (#7679) web: bump rollup from 4.5.0 to 4.5.1 in /web (#7680) web: bump @types/codemirror from 5.60.14 to 5.60.15 in /web (#7682) web: bump the wdio group in /tests/wdio with 2 updates (#7684) website: bump react-tooltip from 5.23.0 to 5.24.0 in /website (#7686) core: bump goauthentik.io/api/v3 from 3.2023103.4 to 3.2023104.1 (#7687) website/blog: Blog on security (#7671) ...

sdimovv added 2 commits November 1, 2023 20:03

Add OIDC auth docs

79454d3

lint

2839cc5

sdimovv requested a review from a team as a code owner November 1, 2023 20:09

sdimovv and others added 4 commits November 1, 2023 20:17

fix note

aec67bc

lint

f01ff64

typo

b74fb40

Update index.md

af66dde

Signed-off-by: sdimovv <36302090+sdimovv@users.noreply.github.com>

sdimovv added 2 commits November 16, 2023 20:49

clarify 2 SSO protocols

ee83278

lint

58d6d38

rissson approved these changes Nov 17, 2023

View reviewed changes

tanberry requested changes Nov 20, 2023

View reviewed changes

website/integrations/services/nextcloud/index.md Outdated Show resolved Hide resolved

rissson approved these changes Nov 20, 2023

View reviewed changes

Update index.md

72e29bd

Signed-off-by: sdimovv <36302090+sdimovv@users.noreply.github.com>

rissson approved these changes Nov 21, 2023

View reviewed changes

fix typos

ff0cf52

Signed-off-by: Jens Langhammer <jens@goauthentik.io>

BeryJu merged commit 30f9d6b into goauthentik:main Nov 22, 2023
56 of 63 checks passed

sdimovv deleted the add-nextcloud-oidc-docs branch November 30, 2023 14:23

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

website/docs: Add OIDC auth integration with Nextcloud #7406

website/docs: Add OIDC auth integration with Nextcloud #7406

sdimovv commented Nov 1, 2023

netlify bot commented Nov 1, 2023 •

edited

netlify bot commented Nov 1, 2023 •

edited

codecov bot commented Nov 1, 2023 •

edited

sdimovv commented Nov 14, 2023

rissson commented Nov 16, 2023

sdimovv commented Nov 16, 2023 •

edited

rissson commented Nov 17, 2023 •

edited

sdimovv commented Nov 20, 2023

tanberry left a comment

rissson commented Nov 20, 2023

sdimovv commented Nov 21, 2023

rissson commented Nov 22, 2023

website/docs: Add OIDC auth integration with Nextcloud #7406

website/docs: Add OIDC auth integration with Nextcloud #7406

Conversation

sdimovv commented Nov 1, 2023

Details

Checklist

netlify bot commented Nov 1, 2023 • edited

✅ Deploy Preview for authentik-storybook canceled.

netlify bot commented Nov 1, 2023 • edited

✅ Deploy Preview for authentik ready!

codecov bot commented Nov 1, 2023 • edited

Codecov Report

sdimovv commented Nov 14, 2023

rissson commented Nov 16, 2023

sdimovv commented Nov 16, 2023 • edited

rissson commented Nov 17, 2023 • edited

sdimovv commented Nov 20, 2023

tanberry left a comment

Choose a reason for hiding this comment

rissson commented Nov 20, 2023

sdimovv commented Nov 21, 2023

rissson commented Nov 22, 2023

netlify bot commented Nov 1, 2023 •

edited

netlify bot commented Nov 1, 2023 •

edited

codecov bot commented Nov 1, 2023 •

edited

sdimovv commented Nov 16, 2023 •

edited

rissson commented Nov 17, 2023 •

edited