Skip to content

MQTT 5.0 強化認証 - SCRAM

この認証機構は、Salted Challenge Response Authentication Mechanism(SCRAM) 認証を実装しており、EMQXの組み込みデータベースを使用してクライアント資格情報(ユーザー)を保存します。

SCRAMはパスワード検証よりも複雑な仕組みであり、接続時に追加のMQTTパケットの交換が必要です。SCRAM認証は外部データソースに依存せず、シンプルかつ軽量に利用できます。

TIP

SCRAM認証機構はMQTT 5.0接続のみをサポートしています。

ダッシュボードでの設定

  1. EMQXダッシュボードの左側ナビゲーションメニューで、アクセス制御 -> 認証 をクリックします。
  2. 右上の 作成 をクリックし、MechanismSCRAMBackendBuilt-in Database を選択します。これにより 設定 タブに移動します。
  3. 認証バックエンドの以下の設定を行います:
    • Password Hash:パスワードハッシュアルゴリズムを選択します。sha256 または sha512 から選べます。
    • Iteration Count:SCRAM認証プロセスでパスワードをハッシュ化する際の反復回数を定義します。反復回数が多いほど計算コストが増え、ブルートフォース攻撃に対する耐性が高まります。デフォルト値は 4096 です。この値を調整することでパフォーマンスとセキュリティに影響が出るため、システムの要件に応じて設定してください。
    • PreconditionVariform式で、クライアント接続に対してこの組み込みデータベース認証機構を適用するかどうかを制御します。式はクライアントの属性(usernameclientidlistenerなど)に対して評価され、結果が文字列 "true" の場合のみ認証機構が呼び出されます。それ以外の場合はスキップされます。詳細は認証の前提条件を参照してください。
  4. 作成 をクリックして設定を完了します。

設定項目による構成

設定例:

hcl
{
    mechanism = scram
    backend = built_in_database
    algorithm = sha512
    iteration_count = 4096
}

項目の説明:

  • algorithm:パスワードハッシュアルゴリズム。選択肢は sha256sha512
  • iteration_count(省略可能):SCRAMの反復回数パラメーター。デフォルトは 4096

認証フロー

scram_workflow