Test Configuration API

Endpoint is /sso/ttapi/2.0/cfg/0/authn

Request
Parameters Type Value Description
Authorization Custom-Header Bearer request must include the authorization token retrieved before
plan JSON plan configuration optional, in case a preconfigured plan should be used. If no plan is sent a full plan configuration will be assumed.

Table 4

Sample request:

POST https://idp.ssocircle.com/sso/ttapi/2.0/cfg/0/authn
Host: idp.ssocircle.com
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:28.0) Gecko/20100101 Firefox/28.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-US,en;q=0.5
Accept-Encoding: gzip, deflate
Authorization: Bearer nN42C7bQnqzeTZi11fhPWd6cUwOwA17uq+ol5OyIT2o7888xiIMi3udG61j+3PfrUpmOe2adK+5
Ql3L1oK056w==
Content-Type: application/json; charset=UTF-8
Content-Length: 286

{"plan":"tT1f8035b66a62ca80d4e61326ad8a8386cd28922df3ccd5d1af2979caf249666204c8449fdcdc14dfffbace
28653bd76ad8deb288b451882a9a289c0d195cfab7dd917988888c63bf5c18c5ad8fd914266e33f282e423e317e1d1434
8904ee0d463a24bfd3b3ed52816aafc96a46db8e1c"}

Response
Parameters Type Value Description
plan JSON plan string The plan that is used for the test.
step1 JSON integer Initial step that should be called (starting point)
HTTP Return Codes
200 request successful
400 error as specified in the error description
402 API access limit exceeded
403 Not authorized

Table 5

Sample response:

200 OK
Server: “SSOCircle Web Server”
Date: Thu, 03 Apr 2014 12:50:34 GMT
Content-Length: 248
Content-Type: application/json;charset=UTF-8
Set-Cookie: SSOCTT=tT1624e223aa614b807695faca38fa8feea80ffe0fd215820bdf1100f2350ab224bf4bcc98d2a
2f5208d3598c9b904545c70d17081df0ca3b321401fb91fb2d67fc8df6c52897194b19082bf28cb8ef0f5ef2f692d38f
49e9809d69748dcf611b1ddfc6bde8880f3c4633ba21b5ec37f0de; Path=/


{"plan":"tT1ceb7188ff6ca6c444b09225000e7c446871b018f26f6f7347d28f7612f554611b541d8184e26b4bf115332c4
a969f9a2d82f6d26ac127d7f4f991786d0d8888b02d66898941c018883a0e488be811198","step1":1}

Please note: for browser use the plan is always responded as a cookie. In the next sample this is omitted as it is not
relevant to the API itself.

Getting a preconfigured test plan string
If you would like to define your own sequence of tests, a customized test plan is needed and must be submitted in the configuration request above. The test plan string is encoded and can only be constructed through the Plan Configuration page:
For use with the public IDP:
https://idp.ssocircle.com/sso/hos/PlanConfig.jsp

In case of IDPee usage, replace your IDPee name in the following URL:
https://<youridpeename>.idpee.com/sso/hosbx/PlanConfig.jsp

You can configure the tests you need manually and then submit the page. You will get the plan string as a response header.
e.g.
X-ttool-plan: tT19f5916eccf1e154edef8a07e93c7ad96eb2cc08063bea46833e1161cbac57d77fee46e04436fa950a24a3b0e94fc37c34bf1425dfacd37b0403ee97c27b84d6f8a3e3dd6a79c33d4f8ec77088888cb2da85fb5a70c6f267c67ddcf16b5b5eaa33f89b3129089b3273f09506d8a688b543e61e6037d1a9d04b53fc90458f6b6b0c927fb8939adff328628f06cd2cc127b

latest technology

SSO Check your Partners

Test your SAML Service Provider for configuration and implementation errors.

Use our verification service on an ongoing bases and get the SSOChecked Seal.

Single password

Hosted Identity Provider

Use our free public IDP or the white label IDPee for your organization or corporate.

Be sure to get a quote if you are interested in getting one of our products.

write a mail

Contact Us

Interested in our services?

Contact us by sending a mail to info[at]ssocircle[dot]net, or by using our contact form.