This page describes the functional flow and is provided to assist the design of merchant workflows in implementing the InAcademia academic validation service.
| COMING SOON! 28.0 is currently available for testing in the customer integration platform. It is scheduled for deploy 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. |
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
|
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 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 |
|---|
| displayName | InAcademia Entry Flow v2.8.0 - PUBLIC |
|---|
| name | InAcademia Entry Flow v2.8.0 - PUBLIC |
|---|
| pagePin | 3 |
|---|
|
Response Flow for release 2.8.0 (including updates from 2.7.0)
| Gliffy Diagram |
|---|
| macroId | c4f0f8e558e99b56-abff11a5-4c2f4bc2-99b7b5ba-0d06f56ae871d55540ae6e12 |
|---|
| displayName | InAcademia Response Entry Flow v23.83.0 - PUBLIC |
|---|
| name | InAcademia Response Flow v2.8.0 - PUBLIC |
|---|
| pagePin | 4 |
|---|
| Entry Flow |
|
...
...
...
| Gliffy Diagram |
|---|
| displayName | InAcademia Entry Flow 2.7.0 - PUBLIC | name | InAcademia Entry Flow As-Built V3 |
|---|
| pagePin | 63 |
|---|
|
Response Flow
...
v4.6.3
| Gliffy Diagram |
|---|
| macroId | a217b297fdf63335-46d383d9-4bec4b65-9e139c71-0ec82b63c181493e1e1cdedd |
|---|
| displayName | InAcademia Response Flow 24.64.0 - PUBLIC |
|---|
| name | InAcademia Response Flow 24.60.0 - PUBLIC |
|---|
| pagePin | 23 |
|---|
|
