Update User（ユーザーの更新）

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

オプション

フィールド	定義	タイプ	必須
Update Semantics (セマンティクスの更新)	Partial：部分的な更新セマンティクスを使用してユーザーのプロファイルまたは資格情報を更新します。指定されないすべてのプロパティーは無視され、現在の値を維持します。 Strict：厳格な更新セマンティクスを使用してユーザーのプロファイルおよび資格情報を更新します。重要：ユーザーのプロファイルを更新する際、すべてのプロファイルを指定する必要があります。リクエストで指定されないすべてのプロパティーはnullに設定されます。	ドロップダウン	FALSE

入力

フィールド	定義	タイプ	必須
ユーザー
ID	OktaユーザーのID（通常はメール形式）。	文字列	FALSE
Option（オプション）
Pass Empty Values? (空の値の受け渡し？)	[Update Semantics (セマンティクスの更新)]がPartialに設定される場合にのみ表示されます。 Yesの場合、選択されて有効な値が入力されているすべてのフィールドが更新されます。選択されているが空白のままのすべてのフィールドは、特殊なフィールドを除きクリアされます。下記の注を参照してください。選択されていないすべてのフィールドは変更されずに残ります。 Noの場合、選択されて有効な値が入力されているすべてのフィールドが更新されます。選択されていないか空白のままのすべてのフィールドは変更されずに残ります。 「1. 基本情報フィールド」も参照してください。	ドロップダウン	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	はい	これら4つのフィールドのいずれかが選択されて空白のままの場合、カードはエラーを報告します。 これらのフィールドのいずれかが選択されて有効な値が入力されている場合、更新されます。 選択されていないすべてのフィールドは変更されずに残ります。
Partial	No	これら4つのフィールドのいずれかが選択されて有効な値が入力されている場合、更新されます。 これらのフィールドのいずれかが選択されているが空白のままか選択されていない場合、変更されずに残ります。
Strict	N/A	これら4つのフィールドのいずれかが選択されているが空白のままか選択されていない場合、カードはエラーを報告します。 これらすべてのフィールドが選択されて有効な値が入力されている場合にのみ、カードは通過できます。

2. 資格情報

a. パスワード

• 実際の値を表示しませんが、フィールドが既存の値を含むか値がクリアされているかどうかにかかわらず常にtrueを表示します。
• ユーザーが資格情報なしで作成され、以前に有効なパスワードが設定されたことがない場合にのみfalseを表示します。
• フィールドをクリアするには、フィールドを選択し、空白のままにした状態で、次のいずれかのオプションを使用します。
  • [Update Semantics (セマンティクスの更新)]をPartialに設定し、[Pass Empty Values (空の値の受け渡し)]をYesに設定する
  • [Update Semantics (セマンティクスの更新)]をStrictに設定する
• フィールドが選択されていない場合、常に変更されずに残ります。

b. 復旧質問と復旧回答

• これらのフィールドをクリアすることはできません。
• ユーザーが資格情報なしで作成され、以前に有効な復旧質問と復旧回答が設定されたことがない場合にのみ空にすることができます。
• これら2つのフィールドは同時に更新する必要があり、そうしない場合は変更されずに残ります。

関連項目

Oktaコネクター

Workflows要素

Oktaコネクターに関するガイダンス

Okta APIドキュメント