2021-04-29 16:17:10 +00:00
|
|
|
---
|
2021-06-08 21:10:17 +00:00
|
|
|
title: Forward auth
|
2021-04-29 16:17:10 +00:00
|
|
|
---
|
|
|
|
|
2021-06-08 21:10:17 +00:00
|
|
|
Using forward auth uses your existing reverse proxy to do the proxying, and only uses the
|
2021-09-24 13:37:54 +00:00
|
|
|
authentik outpost to check authentication and authorization.
|
2021-04-29 16:17:10 +00:00
|
|
|
|
2021-06-08 21:10:17 +00:00
|
|
|
To use forward auth instead of proxying, you have to change a couple of settings.
|
|
|
|
In the Proxy Provider, make sure to use one of the Forward auth modes.
|
|
|
|
|
|
|
|
## Single application
|
|
|
|
|
|
|
|
Single application mode works for a single application hosted on its dedicated subdomain. This
|
|
|
|
has the advantage that you can still do per-application access policies in authentik.
|
2021-04-29 16:17:10 +00:00
|
|
|
|
2021-06-08 21:10:17 +00:00
|
|
|
## Domain level
|
2021-04-29 16:17:10 +00:00
|
|
|
|
2021-06-08 21:10:17 +00:00
|
|
|
To use forward auth instead of proxying, you have to change a couple of settings.
|
|
|
|
In the Proxy Provider, make sure to use the *Forward auth (domain level)* mode.
|
2021-04-29 16:17:10 +00:00
|
|
|
|
2021-06-08 21:10:17 +00:00
|
|
|
This mode differs from the *Forward auth (single application)* mode in the following points:
|
|
|
|
- You don't have to configure an application in authentik for each domain
|
|
|
|
- Users don't have to authorize multiple times
|
2021-05-14 09:42:03 +00:00
|
|
|
|
2021-06-08 21:10:17 +00:00
|
|
|
There are however also some downsides, mainly the fact that you **can't** restrict individual
|
|
|
|
applications to different users.
|
2021-05-14 09:42:03 +00:00
|
|
|
|
2021-06-08 21:10:17 +00:00
|
|
|
The only configuration difference between single application and domain level is the host you specify.
|
2021-05-14 09:42:03 +00:00
|
|
|
|
2022-02-16 09:19:33 +00:00
|
|
|
For single application, you'd use the domain which the application is running on, and only /outpost.goauthentik.io
|
2021-09-24 13:37:54 +00:00
|
|
|
is redirected to the outpost.
|
2021-04-29 16:17:10 +00:00
|
|
|
|
2021-06-08 21:10:17 +00:00
|
|
|
For domain level, you'd use the same domain as authentik.
|
2021-04-29 16:17:10 +00:00
|
|
|
|
2021-07-23 14:07:47 +00:00
|
|
|
:::info
|
|
|
|
*example-outpost* is used as a placeholder for the outpost name.
|
2021-09-17 07:47:27 +00:00
|
|
|
*authentik.company* is used as a placeholder for the authentik install.
|
2021-11-26 12:29:38 +00:00
|
|
|
*app.company* is used as a placeholder for the external domain for the application.
|
|
|
|
*outpost.company* is used as a placeholder for the outpost. When using the embedded outpost, this can be the same as *authentik.company*
|
2021-07-23 14:07:47 +00:00
|
|
|
:::
|
|
|
|
|
2021-04-29 16:17:10 +00:00
|
|
|
## Nginx
|
|
|
|
|
|
|
|
import Tabs from '@theme/Tabs';
|
|
|
|
import TabItem from '@theme/TabItem';
|
|
|
|
|
|
|
|
<Tabs
|
|
|
|
defaultValue="standalone-nginx"
|
|
|
|
values={[
|
|
|
|
{label: 'Standalone nginx', value: 'standalone-nginx'},
|
|
|
|
{label: 'Ingress', value: 'ingress'},
|
2021-11-12 21:57:19 +00:00
|
|
|
{label: 'Nginx Proxy Manager', value: 'proxy-manager'},
|
2021-04-29 16:17:10 +00:00
|
|
|
]}>
|
|
|
|
<TabItem value="standalone-nginx">
|
|
|
|
|
2021-11-12 21:57:19 +00:00
|
|
|
import NginxStandalone from './_nginx_standalone.md'
|
|
|
|
|
|
|
|
<NginxStandalone />
|
2021-04-29 16:17:10 +00:00
|
|
|
|
|
|
|
</TabItem>
|
|
|
|
<TabItem value="ingress">
|
2021-11-12 21:57:19 +00:00
|
|
|
|
|
|
|
import NginxIngress from './_nginx_ingress.md'
|
|
|
|
|
|
|
|
<NginxIngress />
|
|
|
|
|
|
|
|
</TabItem>
|
|
|
|
<TabItem value="proxy-manager">
|
|
|
|
|
|
|
|
import NginxProxyManager from './_nginx_proxy_manager.md'
|
|
|
|
|
|
|
|
<NginxProxyManager />
|
|
|
|
|
2021-04-29 16:17:10 +00:00
|
|
|
</TabItem>
|
|
|
|
</Tabs>
|
|
|
|
|
|
|
|
## Traefik
|
|
|
|
|
|
|
|
<Tabs
|
|
|
|
defaultValue="standalone-traefik"
|
|
|
|
values={[
|
|
|
|
{label: 'Standalone traefik', value: 'standalone-traefik'},
|
|
|
|
{label: 'docker-compose', value: 'docker-compose'},
|
|
|
|
{label: 'Ingress', value: 'ingress'},
|
|
|
|
]}>
|
|
|
|
<TabItem value="standalone-traefik">
|
|
|
|
|
2021-11-12 21:57:19 +00:00
|
|
|
import TraefikStandalone from './_traefik_standalone.md'
|
|
|
|
|
|
|
|
<TraefikStandalone />
|
|
|
|
|
2021-04-29 16:17:10 +00:00
|
|
|
</TabItem>
|
|
|
|
<TabItem value="docker-compose">
|
2021-05-07 12:08:30 +00:00
|
|
|
|
2021-11-12 21:57:19 +00:00
|
|
|
import TraefikCompose from './_traefik_compose.md'
|
|
|
|
|
|
|
|
<TraefikCompose />
|
2021-05-07 12:08:30 +00:00
|
|
|
|
2021-04-29 16:17:10 +00:00
|
|
|
</TabItem>
|
|
|
|
<TabItem value="ingress">
|
2021-08-29 18:46:17 +00:00
|
|
|
|
2021-11-12 21:57:19 +00:00
|
|
|
import TraefikIngress from './_traefik_ingress.md'
|
|
|
|
|
|
|
|
<TraefikIngress />
|
|
|
|
|
2021-04-29 16:17:10 +00:00
|
|
|
</TabItem>
|
|
|
|
</Tabs>
|