...
The purpose of the eduGAIN Connectivity Check is to identify eduGAIN Identity Providers (IdP) that are not properly configured. In particular, it checks if an IdP properly loads and consumes SAML2 metadata which contains the eduGAIN Service Providers (SP). The check results are published on the public eduGAIN Connectivity Check web page (https://technical-test.edugain.org/eccs/). The main purpose is to increase the service overall quality and user experience of the eduGAIN interfederation service by making federation and Identity Provider operators aware of configuration problems.
...
The eduGAIN Connectivity Check Service web page is available at https://technical-test.edugain.org/eccs
User interface parameters
Parameter name | Parameter description | Example |
---|---|---|
date | Show all the service results for a specific date | date=2020-02-20 |
reg_auth | Show all the service results for a specific Registration Authority | reg_auth=https://reg.auth.example.org |
idp | Show all the service results for a specific Identity Provider | idp=https://idp.example.org/idp/shibboleth |
status | Show all the service results for a specific Status:
| status=ERROR |
check_result | Show all the service results for a specific result of check:
| check_result=SSL-Error |
Example:
- https://technical-test.edugain.org/eccs?reg_auth=http://www.idem.garr.it/&status=ERROR
- https://technical-test.edugain.org/eccs?reg_auth=http://www.idem.garr.it/&check_result=SSL-Error
API interface
The eduGAIN Connectivity Check has an API interface that provides access to the monitoring results in JSON format.
The table below describes the actions that can be performed by replacing "##ACTION##" in the URL:
https://technical-test.edugain.org/eccs/api/##ACTION##
...
The table below, instead, describes the JSON parameters that actions can use:
https://technical-test.edugain.org/eccs/api/##ACTION##?##PARAMETER##=<value>
Action Name (JSON) | Parameter Name (JSON) | Parameter Description | Example |
---|---|---|---|
| date | Returns all the service results for a specific date. | date=2020-02-20 |
| reg_auth | Returns all the service results for a specific Registration Authority. | reg_auth=https://reg.auth.example.org |
| idp | Returns the service results for a specific IdP by its entityID. | idp=https://idp.example.org/idp/shibboleth |
| status | Returns all the service results for a specific Status:
| status=ERROR |
| check_result | Returns all the service results for a specific result of check:
| check_result=SSL-Error |
| format | Formats the service results in a simple way | format=simple |
Example URL:
- https://technical-test.edugain.org/eccs/api/eccsresults?reg_auth=http://www.idem.garr.it/&status=ERROR&format=simple
- https://technical-test.edugain.org/eccs/api/eccsresults?reg_auth=http://www.idem.garr.it/&status=ERROR
- https://technical-test.edugain.org/eccs/api/fedstats?reg_auth=http://www.idem.garr.it/
- https://technical-test.edugain.org/eccs/api/fedstats?reg_auth=http://www.idem.garr.it/&check_result=SSL-Error
GIT repository
https://gitlab.geant.org/edugain/eccs
...