mirror of
https://github.com/0rangebananaspy/authelia.git
synced 2024-09-14 22:47:21 +07:00
83 lines
3.7 KiB
Markdown
83 lines
3.7 KiB
Markdown
# Nginx
|
|
|
|
[nginx] is the only official reverse proxy supported by **Authelia** for now.
|
|
|
|
## Configuration
|
|
|
|
Here is a commented example of configuration
|
|
|
|
server {
|
|
listen 443 ssl;
|
|
server_name myapp.example.com;
|
|
|
|
resolver 127.0.0.11 ipv6=off;
|
|
set $upstream_verify https://authelia.example.com/api/verify;
|
|
set $upstream_endpoint http://nginx-backend;
|
|
|
|
ssl_certificate /etc/ssl/server.crt;
|
|
ssl_certificate_key /etc/ssl/server.key;
|
|
|
|
# Use HSTS, please beware of what you're doing if you set it.
|
|
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
|
|
add_header X-Frame-Options "SAMEORIGIN";
|
|
|
|
location / {
|
|
# Send a subsequent request to Authelia to verify if the user is authenticated
|
|
# and has the right permissions to access the resource.
|
|
auth_request /auth_verify;
|
|
|
|
# Set the X-Forwarded-User and X-Forwarded-Groups with the headers
|
|
# returned by Authelia for the backends which can consume them.
|
|
# This is not safe, as the backend must make sure that they come from the
|
|
# proxy. In the future, it's gonna be safe to just use OAuth.
|
|
auth_request_set $user $upstream_http_remote_user;
|
|
proxy_set_header X-Forwarded-User $user;
|
|
|
|
auth_request_set $groups $upstream_http_remote_groups;
|
|
proxy_set_header X-Forwarded-Groups $groups;
|
|
|
|
# Set the `target_url` variable based on the request. It will be used to build the portal
|
|
# URL with the correct redirection parameter.
|
|
auth_request_set $target_url $scheme://$http_host$request_uri;
|
|
|
|
# If Authelia returns 401, then nginx redirects the user to the login portal.
|
|
# If it returns 200, then the request pass through to the backend.
|
|
# For other type of errors, nginx will handle them as usual.
|
|
# NOTE: do not forget to include /#/ representing the hash router of the web application.
|
|
error_page 401 =302 https://login.example.com:8080/#/?rd=$target_url;
|
|
|
|
proxy_pass $upstream_endpoint;
|
|
}
|
|
|
|
# Virtual endpoint created by nginx to forward auth requests.
|
|
location /auth_verify {
|
|
internal;
|
|
|
|
# [OPTIONAL] The IP of the client shown in Authelia logs.
|
|
proxy_set_header X-Real-IP $remote_addr;
|
|
|
|
# [REQUIRED] Needed by Authelia to check authorizations of the resource.
|
|
# Provide either X-Original-URL and X-Forwarded-Proto or
|
|
# X-Forwarded-Proto, X-Forwarded-Host and X-Forwarded-Uri or both.
|
|
# Those headers will be used by Authelia to deduce the target url of the user.
|
|
#
|
|
# X-Forwarded-Proto is mandatory since Authelia uses the "trust proxy" option.
|
|
# See https://expressjs.com/en/guide/behind-proxies.html
|
|
proxy_set_header X-Original-URL $scheme://$http_host$request_uri;
|
|
|
|
proxy_set_header X-Forwarded-Proto $scheme;
|
|
proxy_set_header X-Forwarded-Host $http_host;
|
|
proxy_set_header X-Forwarded-Uri $request_uri;
|
|
|
|
# [OPTIONAL] The list of IPs of client and proxies in the chain.
|
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
|
|
|
proxy_pass_request_body off;
|
|
proxy_set_header Content-Length "";
|
|
|
|
proxy_pass $upstream_verify;
|
|
}
|
|
}
|
|
|
|
|
|
[nginx]: https://www.nginx.com/ |