Getting started (applicant)
Start by clicking the name of one of the offered claims (grey boxes within red ones) within Undeclared Attestations. Click "start" and provide the data requested (e.g. fill the form, follow the QR link or log in with an identity provider). Upon successful completion, this will result in an addition to Presented Claims. Once these are approved by the Registration Authority (RA), they will be moved to Approved Claims and a corresponding Received Attestation will be produced. To see details, retract or start a claim, click on the claim or attestation title. To return, click on "home". More at GÉANT Wiki.
Getting started (RA)
The RA (registration authority) is responsible for approving claims that have been presented by applicants.
Start by clicking the name of one of the Unapproved Claims (yellow boxes), tick if the applicant is present in person, and click "approve" to confirm the claim. To disapprove, click on the title of one of the green claims that you approved (Claims approved by ...) and click on"disapprove". More at GÉANT Wiki.
Glossary
... for developers is provided here
Step by step example
Available claims and attestations, as well as their names, sources and contacts, depend on the configuration of the system. Here provided is a walkthrough for an example that was set up in line with Remote vetting of the guest participant for access to a high Level of Assurance (LoA) project scenario:
Bob, an external researcher on the new Climate balance restoration project requires access to the restricted Massive Climate Archives Service (MCAS) to complete his thesis. The policy of this service is to demand strong identity vetting and multi-factor authentication, but also to check whether the users are genuine academic researchers.
Bob logs into the vetting portal https://app.incubator.geant.org/ with his identity student1/student1.
He proves his identity using his passport by clicking at Undeclared Attestations > ID document > ReadID and following on-screen instructions (do we need a link to the ReadID app ib stores along with the QR?) Yes, for the case when Bob does not have the app on his phone we should. We should include a link. Following the instructions, he scans the presented QR code and downloads an application onto his mobile device (in the event he already has the application, from a previous session (say) he can skip the downloading step). He opens the application and is instructed to use it to scan his passport (PassportProof) and receives confirmation that ‘vetting is in process’.
Bob also provides his ORCID ID (ORCIDProof) and confirms his name and email with a login to ORCID, which also confirms the possession of his ORCID credentials.
Later that day Alice, who is the vetting portal credential manager (RA), receives a notification that a new applicant request is pending. She opens the admin portal https://ra.incubator.geant.org/ with her staff1/staff1 credentials and searches for the applicant.
She makes contact with Bob using a video chat app and the picture from Unapproved Claims > ReadID (for data protection, the photo from Bob's password is not retrieved from ReadID), verifies that the picture from his identity document does correspond with the living Bob (FaceMatch), checks if the document is valid, and confirms the claim by clicking on "approve" (CheckRef). At that time she could also request Bob to provide a TOTP password. Since access to stored climate documents is subject to very strict checks (to prevent rogue history revisionists) she checks Bob’s ORCID ID (ORCIDProof) using Unapproved Claims > ORCID by following the link to the ORCID page on Bob. She confirms that he has a convincing academic record in the field, in line with the MCAS Admittance Policy, by clicking on "approve" and attests that Bob’s data is correct within the admin portal and that he meets admittance criteria (CheckRef). With this confirmation, Alice has created a "Library Access" attestation.
The IdP used by the MCAS portal can confirm Bob's identity and that he is entitled to access the MCAS by invoking the JSON API https://app.incubator.geant.org/rest.php?id=<USER ID>, e.g. https://app.incubator.geant.org/rest.php?id=1.