Versions Compared

Key

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

This page describes the functional flow and is provided to assist the design of merchant workflows in implementing the InAcademia academic validation service.

...

ANNOUNCEMENT 27.10.2020: 

Release 2.5.0 deploys enhancements to the error flow. Please refer to errors 9, 10 and 11 in the diagrams below. For the purposes of comparison, documentation is provided for the error flow as built in version 2.4.0 as well as the enhancements built in version 2.5.0. It is strongly recommended that workflows are updated to respond to these errors.

  • Release 4.6.3 (see SVS 4.6.3) introducing support for SATOSA 8.5.1 and pysaml2 7.5.2, deployed to production 17th March 2025

Table of Contents

High Level Functional flow

Image Removed

Detailed functional flow

In the following diagram, light blue represents the merchant web shop, grey blue is InAcademia functionality. Institutional Identity Provider is represented in Green. 

The figure presents the 'happy' flow, ending in a successful validation, as displayed in green, as well the possible error scenarios represented in red or orange. The error situation where a institutional IdP, or the merchant redirect URL component cannot be reached because of network issues or similar is not take into account as that is out are out of scope and control for InAcademia and will always yield an some error in the users browser. The InAcademia service is part of a continuing development programme and additional features planned for the future are also captured below.

Entry Flow with Errors v4.6.3

Gliffy Diagram
macroId58e99b56-11a5-4bc2-b5ba-d55540ae6e12
displayNameInAcademia Entry Flow (As-Built V3) - 3.3.0 - PUBLIC
nameInAcademia Entry Flow (As-Built V3) - PUBLIC
pagePin4

Response Flow for all versions up to and including 2.4.0 (provided to assist the migration of merchant workflows interacting with 2.4.0 to 2.5.0):

Gliffy Diagram
displayNameInAcademia Response Flow (V3) - PUBLIC
nameInAcademia Response Flow (V3) Copy
pagePin5

...

3.3.0 - PUBLIC
pagePin3

Response Flow v4.6.3

Gliffy Diagram
macroId4c9e47d3fdf63335-ed4f83d9-4a874b65-b8479c71-a87644102ffc493e1e1cdedd
displayNameInAcademia Response Flow Release 24.54.0 v2 - PUBLIC
nameInAcademia Response Flow Release 24.50.0 v2 - PUBLIC
pagePin23