# MySQL/MariaDBの設定プロパティ

{% hint style="info" %}
本ページに記載のプロパティは、MySQL認証を使用している場合にのみ適用されます。MySQL認証のサポートは、[`kcm-guacamole-auth-jdbc-mysql`パッケージを使用してインストール](https://github.com/Keeper-Security/gitbook-jp-kcm/blob/main/advanced-configuration/guacamole.properties/broken-reference/README.md)します。[keeper/guacamoleのDockerイメージ](https://docs.keeper.io/keeper-connection-manager/installation/docker-compose-install/keeper-guacamole)を使用する場合、MySQL認証のサポートは、環境変数を使用して設定します。
{% endhint %}

* [TCP接続情報](#id-.mysql-mariadbconfigurationpropertiesv2.x-tcpconnectioninformation)
* [データベース名とクレデンシャル](#id-.mysql-mariadbconfigurationpropertiesv2.x-databasenameandcredentials)
* [データベースのパスワードポリシー](#id-.mysql-mariadbconfigurationpropertiesv2.x-databasepasswordpolicies)
  * パスワードの最小長と複雑さ
  * パスワードの最小/最大有効期間
  * パスワードの使い回しを防止
* [データベース同時接続数の制限](#id-.mysql-mariadbconfigurationpropertiesv2.x-databaseconcurrentconnectionlimits)
  * 同時接続の一般的な制限
  * ユーザーあたりの同時接続の制限
  * 絶対的な同時接続の制限
* [データベースのユーザーアカウントの要件](#id-.mysql-mariadbconfigurationpropertiesv2.x-require-userdatabaseuseraccountrequirements)

### TCP接続情報 <a href="#id-.mysql-mariadbconfigurationpropertiesv2.x-tcpconnectioninformation" id="id-.mysql-mariadbconfigurationpropertiesv2.x-tcpconnectioninformation"></a>

MySQL/MariaDBデータベースのTCP接続の詳細情報。

| プロパティ名           | デフォルト値    | 説明                                         |
| ---------------- | --------- | ------------------------------------------ |
| `mysql-hostname` | localhost | データベースサーバーのホスト名。                           |
| `mysql-port`     | 3306      | データベースサーバーで実行されているMySQLまたはMariaDBサービスのポート。 |

### データベース名とクレデンシャル <a href="#id-.mysql-mariadbconfigurationpropertiesv2.x-databasenameandcredentials" id="id-.mysql-mariadbconfigurationpropertiesv2.x-databasenameandcredentials"></a>

使用するデータベースの名前と、データベースに接続するときに使用するクレデンシャルです。データベースのいずれかの認証拡張機能を使用する場合は、**これらのプロパティが必要**です。

| プロパティ名           | 説明                                      |
| ---------------- | --------------------------------------- |
| `mysql-database` | Guacamoleがクエリを発行する先のデータベース名。            |
| `mysql-username` | Guacamoleがデータベースに接続するために使用するユーザーのユーザー名。 |
| `mysql-password` | データベースでの認証時にGuacamoleが指定するパスワード。        |

### データベースのパスワードポリシー <a href="#id-.mysql-mariadbconfigurationpropertiesv2.x-databasepasswordpolicies" id="id-.mysql-mariadbconfigurationpropertiesv2.x-databasepasswordpolicies"></a>

パスワードの複雑さ、長さ、変更頻度、使い回しに関して、すべてのデータベースユーザーに適用する制限となります。

{% hint style="danger" %}
これらのプロパティは、データベースの外部で定義されたユーザーには適用されません。
{% endhint %}

#### パスワードの最小長と複雑さ <a href="#id-.mysql-mariadbconfigurationpropertiesv2.x-minimumpasswordlengthandcomplexity" id="id-.mysql-mariadbconfigurationpropertiesv2.x-minimumpasswordlengthandcomplexity"></a>

| プロパティ名                                      | デフォルト値 | 説明                                                                                                       |
| ------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------- |
| `mysql-user-password-min-length`            | 0      | 各パスワードの最小長 (文字単位)。指定した場合、ユーザーはパスワードをこの長さ未満の値に変更できなくなります。デフォルトでは、最小長は強制されません。空のパスワードは許可されません。             |
| `mysql-user-password-require-multiple-case` | false  | 「true」に設定した場合、すべてのパスワードが少なくとも1つの大文字と1つの小文字を使用する必要があります。デフォルトでは、パスワードに大文字と小文字を混在させる必要はありません。              |
| `mysql-user-password-require-symbol`        | false  | 「true」に設定した場合、すべてのパスワードが少なくとも1つの記号を使用する必要があります (「記号」とは英数字以外の任意の文字)。デフォルトでは、パスワードに記号を使用する必要はありません。        |
| `mysql-user-password-require-digit`         | false  | 「true」に設定した場合、すべてのパスワードが少なくとも1つの数字を使用する必要があります (「数字」とは任意の数を表わす文字)。デフォルトでは、パスワードに数字を使用する必要はありません。         |
| `mysql-user-password-prohibit-username`     | false  | 「true」に設定した場合、大文字と小文字に関係なく、パスワードにユーザー自身のユーザー名を使用することが禁止されます。デフォルトでは、パスワードにユーザー自身のユーザー名を使用することは禁止されていません。 |

#### パスワードの最小/最大有効期間 <a href="#id-.mysql-mariadbconfigurationpropertiesv2.x-minimum-maximumpasswordage" id="id-.mysql-mariadbconfigurationpropertiesv2.x-minimum-maximumpasswordage"></a>

| プロパティ名                        | 説明                                                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------------------------------ |
| `mysql-user-password-min-age` | パスワードを変更するまでに経過する必要のある最小日数 (ユーザーがパスワードを頻繁に変更しすぎないようにし、パスワードの流用を無効にするための保護)。デフォルトでは、パスワード変更頻度に制限はありません。 |
| `mysql-user-password-max-age` | ユーザーがパスワードの変更を求められるまでの最大経過日数。デフォルトでは、ユーザーのパスワードは自動的には失効しません。                                           |

#### パスワード使い回しの防止 <a href="#id-.mysql-mariadbconfigurationpropertiesv2.x-passwordreuseprevention" id="id-.mysql-mariadbconfigurationpropertiesv2.x-passwordreuseprevention"></a>

| プロパティ名                             | 説明                                                                                              |
| ---------------------------------- | ----------------------------------------------------------------------------------------------- |
| `mysql-user-password-history-size` | ユーザーごとに記憶する必要のある過去のパスワードの数。指定した場合、ユーザーはこれらのパスワードを使い回しできなくなります。デフォルトでは、過去のパスワードの使い回し用は禁止されていません。 |

### データベース同時接続数の制限 <a href="#id-.mysql-mariadbconfigurationpropertiesv2.x-databaseconcurrentconnectionlimits" id="id-.mysql-mariadbconfigurationpropertiesv2.x-databaseconcurrentconnectionlimits"></a>

接続全体でデフォルトとして適用される同時使用制限です。ただし、絶対的な同時接続制限を除き、これらの制限は管理者が各接続を編集することで、接続単位で上書きすることが可能です。

#### 同時接続の一般的な制限 <a href="#id-.mysql-mariadbconfigurationpropertiesv2.x-generalconnectionconcurrencylimits" id="id-.mysql-mariadbconfigurationpropertiesv2.x-generalconnectionconcurrencylimits"></a>

| プロパティ名                                | デフォルト値 | 説明                                                                              |
| ------------------------------------- | ------ | ------------------------------------------------------------------------------- |
| `mysql-default-max-connections`       | 0      | 特定の接続に許可する同時接続の最大数。ここで、「0」は無制限を意味します。デフォルトでは、接続に対して同時接続総数の制限は適用されません。           |
| `mysql-default-max-group-connections` | 0      | 特定の分散接続グループに許可する同時接続の最大数。ここで、「0」は無制限を意味します。デフォルトでは、接続グループに対して同時接続総数の制限は適用されません。 |

#### ユーザーあたりの同時接続の制限 <a href="#id-.mysql-mariadbconfigurationpropertiesv2.x-per-userconcurrencylimits" id="id-.mysql-mariadbconfigurationpropertiesv2.x-per-userconcurrencylimits"></a>

| プロパティ名                                         | デフォルト値 | 説明                                                                                                                                               |
| ---------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `mysql-default-max-connections-per-user`       | 0      | 接続を確立する個々のユーザーに許可する同時接続の最大数。ここで、「0」は無制限を意味します。デフォルトでは、接続に対してユーザーあたりの同時接続の制限は適用されません。                                                             |
| `mysql-default-max-group-connections-per-user` | 1      | 負荷分散接続グループへの接続を確立する個々のユーザーに許可する同時接続の最大数。ここで、「0」は無制限を意味します。デフォルトでは、1人のユーザーがそのグループ内で使用可能な接続を使い果たさないように、各負荷分散接続グループに対するユーザーごとの接続を1つだけに制限することはありません。 |

#### 絶対的な同時接続の制限 <a href="#id-.mysql-mariadbconfigurationpropertiesv2.x-absoluteconcurrencylimits" id="id-.mysql-mariadbconfigurationpropertiesv2.x-absoluteconcurrencylimits"></a>

| プロパティ名                           | デフォルト値 | 説明                                                                                                                           |
| -------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `mysql-absolute-max-connections` | 0      | Guacamoleサーバー全体に許可する同時接続の絶対的な最大数。どのユーザーが接続を確立しているか、どの接続またはグループがアクセスされているかは考慮しません。ここで、「0」は無制限を意味します。デフォルトでは、絶対的な同時制限は適用されません。 |

### データベースのユーザーアカウントの要件 <a href="#id-.mysql-mariadbconfigurationpropertiesv2.x-require-userdatabaseuseraccountrequirements" id="id-.mysql-mariadbconfigurationpropertiesv2.x-require-userdatabaseuseraccountrequirements"></a>

MySQL/MariaDBデータベース内に存在しないユーザーに対して、他の拡張機能による認証を許可するか否か。「true」に設定すると、認証されたユーザーがデータベース内で定義されていない限り、認証の試行は拒否されます。

| プロパティ名                | デフォルト値 | 説明                                                                                                                                                                                                |
| --------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mysql-user-required` | false  | 「true」に設定した場合、成功した認証の試行をすべて、MySQL内で定義されたユーザーに関連付ける必要があります。他のメカニズム　　 (LDAPなど) を使用してユーザー認証に成功しても、対応するMySQLユーザーが存在しない場合は、その認証は拒否されます。デフォルトでは、そのユーザーのアカウントがMySQL内に存在するか否かに関係なく、認証の試行が成功すれば、成功と見なされます。 |