TiDBダッシュボードのユーザー管理

TiDBダッシュボードは、TiDBと同じユーザー権限システムとサインイン認証を使用します。TiDB TiDB SQLユーザーを制御・管理することで、TiDBダッシュボードへのアクセスを制限できます。このドキュメントでは、TiDB SQLユーザーがTiDBダッシュボードにアクセスするために必要な最小限の権限について説明し、最小限の権限を持つSQLユーザーの作成方法とRBACによる認証方法を例示します。

TiDB SQLユーザーを制御および管理する方法の詳細については、 TiDB ユーザーアカウント管理参照してください。

必要な権限

• 接続された TiDBサーバーでSecurity強化モード（SEM）有効になっていない場合に TiDB ダッシュボードにアクセスするには、SQL ユーザーに次のすべての権限が必要です。

  • プロセス
  • データベースを表示
  • 設定
  • ダッシュボードクライアント

• 接続された TiDBサーバーでSecurity強化モード（SEM）有効になっているときに TiDB ダッシュボードにアクセスするには、SQL ユーザーに次のすべての権限が必要です。

  • プロセス
  • データベースを表示
  • 設定
  • ダッシュボードクライアント
  • 制限付きテーブル管理者
  • 制限付きステータス管理者
  • 制限付き変数管理者

• TiDB ダッシュボードにサインインした後、インターフェイス上の構成を変更するには、SQL ユーザーに次の権限も必要です。

  • システム変数管理者

• TiDB ダッシュボードにサインインした後、インターフェース上の高速バインド実行プラン機能を使用するには、SQL ユーザーに次の権限も必要です。

  • システム変数管理者
  • 素晴らしい

注記：

ALL PRIVILEGESやSUPERといった高い権限を持つユーザーもTiDBダッシュボードにサインインできます。したがって、最小権限の原則を遵守するために、意図しない操作を防ぐために、必要な権限のみを持つユーザーを作成することを強くお勧めします。これらの権限の詳細については、 権限管理参照してください。

SQL ユーザーが前述の権限要件を満たしていない場合、以下に示すように、ユーザーは TiDB ダッシュボードへのサインインに失敗します。

例: TiDB ダッシュボードにアクセスするための最小権限の SQL ユーザーを作成する

• 接続された TiDBサーバーでSecurity強化モード（SEM）有効になっていない場合、TiDB ダッシュボードにサインインできる SQL ユーザーdashboardAdminを作成するには、次の SQL ステートメントを実行します。

  CREATE USER 'dashboardAdmin'@'%' IDENTIFIED BY '<YOUR_PASSWORD>';
  GRANT PROCESS, CONFIG ON *.* TO 'dashboardAdmin'@'%';
  GRANT SHOW DATABASES ON *.* TO 'dashboardAdmin'@'%';
  GRANT DASHBOARD_CLIENT ON *.* TO 'dashboardAdmin'@'%';
  
  -- To modify the configuration items on the interface after signing in to TiDB Dashboard, the user-defined SQL user must be granted with the following privilege.
  GRANT SYSTEM_VARIABLES_ADMIN ON *.* TO 'dashboardAdmin'@'%';
  
  -- To use the Fast Bind Executions Plan feature (https://docs.pingcap.com/tidb/dev/dashboard-statement-details#fast-plan-binding) on the interface after signing in to TiDB Dashboard, the user-defined SQL user must be granted with the following privileges.
  GRANT SYSTEM_VARIABLES_ADMIN ON *.* TO 'dashboardAdmin'@'%';
  GRANT SUPER ON *.* TO 'dashboardAdmin'@'%';
  

• 接続先のTiDBサーバーでSecurity強化モード（SEM）有効になっている場合は、まずSEMを無効にし、以下のSQL文を実行して、TiDBダッシュボードにサインインできるSQLユーザーdashboardAdmin作成します。ユーザーを作成したら、SEMを再度有効にします。

  CREATE USER 'dashboardAdmin'@'%' IDENTIFIED BY '<YOUR_PASSWORD>';
  GRANT PROCESS, CONFIG ON *.* TO 'dashboardAdmin'@'%';
  GRANT SHOW DATABASES ON *.* TO 'dashboardAdmin'@'%';
  GRANT DASHBOARD_CLIENT ON *.* TO 'dashboardAdmin'@'%';
  GRANT RESTRICTED_STATUS_ADMIN ON *.* TO 'dashboardAdmin'@'%';
  GRANT RESTRICTED_TABLES_ADMIN ON *.* TO 'dashboardAdmin'@'%';
  GRANT RESTRICTED_VARIABLES_ADMIN ON *.* TO 'dashboardAdmin'@'%';
  
  -- To modify the configuration items on the interface after signing in to TiDB Dashboard, the user-defined SQL user must be granted with the following privilege.
  GRANT SYSTEM_VARIABLES_ADMIN ON *.* TO 'dashboardAdmin'@'%';
  
  -- To use the Fast Bind Executions Plan feature (https://docs.pingcap.com/tidb/dev/dashboard-statement-details#fast-plan-binding) on the interface after signing in to TiDB Dashboard, the user-defined SQL user must be granted with the following privileges.
  GRANT SYSTEM_VARIABLES_ADMIN ON *.* TO 'dashboardAdmin'@'%';
  GRANT SUPER ON *.* TO 'dashboardAdmin'@'%';
  

例: RBAC 経由で SQL ユーザーに TiDB ダッシュボードへのアクセスを許可する

次の例は、 ロールベースのアクセス制御（RBAC）メカニズムを通じて TiDB ダッシュボードにアクセスするためのロールとユーザーを作成する方法を示しています。

1. TiDB ダッシュボードのすべての権限要件を満たすdashboard_accessロールを作成します。

   CREATE ROLE 'dashboard_access';
   GRANT PROCESS, CONFIG ON *.* TO 'dashboard_access'@'%';
   GRANT SHOW DATABASES ON *.* TO 'dashboard_access'@'%';
   GRANT DASHBOARD_CLIENT ON *.* TO 'dashboard_access'@'%';
   GRANT SYSTEM_VARIABLES_ADMIN ON *.* TO 'dashboard_access'@'%';
   GRANT SUPER ON *.* TO 'dashboardAdmin'@'%';    
   

2. dashboard_accessロールを他のユーザーに付与し、 dashboard_accessデフォルトのロールとして設定します。

   CREATE USER 'dashboardAdmin'@'%' IDENTIFIED BY '<YOUR_PASSWORD>';
   GRANT 'dashboard_access' TO 'dashboardAdmin'@'%';
   -- You need to set dashboard_access as the default role to the user
   SET DEFAULT ROLE dashboard_access to 'dashboardAdmin'@'%';
   

上記の手順を実行すると、 dashboardAdminユーザーを使用して TiDB ダッシュボードにサインインできるようになります。

TiDBダッシュボードにサインイン

TiDB ダッシュボードの権限要件を満たす SQL ユーザーを作成したら、このユーザーを TiDB ダッシュサインインに使用できます。