Skip to content

Commit

Permalink
Update Auth section
Browse files Browse the repository at this point in the history
  • Loading branch information
m-mohr committed Oct 14, 2021
1 parent 0baf1d4 commit f7a8114
Showing 1 changed file with 15 additions and 10 deletions.
25 changes: 15 additions & 10 deletions authentication/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,27 +4,29 @@ To log in to the openEO platform or related services,
you usually do not need to pick a username and invent a new password.
Instead, we rely on the authentication service [EGI check-in](https://www.egi.eu/services/check-in/),
provided by the [EGI Foundation](https://egi.eu).
It allows you to login through an existing account from either your institution,
It allows you to login through an **existing account** from either your institution,
or other commonly used services such as Google, GitHub, Facebook or LinkedIn.

::: tip Some background on Security & Privacy
This procedure has important advantages for our users:

- Neither openEO platform nor the EGI Foundation see, handle or store your password.
That information is only exchanged directly with your institution or the service selected,
That information is only exchanged directly with your institution or the selected service,
to minimize the risk of leaking sensitive credentials.
- openEO platform only retains minimal information about its users,
such as an email address and a few more general attributes.
- No need to set up and remember yet another username and password.
:::

## Connect an existing account

The first step is to connect your existing account with EGI check-in.
If you already have done this in the past, you can directly skip this step and
If you already have done this in the past, you can skip this step and
continue with [joining openEO Platform](#join-openeo-platform).

Otherwise, please go to <https://aai.egi.eu/signup> and select '*SIGN UP*'.
In the next step, select the institution (recommended) or service you want to login with in the future.
Otherwise, please go to <https://aai.egi.eu/signup> to become member of the *EGI User community*.
Please select the institution (recommended) or service you want to login with in the future
and follow the login procedure.

::: warning Recommendation
We recommend to use your institutional account whenever possible.
Expand All @@ -34,6 +36,9 @@ support EGI check-in through EduGain. For any question ragrding this procedure,
please contact `support <at> egi.eu`.
:::

If you didn't see the list of institutions, you are likely already logged in.
In this case you can simply select *'SIGN UP'*.

Afterward, you will have to complete a small registration procedure to connect your account.
You may have to fill any missing personal information: *Name*, *Email*, *Affiliation* and/or *Organisation*.

Expand All @@ -57,8 +62,8 @@ You may be asked to log in again with the account you have previously connected
The instructions below are available in English, but may be localized to your preferred language.
:::

Once you are logged in, a registration form with the title '*Join openEO Platform*' will show up,
which you can start by clicking '*BEGIN*'.
Once you are logged in, a registration form with the title *'Join openEO Platform'* will show up,
which you can start by clicking *'BEGIN'*.

<figure>
<img src="./join1.png" alt="Join openEO Platform - Step 1">
Expand All @@ -69,7 +74,7 @@ In the next step, you will only be required to fill in two fields:
- *Justification for this access request*: Please provide your brief motivation in this field (1).
- *Agree to Acceptable Use Policy and Conditions of Use (AUP)*: You will need to read (2) and accept (3) the AUP.

You can finalize the registration form by clicking '*SUBMIT*' (4).
You can finalize the registration form by clicking *'SUBMIT'* (4).

<figure>
<img src="./join2.png" alt="Join openEO Platform - Step 2">
Expand All @@ -88,7 +93,7 @@ please [contact us](https://openeo.cloud/contact/).
Due to the federated nature of openEO Platform, you may still need to also register
with the individual service provider.
This depends on which [data sets](../data-collections/index.md) and [processes](../processes/index.md) you need to use.
If you plan to use any [data set](../data-collections/index.md) that is '*provided by Terrascope*' or '*provided by SentinelHub*',
If you plan to use any [data set](../data-collections/index.md) that is *'provided by Terrascope'* or *'provided by SentinelHub'*,
you need to follow the steps below to setup a *Terrascope account*.
This allows to get optimal access to the processing resources of Terrascope,
but it is only required temporarily and this requirement will go away in the future.
Expand All @@ -102,7 +107,7 @@ which should happen automatically (based on a common email address) if you follo
:::

Go to the [Terrascope portal](https://terrascope.be) to set up the Terrascope account,
click the '*sign in*' menu item at the top, and pick the '*EduGAIN and social logins*' to log in.
click the '*sign in*' menu item at the top, and pick the *'EduGAIN and social logins'* to log in.
After a one time registration process you should have access to all Terrascope services
using your institution or social media credentials.

Expand Down

0 comments on commit f7a8114

Please sign in to comment.