Step 1: Authentication Request with AppName
GET {{HOST}}/sso/v1/sdk/authenticate?appName={{app_name}}
The user tries to access an application that is associated with TOU. This is a GET request that provides the AppName being accessed. The IDCS server uses this application name to fetch the policy that is assigned to this application. Based on the tenant settings, the server gets the IDP and authentication policy that is associated with this app and then guides the user on the next step..
For the Next Step:
The client must pass the credentials, which are the username and password
The client must pass the requestState that was received in the Step 1 response (this step).
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
appName | string |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Authorization | string |
RESPONSES
status: OK
{"status":"success","ecId":"5fR1O171000000000","nextOp":["credSubmit"],"nextAuthFactors":["USERNAME_PASSWORD"],"USERNAME_PASSWORD":{"credentials":["username","password"]},"requestState":"BC4LO/oKGHPryRorgFZAIZ59Lcvz0+wlqpABFz4eKe3ebTkzwpjqzYecBu+20SRxPvKsQpsgsHofPw5P6H8tPfb7XdQzPx8ThechzZ3Dx4dW+yEKejTuT8S22c/4N83k35Dzxlgt1tUSHgt0tWU+l63q3UEALkH1Zb6QCfND0Ut84qhNuOJOcj0FO0+pOb6q9clO5duJ2QRnXh67Y3Yw5qC45zaGYW83LZKzjUDah8MF9WVLo4saUX7TJeFJFJMzTF+qLuPn+Fci0Iwnoh82kYWs86sHIMaUROCCIFO2xt2xa9rSxuKn+VyR6RL6UieiS1DXAYVhWjJtwL7FrM6EysuK7AvU2U0MiwyNjuqF1luFqSWcpje/R8+sausYIwXciBsyomWCHP5OAySbv74fhvDpL69TWMwyaTI3s3Rq9DpEIb4gJKVdTBM+0ApgZbmEeAVyTQrXWikvZ9C3DrYDrarHgm83xXT6ma3fnF41jNGON6m6NHA8rWFU4uliUorfezMTUqLCy2p6dPbktLRy0zuK4IhAnTuB5apXGjPAh5K1XzrbdTufBGeYNbPuYTmnCTHUKtDmd1DSYaqmAmLHhlDKNnLc0+FKiwbs384CeRV26QXRY1kiF/JGMuXzUtRSVoFBdy2r9mUutn0KWJkOoZmSvhLr7/gCOenjLXvX1SHZJBcR14g08CbtRkOYXha9biop1eaoW9rhOaWdhu9ii6stCqlwGyGIzBI1L6eJn8dzUyybxYtPBT6yilP7RTyqLO9grg/HKG6nKP4JGAnhZzyYpyuvmFRm7uZI51MvxKHvZWXnckKR1nd0QXQqlWa5DZYA9vaDoWaICmkgynt7X+HXx8bf7ugWW0bWP/p1ibephSwmi0SCez4x00KfcisdlHSmRRkC+nCyo/+m2G8tXGZl5zmosi34MFHJdcZdT5SNwUsMu07PSCiaYwmh/nn/yHgDKg1oH8NPadOEUvCupwDMueh3E/wFbw3BbMg8iL/bX9BByE2J8wdIgAeYDPeo0T8HNb/q5l80ScSoyHiuc0/DIN+vnEAwHKmtXdB2xup5qjv9zMwPdNH0iCZjscmWkIoAn8Ov4ujsm7WqXOnQWZ6xjzVgwbNxx0m6l2HuUIB7Wshx4bsqqltgBgRTrhctRvr9/VXj01Ry8Wpf3vc5bl4rSNjnMCRfcKtauEXJJir3ShUaW1M2P/6rfuTIN+ruErPOrGdftT36ssEUIu7bUMFX7qL5Ows5LSD/9CCgV/O1LhOsM+4HKk6NSLTfimundut/MDNvzKEZQwIRmnQJBiB3V1jS0GF03V/5vWyM9qIeYnM2vJaGRHrwM/U85spA0qpRvlvh9hWks0g7DV2hRMFkSEQDP9rSvKcycTGCXTd57q55/Pd2SBcVkhkKgAAq9Wxd1W4kFu7bSe9/LQXhIjdu9hpVxDIP/z5lzdMBImwmqegpNFqcReFHatEYgfwoLbLm3bskx5w6daganrHE9FTkAwJ5waQqjMAHsTpnDO3yBJb3JC14j+xkBcw19QeVwAFwSA2/M/04EpRD8PyC5YG77acAgHOFeX9MhKEOG4wPbYrYSJ2oo7ta2iKDci/GT1kFeFDtFSkyOBDWVORsTlOzRMSkgT49aa0rBxBaVTJW1rsXKLOElabghUsLr0uZ~WD7TPZD1fhJKavVdwLA3L4A62C8FEmtjUykWhOFZ5ZM"}