By default eduTEAMS DSX Discovery Service lists all eduGAIN IdPs for user to select from, which is a list of several thousand IdPs. Showing all IdPs often is not desirable. The eduTEAMS DSX Discovery Service allows to filter out IdPs so that only the relevant IdPs are shown in the list. This allows an SP admin to create a list (or several lists) specifically targeting the user base of his SP. If for nothing else, the filtering should be used to hide IdPs not meant to be shown for 'normal' end user i.e. IdPs having entity category http://refeds.org/category/hide-from-discovery.
Creating the filter using the
...
DSX DS Filter Generator
The filter is generated using eduTEAMS DS DSX Filter Generator.
| Info | ||||
|---|---|---|---|---|
| ||||
https://discoverydsx.eduteamsedugain.org/filter |
The filter generator can create two types of filters, you may filter entities based on their SAML entity categories or based on IdP entityID values.
...
| Expand | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
This example shows how to list all IdPs not tagged as hidden. This is the main use case to setup list of all eduGAIN IdPs. Navigate to filter generator on https://discoverydsx.eduteamsedugain.org/filter Click open the 'select entity categories' - accordion. You should now see all the possible entity categories to choose from in a grey box.
Move http://refeds.org/category/hide-from-discovery to red box.  At the bottom of the page you should see the resulting filter and its plaintext version.
|
...
| Expand | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
This example shows how to list only IdPs tagged with Research and Scholarship entity category. Navigate to filter generator on https://discoverydsx.eduteamsedugain.org/filter Click open the 'select entity categories' - accordion. You should now see all the possible entity categories to choose from in a grey box.
Move http://refeds.org/category/research-and-scholarship to green box. Move also http://id.incommon.org/category/research-and-scholarship.  At the bottom of the page you should see the resulting filter and its plaintext version. 
|
...
| Expand | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
This example shows how to list a specific set of IdPs. Navigate to filter generator on https://discoverydsx.eduteamsedugain.org/filter. Click open the 'select individual IdPs' - accordion. You should now see all the possible IdPs to select from.
Make sure that the radio - button 'Selected IdPs will be visible' is checked. Select the entities you want the user to pick the IdP from.  At the bottom of the page you should see the resulting filter and its plaintext version. Note that by picking individual IdPs you will easily end up with a large filter and you need to set it by reference.
|
...
| Expand | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
This example shows how to list all IdPs tagged with Research and Scholarship entity category and a specific set of IdPs. Navigate to filter generator, https://discoverydsx.eduteamsedugain.org/filter. Click open the 'select entity categories' - accordion. You should now see all the possible entity categories to choose from in a grey box.  Move http://refeds.org/category/research-and-scholarship to green box. Move also http://id.incommon.org/category/research-and-scholarship.  Click open the 'select individual IdPs' - accordion. You should now see all the possible IdPs to select from.  Make sure that the radio - button 'Selected IdPs will be visible' is checked. Select the "Aalto" entity (not belonging to mentioned categories at the time of the writing).  At the bottom of the page you should see the resulting filter and it's plaintext version.
|
...
Filter by value - filter
| Code Block |
|---|
https://discoverydsx.eduteamsedugain.org/wayf.php?filter=eyJhbGxvd0hvc3RlbCI6dHJ1ZSwiYWxsb3dIb3N0ZWxSZWciOnRydWV9Cg== |
...
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
...
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
Filter by reference - efilter
| Code Block |
|---|
https://discoverydsx.eduteamsedugain.org/wayf.php?efilter=www.example.com/filter |
...
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
...
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
...