sonar-users

Logpresso Sonarに登録されたアカウント一覧を照会します。オプションはなく、実行すると登録されたすべてのアカウントを返します。

コマンドプロパティ

構文

出力フィールド

エラーコード

パースエラー

ランタイムエラー

該当なし

説明

sonar-users はLogpresso Sonarに登録されたすべてのアカウントを照会する管理者専用コマンドです。管理者権限のないセッションで実行するとパース段階でエラーが発生し、クエリは実行されません。

出力フィールドには granted_tables（テーブル権限）、trust_hosts（アクセス制御リスト）、ログインロック・失敗状態、OTP登録の有無など、アカウントのセキュリティに直結する属性が多数含まれます。ただし、REST APIと同じフィールドのみを出力するように制限されているため、パスワードハッシュやAPIキーの値自体は含まれず、has_api_key フィールドでAPIキーの発行有無のみを確認できます。この性質のため、照会結果を他のユーザーと共有したりダッシュボードに表示する際は、アカウントのセキュリティ属性が漏洩しないよう注意する必要があります。

login_lock_until に記録されたロック解除時刻が既に過ぎている場合、アカウントは実際にはロックが解除されたものとみなされ、login_lock_until は null として、login_fail_count は0として返されます。

使用例

1. 登録されたすべてのアカウントを照会

   sonar-users
   

2. 管理者の役割を持つアカウントのみをフィルタリング

   sonar-users
   | search role_id == 1 or role_id == 2
   | fields login, name, role_name, dept, email
   

3. アカウントロックまたはOTP未登録のアカウントを点検

   sonar-users
   | search login_lock_until not null or (otp_enabled == true and otp_registered == false)
   | fields login, name, login_lock_until, login_fail_count, otp_enabled, otp_registered
   

4. 役割別のアカウント数を集計

   sonar-users
   | stats count by role_name
   | sort -count
   

変更履歴

sonar-users コマンドはSonar 4.0.2609.0バージョンから利用可能です。Experimental アプリが提供していたコマンドをSonarコアに内蔵したものです。内蔵されていないバージョンでは、Experimental アプリをインストールして使用できます。