//
// Licensed to the Apache Software Foundation (ASF) under one
// or more contributor license agreements.  See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership.  The ASF licenses this file
// to you under the Apache License, Version 2.0 (the
// "License"); you may not use this file except in compliance
// with the License.  You may obtain a copy of the License at
//
//   http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing,
// software distributed under the License is distributed on an
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied.  See the License for the
// specific language governing permissions and limitations
// under the License.
//
=== Authentication Modules

Authentication Modules allow to specify how <<web-access,WA>> shall check the provided credentials against specific
technology or repository, in the context of a certain <<policies-authentication,Authentication Policy>>.

Several authentication modules are provided:

* Principal Authentication:
    ** https://apereo.github.io/cas/7.2.x/authentication/Database-Authentication.html[Database^]
    ** https://apereo.github.io/cas/7.2.x/authentication/JAAS-Authentication.html[JAAS^]
    ** https://apereo.github.io/cas/7.2.x/authentication/LDAP-Authentication.html[LDAP^]
    ** https://apereo.github.io/cas/7.2.x/authentication/SPNEGO-Authentication.html[SPNEGO^]
    ** https://apereo.github.io/cas/7.2.x/authentication/Syncope-Authentication.html[Syncope^]
    ** https://apereo.github.io/cas/7.2.x/authentication/Azure-ActiveDirectory-Authentication.html[Azure Active Directory^]
    ** https://apereo.github.io/cas/7.2.x/authentication/Okta-Authentication.html[Okta^]
    ** https://apereo.github.io/cas/7.2.x/authentication/X509-Authentication.html[X509^]
    ** https://apereo.github.io/cas/7.2.x/integration/Delegate-Authentication-Generic-OpenID-Connect.html[OpenID Connect^]
    ** https://apereo.github.io/cas/7.2.x/integration/Delegate-Authentication-OAuth20.html[OAuth2^]
    ** https://apereo.github.io/cas/7.2.x/integration/Delegate-Authentication-SAML.htmll[SAML^]
    ** https://apereo.github.io/cas/7.2.x/integration/Delegate-Authentication-Apple.html[Apple Signin^]
    ** https://apereo.github.io/cas/7.2.x/integration/Delegate-Authentication-Azure-AD.html[Azure Active Directory (OIDC)^]
    ** https://apereo.github.io/cas/7.2.x/integration/Delegate-Authentication-Google-OpenID-Connect.html[Google OpenID^]
    ** https://apereo.github.io/cas/7.2.x/integration/Delegate-Authentication-Keycloak.html[Keycloak^]
* MFA:
    ** https://apereo.github.io/cas/7.2.x/mfa/DuoSecurity-Authentication.html[Duo Security^]
    ** https://apereo.github.io/cas/7.2.x/mfa/GoogleAuthenticator-Authentication.html[Google Authenticator^]

[TIP]
====
Custom authentication modules can be provided by implementing the
ifeval::["{snapshotOrRelease}" == "release"]
https://github.com/apache/syncope/blob/syncope-{docVersion}/common/am/lib/src/main/java/org/apache/syncope/common/lib/auth/AuthModuleConf.java[AuthModuleConf^]
endif::[]
ifeval::["{snapshotOrRelease}" == "snapshot"]
https://github.com/apache/syncope/blob/4_0_X/common/am/lib/src/main/java/org/apache/syncope/common/lib/auth/AuthModuleConf.java[AuthModuleConf^]
endif::[]
interface and extending appropriately the
ifeval::["{snapshotOrRelease}" == "release"]
https://github.com/apache/syncope/blob/syncope-{docVersion}/wa/bootstrap/src/main/java/org/apache/syncope/wa/bootstrap/WAPropertySourceLocator.java[WAPropertySourceLocator^]
endif::[]
ifeval::["{snapshotOrRelease}" == "snapshot"]
https://github.com/apache/syncope/blob/4_0_X/wa/bootstrap/src/main/java/org/apache/syncope/wa/bootstrap/WAPropertySourceLocator.java[WAPropertySourceLocator^]
endif::[]
class.
====

[NOTE]
Authentication Modules are dynamically translated into
https://apereo.github.io/cas/7.2.x/authentication/Configuring-Authentication-Components.html#authentication-handlers[CAS Authentication Handlers^].
