Global Metadata Import Process
The global eduGAIN metadata import process is built on top of two independent operations:
Phase 1 Import Operation:
GET the eduGAIN aggregate from the eduGAIN MDS server, verify its signature, and validate the
validUntildate. If successful, continue with step 2; otherwise FAIL this Import Operation with notifications.
Write the aggregate to a pre-specified file location.
Phase 2 Aggregate Operation:
Read the eduGAIN aggregate from the file system, verify its signature, and validate the
validUntildate. If successful, continue with step 2; otherwise FAIL this Aggregate Operation.
Combine the entities registered by InCommon with the entities imported from eduGAIN.
Sign and publish the combined aggregate.
- Publish reports including 1) a diff between two consecutive combined aggregates and 2) the entities filtered from the eduGAIN aggregate.
A controller script executes the Import Operation in a cron job every 30 mins beginning at 9:00 am ET and ending at 2:30 pm ET. The Aggregate Operation is manually executed once at approximately 3:00 pm ET. This results in a comprehensive metadata signing process that spans multiple hours of the day:
|9:00||Import or FAIL|
|9:30||Import or FAIL|
|10:00||Import or FAIL|
|10:30||Import or FAIL|
|11:00||Import or FAIL|
|11:30||Import or FAIL|
|12:00||Import or FAIL|
|12:30||Import or FAIL|
|1:00||Import or FAIL|
|1:30||Import or FAIL|
|2:00||Import or FAIL|
|2:30||Import or FAIL|
|3:00||Aggregate, sign, and report|
On a typical day, every Import Operation will succeed (even though only one successful Import Operation is required). If a particular Import Operation fails, that failure will be reported and staff will be alerted, but in any case, the sequence of Import Operations will continue unabated until the Aggregate Operation is finally performed at approximately 3:00 ET. In this way, we keep our finger on the pulse of eduGAIN metadata distribution and ensure (with high probability) that the Aggregate Operation has access to a fresh local copy of the eduGAIN aggregate at the designated time.