Index
- 148092135eduGAIN Connectivity Check 2#Introduction
- Check performed on the IdPs
- Statuses and results
- Common reasons for check failure
- 148092135eduGAIN Connectivity Check 2#Limits
- Disable Checks
- User interface
- JSON interface
- GIT repository148092135
- eduGAIN Connectivity Check 2#Presentations
Introduction
The purpose of the eduGAIN Connectivity Check 2 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 2 web page (https://technical-test.edugain.org/eccs2eccs/). 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 2 test Service web page is available at https://technical-test.edugain.org/eccs2eccs
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/eccs2eccs?reg_auth=http://www.idem.garr.it/&status=ERROR
- https://technical-test.edugain.org/eccs2eccs?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.
...
https://technical-test.edugain.org/eccs2eccs/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/eccs2eccs/api/eccsresults?reg_auth=http://www.idem.garr.it/&status=ERROR&format=simple
- https://technical-test.edugain.org/eccs2eccs/api/eccsresults?reg_auth=http://www.idem.garr.it/&status=ERROR
- https://technical-test.edugain.org/eccs2eccs/api/fedstats?reg_auth=http://www.idem.garr.it/
- https://technical-test.edugain.org/eccs2eccs/api/fedstats?reg_auth=http://www.idem.garr.it/&check_result=SSL-Error
GIT repository
https://gitlab.geant.org/marco.malavoltiedugain/eccs2eccs
Presentations
...