Update User（ユーザーの更新）

Tenable Vulnerability Managementでユーザーを更新します。

入力

フィールド	定義	タイプ	必須
更新条件
ID or UUID（IDまたはUUID）	ユーザーの一意識別子。 UUIDとIDの両方が受け入れられます。 UUIDの入力例：a1ac5e57-d3cf-4396-a825-38538bc52d26 IDの入力例：2192886	テキスト	TRUE
User（ユーザー）
Full Name（フルネーム）	ユーザーのフルネーム。	テキスト	FALSE
Email（メール）	ユーザーのメールアドレス。有効なメールアドレスはname@domainの形式にする必要があります。このドメインは、Tenable Vulnerability Managementインスタンスで承認されたドメインに対応します。管理者は、承認されたドメイン外のドメインを持つメールアドレスでユーザーを作成できます。このメールアドレスは、ユーザー名に設定されているメールアドレスを上書きします。リクエストがこのパラメーターを省略した場合、Tenable Vulnerability Managementでは、ユーザー名値がユーザーのメールアドレスとして使用されます。初回セットアップ時に、TenableでVulnerability Managementインスタンスの承認済みドメインが構成されます。インスタンスにドメインを追加する場合は、Tenableサポートまでお問い合わせください。	テキスト	FALSE
Is Enabled（有効化）	ユーザーアカウントが有効（true）か、または無効（false）かを指定します。	True/False	FALSE
Predefined Role（事前定義済みロール）	ユーザーロールで説明されているように、整数値で表されるユーザーロール。値： Basic Scan Operator 標準 Scan Manager 管理者事前定義された［User Roles（ユーザーロール）］のみ割り当てられます。［Update User Role（ユーザーロールを更新する）］カードを使って、［Custom Roles（カスタムロール）］を割り当てることができます。	ドロップダウン	FALSE

出力

フィールド	定義	タイプ
ユーザー
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
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から返される未加工の応答本文。	オブジェクト