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.

  • Release
3
  • 4.
0.0 was deployed to the production platform on Wednesday 25th August 2021. Release notes are here: SVS 3.0.0

Release 2.8.0 was deployed to the production platform on Monday 28th June 2021.

Release notes are included here: SVS 2.8.0 and have been circulated via the inacademia-service-information email distribution list to all licensees.

Release 2.7.0 was released to the production environment on 25th February 2021. No service outage was required. . The release delivered further enhancements to error handling, this time around unsupported claims or claims requested using unsupported formats, as well as other minor changes to internal logging.

Release 2.6.0 was deployed to production on 14th December 2020.

Please note: Release 2.5.0 deploys enhancements to the error flow, and was released to the production environment on 30th November 2020. No service outage was required. Clients planning to take advantage of the idp_hint assertion feature in production who haven’t already expressed this preference, please email a request to info@inacademia.org.. 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, and to follow in version 2.6.0. It is strongly recommended that workflows are updated to respond to these errors.

Table of Contents
High Level Functional flow

...

  • 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
Detailed functional flow

In the following diagram, light blue represents the merchant web shop, grey blue is InAcademia functionality. 

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 are out of scope and control for InAcademia and will always yield an 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
macroId60d60dd858e99b56-89eb11a5-4b004bc2-ab08b5ba-ac0fe5f54b4fd55540ae6e12
namedisplayNameInAcademia Entry Flow v3.0.0 - PUBLIC
pagePin1

Response Flow v3.1.0

Gliffy Diagram
macroIdb41750df-03b4-4e6f-bf14-187ac53370f0
displayNameInAcademia Response Flow 3.1.3.3.0 - PUBLIC
nameInAcademia Response Entry Flow 3.13.0 - PUBLIC
pagePin3

Archived versions

Response Flow

...

Gliffy Diagram
macroIdd6360e64-8631-4cd7-b398-50e727b169da
displayNameInAcademia Response Flow v3.0.0 - PUBLIC
nameInAcademia Response Flow v3.0.0 - PUBLIC
pagePin2

Entry Flow with Errors v2.8.0

Gliffy Diagram
displayNameInAcademia Entry Flow v2.8.0 - PUBLIC
nameInAcademia Entry Flow v2.8.0 - PUBLIC
pagePin3

...

v4.6.3

Gliffy Diagram
macroIdc4f0f8e5fdf63335-abff83d9-4c2f4b65-99b79c71-0d06f56ae871493e1e1cdedd
displayNameInAcademia Response Flow v24.84.0 - PUBLIC
nameInAcademia Response Flow v2.8.0 - PUBLICpagePin 4

...

.0

...

Gliffy Diagram
displayNameInAcademia Entry Flow 2.7.0 - PUBLIC
nameInAcademia Entry Flow As-Built V3
pagePin6

Response Flow for release 2.7.0 (including updates from 2.5.0 & 2.6.0)

pagePin3
Gliffy Diagram
macroIda217b297-46d3-4bec-9e13-0ec82b63c181
displayNameInAcademia Response Flow 2.6.0 - PUBLIC
nameInAcademia Response Flow 2.6.0 - PUBLIC
pagePin2