Discovery API can be used to fetch information in JSON format about a specific agent application and a template, such as available authentication methods. This information is usable, for example, when the initial login menu screen showing all the available authentication methods is being built externally.
...
methods → List of authentication methods in the group.
...
Example of Discovery API message for request:
https://idp.example.com:8443/uas/discovery?entityID=urn%3Auuid%3A2aca7e7e-7a00-4149-8126-65536cdfcb7d&template=default&locale=en
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"idp": "https://idp.example.com:8443/sso-ui",
"sp": "urn:uuid:2aca7e7e-7a00-4149-8126-65536cdfcb7d",
"template": {
"name": "template5",
"defaultLocale": "fi",
"locales": [
"fi",
"en",
"sv"
],
"localeNames": {
"fi": "Suomeksi",
"sv": "På Svenska",
"en": "In English"
}
},
"locale": "en",
"settings": {
"showlogin": false,
"showmenustepup": true,
"usemethodlogoimages": true,
"usemethodtextlink": true,
"usemethodgroups": true
},
"methods": {
"password.1": {
"title": "Password One",
"type": "password"
},
"otp.1": {
"title": "OTP One",
"type": "stepup",
"password": "password.1",
"stepUp": "otp"
},
"sms.1": {
"title": "SMS OTP One",
"type": "stepup",
"password": "password.1",
"stepUp": "sms"
},
"mpki.1": {
"title": "MPKI One",
"type": "stepup",
"password": "password.1",
"stepUp": "mpki"
},
"password.2": {
"title": "Password Two",
"type": "password"
},
"otp.2": {
"title": "OTP Two",
"type": "stepup",
"password": "password.2",
"stepUp": "otp"
},
"proxy.1": {
"title": "Proxy One",
"type": "proxy"
},
"proxy.2": {
"title": "Proxy Two",
"type": "proxy"
},
"proxy.4": {
"title": "Proxy Directory",
"type": "proxy"
},
"tupas.nordea.1": {
"title": "Nordea",
"type": "proxy"
},
"tupas.danske.1": {
"title": "Danske",
"type": "proxy"
},
"tupas.op.1": {
"title": "OP",
"type": "proxy"
},
"mpki.2": {
"title": "MPKI Two",
"type": "unregistered",
"unregistered": "mpki"
},
"active.1": {
"title": "WAYF",
"type": "discovery"
}
},
"groups": [
{
"title": "Pankit",
"methods": [
"tupas.op.1",
"tupas.danske.1",
"password.1"
]
},
{
"title": "Testi",
"methods": [
"tupas.nordea.1"
]
},
{
"title": "Muut",
"methods": [
"otp.1",
"sms.1",
"mpki.1",
"password.2",
"otp.2",
"proxy.1",
"proxy.2",
"proxy.4",
"mpki.2",
"active.1"
]
}
]
} |
...