diff --git a/.markdownlint.yaml b/.markdownlint.yaml index 02907b2..8ece4c7 100644 --- a/.markdownlint.yaml +++ b/.markdownlint.yaml @@ -1,2 +1,3 @@ --- MD013: false +MD029: false diff --git a/images/registration/1.png b/images/registration/1.png new file mode 100644 index 0000000..44dbf7c Binary files /dev/null and b/images/registration/1.png differ diff --git a/images/registration/2.png b/images/registration/2.png new file mode 100644 index 0000000..8c89bb6 Binary files /dev/null and b/images/registration/2.png differ diff --git a/images/registration/3.png b/images/registration/3.png new file mode 100644 index 0000000..e89051b Binary files /dev/null and b/images/registration/3.png differ diff --git a/images/registration/4.png b/images/registration/4.png new file mode 100644 index 0000000..13aac82 Binary files /dev/null and b/images/registration/4.png differ diff --git a/index.md b/index.md index d7bd090..fd68c7d 100644 --- a/index.md +++ b/index.md @@ -57,5 +57,4 @@ receiver and the custom implementation at the host institution? - How do I connect to MyAcademicID? - The enrollment receiver needs to be connected as a relying party to MyAcademicID. The API server needs to be connected as a Resource Server. - Both can be registered by filling in this - [myacademic id registration form](https://wiki.geant.org/display/SM/Registering+services+on+MyAcademicID) + Both can be registered by [filling in the myacademic id registration form](./registration.md) diff --git a/registration.md b/registration.md new file mode 100644 index 0000000..3d9bc9a --- /dev/null +++ b/registration.md @@ -0,0 +1,41 @@ +# Registration at MyAcademicID + +## Relying Party (RP) + +The Generic part of the Enrollment Receiver handles authentication and OIDC +tokens. It should be registerd at the MyAcademicID Service. + +1. Go to [the registration form](https://webapp.prod.erasmus.eduteams.org/sp_request) +and log in using your institutional account. + +![log in](./images/registration/1.png) + +2. Fill in all the fields under `Requester Details` and `Organization information` +3. Enter the service details. Using the name and logo of your institution. + +![service details](./images/registration/2.png) + +4. Fill in the fields under `Contact information` and +`Service provider policies`. Use [https://eduxchange.eu/privacy](https://eduxchange.eu/privacy) +for the privacy policy. + +![service details](./images/registration/3.png) + +5. Under `Technical Information`, select `Authorization Code Flow` and +`Refresh Token`. Enter the redirect url as the domein name where the enrollment +receiver can be reached, and add `/redirect_uri/`. + +![Technical Information](./images/registration/4.png) + +6. Add a comment in the `Additional information` mentioning this is a euroteq +service. +7. Submit the form. You will receive a confirmation email + +## Resource Server (RS) + +The Protected OpenEducationAPI endpoints are connected as a resource Server +using [the same form](https://webapp.prod.erasmus.eduteams.org/sp_request) and +information. + +Add a comment to the `Additional information` field te indicate this is a +_resource server_, connected to the Euroteq services.