PostgreSQL 認証

拡張認証では、PostgreSQL 統合によるパスワード認証をサポートしています。

注意

PostgreSQL 認証は EMQX Serverless のデプロイメントではサポートされていません。

テーブル構造とクエリ文

PostgreSQL 認証機能は、複数テーブルの結合クエリやビューからのクエリを含む任意のテーブル構造をサポートできます。ユーザーはクエリ用の SQL テンプレートを提供し、クエリ結果に以下のフィールドが含まれている必要があります。

password_hash：必須。データベース内の平文またはハッシュ化されたパスワードフィールド。
salt：任意。空または存在しない場合は空のソルト（salt = ""）として扱われます。
is_superuser：任意。現在のクライアントがスーパーユーザーかどうかを示します。デフォルトは false です。true に設定すると、そのユーザー名を使用するクライアントは認可制約を受けません。スーパーユーザーの設定は推奨されません。

テーブル構造の例：

sql

CREATE TABLE `mqtt_user` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `username` varchar(100) DEFAULT NULL,
  `password_hash` varchar(100) DEFAULT NULL,
  `salt` varchar(35) DEFAULT NULL,
  `created` datetime DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `mqtt_username` (`username`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

TIP

上記の例では、クエリを効率化するために暗黙の UNIQUE インデックスフィールド（username）を作成しています。ユーザー数が多いシステムでは、クエリ対象のテーブルが最適化され、有効なインデックスを使用していることを確認してください。これにより、多数の接続時のデータ検索速度が向上し、EMQX の負荷軽減につながります。

このテーブルでは username を検索条件として使用します。例えば、ユーザー名 emqx_u、パスワード public、ソルト slat_foo123、ハッシュ方式 sha256、スーパーユーザーフラグ false のユーザーを追加する場合：

sql

mysql> INSERT INTO mqtt_user(username, password_hash, salt, is_superuser) VALUES ('emqx_u', SHA2(concat('public', 'slat_foo123'), 256), 'slat_foo123', 0);
Query OK, 1 row affected (0.01 sec)

対応するクエリ文およびパスワードハッシュ方式の設定パラメータは以下の通りです。

パスワード暗号化方式：sha256
ソルトモード：suffix
SQL：

sql

SELECT password_hash, salt, is_superuser FROM mqtt_user WHERE username = ${username} LIMIT 1