ジャンプ先

• リクエスト
• レスポンス

initチャレンジからのレスポンスを取得し、チャレンジおよびチャレンジAPIを確定して、ユーザーがさらにチャレンジされる必要があるかどうかを識別する。

put

/authn/v1

UAS内の認証ステータスを更新します。また、ユーザーにさらにチャレンジが必要な場合にも返されます(ユーザーの成功を返すこともできます)。内部的にvalidateをコールして、パッシブなファクタで渡されたパラメータを検証できます。

リクエスト

この操作にはリクエスト・パラメータはありません。

サポートされているメディア・タイプ

• application/xml
• application/json

リクエスト本文 - application/xml ()

ルート・スキーマ: schema

型: object

オブジェクトは、認証リクエストの更新のリクエスト・パラメータを定義します。

ソースの表示

• challengeAnswer: string
  ファクタに渡す、ユーザーが指定した回答。
• challengedata: object InitChallengeData
  チャレンジ・ファクタに対するユーザーおよびユーザーの登録に関する情報。
• challengeop(required): string
  チャレンジAPIで実行するようにリクエストされた操作。Init/Validate/Finalizeのいずれかです。initの場合、nonceはオプションです。Validate/Finalizeの場合は、nonceが必要です。
• challengeResult: string
  チャレンジの結果。Success/Error/Failureのいずれか。検証の結果、パッシブ・ファクタAPIが呼び出され、ChallengeAnswerが検証されます。ファクタがパッシブでない場合は、例外がスローされます。他の結果は、チャレンジ・コールを確定するために直接渡されます。
• challengeResultReason: string
  チャレンジ結果が失敗した場合の理由。wrong_answer/too_many_attempts/channel_comm_error/other_error/unavailable_for_user/user_abandoned/user_timedoutのいずれかです。
• correlationId(required): string
  チャレンジAPIによって提供されるトランザクションID。また、このフィールドには、ストアを更新するためにセッション内で使用された以前のIDも含まれます。
• nonce: string
  将来のリクエストを識別するランダムな文字列。これは応答ごとに変化し、確定コールでは最新のnonceが期待されます。

{
    "required":[
        "challengeop",
        "correlationId"
    ],
    "type":"object",
    "properties":{
        "correlationId":{
            "type":"string",
            "description":"transaction id provided by the challenge api. Also this field contains previous id used within the session to update store."
        },
        "nonce":{
            "type":"string",
            "description":"random string to identify the future request. This will change in each response and the lastest nonce is expected in the finalize call."
        },
        "challengedata":{
            "$ref":"#/components/schemas/InitChallengeData"
        },
        "challengeop":{
            "type":"string",
            "description":"Requested operation to perform on the challenge API. It can be one of Init/Validate/Finalize. For init nonce is optional. Validate/Finalize nonce is required."
        },
        "challengeAnswer":{
            "type":"string",
            "description":"answer provided by the user to be passed to factor."
        },
        "challengeResult":{
            "type":"string",
            "description":"Result of the challenge. One of Success/Error/Failure. Validate will result in invocation of passive factor api to validate ChallengeAnswer. If the factor is not passive, exception will be thrown. Other result will be passed directly to finalize challenge call."
        },
        "challengeResultReason":{
            "type":"string",
            "description":"Reason for challenge result if it is failure. One of wrong_answer/too_many_attempts/channel_comm_error/other_error/unavailable_for_user/user_abandoned/user_timedout."
        }
    },
    "description":"The object defines the request parametes for update authentication request."
}

ネストされたスキーマ: InitChallengeData

型: object

チャレンジ・ファクタに対するユーザーおよびユーザーの登録に関する情報。

ソースの表示

• abandonedChallenge: boolean
  このチャレンジがユーザーによって破棄されたかどうかを示すフラグ。
• correlationId: string
  このチャレンジの相関ID。ファクタ実装では、finishChallengeコール中にSP/UASへのコールバックでこれを使用する必要があります。
• factorAttributes: array factorAttributes
• factorKey: string
  エンド・ユーザーによって選択されたファクタの名前。
• failureURL: string
  チャレンジが失敗した場合にフローをリダイレクトする必要があるリソース。ほとんどの場合、これはfinalizerChallengeのURLになります。
• groupId: string
  ユーザーに適用可能なグループIDまたはアプリケーション名。
• isRetry: boolean
  これが再試行かどうか。
• successURL: string
  チャレンジが成功した場合にフローをリダイレクトする必要があるリソース。
• timeToLiveInSec: integer
  ブロッキング・コールの開始時のブロッキング・コールの期間。期間の経過後、ブロッキング・コールが無効になります。
• uniqueUserId: string
  外部システムのユーザーの不変ID。これが存在する場合は、userId + groupIdの組合せよりも優先されます。
• userId: string
  ユーザーの一意の識別子。さらにgroupIdで修飾できます。

{
    "required":[
        "userId|factorKey|correlationId"
    ],
    "type":"object",
    "properties":{
        "userId":{
            "type":"string",
            "description":"Unique identifier of the user. May be further qualified by groupId."
        },
        "groupId":{
            "type":"string",
            "description":"Group Id or app-name as applicable for user."
        },
        "uniqueUserId":{
            "type":"string",
            "description":"Immutable ID of the user in the external systems. If this is present, then it takes precedence over userId + groupId combination."
        },
        "correlationId":{
            "type":"string",
            "description":"Co-relation Id for this challenge. Factor implementation should use this in call back to SP/UAS during the finishChallenge call."
        },
        "factorKey":{
            "type":"string",
            "description":"the name of the factor that is selected by end user."
        },
        "isRetry":{
            "type":"boolean",
            "description":"If this is a retry."
        },
        "successURL":{
            "type":"string",
            "description":"Resource where flow should be redirected to in case of successful challenge."
        },
        "failureURL":{
            "type":"string",
            "description":"Resource where flow should be redirected to in case of failed challenge. Most times this will be URL of the finalizerChallenge."
        },
        "timeToLiveInSec":{
            "type":"integer",
            "description":"duration of the blocking call when initiating blocking call. After the duration, the blocking call will be invalidated."
        },
        "abandonedChallenge":{
            "type":"boolean",
            "description":"Flag to indicate if this challenge is abandoned by user."
        },
        "factorAttributes":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/UserFactorAttribute"
            }
        }
    },
    "description":"Information about the user and user's registration for challenge factor."
}

ネストされたスキーマ: factorAttributes

型: array

ソースの表示

• Array of: object UserFactorAttribute
  エントリの配列として表されるマップ。

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/UserFactorAttribute"
    }
}

ネストされたスキーマ: UserFactorAttribute

型: object

エントリの配列として表されるマップ。

ソースの表示

• userAttributeName: string
  このユーザーのファクタ固有属性の名前。
• userAttributeValue: string
  このユーザーのファクタ固有属性の値。

{
    "required":[
        "userAttributeName|userAttributeValue"
    ],
    "type":"object",
    "properties":{
        "userAttributeName":{
            "type":"string",
            "description":"Name of factor specific attribute for this user."
        },
        "userAttributeValue":{
            "type":"string",
            "description":"Value of factor specific attribute for this user."
        }
    },
    "description":"A map represented as an array of entries."
}

リクエスト本文 - application/json ()

ルート・スキーマ: schema

型: object

オブジェクトは、認証リクエストの更新のリクエスト・パラメータを定義します。

ソースの表示

• challengeAnswer: string
  ファクタに渡す、ユーザーが指定した回答。
• challengedata: object InitChallengeData
  チャレンジ・ファクタに対するユーザーおよびユーザーの登録に関する情報。
• challengeop(required): string
  チャレンジAPIで実行するようにリクエストされた操作。Init/Validate/Finalizeのいずれかです。initの場合、nonceはオプションです。Validate/Finalizeの場合は、nonceが必要です。
• challengeResult: string
  チャレンジの結果。Success/Error/Failureのいずれか。検証の結果、パッシブ・ファクタAPIが呼び出され、ChallengeAnswerが検証されます。ファクタがパッシブでない場合は、例外がスローされます。他の結果は、チャレンジ・コールを確定するために直接渡されます。
• challengeResultReason: string
  チャレンジ結果が失敗した場合の理由。wrong_answer/too_many_attempts/channel_comm_error/other_error/unavailable_for_user/user_abandoned/user_timedoutのいずれかです。
• correlationId(required): string
  チャレンジAPIによって提供されるトランザクションID。また、このフィールドには、ストアを更新するためにセッション内で使用された以前のIDも含まれます。
• nonce: string
  将来のリクエストを識別するランダムな文字列。これは応答ごとに変化し、確定コールでは最新のnonceが期待されます。

{
    "required":[
        "challengeop",
        "correlationId"
    ],
    "type":"object",
    "properties":{
        "correlationId":{
            "type":"string",
            "description":"transaction id provided by the challenge api. Also this field contains previous id used within the session to update store."
        },
        "nonce":{
            "type":"string",
            "description":"random string to identify the future request. This will change in each response and the lastest nonce is expected in the finalize call."
        },
        "challengedata":{
            "$ref":"#/components/schemas/InitChallengeData"
        },
        "challengeop":{
            "type":"string",
            "description":"Requested operation to perform on the challenge API. It can be one of Init/Validate/Finalize. For init nonce is optional. Validate/Finalize nonce is required."
        },
        "challengeAnswer":{
            "type":"string",
            "description":"answer provided by the user to be passed to factor."
        },
        "challengeResult":{
            "type":"string",
            "description":"Result of the challenge. One of Success/Error/Failure. Validate will result in invocation of passive factor api to validate ChallengeAnswer. If the factor is not passive, exception will be thrown. Other result will be passed directly to finalize challenge call."
        },
        "challengeResultReason":{
            "type":"string",
            "description":"Reason for challenge result if it is failure. One of wrong_answer/too_many_attempts/channel_comm_error/other_error/unavailable_for_user/user_abandoned/user_timedout."
        }
    },
    "description":"The object defines the request parametes for update authentication request."
}

ネストされたスキーマ: InitChallengeData

型: object

チャレンジ・ファクタに対するユーザーおよびユーザーの登録に関する情報。

ソースの表示

• abandonedChallenge: boolean
  このチャレンジがユーザーによって破棄されたかどうかを示すフラグ。
• correlationId: string
  このチャレンジの相関ID。ファクタ実装では、finishChallengeコール中にSP/UASへのコールバックでこれを使用する必要があります。
• factorAttributes: array factorAttributes
• factorKey: string
  エンド・ユーザーによって選択されたファクタの名前。
• failureURL: string
  チャレンジが失敗した場合にフローをリダイレクトする必要があるリソース。ほとんどの場合、これはfinalizerChallengeのURLになります。
• groupId: string
  ユーザーに適用可能なグループIDまたはアプリケーション名。
• isRetry: boolean
  これが再試行かどうか。
• successURL: string
  チャレンジが成功した場合にフローをリダイレクトする必要があるリソース。
• timeToLiveInSec: integer
  ブロッキング・コールの開始時のブロッキング・コールの期間。期間の経過後、ブロッキング・コールが無効になります。
• uniqueUserId: string
  外部システムのユーザーの不変ID。これが存在する場合は、userId + groupIdの組合せよりも優先されます。
• userId: string
  ユーザーの一意の識別子。さらにgroupIdで修飾できます。

{
    "required":[
        "userId|factorKey|correlationId"
    ],
    "type":"object",
    "properties":{
        "userId":{
            "type":"string",
            "description":"Unique identifier of the user. May be further qualified by groupId."
        },
        "groupId":{
            "type":"string",
            "description":"Group Id or app-name as applicable for user."
        },
        "uniqueUserId":{
            "type":"string",
            "description":"Immutable ID of the user in the external systems. If this is present, then it takes precedence over userId + groupId combination."
        },
        "correlationId":{
            "type":"string",
            "description":"Co-relation Id for this challenge. Factor implementation should use this in call back to SP/UAS during the finishChallenge call."
        },
        "factorKey":{
            "type":"string",
            "description":"the name of the factor that is selected by end user."
        },
        "isRetry":{
            "type":"boolean",
            "description":"If this is a retry."
        },
        "successURL":{
            "type":"string",
            "description":"Resource where flow should be redirected to in case of successful challenge."
        },
        "failureURL":{
            "type":"string",
            "description":"Resource where flow should be redirected to in case of failed challenge. Most times this will be URL of the finalizerChallenge."
        },
        "timeToLiveInSec":{
            "type":"integer",
            "description":"duration of the blocking call when initiating blocking call. After the duration, the blocking call will be invalidated."
        },
        "abandonedChallenge":{
            "type":"boolean",
            "description":"Flag to indicate if this challenge is abandoned by user."
        },
        "factorAttributes":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/UserFactorAttribute"
            }
        }
    },
    "description":"Information about the user and user's registration for challenge factor."
}

ネストされたスキーマ: factorAttributes

型: array

ソースの表示

• Array of: object UserFactorAttribute
  エントリの配列として表されるマップ。

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/UserFactorAttribute"
    }
}

ネストされたスキーマ: UserFactorAttribute

型: object

エントリの配列として表されるマップ。

ソースの表示

• userAttributeName: string
  このユーザーのファクタ固有属性の名前。
• userAttributeValue: string
  このユーザーのファクタ固有属性の値。

{
    "required":[
        "userAttributeName|userAttributeValue"
    ],
    "type":"object",
    "properties":{
        "userAttributeName":{
            "type":"string",
            "description":"Name of factor specific attribute for this user."
        },
        "userAttributeValue":{
            "type":"string",
            "description":"Value of factor specific attribute for this user."
        }
    },
    "description":"A map represented as an array of entries."
}

先頭に戻る

レスポンス

サポートされているメディア・タイプ

• application/xml
• application/json

200レスポンス

成功

本文()

ルート・スキーマ: UpdateAuthnResponse

型: object

更新レスポンス・オブジェクト。

ソースの表示

• apiResponse: object StatusInfo
  フェッチ・チャレンジ情報リクエストのステータス。これには、ユーザー認証リクエストの処理に必要な情報が含まれています。
• challengecontext: object InitContext
• challengeInfo: array challengeInfo
  ユーザーは様々な方法でチャレンジできます。オブジェクトには、ユーザーが認証可能なすべての方法が含まれています。リクエストでユーザー情報を使用できない場合、サービス・プロバイダ構成に従ってデフォルトのチャレンジ・メカニズムが提供されます。
• challengeselectiontext: string
  複数のチャレンジのうち1つを選択するために表示するメッセージ
• cookies: array cookies
  ユーザー・アクセス・リクエストに存在するCookie。
• correlationId: string
  チャレンジAPIによって提供されるトランザクションID。また、このフィールドには、ストアを更新するためにセッション内で使用された以前のIDも含まれます。
• nonce: string
  将来のリクエストを識別するランダムな文字列。これは応答ごとに変化し、確定コールでは最新のnonceが期待されます。

{
    "type":"object",
    "properties":{
        "correlationId":{
            "type":"string",
            "description":"transaction id provided by the challenge api. Also this field contains previous id used within the session to update store."
        },
        "apiResponse":{
            "$ref":"#/components/schemas/StatusInfo"
        },
        "challengeselectiontext":{
            "type":"string",
            "description":"Message to be displayed to select one of multiple challenges"
        },
        "challengeInfo":{
            "type":"array",
            "description":"A user can be challenged in many ways, the object will contain all the possible ways a user can be authenticated. In case the user information is not available in the request, the Default challenge mechanism as per the service provider configuration will be present.",
            "items":{
                "$ref":"#/components/schemas/FactorChallengeInfo"
            }
        },
        "nonce":{
            "type":"string",
            "description":"random string to identify the future request. This will change in each response and the lastest nonce is expected in the finalize call."
        },
        "challengecontext":{
            "$ref":"#/components/schemas/InitContext"
        },
        "cookies":{
            "type":"array",
            "description":"Cookies present in the user access request.",
            "items":{
                "$ref":"#/components/schemas/KeyValPair"
            }
        }
    },
    "description":"The update response object."
}

ネストされたスキーマ: StatusInfo

型: object

フェッチ・チャレンジ情報リクエストのステータス。これには、ユーザー認証リクエストの処理に必要な情報が含まれています。

ソースの表示

• code: integer
  チャレンジ・ステータスを表すコード。
• message: string
  サーバーがリクエストを処理できない場合に生成されるエラー・メッセージ。
• status(required): string
  ユーザー・リクエストのフェッチ・チャレンジ情報のステータス。これは、authenticated/pending verification/pending identification/failed/error/missing registration/challenge blockedのいずれかになります。

{
    "required":[
        "status"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"integer",
            "description":"Code representing the challenge status."
        },
        "status":{
            "type":"string",
            "description":"status of the fetch challenge info for user request. It will be one of the following authenticated/pending verification/pending identification/failed/error/missing registration/challenge blocked."
        },
        "message":{
            "type":"string",
            "description":"Error message generated if the server is unable to process the request."
        }
    },
    "description":"Status of the fetch challenge info request. It contains the information required to process the user authentication request."
}

ネストされたスキーマ: InitContext

型: object

ソースの表示

• factorAttributes: array factorAttributes
• factorKey: string
  エンド・ユーザーによって選択されたファクタの名前。
• failureURL: string
  チャレンジが失敗した場合にフローをリダイレクトする必要があるリソース。ほとんどの場合、これはfinalizerChallengeのURLになります。
• groupId: string
  ユーザーに適用可能なグループIDまたはアプリケーション名。
• requestParams: array requestParams
• successURL: string
  チャレンジが成功した場合にフローをリダイレクトする必要があるリソース。
• timeToLiveInSec: integer
  ブロッキング・コールの開始時のブロッキング・コールの期間。期間の経過後、ブロッキング・コールが無効になります。
• uniqueUserId: string
  外部システムのユーザーの不変ID。これが存在する場合は、userId + groupIdの組合せよりも優先されます。
• userId: string
  ユーザーの一意の識別子。さらにgroupIdで修飾できます。

{
    "type":"object",
    "properties":{
        "factorKey":{
            "type":"string",
            "description":"the name of the factor that is selected by end user."
        },
        "successURL":{
            "type":"string",
            "description":"Resource where flow should be redirected to in case of successful challenge."
        },
        "failureURL":{
            "type":"string",
            "description":"Resource where flow should be redirected to in case of failed challenge. Most times this will be URL of the finalizerChallenge."
        },
        "timeToLiveInSec":{
            "type":"integer",
            "description":"duration of the blocking call when initiating blocking call. After the duration, the blocking call will be invalidated."
        },
        "factorAttributes":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/UserFactorAttribute"
            }
        },
        "requestParams":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/KeyValPair_2"
            }
        },
        "userId":{
            "type":"string",
            "description":"Unique identifier of the user. May be further qualified by groupId."
        },
        "groupId":{
            "type":"string",
            "description":"Group Id or app-name as applicable for user."
        },
        "uniqueUserId":{
            "type":"string",
            "description":"Immutable ID of the user in the external systems. If this is present, then it takes precedence over userId + groupId combination."
        }
    }
}

ネストされたスキーマ: challengeInfo

型: array

ユーザーは様々な方法でチャレンジできます。オブジェクトには、ユーザーが認証可能なすべての方法が含まれています。リクエストでユーザー情報を使用できない場合、サービス・プロバイダ構成に従ってデフォルトのチャレンジ・メカニズムが提供されます。

ソースの表示

• Array of: object FactorChallengeInfo
  使用可能なファクタを使用してユーザー・リクエストを処理するために必要な情報がオブジェクトに存在します。

{
    "type":"array",
    "description":"A user can be challenged in many ways, the object will contain all the possible ways a user can be authenticated. In case the user information is not available in the request, the Default challenge mechanism as per the service provider configuration will be present.",
    "items":{
        "$ref":"#/components/schemas/FactorChallengeInfo"
    }
}

ネストされたスキーマ: cookies

型: array

ユーザー・アクセス・リクエストに存在するCookie。

ソースの表示

• 配列: object KeyValPair
  一般的に使用できるキーと値のペア。

{
    "type":"array",
    "description":"Cookies present in the user access request.",
    "items":{
        "$ref":"#/components/schemas/KeyValPair"
    }
}

ネストされたスキーマ: factorAttributes

型: array

ソースの表示

• Array of: object UserFactorAttribute
  エントリの配列として表されるマップ。

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/UserFactorAttribute"
    }
}

ネストされたスキーマ: requestParams

型: array

ソースの表示

• Array of: object KeyValPair_2
  一般的に使用できるキーと値のペア。

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/KeyValPair_2"
    }
}

ネストされたスキーマ: UserFactorAttribute

型: object

エントリの配列として表されるマップ。

ソースの表示

• userAttributeName: string
  このユーザーのファクタ固有属性の名前。
• userAttributeValue: string
  このユーザーのファクタ固有属性の値。

{
    "required":[
        "userAttributeName|userAttributeValue"
    ],
    "type":"object",
    "properties":{
        "userAttributeName":{
            "type":"string",
            "description":"Name of factor specific attribute for this user."
        },
        "userAttributeValue":{
            "type":"string",
            "description":"Value of factor specific attribute for this user."
        }
    },
    "description":"A map represented as an array of entries."
}

ネストされたスキーマ: KeyValPair_2

型: object

一般的に使用できるキーと値のペア。

ソースの表示

• key(required): string
  関連値のフェッチに使用できるキー。
• value(required): object value
  指定する必要があるコンテンツ。

{
    "required":[
        "key",
        "value"
    ],
    "type":"object",
    "properties":{
        "key":{
            "type":"string",
            "description":"Key that can be used to fetch the related value."
        },
        "value":{
            "type":"object",
            "description":"Content that needs to be provided."
        }
    },
    "description":"Key-value pair which can be used generically."
}

ネストされたスキーマ: value

型: object

指定する必要があるコンテンツ。

ネストされたスキーマ: FactorChallengeInfo

型: object

使用可能なファクタを使用してユーザー・リクエストを処理するために必要な情報がオブジェクトに存在します。

ソースの表示

• displayOrder(required): integer
  複数のファクタが存在する場合のユーザーへの表示順序
• factorContext(required): object FactorContext
  ユーザー認証リクエストを処理するためにファクタに必要なコンテキスト。
• factorKey: string
  登録に使用できるファクタのキー。
• factorName(required): string
  ファクタの名前
• factorUrl(required): string
  ファクタのURL

{
    "required":[
        "displayOrder",
        "factorContext",
        "factorName",
        "factorUrl"
    ],
    "type":"object",
    "properties":{
        "displayOrder":{
            "type":"integer",
            "description":"The order of display to user when multiple factors are present"
        },
        "factorUrl":{
            "type":"string",
            "description":"URL of the factor"
        },
        "factorName":{
            "type":"string",
            "description":"name of the factor"
        },
        "factorKey":{
            "type":"string",
            "description":"key of the factor that can be used for registration."
        },
        "factorContext":{
            "$ref":"#/components/schemas/FactorContext"
        }
    },
    "description":"information required to process user request using the factors available to it will be present in the object."
}

ネストされたスキーマ: FactorContext

型: object

ユーザー認証リクエストを処理するためにファクタに必要なコンテキスト。

ソースの表示

• challengeAttrMap(required): array challengeAttrMap
• isSelected(required): boolean
  これがユーザー・プリファレンスに従って選択されたオプションかどうか。
• prompts(required): array prompts
  表示プロンプトには、ユーザーがさらに選択できる1つ以上のプロンプトが含まれます。
• promptselectmessage: string
  チャレンジ・プロンプトの1つを選択するためのメッセージ。

{
    "required":[
        "challengeAttrMap",
        "isSelected",
        "prompts"
    ],
    "type":"object",
    "properties":{
        "promptselectmessage":{
            "type":"string",
            "description":"Message to select one of the challenge prompts."
        },
        "prompts":{
            "type":"array",
            "description":"the display prompt will contain one or more prompts that can be further selected by user.",
            "items":{
                "$ref":"#/components/schemas/Prompt"
            }
        },
        "isSelected":{
            "type":"boolean",
            "description":"if this is the selected option as per the user preference."
        },
        "challengeAttrMap":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FactorAttribute"
            }
        }
    },
    "description":"The context required by factor to process the user authentication request."
}

ネストされたスキーマ: challengeAttrMap

型: array

ソースの表示

• Array of: object FactorAttribute
  エントリの配列として表されるマップ。

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/FactorAttribute"
    }
}

ネストされたスキーマ: prompts

型: array

表示プロンプトには、ユーザーがさらに選択できる1つ以上のプロンプトが含まれます。

ソースの表示

• Array of: object Prompt
  エンド・ユーザーに表示できるプロンプト

{
    "type":"array",
    "description":"the display prompt will contain one or more prompts that can be further selected by user.",
    "items":{
        "$ref":"#/components/schemas/Prompt"
    }
}

ネストされたスキーマ: FactorAttribute

型: object

エントリの配列として表されるマップ。

ソースの表示

• factorAttributeName: string
  ファクタ固有属性の名前。
• factorAttributeValue: string
  ファクタ固有属性の値。
• isValidated: boolean
  指定された属性が検証されているかどうか。一部の属性には検証が不要なため、このフィールドはオプションです。
• isVerified: boolean
  指定された属性が検証されているかどうか。一部の属性には検証が不要なため、このフィールドはオプションです。

{
    "type":"object",
    "properties":{
        "factorAttributeName":{
            "type":"string",
            "description":"Name of factor specific attribute."
        },
        "factorAttributeValue":{
            "type":"string",
            "description":"Value of factor specific attribute."
        },
        "isVerified":{
            "type":"boolean",
            "description":"is the given attribute is verified. Some attributes does not require verification hence this field is optional."
        },
        "isValidated":{
            "type":"boolean",
            "description":"If the given attribute is validated. Some attributes do not require validation hence this field is optional."
        }
    },
    "description":"A map represented as an array of entries."
}

ネストされたスキーマ: Prompt

型: object

エンド・ユーザーに表示できるプロンプト

ソースの表示

• challengeText: string
  チャレンジ画面に表示されるメッセージ。
• name: string
  デバイスまたはプロンプトのわかりやすい名前。
• prompt: string
  マスクされたデバイス情報。
• prompttext: string
  選択のためにエンド・ユーザーに表示できるメッセージ文字列。
• requiredInputType: string
  none/text/radio/checkbox/textarea/waitingpageの列挙
• selected: boolean
  この特定のプロンプトが選択されているかどうか。
• validated: boolean
  プロンプトが検証されているかどうか
• verified: boolean
  プロンプトが検証されているかどうか

{
    "required":[
        "promptmessage"
    ],
    "type":"object",
    "properties":{
        "prompttext":{
            "type":"string",
            "description":"Message string that can be displayed to end user for selection."
        },
        "prompt":{
            "type":"string",
            "description":"Masked device info."
        },
        "challengeText":{
            "type":"string",
            "description":"Message to be displayed on the challenge screen."
        },
        "requiredInputType":{
            "type":"string",
            "description":"Enumeration of none/text/radio/checkbox/textarea/waitingpage"
        },
        "selected":{
            "type":"boolean",
            "description":"if this particular prompt is selected."
        },
        "name":{
            "type":"string",
            "description":"friendly name of the device or the prompt."
        },
        "verified":{
            "type":"boolean",
            "description":"if the prompt is verified"
        },
        "validated":{
            "type":"boolean",
            "description":"if the prompt is validated"
        }
    },
    "description":"Prompt the can be displayed to end user"
}

ネストされたスキーマ: KeyValPair

型: object

一般的に使用できるキーと値のペア。

ソースの表示

• key(required): string
  関連値のフェッチに使用できるキー。
• value(required): object value
  関連付けられた値。

{
    "required":[
        "key",
        "value"
    ],
    "type":"object",
    "properties":{
        "key":{
            "type":"string",
            "description":"Key that can be used to fetch the related value."
        },
        "value":{
            "type":"object",
            "description":"associated value."
        }
    },
    "description":"Key-value pair which can be used generically."
}

ネストされたスキーマ: value

型: object

関連付けられた値。

400レスポンス

パラメータの検証のために更新認証に失敗した場合。

本文()

ルート・スキーマ: AuthnAPIResponse

型: object

ソースの表示

• responseCode: string
• responseMessage: string

{
    "type":"object",
    "properties":{
        "responseCode":{
            "type":"string"
        },
        "responseMessage":{
            "type":"string"
        }
    }
}

先頭に戻る