split docs (#1533)

src/main/docs/guide/authenticationProviders.adoc

@@ -6,9 +6,3 @@ The following code snippet illustrates a naive implementation:
 ----
 include::{testssecurity}/security/token/basicauth/AuthenticationProviderUserPassword.java[tag=clazz,indent=0]
 ----
-
-The built-in <<login, Login Controller>> uses every available authentication provider. The first provider that returns a successful authentication response will have its value used as the basis for the JWT token or session state.
-
-Basic authentication which is implemented as an api:security.filters.AuthenticationFetcher[] will also trigger the available api:security.authentication.AuthenticationProvider[]s.
-
-Micronaut comes with authentication providers for LDAP and the OAuth 2.0 password grant authentication flow. For any custom authentication, an authentication provider must be created.

src/main/docs/guide/authenticationProviders/authenticationProvidersUseCases.adoc

@@ -0,0 +1,3 @@
+The built-in <<login, Login Controller>> uses every available authentication provider. The first provider that returns a successful authentication response will have its value used as the basis for the JWT token or session state.
+
+Basic authentication which is implemented as an api:security.filters.AuthenticationFetcher[] will also trigger the available api:security.authentication.AuthenticationProvider[]s.

src/main/docs/guide/authenticationProviders/builtInAuthenticationProviders.adoc

@@ -0,0 +1 @@
+Micronaut comes with authentication providers for LDAP (api:security.ldap.LdapAuthenticationProvider[]) and the OAuth 2.0 password grant authentication flow (api:security.oauth2.endpoint.token.request.password.OauthPasswordAuthenticationProvider[] and api:security.oauth2.endpoint.token.request.password.OpenIdPasswordAuthenticationProvider[]). For any custom authentication, an authentication provider must be created.

src/main/docs/guide/toc.yml

@@ -14,7 +14,10 @@ securityConfiguration:
   logoutHandler: Logout Handler
   noRedirection: Handlers without redirection
   redirection: Redirection Configuration
-authenticationProviders: Authentication Providers
+authenticationProviders:
+  title: Authentication Providers
+  authenticationProvidersUseCases: Authentication Providers Use Cases
+  builtInAuthenticationProviders: Built-In Authentication Providers
 securityRule:
   title: Security Rules
   ipPattern: IP Pattern Rule