Read User(ユーザーの読み出し)
Tenable Vulnerability Managementでユーザーを参照します。
入力
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
| User(ユーザー) | |||
| ID or UUID(IDまたはUUID) |
ユーザーの一意識別子。 UUIDとIDの両方が受け入れられます。
|
テキスト | TRUE |
出力
| フィールド | 定義 | タイプ |
|---|---|---|
| ユーザー | ||
| ID |
ユーザーの一意識別子。 |
テキスト |
| UUID |
ユーザーのUUID。 |
テキスト |
| Username(ユーザー名) |
ユーザーのユーザー名。 |
テキスト |
| Email(メール) |
ユーザーのメールアドレス。この属性が空の場合、Tenable Vulnerability Managementでは、username値がユーザーのメールアドレスとして使用されます。 |
テキスト |
| Full Name(フルネーム) |
ユーザーのフルネーム。 |
テキスト |
| Is Enabled(有効化) |
ユーザーアカウントが有効(true)か、または無効(false)かを指定します。 |
True/False |
| Container UUID(コンテナUUID) |
ユーザーが属するTenable Vulnerability ManagementインスタンスのUUID。 |
テキスト |
| Is Lockedout(ロックアウトされる) |
ユーザーがTenable Vulnerability Managementアプリにサインインできる(false)、またはロックアウトされる(true)かを指定します。 Tenable Vulnerability Managementでは、ユーザーのlogin_fail_count属性が[5]より大きい場合、この属性を自動的に[true]に更新します。ユーザーアカウントをロック解除するには、[Change User Password(ユーザーパスワードを変更する)]カード(パスワード変更エンドポイント)を使用して、ユーザーのパスワードをリセットします。 ユーザーは、ユーザーインターフェイスからロックアウトできますが、適切な認可(api_permitted)が割り当てられている場合は、APIリクエストを送信できます。ユーザーがAPIリクエストを送信しないようにするには、ユーザー認可を更新エンドポイントを使用して認可を制限するか、[Update User(ユーザーを更新する)]カード(ユーザーを更新エンドポイント)、またはユーザーアカウントを有効化エンドポイントを使用してユーザーを完全に無効にします。 |
True/False |
| Is Not Deleteable(削除不可) |
ユーザーアカウントが削除から保護されている(true)か、または保護されていない(false)かを指定します。 |
True/False |
| Type(タイプ) |
ユーザーのタイプ。 サポートされるタイプはlocalのみです。 |
テキスト |
| Predefined Role(事前定義済みロール) |
ユーザーロールで説明されているように、整数値で表されるユーザーロール。 ユーザーに[Custom Role(カスタムロール)]が割り当てられている場合、このフィールドの値は0です。 |
数値 |
| Groups(グループ) |
ユーザーが属するグループのUUIDのリスト。 |
テキストのリスト |
| Two Factor(2要素) |
2要素認証の詳細。 このフィールドは、ユーザーが2要素認証をセットアップしていない場合は省略されます。 |
オブジェクト |
| Activated At(アクティブ化日時) |
2要素認証のアクティブ化時間(Unixミリ秒で表示)。 |
数値 |
| Is TOTP Enabled(TOTPが有効) |
TOTP2要素認証が有効(true)または無効(false)のどちらであるかを指定します。 |
True/False |
| Is Email Enabled(メールが有効) |
2要素認証のバックアップ通知が有効(true)か、または無効(false)かを示します。有効の場合、Tenable Vulnerability Managementはメールで2要素検証コードを送信します。 |
True/False |
| Last Successful Login(最後に成功したログイン) |
ユーザーが、最後にTenable Vulnerability Managementアプリに正常にサインインした時刻(Unixミリ秒)。 この属性は、ユーザーがTenable Vulnerability Managementユーザーインターフェイスに少なくとも1回正常にログインした場合にのみ存在します。 |
数値 |
| Last Failed Login(最終失敗ログイン) |
ユーザーが、最後にTenable Vulnerability Managementにサインインできなかった時刻(Unixミリ秒)。 この属性は、ユーザーがTenable Vulnerability Managementアプリへのサインイン試行に失敗した場合にのみ存在します。 |
数値 |
| Login Fail Count(ログイン失敗回数) |
ユーザーが、最後にTenable Vulnerability Managementアプリに正常にサインインした以降に失敗したサインイン試行の回数。 この属性が5より大きい場合、Tenable Vulnerability Managementはユーザーアカウントをロックします(ユーザーのIs Lockedout (lockout)属性をtrue(1)に更新します)。[Change User Password(ユーザーパスワードを変更する)]カード(ユーザーのパスワードを変更)を使用するか、ユーザーのAPIキーを生成することで、この回数を0にリセットできます。 |
数値 |
| Login Fail Total(ログイン失敗の合計) |
ユーザーが失敗したサインイン試行の合計回数。 |
数値 |
| Raw Output(未加工出力) |
APIから返される未加工の応答本文。 |
オブジェクト |
