PS-9326 Add authentication methods (#378)

On branch ps-9326
	new file:   docs/authentication-methods.md
	new file:   docs/configure-authentication.md
	modified:   mkdocs-base.yml

docs/authentication-methods.md

@@ -0,0 +1,29 @@
+# Authentication methods
+
+An authentication method is a way to verify the identity of a user trying to access the database. It defines how the server checks if the credentials provided are correct and whether the user can connect.
+
+## Version changes
+
+MySQL 8.4 disables the deprecated `mysql_native_password` authentication plugin by default.
+
+To use this plugin, you must explicitly enable it. You can do this in two ways:
+
+* Add the new `--mysql-native-password=ON` option when starting the MySQL server.
+
+* Edit your MySQL configuration file. In the `[mysqld]` section, add the line `mysql_native_password=ON`.
+
+Either of these ways let you continue using the authentication method if needed, but we encourage the adoption of more secure authentication methods.
+
+## Common Authentication Methods
+
+
+| Method                              | Description                                                                                                                                                                                   |
+|-------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Caching SHA-2 Pluggable Authentication | Uses SHA-256 for password hashing. MySQL hashes the user's password and compares it to the stored hash. It caches authentication data for better performance. Suitable for modern setups with strong security and performance. However, it may not work with older MySQL clients. |
+| MySQL Native Authentication      | An older method that uses SHA-1 for password hashing. It offers wide compatibility, making it useful for legacy systems or applications that don't support newer methods. However, it has reduced security and is best avoided unless necessary for compatibility.                |
+| PAM Pluggable Authentication     | Integrates MySQL with Linux's Pluggable Authentication Modules (PAM). MySQL relies on the operating system for authentication, allowing for various authentication mechanisms. Useful in environments needing centralized authentication management, but setup can be complex.       |
+| LDAP Authentication              | MySQL connects to an LDAP server to authenticate users. Ideal for managing large, distributed systems, enabling centralized user management, and integrating with existing directory services. The main drawback is the added complexity of maintaining an LDAP server.              |
+| Kerberos Authentication          | Uses the Kerberos protocol for authentication. Provides strong security and single sign-on across multiple services. Common in enterprise environments but requires a complex Kerberos infrastructure.                                                              |
+| FIDO Pluggable Authentication    | Supports FIDO (Fast IDentity Online) authentication devices. Used in high-security environments for robust two-factor authentication. Requires special hardware like security keys and may face user resistance.                                                          |
+| Auth Socket Authentication       | Uses the operating system's socket-based authentication, matching the connecting user with the system user that owns the MySQL process. Ideal for local administrative access but limited to local machine use and not suitable for remote or multi-user environments.        |
+

mkdocs-base.yml

@@ -265,6 +265,7 @@ nav:
         - isolation-levels.md
         - transaction-mgmt.md
         - views.md
+        - authentication-methods.md
     - extended-show-grants.md
     - restrict-dynamic-log-locations.md
     - clone-plugin.md