Files
api-specs/idn/beta/paths/mfa-kba-config.yaml
GitHub Action Bot 2019acc760 Automated commit 'Merge pull request #1647 from sailpoint/saurabh/ISCARP-13782
ISCARP-13782 / Add documentation for CC challenge APIs replacements in MFA' by github action: 8742380269
2024-04-18 17:42:20 +00:00

57 lines
1.8 KiB
YAML

get:
operationId: getMFAKbaConfig
tags:
- MFA Configuration
summary: Configuration of KBA MFA method
description: >-
This API returns the KBA configuration for MFA.
A token with USER or ORG_ADMIN authority is required to call this API.
parameters:
- in: query
name: allLanguages
required: false
schema:
type: boolean
description: >-
Indicator whether the question text should be returned in all configured languages
* If true, the question text is returned in all languages that it is configured in.
* If false, the question text is returned in the user locale if available, else for the default locale.
* If not passed, it behaves the same way as passing this parameter as false
example: allLanguages=true
security:
- UserContextAuth: [idn:mfa-kba:read]
responses:
"200":
description: The configuration for KBA MFA method.
content:
application/json:
schema:
type: array
items:
$ref: "../schemas/KbaQuestion.yaml"
example:
[
{
"id": "143cfd3b-c23f-426b-ae5f-d3db06fa5919",
"text": "MFA new question -1 ?",
"hasAnswer": false,
"numAnswers": 0
},
{
"id": "173421",
"text": "What is your alphanumeric PIN?",
"hasAnswer": false,
"numAnswers": 3
}
]
"400":
$ref: "../../v3/responses/400.yaml"
"401":
$ref: "../../v3/responses/401.yaml"
"403":
$ref: "../../v3/responses/403.yaml"
"429":
$ref: "../../v3/responses/429.yaml"
"500":
$ref: "../../v3/responses/500.yaml"