Dokumentation för version 1.0 (nuvarande version)

Om man vill köra en egen instans av edusign.sunet.se krävs en del programvara som levereras som docker-containers:

Detta krävs för att sätta upp en egen instans

Såhär ser en installation av edusign ut:

draw.io Diagram

För att köra en egen instans av samma programvara som edusign.sunet.se kör krävs följande:

Kunna köra docker-containers - programvaran levereras som ett antal docker-images (se ovan)
Konfigurera och sätta upp en instans av docker.sunet.se/upload-sign-app:<version> (dokumentation i README-filen på https://github.com/SUNET/docker-sign-app)
Sätta upp och registrera en SP i Swamid (tex https://edusign.<universitet>.se/) tex genom att köra en instans av docker.sunet.se/shibsp-ajp:latest (baserad på shibboleth)
Koppla SPn (som förslagsvis kör docker.sunet.se/shibsp-ajp:latest eller motsvarande) till en instans av docker.sunet.se/upload-sign-app:<version>
Koppla ihop instansen med signeringsinfrastrukturen. Detta steg kräver en registrering av instansen i en intern behörighetskontrollfunktion - kontakta Sunet för detaljer!

För närvarande är den senaste versionen av upload-sign-app 1.0.5 men kontrollera med dokumentationen för vad som är aktuellt.

Den 29/9 2021 planerar vi att släppa den nya versionen av edusign. Här finner du programvaran vi kommer köra:

Samtidigt med den nya versionen finns ett API tillgängligt som kan användas för att integrera med egna applikationer. Länk till dokumentation nedan.

Om du vill bygga egna docker-images så kontakta Sunet för access till maven-repos osv som krävs för byggprocessen.

Såhär såhär ser en installation av edusign 2.0 ut:

draw.io Diagram

...

Kunna köra docker-containers - programvaran levereras som ett antal docker-images (se ovan)
Konfigurera och sätta upp en instans av docker.sunet.se/upload-sign-app:<version> (dokumentation i README-filen på edusign-sp:<version> samt docker.sunet.se/edusign-app som båda byggs och dokumenteras från detta repo: https://github.com/SUNET/docker-signedusign-app)
Sätta upp och registrera en SP i Swamid (tex https://edusign.<universitet>.se/) tex genom att köra en instans av baserat på docker.sunet.se/shibsp-ajp:latest (baserad på shibboleth)edusign-sp
De två docker-images kopplas ihop enligt dokumentation i Koppla SPn (som förslagsvis kör docker.sunet.se/shibsp-ajp:latest eller motsvarande) till en instans av docker.sunet.se/upload-signedusign-app:<version>
Koppla ihop instansen med signeringsinfrastrukturen och med API-servern. Detta steg kräver en registrering av instansen i en intern behörighetskontrollfunktion - kontakta Sunet för detaljer!

...

Specifikationer för underskriftstjänst finns på Sweden Connect under följande länk https://docs.swedenconnect.se/technical-framework/.
De dokument som är relevanta är:

...

Integration direkt med API:et kräver att en tjänst genomgår en granskning av Sunet i syfte att kontrollera att den uppfyller följande krav:

Identifiering av användare måste ske på ett sätt som är ekvivalent eller bättre än som sker på edusign.sunet.se.
Användare måste tydligt informeras om att en signatur sker på ett sätt som uppfyller krav på informerat medgivande i GDPR.
Tjänsten måste hantera inloggningsuppgifter till API:et på ett sätt som gör att endast den tjänsten har möjlighet att för användarens räkning begära en signatur
Tjänsten måste tillse att endast de signaturer som användaren avser att genomföra kan begäras av signaturtjänst och API:er
Tjänste måste tydligt visa upp resultatet av en signatur för användaren