OAAで使用可能なユーザーのチャレンジ・プリファレンスを返す
put
/oaa/runtime/preferences/v1/fetchuserpreferencessecurely
ユーザーのチャレンジ・プリファレンスのリストを返します。OAAでユーザーが見つからない場合は、エラーが返されます。
リクエスト
この操作にはリクエスト・パラメータはありません。
サポートされているメディア・タイプ
- application/xml
- application/json
ルート・スキーマ: schema
型:
object
リクエスト・オブジェクトには、userIdおよびgroupIdが含まれます。
ソースの表示
-
groupId: string
デフォルト値:
default
ユーザーが属するグループ。このパラメータが存在しない場合は、Defaultという値が使用されます。 -
uniqueUserId: string
外部システムのユーザーの不変ID。これが存在する場合は、userId + groupIdの組合せよりも優先されます。
-
userId(required): string
グループ内で一意のユーザID。
ルート・スキーマ: schema
型:
object
リクエスト・オブジェクトには、userIdおよびgroupIdが含まれます。
ソースの表示
-
groupId: string
デフォルト値:
default
ユーザーが属するグループ。このパラメータが存在しない場合は、Defaultという値が使用されます。 -
uniqueUserId: string
外部システムのユーザーの不変ID。これが存在する場合は、userId + groupIdの組合せよりも優先されます。
-
userId(required): string
グループ内で一意のユーザID。
レスポンス
サポートされているメディア・タイプ
- application/xml
- application/json
- text/plain
200レスポンス
成功。
ルート・スキーマ: 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 PUT '<OAAService>/oaa/runtime/preferences/v1/fetchuserpreferencessecurely' \ --header 'Content-Type: application/json' \ --header 'Authorization: Basic <Base64Encoded(<username>:<password>)>' \ --data '{ "userId": "testuser4", "groupId": "testfinanceapp4" }'
JSON形式のサンプル・レスポンス
{ "userId": "testuser4", "groupId": "testfinanceapp4", "displayName": "testuser4", "factorsRegistered": [ { "isPreferred": false, "factorName": "Oracle Mobile Authenticator", "factorKey": "ChallengeOMATOTP", "factorAttributes": [ { "factorAttributeName": "omatotpsecretkey", "factorAttributeValue": [ { "value": "WIFSG2NMB36EGIRC", "isPreferred": false, "isVerified": true, "isValidated": true, "name": "UserPreferencesIT11", "isEnabled": true, "createTime": { "parseFailed": false, "dateTime": "2023-06-07T11:45:43.551Z", "rawParam": "2023-06-07T11:45:43.551Z" } }, { "value": "I6PXBQVD3T76YLSH", "isPreferred": false, "isVerified": false, "isValidated": true, "name": "authnIT13", "isEnabled": true, "createTime": { "parseFailed": false, "dateTime": "2023-06-07T11:47:14.401Z", "rawParam": "2023-06-07T11:47:14.401Z" } } ] } ] }, { "isPreferred": false, "factorName": "Email Challenge", "factorKey": "ChallengeEmail", "factorAttributes": [ { "factorAttributeName": "email", "factorAttributeValue": [ { "value": "test@test.com", "isPreferred": false, "isVerified": false, "isValidated": false, "name": "Email1", "isEnabled": true, "createTime": { "parseFailed": false, "dateTime": "2023-06-07T11:45:09.941Z", "rawParam": "2023-06-07T11:45:09.941Z" } } ] } ] }, { "isPreferred": false, "factorName": "Yubico OTP Challenge", "factorKey": "ChallengeYubicoOTP", "factorAttributes": [ { "factorAttributeName": "privateId", "factorAttributeValue": [ { "value": "269b0ed09233", "isVerified": true, "isValidated": true, "name": "MyPersonalDevice", "isEnabled": true, "createTime": { "parseFailed": false, "dateTime": "2023-06-07T11:45:09.939Z", "rawParam": "2023-06-07T11:45:09.939Z" } } ] }, { "factorAttributeName": "secretkey", "factorAttributeValue": [ { "value": "bb23b36dd3ba45b4db8776e43759bbfb", "isVerified": true, "isValidated": true, "name": "MyPersonalDevice", "isEnabled": true, "createTime": { "parseFailed": false, "dateTime": "2023-06-07T11:45:09.939Z", "rawParam": "2023-06-07T11:45:09.939Z" } } ] }, { "factorAttributeName": "publicId", "factorAttributeValue": [ { "value": "vvccccjeelee", "isVerified": false, "isValidated": false, "name": "MyPersonalDevice", "isEnabled": true, "createTime": { "parseFailed": false, "dateTime": "2023-06-07T11:45:09.939Z", "rawParam": "2023-06-07T11:45:09.939Z" } } ] } ] }, { "isPreferred": false, "factorName": "Security Question Challenge", "factorKey": "ChallengeKBA", "factorAttributes": [ { "factorAttributeName": "kba", "factorAttributeValue": [ { "value": "3", "isVerified": true, "isValidated": true, "name": "Security Questions", "isEnabled": true, "createTime": { "parseFailed": false, "dateTime": "2023-06-07T11:46:06.152Z", "rawParam": "2023-06-07T11:46:06.152Z" } } ] } ] }, { "isPreferred": false, "factorName": "SMS Challenge", "factorKey": "ChallengeSMS", "factorAttributes": [ { "factorAttributeName": "mobile", "factorAttributeValue": [ { "value": "1111111111", "isPreferred": false, "isVerified": false, "isValidated": false, "name": "Phone1", "isEnabled": true, "createTime": { "parseFailed": false, "dateTime": "2023-06-07T11:45:09.943Z", "rawParam": "2023-06-07T11:45:09.943Z" } } ] } ] }, { "isPreferred": false, "factorName": "FIDO2 Challenge", "factorKey": "ChallengeFIDO2", "factorAttributes": [ { "factorAttributeName": "fido2publickey", "factorAttributeValue": [ { "value": "fidosecretvalue", "isPreferred": false, "isVerified": true, "isValidated": true, "name": "up11_device", "isEnabled": true, "createTime": { "parseFailed": false, "dateTime": "2023-06-07T11:45:09.944Z", "rawParam": "2023-06-07T11:45:09.944Z" } } ] } ] } ] }
XML形式でチャレンジ・プリファレンスのリストを取得するcURLコマンド
curl --location --request PUT '<OAAService>/oaa/runtime/preferences/v1/fetchuserpreferencessecurely' \ --header 'Content-Type: application/xml' \ --header 'Accept: application/xml' \ --header 'Authorization: Basic <Base64Encoded(<username>:<password>)>' \ --data '<?xml version="1.0" encoding="UTF-8" ?> <PrefUserData> <userId>testuser4</userId> <groupId>testfinanceapp4</groupId> </PrefUserData> '
XML形式のサンプル・レスポンス
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <UserPreferences> <userId>testuser4</userId> <groupId>testfinanceapp4</groupId> <displayName>testuser4</displayName> <factorsRegistered> <isPreferred>false</isPreferred> <factorName>Oracle Mobile Authenticator</factorName> <factorKey>ChallengeOMATOTP</factorKey> <factorAttributes> <factorAttributeName>omatotpsecretkey</factorAttributeName> <factorAttributeValue> <value>WIFSG2NMB36EGIRC</value> <isPreferred>false</isPreferred> <isVerified>true</isVerified> <isValidated>true</isValidated> <name>UserPreferencesIT11</name> <isEnabled>true</isEnabled> <createTime> <parseFailed>false</parseFailed> <dateTime>2023-06-07T11:45:43.551Z</dateTime> <rawParam>2023-06-07T11:45:43.551Z</rawParam> </createTime> </factorAttributeValue> <factorAttributeValue> <value>I6PXBQVD3T76YLSH</value> <isPreferred>false</isPreferred> <isVerified>false</isVerified> <isValidated>true</isValidated> <name>authnIT13</name> <isEnabled>true</isEnabled> <createTime> <parseFailed>false</parseFailed> <dateTime>2023-06-07T11:47:14.401Z</dateTime> <rawParam>2023-06-07T11:47:14.401Z</rawParam> </createTime> </factorAttributeValue> </factorAttributes> </factorsRegistered> <factorsRegistered> <isPreferred>false</isPreferred> <factorName>Email Challenge</factorName> <factorKey>ChallengeEmail</factorKey> <factorAttributes> <factorAttributeName>email</factorAttributeName> <factorAttributeValue> <value>test@test.com</value> <isPreferred>false</isPreferred> <isVerified>false</isVerified> <isValidated>false</isValidated> <name>Email1</name> <isEnabled>true</isEnabled> <createTime> <parseFailed>false</parseFailed> <dateTime>2023-06-07T11:45:09.941Z</dateTime> <rawParam>2023-06-07T11:45:09.941Z</rawParam> </createTime> </factorAttributeValue> </factorAttributes> </factorsRegistered> <factorsRegistered> <isPreferred>false</isPreferred> <factorName>Yubico OTP Challenge</factorName> <factorKey>ChallengeYubicoOTP</factorKey> <factorAttributes> <factorAttributeName>privateId</factorAttributeName> <factorAttributeValue> <value>269b0ed09233</value> <isVerified>true</isVerified> <isValidated>true</isValidated> <name>MyPersonalDevice</name> <isEnabled>true</isEnabled> <createTime> <parseFailed>false</parseFailed> <dateTime>2023-06-07T11:45:09.939Z</dateTime> <rawParam>2023-06-07T11:45:09.939Z</rawParam> </createTime> </factorAttributeValue> </factorAttributes> <factorAttributes> <factorAttributeName>secretkey</factorAttributeName> <factorAttributeValue> <value>bb23b36dd3ba45b4db8776e43759bbfb</value> <isVerified>true</isVerified> <isValidated>true</isValidated> <name>MyPersonalDevice</name> <isEnabled>true</isEnabled> <createTime> <parseFailed>false</parseFailed> <dateTime>2023-06-07T11:45:09.939Z</dateTime> <rawParam>2023-06-07T11:45:09.939Z</rawParam> </createTime> </factorAttributeValue> </factorAttributes> <factorAttributes> <factorAttributeName>publicId</factorAttributeName> <factorAttributeValue> <value>vvccccjeelee</value> <isVerified>false</isVerified> <isValidated>false</isValidated> <name>MyPersonalDevice</name> <isEnabled>true</isEnabled> <createTime> <parseFailed>false</parseFailed> <dateTime>2023-06-07T11:45:09.939Z</dateTime> <rawParam>2023-06-07T11:45:09.939Z</rawParam> </createTime> </factorAttributeValue> </factorAttributes> </factorsRegistered> <factorsRegistered> <isPreferred>false</isPreferred> <factorName>Security Question Challenge</factorName> <factorKey>ChallengeKBA</factorKey> <factorAttributes> <factorAttributeName>kba</factorAttributeName> <factorAttributeValue> <value>3</value> <isVerified>true</isVerified> <isValidated>true</isValidated> <name>Security Questions</name> <isEnabled>true</isEnabled> <createTime> <parseFailed>false</parseFailed> <dateTime>2023-06-07T11:46:06.152Z</dateTime> <rawParam>2023-06-07T11:46:06.152Z</rawParam> </createTime> </factorAttributeValue> </factorAttributes> </factorsRegistered> <factorsRegistered> <isPreferred>false</isPreferred> <factorName>SMS Challenge</factorName> <factorKey>ChallengeSMS</factorKey> <factorAttributes> <factorAttributeName>mobile</factorAttributeName> <factorAttributeValue> <value>1111111111</value> <isPreferred>false</isPreferred> <isVerified>false</isVerified> <isValidated>false</isValidated> <name>Phone1</name> <isEnabled>true</isEnabled> <createTime> <parseFailed>false</parseFailed> <dateTime>2023-06-07T11:45:09.943Z</dateTime> <rawParam>2023-06-07T11:45:09.943Z</rawParam> </createTime> </factorAttributeValue> </factorAttributes> </factorsRegistered> <factorsRegistered> <isPreferred>false</isPreferred> <factorName>FIDO2 Challenge</factorName> <factorKey>ChallengeFIDO2</factorKey> <factorAttributes> <factorAttributeName>fido2publickey</factorAttributeName> <factorAttributeValue> <value>fidosecretvalue</value> <isPreferred>false</isPreferred> <isVerified>true</isVerified> <isValidated>true</isValidated> <name>up11_device</name> <isEnabled>true</isEnabled> <createTime> <parseFailed>false</parseFailed> <dateTime>2023-06-07T11:45:09.944Z</dateTime> <rawParam>2023-06-07T11:45:09.944Z</rawParam> </createTime> </factorAttributeValue> </factorAttributes> </factorsRegistered> </UserPreferences>