Skip to content

Commit a67e4b1

Browse files
committed
added more SSO info
1 parent 5a45aad commit a67e4b1

File tree

4 files changed

+33
-10
lines changed

4 files changed

+33
-10
lines changed

src/.vuepress/config.ts

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -235,6 +235,16 @@ export default defineUserConfig({
235235
'/guides/sound/bar_to_kitchen',
236236
]
237237
},
238+
],
239+
'/servers/sso': [
240+
{
241+
text: 'SSO / Login',
242+
collapsible: false,
243+
children: [
244+
'/servers/sso/backup_access',
245+
'/servers/sso/login_flow',
246+
]
247+
}
238248
]
239249
}
240250
})

src/servers/sso/backup_access.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# Backup Admin Access
2+
3+
It is possible that a miss-configuration of the service results in the Google
4+
SAML login to stop working. To avoid total lockout there is a secondary way to
5+
log in with a local account.
6+
7+
To access the fallback method go to [https://sso-admin.kth.it/if/admin][1] and sign
8+
in with the local account credentials.
9+
10+
[1]: https://sso-admin.kth.it/if/admin

src/servers/sso/index.md

Lines changed: 1 addition & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,18 +8,9 @@ resources and apps. It can be used as a backend for both OAuth2, SAML and OIDC.
88
This is supported by Google Workspace via LDAP as the source for accounts and
99
groups.
1010

11-
The service is hosted on the domain [https://goauthentik.io/][2] where a login
11+
The service is hosted on the domain [https://sso.kth.it/][2] where a login
1212
will also show a dashboard with available apps.
1313

14-
## Login flow
15-
16-
1. User navigates to app domain.
17-
2. User is redirected to the SSO service at [https://sso.kth.it][2].
18-
3. User needs to log in and is redirected to Google sign in.
19-
4. After sign in user is redirected back to the SSO service.
20-
5. User is checked against group and roles.
21-
6. If all OK, redirect back to the app requested.
22-
2314
## Auth proxy
2415

2516
Services that needs to be controlled by auth that we host ourselves can add

src/servers/sso/login_flow.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
# Login flow
2+
3+
1. User navigates to app domain. Ex. [https://lmixer.kth.it][1].
4+
2. User is redirected to the SSO service at [https://sso.kth.it][2].
5+
3. User needs to log in and is redirected to Google sign in.
6+
4. After sign in user is redirected back to the SSO service.
7+
5. User is checked against group and roles.
8+
6. If app is assigned to any group the user belongs to access is granted.
9+
7. If all OK, redirect back to the app that was requested.
10+
11+
[1]: https://lmixer.kth.it
12+
[2]: https://sso.kth.it

0 commit comments

Comments
 (0)