Skip to content

Basic guide to using Zoraxy Auth

Toby Chui edited this page Aug 1, 2026 · 1 revision

Zoraxy Auth

Zoraxy Auth is the build in SSO feature of Zoraxy, which offers something similar to Authentik or Authelia but with more minimalistic feature sets and no external dependencies.

Setup Zoraxy Auth

Enable Zoraxy Auth

Under Security -> SSO -> Zoraxy Auth, enable the Zoraxy auth server and fill in the domain that you plan to use for SSO login. Here is an example: 圖片

Add Users to Zoraxy Auth

You would want to add users to Zoraxy Auth so they can access the site behind Zoraxy Auth. To do so, select "Manage Users" buttons and setup the account for your user accordingly. 圖片

Setup Auth URL Proxy Rule

Setup a new HTTP Proxy rule that points to the Zoraxy Auth listening port. Here is an example:

圖片

Add Zoraxy Auth to a HTTP Proxy Rule

After that, select a HTTP Proxy rule that you want to add SSO support to, and in the Authentication Provider options select Zoraxy Auth

圖片

Optionally, you might also assign a user permission to a Group Policy. If that is the case, you will need to first setup a Group Policy in the Group Policy tab and then proceed on creating the user.

圖片

User Portal

To change password or setup a user pass key, first navigate to the ${auth_url}(for example https://auth.localhost) and login, if you have already logged in, you can directly navigate to /user (for example https://auth.localhost/user) and afterward you will see an interface like this.

圖片

Setting up 2FA

You can optionally setup 2FA using TOTP by scrolling to the 2FA section and create a 2FA key.

Scan the QR code with your Authenticator App then following the on-screen instruction. 圖片

Setting up PassKey

You can also choose to authenticate using a physical PassKey. Scroll to the Passkey section and follow on-screen instruction to register your passkey. Note that some system might require OS level authorization to make it works, so make sure your system administrator has this feature enabled.

圖片

Clone this wiki locally