Versions Compared

Old Version 7

changes.mady.by.user Marco Malavolti

Saved on

compared with

New Version 8

changes.mady.by.user Marco Malavolti

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. eduGAIN Connectivity Check 2
  2. Check performed on the IdPs
  3. eduGAIN Connectivity Check 2
  4. Disable Checks
  5. On-line interface
  6. JSON interface

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/eccs2/). 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 tool uses following status for IdPs:

StatusColorDescription
ERRORRed
  • The IdP's response contains an HTTP Error or the web page returned does not look like a login page. The most probable causes for this error are HTTP errors (e.g.: 404 error)
  • The IdP most likely does not consume the eduGAIN metadata correctly or it hasn't returned a web page that looks like a login form.
    A typical case that falls into this category is when an IdP returns a message "No return endpoint available for relying party" or "No metadata found for relying party".
  • The IdP has a problem with its SSL certificate.
OKGreen
  • The IdP most likely correctly consumes eduGAIN metadata and returns a valid login page. This is no guarantee that login on this IdP works for all eduGAIN services but if the check is passed for an IdP, this is probable.
DISABLEDWhite
  • The IdP is excluded because it cannot be checked reliably. The "Page Source" column, when an entity is disabled, shows the reason of the disabling.

JSON interface

The eduGAIN Connectivity Check service provides also a JSON feed on the monitoring results.


The table below describes the actions that can be performed by replacing "##ACTION##" in the URL:

https://technical-test.edugain.org/eccs2/api/##ACTION##

Action Name (JSON)Action Description
eccsresults
Returns all the eduGAIN Connectivity Check 2 service results
fedstats

Returns all the federation statistics collected by the eduGAIN Connectivity Check 2 service.

This action can use only the additional "reg_auth" parameter explained below.


The table below, instead, describes the JSON parameters that actions can use:

https://technical-test.edugain.org/eccs2/api/##ACTION##?##PARAMETER##=<value>

Parameter Name (JSON)Parameter DescriptionExample
date
Returns all the eduGAIN Connectivity Check service results for a specific date.
date=2020-02-20
idp
Return the eduGAIN Connectivity Check service result for a specific IdP by its entityID.
idp=https://idp.example.org/idp/shibboleth
status

Returns all the eduGAIN Connectivity Check service results for a specific Status:

  • OK
  • ERROR
  • DISABLED
status=ERROR
reg_authReturns all the eduGAIN Connectivity Check service results for a specific Registration Authority.
reg_auth=https://reg.auth.example.org


Example URL: