Update User(ユーザーの更新)
IDまたはユーザー名によって、Oktaユーザーのシステム情報およびプロファイルプロパティーを更新します。

このアクションは、アプリケーションユーザーについての情報を更新しません。ユーザーのタイプが無効または正しくないとき、この操作を試みると、404エラーが返されます。アプリケーションユーザーに関する詳細を取得するには、カスタムAPIアクションカードを使用します。アプリケーション用に割り当てられているユーザーに関する情報の参照の詳細については、「アプリケーションユーザーの処理」を参照してください。
オプション
フィールド | 定義 | タイプ | 必須 |
---|---|---|---|
Update Semantics (セマンティクスの更新) | Partial:部分的な更新セマンティクスを使用してユーザーのプロファイルまたは資格情報を更新します。指定されないすべてのプロパティーは無視され、現在の値を維持します。 Strict:厳格な更新セマンティクスを使用してユーザーのプロファイルおよび資格情報を更新します。重要:ユーザーのプロファイルを更新する際、すべてのプロファイルを指定する必要があります。リクエストで指定されないすべてのプロパティーは |
ドロップダウン | FALSE |
入力
フィールド | 定義 | タイプ | 必須 |
---|---|---|---|
ユーザー | |||
ID | OktaユーザーのID(通常はメール形式)。 | 文字列 | FALSE |
Option(オプション) | |||
Pass Empty Values? (空の値の受け渡し?) |
[Update Semantics (セマンティクスの更新)]がPartialに設定される場合にのみ表示されます。
|
ドロップダウン | FALSE |
プロファイル | |||
City(市町村) | ユーザーの住所の市部分。 | 文字列 | FALSE |
Cost center (コストセンター) | ユーザーに割り当てられているコストセンターの名前。 | 文字列 | FALSE |
Country code (国コード) | 国の省略形。 | 文字列 | FALSE |
Department(部門) | ユーザーの所属部署の名前。 | 文字列 | FALSE |
Display name (表示名) | ユーザーの名前。エンドユーザーへの表示に適しています。 | 文字列 | FALSE |
Division (部門) | ユーザーの事業部の名前。 | 文字列 | FALSE |
Primary email (プライマリーメール) | ユーザーのプライマリーメールアドレス。 | 文字列 | FALSE |
Employee number (従業員番号) | Organizationまたは企業からユーザーに割り当てられている一意の識別子。 | 文字列 | FALSE |
First name (名) | ユーザーの名。 | 文字列 | FALSE |
Honorific prefix (敬称接頭辞) | ユーザーの敬称接頭辞。ほとんどの西洋言語では称号としても知られています。 | 文字列 | FALSE |
Honorific suffix (敬称接尾辞) | ユーザーの敬称接尾辞。ほとんどの西洋言語では称号としても知られています。 | 文字列 | FALSE |
Last name (姓) | ユーザーの姓つまり名字。 | 文字列 | FALSE |
Locale(ロケール) | 通貨、日時の形式、数値の表示形式などの項目をローカライズするための、ユーザーのデフォルトの場所。 | 文字列 | FALSE |
Username(ユーザー名) | ユーザーのログインユーザー名 (通常、メールアドレスの形式)。 | 文字列 | FALSE |
マネージャー | ユーザーのマネージャーの表示名。 | 文字列 | FALSE |
ManagerId (マネージャーID) | ユーザーのマネージャーのID。 | 文字列 | FALSE |
Middle name (ミドルネーム) | ユーザーのミドルネーム。 | 文字列 | FALSE |
Mobile phone (携帯電話) | ユーザーの携帯電話番号。 | 文字列 | FALSE |
ニックネーム | ユーザーが選定するニックネーム (該当する場合)。 | 文字列 | FALSE |
Organization | ユーザーのOrganizationの名前。 | 文字列 | FALSE |
Postal Address (郵便物送付先) | ユーザーの住所の郵便物送付先部分 | 文字列 | FALSE |
Preferred language (優先言語) | ユーザーの優先する書き言葉または話し言葉の言語。 | 文字列 | FALSE |
Primary phone (メインの電話番号) | ユーザーのメインの電話番号 (自宅の番号など)。 | 文字列 | FALSE |
Profile Url (プロファイルURL) | ユーザーのオンラインプロファイル (ウェブページ) のURL。 | 文字列 | FALSE |
Secondary email (セカンダリーメール) | ユーザーのセカンダリメールアドレス (一般にアカウント復旧に使用)。 | 文字列 | FALSE |
State(都道府県) | ユーザーの住所の州または地域部分。 | 文字列 | FALSE |
Street address (番地) | ユーザーの住所の完全な番地部分。 | 文字列 | FALSE |
Time zone (タイムゾーン) | ユーザーのタイムゾーン。 | 文字列 | FALSE |
Title(役職) |
ユーザーの役職名。 |
文字列 | FALSE |
User type (ユーザータイプ) | Organizationに対するユーザーの関係 (従業員または請負業者など)。 | 文字列 | FALSE |
Zip code (郵便番号) | ユーザーの住所のZIPコードまたは郵便番号部分。 | 文字列 | FALSE |
Custom Profile Properties (カスタムプロファイルプロパティー) | このカードの設定時に生成される追加のカスタムユーザープロファイルプロパティー。 | 動的生成 | FALSE |
Credentials(資格情報) | |||
パスワード | ユーザーの新規パスワードの文字列値。 | 文字列 | FALSE |
Recovery Question (復旧質問) | ユーザーのパスワード復旧を可能にするための質問。 | 文字列 | FALSE |
Recovery Answer (復旧回答) | パスワード復旧質問に対する回答。 | 文字列 | FALSE |
「2. 資格情報」も参照してください。 |
出力
フィールド | 定義 | タイプ |
---|---|---|
System Properties (システムプロパティー) | ||
ID | OktaユーザーのID。 | 文字列 |
[Status(ステータス)] | ユーザーの現在のステータスで、STAGED 、PROVISIONED 、ACTIVE 、RECOVERY 、LOCKED_OUT 、PASSWORD_EXPIRED 、SUSPENDED 、DEPROVISIONED のいずれか。 |
文字列 |
作成済み |
オブジェクトが作成された日時。 |
日時 |
アクティブ化できます | ACTIVE ステータスへの遷移が完了した時点のタイムスタンプ。 |
ブール値 |
Status Changed (ステータス変更日時) | ユーザーのステータスが最後に変更された日。 | 日時 |
[Last Login(前回のログイン)] | ユーザーの最終ログイン日時のタイムスタンプ。 | 日時 |
最終アップデート日 | ユーザーの最終更新日時のタイムスタンプ。 | 日時 |
パスワード変更 | ユーザーのパスワードが最後に変更された時点のタイムスタンプ。 | ブール値 |
Credentials(資格情報) | ||
メール | ユーザーに関連付けられたメールのリスト。 | リスト |
Password(パスワード) | ユーザーが有効なパスワードを持っているかハッシュパスワードをインポートした場合はtrue 。それ以外の場合はfalse 。 |
ブール値 |
Recovery Question (復旧質問) | ユーザーがパスワードを忘れた場合の復旧質問。 | 文字列 |
Provider (プロバイダー) | ||
名前 | 認証プロバイダーの名前。 | 文字列 |
タイプ | 認証プロバイダーのタイプ。OKTA 、ACTIVE_DIRECTORY 、LDAP 、FEDERATION 、SOCIAL 、またはIMPORT 。 |
文字列 |
Profile Properties (プロファイルプロパティー) | ||
City(市町村) | ユーザーの住所の市部分。 | 文字列 |
Cost center (コストセンター) | ユーザーに割り当てられているコストセンターの名前。 | 文字列 |
Country code (国コード) | 国の省略形。 | 文字列 |
Department(部門) | ユーザーの所属部署の名前。 | 文字列 |
Display name (表示名) | ユーザーの名前。エンドユーザーへの表示に適しています。 | 文字列 |
Division (部門) | ユーザーの事業部の名前。 | 文字列 |
Primary email (プライマリーメール) | ユーザーのプライマリーメールアドレス。 | 文字列 |
Employee number (従業員番号) | Organizationまたは企業からユーザーに割り当てられている一意の識別子。 | 文字列 |
First name (名) | ユーザーの名。 | 文字列 |
Honorific prefix (敬称接頭辞) | ユーザーの敬称接頭辞。ほとんどの西洋言語では称号としても知られています。 | 文字列 |
Honorific suffix (敬称接尾辞) | ユーザーの敬称接尾辞。ほとんどの西洋言語では称号としても知られています。 | 文字列 |
Last name (姓) | ユーザーの姓つまり名字。 | 文字列 |
Locale (ロケール) | 通貨、日時の形式、数値の表示形式などの項目をローカライズするための、ユーザーのデフォルトの場所。 | 文字列 |
Username(ユーザー名) | ユーザーのログインユーザー名 (通常、メールアドレスの形式)。 | 文字列 |
マネージャー | ユーザーのマネージャーの表示名。 | 文字列 |
ManagerId (マネージャーID) | ユーザーのマネージャーのID。 | 文字列 |
Middle name (ミドルネーム) | ユーザーのミドルネーム。 | 文字列 |
Mobile phone (携帯電話) | ユーザーの携帯電話番号。 | 文字列 |
ニックネーム | ユーザーが選定するニックネーム (該当する場合)。 | 文字列 |
Organization | ユーザーのOrganizationの名前。 | 文字列 |
Postal Address (郵便物送付先) | ユーザーの住所の郵便物送付先部分 | 文字列 |
Preferred language (優先言語) | ユーザーの優先する書き言葉または話し言葉の言語。 | 文字列 |
Primary phone (メインの電話番号) | ユーザーのメインの電話番号 (自宅の番号など)。 | 文字列 |
Profile Url (プロファイルURL) | ユーザーのオンラインプロファイル (ウェブページ) のURL。 | 文字列 |
Secondary email (セカンダリーメール) | ユーザーのセカンダリメールアドレス (一般にアカウント復旧に使用)。 | 文字列 |
State(都道府県) | ユーザーの住所の州または地域部分。 | 文字列 |
Street address (番地) | ユーザーの住所の完全な番地部分。 | 文字列 |
Time zone (タイムゾーン) | ユーザーのタイムゾーン。 | 文字列 |
Title(役職) |
ユーザーの役職名。 |
文字列 |
User type (ユーザータイプ) | Organizationに対するユーザーの関係 (従業員または請負業者など)。 | 文字列 |
Zip code (郵便番号) | ユーザーの住所のZIPコードまたは郵便番号部分。 | 文字列 |
Custom Profile Properties (カスタムプロファイルプロパティー) | このカードの設定時に生成される追加のカスタムユーザープロファイルプロパティー。 | 動的生成 |
追加情報
1. 基本情報フィールド
次の4つのフィールドは基本情報フィールドで、クリアできません。
- Username(ユーザー名)
- First Name(名)
- Last Name(姓)
- Primary Email(プライマリーメール)
セマンティクスの更新の設定 | 空の値の受け渡しの設定 | 基本フィールドの処理 |
---|---|---|
Partial | はい |
|
Partial | No |
|
Strict | N/A |
|
2. 資格情報
a. パスワード
- 実際の値を表示しませんが、フィールドが既存の値を含むか値がクリアされているかどうかにかかわらず常にtrueを表示します。
- ユーザーが資格情報なしで作成され、以前に有効なパスワードが設定されたことがない場合にのみfalseを表示します。
- フィールドをクリアするには、フィールドを選択し、空白のままにした状態で、次のいずれかのオプションを使用します。
- [Update Semantics (セマンティクスの更新)]をPartialに設定し、[Pass Empty Values (空の値の受け渡し)]をYesに設定する
- [Update Semantics (セマンティクスの更新)]をStrictに設定する
- フィールドが選択されていない場合、常に変更されずに残ります。
b. 復旧質問と復旧回答
- これらのフィールドをクリアすることはできません。
- ユーザーが資格情報なしで作成され、以前に有効な復旧質問と復旧回答が設定されたことがない場合にのみ空にすることができます。
- これら2つのフィールドは同時に更新する必要があり、そうしない場合は変更されずに残ります。