.. _authentication-ref:

Authentication Plugins
======================

|RCE| provides a built in authentication plugin ``rhodecode.lib.auth_rhodecode``. This is enabled by default and
accessed through the administrative interface. Additionally, |RCE| provides a Pluggable Authentication
System (PAS). This gives the administrator greater control over how users authenticate with the system.

 .. note::

    If you disable the default ``rhodecode.lib.auth_rhodecode`` authentication plugin and your external
    authentication tools fails, you will be unable to access the |RCE| administrative interface.

PAS allows administrators to plug in their own authentication service to manage user access to their
instance of |RCE|. To manage all user authentication plugins and settings, use the administrative interface:
|buttonAdmin| > |buttonAuthentication|

.. include:: ldap-config-steps.rst

.. include:: ldap-authentication.rst