ユーザー・プリファレンスが作成/登録される。
post
/oaa/runtime/preferences/v1
ユーザー・プリファレンスを登録するAPI。このAPIは、OAAシステムにユーザーとそのプリファレンスをシードします。整合性がとれていない/完全でないデータの場合、エラーが返されます。システムにすでに存在するユーザーの場合、エラーが返されます。このようなユーザーの場合は、プリファレンスの削除と更新の組合せを使用してプリファレンスを変更できます。
リクエスト
この操作にはリクエスト・パラメータはありません。
サポートされているメディア・タイプ
- application/xml
- application/json
ルート・スキーマ: schema
型:
object
各タイプのチャレンジ・ファクタに対するユーザーおよびユーザーのチャレンジの登録に関する情報。
ソースの表示
-
alternateName: string
ユーザー画面で使用できるユーザーの代替名。
-
defaultlocale: string
ユーザーのデフォルト・ロケール。指定しない場合は、デフォルト値の「en_US」が使用されます。
-
displayName: string
ユーザー画面で使用できるユーザーの表示名。
-
factorsRegistered: array factorsRegistered
ユーザーのファクタ登録データの配列。
-
groupId: string
プリファレンス・データが必要なユーザーのGroupId/ApplicationId。このパラメータが存在しない場合、"Default"という値が使用されます。
-
imageReference: string
secureImageの場所。Example:/images/secureImage01.jpg.イメージ・パスを完全なURLとして返すようにシステムが構成されている場合、次の2つのプロパティを構成する必要があります。1.)oaa.preferences.prependBasePath = true (デフォルトはfalse)、2.)oaa.preferences.imageBasePath=
。システム・プロパティoaa.preferences.prependBasePath = falseの場合、secureImageの場所のみがそのまま返されます。set (post)の場合は、相対パスのみが使用され、getの場合は、前述のように設定されていれば完全なURLが返されます。 -
phraseString: string
ユーザー優先フレーズ文字列(例: Hello World!)
-
uniqueUserId: string
外部システムのユーザーの不変ID。これが存在する場合は、userId + groupIdの組合せよりも優先されます。
-
userId: string
ユーザーの一意の識別子。さらにgroupIdで修飾できます。
ネストされたスキーマ: factorsRegistered
型:
array
ユーザーのファクタ登録データの配列。
ソースの表示
- 配列: object FactorRegData
factorNameおよびキーと値のマップを含むエントリ。キーと値のマップには、そのファクタに固有の属性が含まれます。
ネストされたスキーマ: FactorRegData
型:
object
factorNameおよびキーと値のマップを含むエントリ。キーと値のマップには、そのファクタに固有の属性が含まれます。
ソースの表示
-
factorAttributes: array factorAttributes
このユーザーのファクタの属性のコレクション。
-
factorKey: string
ファクタのキー。これは、OAAシステムで使用可能なファクタの1つにマップする必要がある名前です。これは、challenge.type.enumの列挙名の1つである必要があります。たとえば、ChallengeEmail、ChallengeSMS、ChallengeOMATOTP、ChallangeYOTPおよびChallengeFIDO2です。
-
factorName: string
これは、OAAシステムで使用可能なファクタの1つにマップする必要がある名前です。これは、challenge.type.enumの列挙名の1つである必要があります。たとえば、ファクタが電子メールの場合、factorNameはEmail Challengeです。例として、Email Challenge、SMS Challenge、OMA TOTP Challenge、Yubikey OTP Challange、FIDO2 Challengeがあります。
-
isPreferred: boolean
ファクタが、ユーザーがチャレンジする優先ファクタかどうか。
ネストされたスキーマ: factorAttributes
型:
array
このユーザーのファクタの属性のコレクション。
ソースの表示
- 配列: object PrefFactorAttribute
エントリの配列として表されるマップ。
ネストされたスキーマ: PrefFactorAttribute
型:
object
エントリの配列として表されるマップ。
ソースの表示
-
factorAttributeName: string
ファクタ固有属性の名前。
-
factorAttributeValue: array factorAttributeValue
ファクタ固有属性の値。配列に複数の値を指定できます。
ネストされたスキーマ: factorAttributeValue
型:
array
ファクタ固有属性の値。配列に複数の値を指定できます。
ソースの表示
- 配列: object PrefFactorAttributeValue
ファクタの属性値。
ネストされたスキーマ: PrefFactorAttributeValue
型:
object
ファクタの属性値。
ソースの表示
-
createTime: string (date-time)
"rfc3339セクション5.6の形式の日時文字列。https://tools.ietf.org/html/rfc3339#section-5.6"
-
isEnabled: boolean
ファクタ属性が有効どうかを示します。デフォルトでは、trueに設定されています。
-
isPreferred: boolean
属性の値が配列の他の同様の値よりも優先されるかどうかを示します。
-
isValidated: boolean
デフォルト値:
true
指定された属性が検証されているかどうかを示します。一部の属性には検証が不要なため、このフィールドはオプションです。 -
isVerified: boolean
デフォルト値:
true
指定された属性が検証されているかどうかを示します。一部の属性には検証が不要なため、このフィールドはオプションです。 -
name: string
デバイスのわかりやすい名前。
-
value: string
ファクタ属性の値。
ルート・スキーマ: schema
型:
object
各タイプのチャレンジ・ファクタに対するユーザーおよびユーザーのチャレンジの登録に関する情報。
ソースの表示
-
alternateName: string
ユーザー画面で使用できるユーザーの代替名。
-
defaultlocale: string
ユーザーのデフォルト・ロケール。指定しない場合は、デフォルト値の「en_US」が使用されます。
-
displayName: string
ユーザー画面で使用できるユーザーの表示名。
-
factorsRegistered: array factorsRegistered
ユーザーのファクタ登録データの配列。
-
groupId: string
プリファレンス・データが必要なユーザーのGroupId/ApplicationId。このパラメータが存在しない場合、"Default"という値が使用されます。
-
imageReference: string
secureImageの場所。Example:/images/secureImage01.jpg.イメージ・パスを完全なURLとして返すようにシステムが構成されている場合、次の2つのプロパティを構成する必要があります。1.)oaa.preferences.prependBasePath = true (デフォルトはfalse)、2.)oaa.preferences.imageBasePath=
。システム・プロパティoaa.preferences.prependBasePath = falseの場合、secureImageの場所のみがそのまま返されます。set (post)の場合は、相対パスのみが使用され、getの場合は、前述のように設定されていれば完全なURLが返されます。 -
phraseString: string
ユーザー優先フレーズ文字列(例: Hello World!)
-
uniqueUserId: string
外部システムのユーザーの不変ID。これが存在する場合は、userId + groupIdの組合せよりも優先されます。
-
userId: string
ユーザーの一意の識別子。さらにgroupIdで修飾できます。
ネストされたスキーマ: factorsRegistered
型:
array
ユーザーのファクタ登録データの配列。
ソースの表示
- 配列: object FactorRegData
factorNameおよびキーと値のマップを含むエントリ。キーと値のマップには、そのファクタに固有の属性が含まれます。
ネストされたスキーマ: FactorRegData
型:
object
factorNameおよびキーと値のマップを含むエントリ。キーと値のマップには、そのファクタに固有の属性が含まれます。
ソースの表示
-
factorAttributes: array factorAttributes
このユーザーのファクタの属性のコレクション。
-
factorKey: string
ファクタのキー。これは、OAAシステムで使用可能なファクタの1つにマップする必要がある名前です。これは、challenge.type.enumの列挙名の1つである必要があります。たとえば、ChallengeEmail、ChallengeSMS、ChallengeOMATOTP、ChallangeYOTPおよびChallengeFIDO2です。
-
factorName: string
これは、OAAシステムで使用可能なファクタの1つにマップする必要がある名前です。これは、challenge.type.enumの列挙名の1つである必要があります。たとえば、ファクタが電子メールの場合、factorNameはEmail Challengeです。例として、Email Challenge、SMS Challenge、OMA TOTP Challenge、Yubikey OTP Challange、FIDO2 Challengeがあります。
-
isPreferred: boolean
ファクタが、ユーザーがチャレンジする優先ファクタかどうか。
ネストされたスキーマ: factorAttributes
型:
array
このユーザーのファクタの属性のコレクション。
ソースの表示
- 配列: object PrefFactorAttribute
エントリの配列として表されるマップ。
ネストされたスキーマ: PrefFactorAttribute
型:
object
エントリの配列として表されるマップ。
ソースの表示
-
factorAttributeName: string
ファクタ固有属性の名前。
-
factorAttributeValue: array factorAttributeValue
ファクタ固有属性の値。配列に複数の値を指定できます。
ネストされたスキーマ: factorAttributeValue
型:
array
ファクタ固有属性の値。配列に複数の値を指定できます。
ソースの表示
- 配列: object PrefFactorAttributeValue
ファクタの属性値。
ネストされたスキーマ: PrefFactorAttributeValue
型:
object
ファクタの属性値。
ソースの表示
-
createTime: string (date-time)
"rfc3339セクション5.6の形式の日時文字列。https://tools.ietf.org/html/rfc3339#section-5.6"
-
isEnabled: boolean
ファクタ属性が有効どうかを示します。デフォルトでは、trueに設定されています。
-
isPreferred: boolean
属性の値が配列の他の同様の値よりも優先されるかどうかを示します。
-
isValidated: boolean
デフォルト値:
true
指定された属性が検証されているかどうかを示します。一部の属性には検証が不要なため、このフィールドはオプションです。 -
isVerified: boolean
デフォルト値:
true
指定された属性が検証されているかどうかを示します。一部の属性には検証が不要なため、このフィールドはオプションです。 -
name: string
デバイスのわかりやすい名前。
-
value: string
ファクタ属性の値。
レスポンス
サポートされているメディア・タイプ
- application/xml
- application/json
- text/plain
201レスポンス
ユーザー・プリファレンスが登録されました。
ルート・スキーマ: PreferencesResponse
型:
ソースの表示
object
-
message: object PrefAPIResponse
-
preferences: object schema
各タイプのチャレンジ・ファクタに対するユーザーおよびユーザーのチャレンジの登録に関する情報。
ネストされたスキーマ: schema
型:
object
各タイプのチャレンジ・ファクタに対するユーザーおよびユーザーのチャレンジの登録に関する情報。
ソースの表示
-
alternateName: string
ユーザー画面で使用できるユーザーの代替名。
-
defaultlocale: string
ユーザーのデフォルト・ロケール。指定しない場合は、デフォルト値の「en_US」が使用されます。
-
displayName: string
ユーザー画面で使用できるユーザーの表示名。
-
factorsRegistered: array factorsRegistered
ユーザーのファクタ登録データの配列。
-
groupId: string
プリファレンス・データが必要なユーザーのGroupId/ApplicationId。このパラメータが存在しない場合、"Default"という値が使用されます。
-
imageReference: string
secureImageの場所。Example:/images/secureImage01.jpg.イメージ・パスを完全なURLとして返すようにシステムが構成されている場合、次の2つのプロパティを構成する必要があります。1.)oaa.preferences.prependBasePath = true (デフォルトはfalse)、2.)oaa.preferences.imageBasePath=
。システム・プロパティoaa.preferences.prependBasePath = falseの場合、secureImageの場所のみがそのまま返されます。set (post)の場合は、相対パスのみが使用され、getの場合は、前述のように設定されていれば完全なURLが返されます。 -
phraseString: string
ユーザー優先フレーズ文字列(例: Hello World!)
-
uniqueUserId: string
外部システムのユーザーの不変ID。これが存在する場合は、userId + groupIdの組合せよりも優先されます。
-
userId: string
ユーザーの一意の識別子。さらにgroupIdで修飾できます。
ネストされたスキーマ: factorsRegistered
型:
array
ユーザーのファクタ登録データの配列。
ソースの表示
- 配列: object FactorRegData
factorNameおよびキーと値のマップを含むエントリ。キーと値のマップには、そのファクタに固有の属性が含まれます。
ネストされたスキーマ: FactorRegData
型:
object
factorNameおよびキーと値のマップを含むエントリ。キーと値のマップには、そのファクタに固有の属性が含まれます。
ソースの表示
-
factorAttributes: array factorAttributes
このユーザーのファクタの属性のコレクション。
-
factorKey: string
ファクタのキー。これは、OAAシステムで使用可能なファクタの1つにマップする必要がある名前です。これは、challenge.type.enumの列挙名の1つである必要があります。たとえば、ChallengeEmail、ChallengeSMS、ChallengeOMATOTP、ChallangeYOTPおよびChallengeFIDO2です。
-
factorName: string
これは、OAAシステムで使用可能なファクタの1つにマップする必要がある名前です。これは、challenge.type.enumの列挙名の1つである必要があります。たとえば、ファクタが電子メールの場合、factorNameはEmail Challengeです。例として、Email Challenge、SMS Challenge、OMA TOTP Challenge、Yubikey OTP Challange、FIDO2 Challengeがあります。
-
isPreferred: boolean
ファクタが、ユーザーがチャレンジする優先ファクタかどうか。
ネストされたスキーマ: factorAttributes
型:
array
このユーザーのファクタの属性のコレクション。
ソースの表示
- 配列: object PrefFactorAttribute
エントリの配列として表されるマップ。
ネストされたスキーマ: PrefFactorAttribute
型:
object
エントリの配列として表されるマップ。
ソースの表示
-
factorAttributeName: string
ファクタ固有属性の名前。
-
factorAttributeValue: array factorAttributeValue
ファクタ固有属性の値。配列に複数の値を指定できます。
ネストされたスキーマ: factorAttributeValue
型:
array
ファクタ固有属性の値。配列に複数の値を指定できます。
ソースの表示
- 配列: object PrefFactorAttributeValue
ファクタの属性値。
ネストされたスキーマ: PrefFactorAttributeValue
型:
object
ファクタの属性値。
ソースの表示
-
createTime: string (date-time)
"rfc3339セクション5.6の形式の日時文字列。https://tools.ietf.org/html/rfc3339#section-5.6"
-
isEnabled: boolean
ファクタ属性が有効どうかを示します。デフォルトでは、trueに設定されています。
-
isPreferred: boolean
属性の値が配列の他の同様の値よりも優先されるかどうかを示します。
-
isValidated: boolean
デフォルト値:
true
指定された属性が検証されているかどうかを示します。一部の属性には検証が不要なため、このフィールドはオプションです。 -
isVerified: boolean
デフォルト値:
true
指定された属性が検証されているかどうかを示します。一部の属性には検証が不要なため、このフィールドはオプションです。 -
name: string
デバイスのわかりやすい名前。
-
value: string
ファクタ属性の値。
401レスポンス
未認可
412レスポンス
無効な入力
500レスポンス
内部サーバー・エラー
503レスポンス
サービス使用不可
例
次の例は、ユーザー・プリファレンスを作成するサンプルのリクエストとレスポンスを示します。ユーザーがシステムにすでに存在する場合は、エラーが返されます。このようなユーザーの場合は、プリファレンスの削除と更新の組合せを使用してプリファレンスを変更できます。
JSON形式でユーザー・プリファレンスを作成するcURLコマンド
curl --location --request POST '<OAAService>/oaa/runtime/preferences/v1' \ --header 'Content-Type: application/json' \ --header 'Authorization: Basic <Base64Encoded(<username>:<password>)>' \ --data '{ "userId": "user1", "groupId": "Default", "imageReference": "/u01/oracle/service/store/img001.jpg ", "phraseString": "Hello World!", "factorsRegistered": [ { "factorAttributes": [ { "factorAttributeValue": [ { "value": "user1@example.com", "name": "Device1", "isEnabled": true } ], "factorAttributeName": "email" } ], "factorKey": "ChallengeEmail", "isPreferred": false }, { "factorAttributes": [ { "factorAttributeValue": [ { "value": "secret_key", "name": "Device1", "isEnabled": true } ], "factorAttributeName": "omatotpsecretkey" } ], "factorKey": "ChallengeOMATOTP", "isPreferred": false } ] }'
JSON形式のサンプル・レスポンス
{ "preferences": { "userId": "user1", "groupId": "Default", "imageReference": "/u01/oracle/service/store/img001.jpg", "phraseString": "Hello World!", "factorsRegistered": [ { "isPreferred": false, "factorName": "Oracle Mobile Authenticator", "factorKey": "ChallengeOMATOTP", "factorAttributes": [ { "factorAttributeName": "omatotpsecretkey", "factorAttributeValue": [ { "value": "secret_key", "name": "Device1", "isEnabled": true } ] } ] }, { "isPreferred": false, "factorName": "Email Challenge", "factorKey": "ChallengeEmail", "factorAttributes": [ { "factorAttributeName": "email", "factorAttributeValue": [ { "value": "user1@example.com", "name": "Device1", "isEnabled": true } ] } ] } ] }, "message": { "responseCode": "201", "responseMessage": "User preference is created." } }
XML形式でユーザー・プリファレンスを作成するcURLコマンド
curl --location --request POST '<OAAService>/oaa/runtime/preferences/v1' \ --header 'Content-Type: application/xml' \ --header 'Accept: application/xml' \ --header 'Authorization: Basic <Base64Encoded(<username>:<password>)>' \ --data '<?xml version="1.0" encoding="UTF-8" ?> <UserPreferences> <userId>user1</userId> <groupId>Default</groupId> <imageReference>/u01/oracle/service/store/img001.jpg </imageReference> <phraseString>Hello World!</phraseString> <factorsRegistered> <factorAttributes> <factorAttributeValue> <value>user1@example.com</value> <name>Device1</name> <isEnabled>true</isEnabled> </factorAttributeValue> <factorAttributeName>email</factorAttributeName> </factorAttributes> <factorKey>ChallengeEmail</factorKey> <isPreferred>false</isPreferred> </factorsRegistered> <factorsRegistered> <factorAttributes> <factorAttributeValue> <value>secret_key</value> <name>Device1</name> <isEnabled>true</isEnabled> </factorAttributeValue> <factorAttributeName>omatotpsecretkey</factorAttributeName> </factorAttributes> <factorKey>ChallengeOMATOTP</factorKey> <isPreferred>false</isPreferred> </factorsRegistered> </UserPreferences> '
XML形式のサンプル・レスポンス
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <PreferencesResponse> <preferences> <userId>user1</userId> <groupId>Default</groupId> <imageReference>/u01/oracle/service/store/img001.jpg</imageReference> <phraseString>Hello World!</phraseString> <factorsRegistered> <isPreferred>false</isPreferred> <factorName>Oracle Mobile Authenticator</factorName> <factorKey>ChallengeOMATOTP</factorKey> <factorAttributes> <factorAttributeName>omatotpsecretkey</factorAttributeName> <factorAttributeValue> <value>secret_key</value> <name>Device1</name> <isEnabled>true</isEnabled> <createTime> <parseFailed>false</parseFailed> <rawParam>2023-05-10T21:07:36.814Z</rawParam> <dateTime>2023-05-10T21:07:36.814Z</dateTime> </createTime> </factorAttributeValue> </factorAttributes> </factorsRegistered> <factorsRegistered> <isPreferred>false</isPreferred> <factorName>Email Challenge</factorName> <factorKey>ChallengeEmail</factorKey> <factorAttributes> <factorAttributeName>email</factorAttributeName> <factorAttributeValue> <value>user1@example.com</value> <name>Device1</name> <isEnabled>true</isEnabled> <createTime> <parseFailed>false</parseFailed> <rawParam>2023-05-10T21:07:36.814Z</rawParam> <dateTime>2023-05-10T21:07:36.814Z</dateTime> </createTime> </factorAttributeValue> </factorAttributes> </factorsRegistered> </preferences> <message> <responseCode>201</responseCode> <responseMessage>User preference is created.</responseMessage> </message> </PreferencesResponse>