Optionen für KBA-Sicherheitsfragen abrufen

Ruft alle aktiven und veralteten KBA-Optionen (Knowledge-Based Authentication) für eine angegebene Instanz von Cloud Identity Service ab.

Anforderung

GET /GmaApi/ss/getKba

cURL-Beispielanforderung

# curl -v -X GET -H "Authorization: Bearer 644d0ac0-908f-485a-ac8d-b5bb99f200d7" https://Hostname/GmaApi/ss/getKba?instanceId=3

Ressourcen-URI

https://Hostname/GmaApi/ss/getKba

Berechtigungsheader

Informationen zum Anfordern eines Zugriffstoken finden Sie unter Zugriffstoken anfordern.

Anforderungsparameter

Tabelle 1. Abfrageparameter
Parameter Typ Erforderlich Beschreibung
instanceId Ganzzahl. Ja Die ID der Instanz, für die Optionen zu KBA-Sicherheitsfragen abgerufen werden sollen.

Beispielantwort

"status":{"success":true,"apiError":false,"message":"Success","errors":{}},"kba":[
]}

Antwortparameter

Tabelle 2. Antwortparameter
Parameter Beschreibung
status Gibt zurück, ob die Anforderung erfolgreich war. Gibt eine Fehlernachricht zurück, wenn die Anforderung nicht erfolgreich war. Weitere Informationen zu Fehlern finden Sie unter Fehler. In einigen Fällen wird result_limit_exceeded zurückgegeben, wenn die Antwortanforderung zu viele Übereinstimmungen für die Anzahl an Ergebnissen findet.
kba Optionen für KBA-Fragen.
uniqueAnswers Gibt an, ob Antworten auf verschiedene Fragen eindeutig sein müssen.
minRequired Die minimale Anzahl an Fragen, die ein Benutzer beantworten muss, um sein Kennwort zurückzusetzen oder seine Identität zu bestätigen.
questions Die Fragen und Sprachen, die für die angegebene Instanz im Gebrauch sind.