awx/docs/auth/README.md
Djebran Lezzoum 2c2694ce89 Remove RADIUS authentication (#15548)
Remove RADIUS authentication from AWX

Do not remove models fields and tables let it for a stage where all the work of removing external auth finished AAP-27707

Co-authored-by: Hao Liu <44379968+TheRealHaoLiu@users.noreply.github.com>
2024-10-15 17:43:32 -04:00

1.5 KiB

This folder describes third-party authentications supported by AWX. These authentications can be configured and enabled inside AWX.

When a user wants to log into AWX, she can explicitly choose some of the supported authentications to log in instead of AWX's own authentication using username and password. Here is a list of such authentications:

  • Google OAuth2
  • Github OAuth2
  • Github Organization OAuth2
  • Github Team OAuth2
  • Github Enterprise OAuth2
  • Github Enterprise Organization OAuth2
  • Github Enterprise Team OAuth2
  • Microsoft Azure Active Directory (AD) OAuth2

On the other hand, the other authentication methods use the same types of login info (username and password), but authenticate using external auth systems rather than AWX's own database. If some of these methods are enabled, AWX will try authenticating using the enabled methods before AWX's own authentication method. The order of precedence is:

  • SAML

Notes:

  • Enterprise users can only be created via the first successful login attempt from remote authentication backend.
  • Enterprise users cannot be created/authenticated if non-enterprise users with the same name has already been created in AWX.
  • AWX passwords of Enterprise users should always be empty and cannot be set by any user if there are enterprise backends enabled.
  • If enterprise backends are disabled, an Enterprise user can be converted to a normal AWX user by setting password field. But this operation is irreversible (the converted AWX user can no longer be treated as Enterprise user).