このセクションでは、操作を構成および監視できるようにするために validate_password が提供するシステム変数およびステータス変数について説明します。
validate_password コンポーネントが有効になっている場合、パスワードチェックの構成を有効にするいくつかのシステム変数が公開されます:
mysql> SHOW VARIABLES LIKE 'validate_password.%';
+--------------------------------------+--------+
| Variable_name | Value |
+--------------------------------------+--------+
| validate_password.check_user_name | ON |
| validate_password.dictionary_file | |
| validate_password.length | 8 |
| validate_password.mixed_case_count | 1 |
| validate_password.number_count | 1 |
| validate_password.policy | MEDIUM |
| validate_password.special_char_count | 1 |
+--------------------------------------+--------+パスワードのチェック方法を変更するには、サーバーの起動時または実行時にこれらのシステム変数を設定します。 次のリストは、各変数の意味を説明したものです。
-
validate_password.check_user_nameコマンド行形式 --validate-password.check-user-name[={OFF|ON}]システム変数 validate_password.check_user_nameスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 Boolean デフォルト値 ONvalidate_passwordで、現在のセッションの有効なユーザーアカウントのユーザー名部分とパスワードを比較し、一致する場合は拒否するかどうか。 この変数は、validate_passwordがインストールされていないかぎり使用できません。デフォルトでは、
validate_password.check_user_nameは有効です。 この変数は、validate_password.policyの値に関係なく、ユーザー名の一致を制御します。validate_password.check_user_nameを有効にすると、次の効果があります:チェックは、
validate_passwordが起動されるすべてのコンテキストで行われます。これには、ALTER USERやSET PASSWORDなどのステートメントを使用した現在のユーザーパスワードの変更、VALIDATE_PASSWORD_STRENGTH()などの関数の起動が含まれます。比較に使用されるユーザー名は、現行セッションの
USER()およびCURRENT_USER()関数の値から取得されます。 つまり、別のユーザーパスワードを設定するための十分な権限を持つユーザーは、そのユーザー名にパスワードを設定でき、そのユーザーパスワードをステートメントを実行するユーザーの名前に設定できません。 たとえば、'root'@'localhost'では'jeffrey'@'localhost'のパスワードを'jeffrey'に設定できますが、パスワードを'rootに設定することはできません。USER()およびCURRENT_USER()関数の値のユーザー名部分のみが使用され、ホスト名部分は使用されません。 ユーザー名が空の場合、比較は行われません。パスワードがユーザー名と同じであるか、その逆の場合、一致が発生し、パスワードは拒否されます。
ユーザー名の照合では、大文字と小文字が区別されます。 パスワードとユーザー名の値は、バイト単位でバイナリ文字列として比較されます。
パスワードがユーザー名と一致する場合、他の
validate_passwordシステム変数の設定方法に関係なく、VALIDATE_PASSWORD_STRENGTH()は 0 を返します。
-
validate_password.dictionary_fileコマンド行形式 --validate-password.dictionary-file=file_nameシステム変数 validate_password.dictionary_fileスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 ファイル名 validate_passwordがパスワードのチェックに使用するディクショナリファイルのパス名。 この変数は、validate_passwordがインストールされていないかぎり使用できません。デフォルトでは、この変数は空の値を持ち、辞書検査は実行されません。 ディクショナリチェックを実行するには、変数値を空にしないでください。 ファイル名が相対パスとして指定された場合、サーバーのデータディレクトリを基準として解釈されます。 ファイルの内容は小文字で、1 行につき 1 語にする必要があります。 内容は、
utf8の文字セットを持つものとして処理されます。 許可される最大のファイルサイズは 1M バイトです。パスワードチェック中にディクショナリファイルを使用するには、パスワードポリシーを 2 (
STRONG) に設定する必要があります。validate_password.policyシステム変数の説明を参照してください。 これが true である場合、長さが 4 から 100 までのパスワードの各部分文字列が辞書ファイル内の単語と比較されます。 いずれかが一致すると、パスワードが拒否されます。 比較では大文字と小文字は区別されません。VALIDATE_PASSWORD_STRENGTH()の場合、パスワードはSTRONGを含むすべてのポリシーに対してチェックされるため、強度評価にはvalidate_password.policy値に関係なくディクショナリチェックが含まれます。validate_password.dictionary_fileは実行時に設定でき、値を割り当てると、サーバーを再起動せずに名前付きファイルが読み取られます。 -
コマンド行形式 --validate-password.length=#システム変数 validate_password.lengthスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 Integer デフォルト値 8最小値 0validate_passwordがパスワードを必要とする最小文字数。 この変数は、validate_passwordがインストールされていないかぎり使用できません。validate_password.lengthの最小値は、他のいくつかの関連するシステム変数の関数です。 この式の値より小さい値は設定できません:validate_password.number_count + validate_password.special_char_count + (2 * validate_password.mixed_case_count)validate_passwordは、前述の制約のためにvalidate_password.lengthの値を調整すると、エラーログにメッセージを書き込みます。 -
validate_password.mixed_case_countコマンド行形式 --validate-password.mixed-case-count=#システム変数 validate_password.mixed_case_countスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 Integer デフォルト値 1最小値 0パスワードポリシーが
MEDIUM以上の場合に、validate_passwordがパスワードを必要とする小文字と大文字の最小数。 この変数は、validate_passwordがインストールされていないかぎり使用できません。特定の
validate_password.mixed_case_count値について、パスワードには小文字が多数含まれ、大文字が多数含まれている必要があります。 -
validate_password.number_countコマンド行形式 --validate-password.number-count=#システム変数 validate_password.number_countスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 Integer デフォルト値 1最小値 0パスワードポリシーが
MEDIUM以上の場合に、validate_passwordがパスワードを必要とする数字 (数字) の最小数。 この変数は、validate_passwordがインストールされていないかぎり使用できません。 -
コマンド行形式 --validate-password.policy=valueシステム変数 validate_password.policyスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 列挙 デフォルト値 1有効な値 012validate_passwordによって強制されるパスワードポリシー。 この変数は、validate_passwordがインストールされていないかぎり使用できません。validate_password.policyは、validate_password.check_user_nameによって独立して制御されるユーザー名に対するパスワードのチェックを除き、validate_passwordが他のポリシー設定システム変数を使用する方法に影響します。validate_password.policy値は、数値 0、1、2、または対応するシンボリック値LOW,MEDIUM,STRONGを使用して指定できます。 次の表では、それぞれのポリシーに対して実施されるテストについて説明します。 長さテストの場合、必要な長さはvalidate_password.lengthシステム変数の値です。 同様に、他のテストに必要な値は、他のvalidate_password.変数によって指定されます。xxxポリシー 実施されるテスト 0またはLOW長さ 1またはMEDIUM長さ。数値、小文字、大文字、および特殊文字 2またはSTRONG長さ。数値、小文字、大文字、および特殊文字。辞書ファイル -
validate_password.special_char_countコマンド行形式 --validate-password.special-char-count=#システム変数 validate_password.special_char_countスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 Integer デフォルト値 1最小値 0パスワードポリシーが
MEDIUM以上の場合に、validate_passwordがパスワードを必要とする英数字以外の最小文字数。 この変数は、validate_passwordがインストールされていないかぎり使用できません。
validate_password コンポーネントが有効になっている場合、操作情報を提供するステータス変数が公開されます:
mysql> SHOW STATUS LIKE 'validate_password.%';
+-----------------------------------------------+---------------------+
| Variable_name | Value |
+-----------------------------------------------+---------------------+
| validate_password.dictionary_file_last_parsed | 2019-10-03 08:33:49 |
| validate_password.dictionary_file_words_count | 1902 |
+-----------------------------------------------+---------------------+次のリストに、各ステータス変数の意味を示します。
MySQL 8.0 では、validate_password プラグインが validate_password コンポーネントとして再実装されました。 validate_password プラグインは非推奨です。将来のバージョンの MySQL で削除される予定です。 したがって、そのオプションも非推奨になり、それらも削除されることが予想されます。 プラグインを使用する MySQL インストールでは、かわりにコンポーネントの使用に移行する必要があります。 セクション6.4.3.3「パスワード検証コンポーネントへの移行」を参照してください。
validate_password プラグインのアクティブ化を制御するには、このオプションを使用します:
-
コマンド行形式 --validate-password[=value]型 列挙 デフォルト値 ON有効な値 ONOFFFORCEFORCE_PLUS_PERMANENTこのオプションは、サーバーが起動時に非推奨の
validate_passwordプラグインをロードする方法を制御します。 値はセクション5.6.1「プラグインのインストールおよびアンインストール」に記載されているような、プラグインロードオプション用に指定可能ないずれかの値とする必要があります。 たとえば、--validate-password=FORCE_PLUS_PERMANENTは、起動時にプラグインをロードし、サーバーの実行中にプラグインが削除されないようにサーバーに指示します。このオプションは、
validate_passwordプラグインが以前にINSTALL PLUGINに登録されているか、--plugin-load-addにロードされている場合にのみ使用できます。 セクション6.4.3.1「パスワード検証コンポーネントのインストールおよびアンインストール」を参照してください。
MySQL 8.0 では、validate_password プラグインが validate_password コンポーネントとして再実装されました。 validate_password プラグインは非推奨です。将来のバージョンの MySQL で削除される予定です。 したがって、そのシステム変数も非推奨になるため、これらも削除する必要があります。 かわりに、validate_password コンポーネントの対応するシステム変数を使用してください。パスワード検証コンポーネントのシステム変数 を参照してください。 プラグインを使用する MySQL インストールでは、かわりにコンポーネントの使用に移行する必要があります。 セクション6.4.3.3「パスワード検証コンポーネントへの移行」を参照してください。
-
validate_password_check_user_nameコマンド行形式 --validate-password-check-user-name[={OFF|ON}]システム変数 validate_password_check_user_nameスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 Boolean デフォルト値 ONこの
validate_passwordプラグインシステム変数は非推奨です。将来のバージョンの MySQL で削除される予定です。 かわりに、validate_passwordコンポーネントの対応するvalidate_password.check_user_nameシステム変数を使用してください。 -
validate_password_dictionary_fileコマンド行形式 --validate-password-dictionary-file=file_nameシステム変数 validate_password_dictionary_fileスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 ファイル名 この
validate_passwordプラグインシステム変数は非推奨です。将来のバージョンの MySQL で削除される予定です。 かわりに、validate_passwordコンポーネントの対応するvalidate_password.dictionary_fileシステム変数を使用してください。 -
コマンド行形式 --validate-password-length=#システム変数 validate_password_lengthスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 Integer デフォルト値 8最小値 0この
validate_passwordプラグインシステム変数は非推奨です。将来のバージョンの MySQL で削除される予定です。 かわりに、validate_passwordコンポーネントの対応するvalidate_password.lengthシステム変数を使用してください。 -
validate_password_mixed_case_countコマンド行形式 --validate-password-mixed-case-count=#システム変数 validate_password_mixed_case_countスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 Integer デフォルト値 1最小値 0この
validate_passwordプラグインシステム変数は非推奨です。将来のバージョンの MySQL で削除される予定です。 かわりに、validate_passwordコンポーネントの対応するvalidate_password.mixed_case_countシステム変数を使用してください。 -
validate_password_number_countコマンド行形式 --validate-password-number-count=#システム変数 validate_password_number_countスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 Integer デフォルト値 1最小値 0この
validate_passwordプラグインシステム変数は非推奨です。将来のバージョンの MySQL で削除される予定です。 かわりに、validate_passwordコンポーネントの対応するvalidate_password.number_countシステム変数を使用してください。 -
コマンド行形式 --validate-password-policy=valueシステム変数 validate_password_policyスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 列挙 デフォルト値 1有効な値 012この
validate_passwordプラグインシステム変数は非推奨です。将来のバージョンの MySQL で削除される予定です。 かわりに、validate_passwordコンポーネントの対応するvalidate_password.policyシステム変数を使用してください。 -
validate_password_special_char_countコマンド行形式 --validate-password-special-char-count=#システム変数 validate_password_special_char_countスコープ グローバル 動的 はい SET_VARヒントの適用いいえ 型 Integer デフォルト値 1最小値 0この
validate_passwordプラグインシステム変数は非推奨です。将来のバージョンの MySQL で削除される予定です。 かわりに、validate_passwordコンポーネントの対応するvalidate_password.special_char_countシステム変数を使用してください。
MySQL 8.0 では、validate_password プラグインが validate_password コンポーネントとして再実装されました。 validate_password プラグインは非推奨です。将来のバージョンの MySQL で削除される予定です。 その結果、そのステータス変数も非推奨になり、削除されることが予想されます。 validate_password コンポーネントの対応するステータス変数を使用します。パスワード検証コンポーネントのステータス変数 を参照してください。 プラグインを使用する MySQL インストールでは、かわりにコンポーネントの使用に移行する必要があります。 セクション6.4.3.3「パスワード検証コンポーネントへの移行」を参照してください。
-
validate_password_dictionary_file_last_parsedこの
validate_passwordプラグインステータス変数は非推奨です。将来のバージョンの MySQL で削除される予定です。 かわりに、validate_passwordコンポーネントの対応するvalidate_password.dictionary_file_last_parsedステータス変数を使用してください。 -
validate_password_dictionary_file_words_countこの
validate_passwordプラグインステータス変数は非推奨です。将来のバージョンの MySQL で削除される予定です。 かわりに、validate_passwordコンポーネントの対応するvalidate_password.dictionary_file_words_countステータス変数を使用してください。