Skip to content

Commit

Permalink
Update authorization.adoc
Browse files Browse the repository at this point in the history
  • Loading branch information
jamesread authored Jan 27, 2024
1 parent 263cd97 commit 89fd00c
Showing 1 changed file with 5 additions and 1 deletion.
6 changes: 5 additions & 1 deletion authorization.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,11 @@ See <<auth-concepts,concepts>> for a good overview of how this works in OliveTin
[#auth-concepts]
=== Concepts

OliveTin does not have any built-in code for doing **Authentication** (eg: entering a username and password), however it can do **Authorization** by relying on another system like a reverse proxy or "homepage" tool to first login users. OliveTin is often deployed alongside <<reverse-proxies,reverse proxies>> like Traefik and Organizr, which pass a special "token" to OliveTin, so OliveTin knows when a user has been authenticated.
OliveTin does not have any built-in code for doing **Authentication** (ie: entering a username and password), however it can do **Authorization** (ie: checking permissions of a user who logged in via another system, like simgle sign on).

A popular way of deploying OliveTin is by users accessing it via another system, like a <<reverse-proxies,reverse proxy>> (eg: Traefik) or a "homepage" app (eg: Organizr). Both of these are used to handle user authentication first, before users then access OliveTin. Permissions can then be applied inside OliveTin depending on who has logged in.

The flow generally goes like this;

1. User browses to a website like Organizr and logs in, which sets a JWT Cookie for apps.example.com.
2. User browses to OliveTin.apps.example.com, and the cookie is sent to OliveTin.
Expand Down

0 comments on commit 89fd00c

Please sign in to comment.