Joomla and MySQL 8: Difference between revisions

From Joomla! Documentation

← Older edit
Rolandd (talk | contribs)
Editors, JDOC Contributors
152 edits
Clarify text
Cmb (talk | contribs)
956 edits
Several markup and capitalization changes.
 
(9 intermediate revisions by 6 users not shown)
Line 1: Line 1:
==MySQL default authentication plugin issue==
<noinclude><languages /></noinclude>
It's not possible to connect to a MySQL 8 Database using Joomla 3.8, 3.9 or 4.0. The reason is that MySQL 8 has a lot of changes under the hood. One change that affects Joomla is the default authentication plugin which is <tt>sha256_password</tt> instead of <tt>mysql_native_password</tt>. The native PHP MySQL-Driver don't support MySQL 8 with this plugin yet other programming languages like GO or PERL are struggling too. [https://github.com/php/php-src/commit/d6e81f0bfd0cb90586dd83d4fd47a4302605261a PHP 7.3 (alpha)] is supporting MySQL 8 though.  
<translate>
==MySQL Default Authentication Plugin Issue== <!--T:1-->
</translate>
<translate><!--T:2--> It is possible to connect to a MySQL 8 Database using Joomla {{JVer|3.x}}, however it requires a customisation on the MySQL 8 installation configuration. The reason is that MySQL 8 has many low-level changes including the default authentication plugin changing to ''sha256_password'' from ''mysql_native_password''. The native PHP MySQL-Driver doesn't currently support MySQL 8 with this plugin. [https://github.com/php/php-src/commit/d6e81f0bfd0cb90586dd83d4fd47a4302605261a PHP 7.3 (alpha)] is supporting MySQL 8 though.</translate>


==Workaround to get Joomla working with MySQL 8==
<translate>
Fortunately there is a workaround! We can use the <tt>mysql_native_password</tt> default authentication plugin for MySQL.
==MySQL Configuration Change to Get Joomla Working with MySQL 8== <!--T:3-->
We need to open our configuration file <tt>sudo nano /etc/my.cnf</tt> (Please note that your file may be under a different directory) and add the following configuration:  
</translate>
<source lang="ini">
<translate><!--T:4-->
If you edit the configuration file for MySQL 8, you can change the default authentication plugin for MySQL to use the older ''mysql_native_password''.
Open your configuration file ''sudo nano /etc/my.cnf''. (Note that your file may be under a different directory.) Add this configuration:</translate>
<syntaxhighlight lang="ini">
[mysqld]
[mysqld]
default-authentication-plugin=mysql_native_password
default-authentication-plugin=mysql_native_password
</source>  
</syntaxhighlight>
If you don't have access to your config file then you can update your user as follows:
<translate><!--T:5--> If you don't have access to your config file, you can update your user:</translate>
<source lang="mysql">
<syntaxhighlight lang="mysql">
ALTER USER 'username'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';
ALTER USER 'username'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';
</source>  
</syntaxhighlight>
Replace username with the name of the user account and password with the password belonging to the account. Restart MySQL and you are done, well only if you have Joomla 3.8 or 3.9 installed.
<translate><!--T:6--> Replace ''username'' with the name of the user account and ''password'' with the password belonging to the account. Restart MySQL and you are done. Well, only if you have Joomla 3.8 or 3.9 installed.</translate>


If you want to work with Joomla 4.0 you have to do some extra work, because the administration dashboard is blank after the installation with Joomla 4.0 and MySQL 8.
<translate>
==How MySQL Default Authentication Plugin Works== <!--T:11-->
</translate>
<translate><!--T:12--> The advantage of ''mysql_native_password'' is that it supports the challenge/response mechanism which is quick and does not require encrypted connection. However, ''mysql_native_password'' relies on SHA1 algorithm and NIST has recommended to stop using it.</translate>


Fortunately there is a fix for that too!
<translate><!--T:13--> Further, if two user accounts use the same password, ''mysql_native_password'' transformation is the same in the ''mysql.user'' table. Although the hash does not expose information about the actual password, it still tells which two users use the same password. To avoid that, a salt should be used. A salt is a random number that is used as one of the parameters to cryptographic hash functions used to transform user passwords. Since a salt is random and different for each execution, even if two users use the same passwords, the end result of transformation would look different.</translate>
MySQL 8 is returning <tt>Incorrect date value: '0000-00-00'</tt> after running following insertion from the installation file <tt>/installation/sql/mysql/joomla.sql</tt>. The following queries must be run to fix this.
<source lang=sql>
UPDATE `#__modules` SET `checked_out_time` = '1001-01-01 00:00:00', `publish_up` = '1001-01-01 00:00:00', `publish_down` = '1001-01-01 00:00:00';
</source>


This is happening because since MySQL 5.7, MySQL stops supporting zeros value in date / datetime.
<translate>
<!--T:14-->
Since MySQL 5.6, the ''sha256_password'' authentication plugin is supported. It uses multiple rounds of SHA256 hash on a salted password to make sure that the hash transformation is more secure. However, it requires either encrypted connections or support for an RSA key pair. So, while password security is stronger, secure connections and multiple rounds of hash transformations require more time in the authentication process.</translate>


==How MySQL default authentication plugin works==
<translate><!--T:15--> The ''caching_sha2_password'' tries to combine the best of both worlds.</translate> <ref>https://mysqlserverteam.com/mysql-8-0-4-new-default-authentication-plugin-caching_sha2_password/</ref>
The advantage of <tt>mysql_native_password</tt> is that it supports challenge-response mechanism which is very quick and does not require encrypted connection. However, <tt>mysql_native_password</tt> relies on SHA1 algorithm and NIST has suggested to stop using it.
 
Further, if two user accounts use the same password, <tt>mysql_native_password</tt> transformation is the same in the mysql.user table. Although the hash does not expose information about the actual password, it still tells which two users use the same password. To avoid that, salt should be used. Salt is basically a random number that is used as one of the inputs to cryptographic hash functions used to transform user passwords. Since salt is random and different for each execution, even if two users use the same passwords, the end result of transformation would look very different.
 
Since MySQL 5.6, sha256_password authentication plugin is supported. It uses multiple rounds of SHA256 hash on a salted password to make sure that the hash transformation is more secure. However, it requires either encrypted connections or support for an RSA key pair. So, while password security is stronger, secure connections and multiple rounds of hash transformations require more time in the authentication process.
 
caching_sha2_password tries to combine the best of both worlds. <ref>https://mysqlserverteam.com/mysql-8-0-4-new-default-authentication-plugin-caching_sha2_password/</ref>


<noinclude>
<noinclude>
[[Category:Server configurations]]
[[Category:Server configurations{{#translation:}}]]
[[Category:Installation]]
[[Category:Installation{{#translation:}}]]
[[Category:Tutorials]]
[[Category:Tutorials{{#translation:}}]]
</noinclude>
</noinclude>

Latest revision as of 22:42, 27 November 2022

Other languages:

MySQL Default Authentication Plugin Issue

It is possible to connect to a MySQL 8 Database using Joomla Joomla 3.x, however it requires a customisation on the MySQL 8 installation configuration. The reason is that MySQL 8 has many low-level changes including the default authentication plugin changing to sha256_password from mysql_native_password. The native PHP MySQL-Driver doesn't currently support MySQL 8 with this plugin. PHP 7.3 (alpha) is supporting MySQL 8 though.

MySQL Configuration Change to Get Joomla Working with MySQL 8

If you edit the configuration file for MySQL 8, you can change the default authentication plugin for MySQL to use the older mysql_native_password. Open your configuration file sudo nano /etc/my.cnf. (Note that your file may be under a different directory.) Add this configuration: 

[mysqld]
default-authentication-plugin=mysql_native_password

If you don't have access to your config file, you can update your user: 

ALTER USER 'username'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';

Replace username with the name of the user account and password with the password belonging to the account. Restart MySQL and you are done. Well, only if you have Joomla 3.8 or 3.9 installed.

How MySQL Default Authentication Plugin Works

The advantage of mysql_native_password is that it supports the challenge/response mechanism which is quick and does not require encrypted connection. However, mysql_native_password relies on SHA1 algorithm and NIST has recommended to stop using it.

Further, if two user accounts use the same password, mysql_native_password transformation is the same in the mysql.user table. Although the hash does not expose information about the actual password, it still tells which two users use the same password. To avoid that, a salt should be used. A salt is a random number that is used as one of the parameters to cryptographic hash functions used to transform user passwords. Since a salt is random and different for each execution, even if two users use the same passwords, the end result of transformation would look different.

Since MySQL 5.6, the sha256_password authentication plugin is supported. It uses multiple rounds of SHA256 hash on a salted password to make sure that the hash transformation is more secure. However, it requires either encrypted connections or support for an RSA key pair. So, while password security is stronger, secure connections and multiple rounds of hash transformations require more time in the authentication process.

The caching_sha2_password tries to combine the best of both worlds. [1]

  1. ↑ https://mysqlserverteam.com/mysql-8-0-4-new-default-authentication-plugin-caching_sha2_password/
Retrieved from "https://docs.sandbox.joomla.org/index.php?title=Joomla_and_MySQL_8&oldid=995452"