@@ -4,13 +4,13 @@ The objective of this repo is to provide guidance on how to enroll in the EMERAL
...
@@ -4,13 +4,13 @@ The objective of this repo is to provide guidance on how to enroll in the EMERAL
In order to enroll a project such as EMERALD, you need to follow the next steps:
In order to enroll a project such as EMERALD, you need to follow the next steps:
*[register in git.code.tecnalia.com with orein.](#register-in-gitcodetecnaliacom-with-orein)
1.[Register in git.code.tecnalia.com with orein.](#register-in-gitcodetecnaliacom-with-orein)
*[login to git.code.tecnalia.com](#login-to-gitcodetecnaliacom)
2.[Login to git.code.tecnalia.com](#login-to-git.code.tecnalia.com)
*[request access to the project responsible](#request-access-to-the-project-responsible)
3.[Request access to the project responsible](#request-access-to-the-project-responsible)
We included a section for [trouble shooting](#trouble-shooting) in case of sign-up or sign-in issues.
We included a section for [trouble shooting](#trouble-shooting) in case of sign-up or sign-in issues.
## Register in git.code.tecnalia.com with orein
## Register in gitcodetecnaliacom with orein
First of all you have to create an account in git.code.tecnalia.com so that you can be added latter to a project. In order to create an account:
First of all you have to create an account in git.code.tecnalia.com so that you can be added latter to a project. In order to create an account:
* Access to Orein
* Access to Orein
...
@@ -23,11 +23,11 @@ First of all you have to create an account in git.code.tecnalia.com so that you
...
@@ -23,11 +23,11 @@ First of all you have to create an account in git.code.tecnalia.com so that you
To log in go to the root url of the gitlab repository [htts://git.code.tecnalia.com/](https://git.code.tecnalia.com/) as an external user or click `Sign in` if you are in another page ( i.e. https://git.code.tecnalia.com/groups/emerald ).
To log in go to the root url of the gitlab repository [htts://git.code.tecnalia.com/](https://git.code.tecnalia.com/) as an external user or click `Sign in` if you are in another page ( i.e. https://git.code.tecnalia.com/groups/emerald ).
Immediately, you are going to be asked to configure the `2FA` two factor authentication. Which is mandatory for all users in git.code.tecnalia.com.
Immediately, you are going to be asked to configure the `2FA` two factor authentication. Which is mandatory for all users in git.code.tecnalia.com.

{width=80%}
Following the instructions you should configure your Authenticator app. In this case we show the process with the [Microsoft Authenticator](https://play.google.com/store/apps/details?id=com.azure.authenticator&hl=es&gl=US) app. But you can use any other app that supports the TOTP protocol such as [Google Authenticator](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=es&gl=US) or [Authy](https://play.google.com/store/apps/details?id=com.authy.authy&hl=es&gl=US).
Following the instructions you should configure your Authenticator app. In this case we show the process with the [Microsoft Authenticator](https://play.google.com/store/apps/details?id=com.azure.authenticator&hl=es&gl=US) app. But you can use any other app that supports the TOTP protocol such as [Google Authenticator](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=es&gl=US) or [Authy](https://play.google.com/store/apps/details?id=com.authy.authy&hl=es&gl=US).
Once validated the 2FA you will be shown the recovery codes.
Once validated the 2FA you will be shown the recovery codes.

{width=80%}
**Important**: **Copy Authentication recovery codes** in a secure place. These are required in case you lost the authenticator. The can be also used to login in case you have forgotten the password and you need to reset it.
**Important**: **Copy Authentication recovery codes** in a secure place. These are required in case you lost the authenticator. The can be also used to login in case you have forgotten the password and you need to reset it.
To login using orein you have to click on the Orein OpenID button and you will be redirected to the Orein login page. There you have to use the first (2) option. The number 2 in the image below.
To login using orein you have to click on the Orein OpenID button and you will be redirected to the Orein login page. There you have to use the first (2) option. The number 2 in the image below.
In this case as described in the `Register a one-time password authenticator`you have to first to `Disable two-factor authentication` (1) and then register again.
In this case as described in the `Register a one-time password authenticator`you have to first to `Disable two-factor authentication` (1) and then register again.

{width=50%}
Following the procedure shown in the [register in git.code.tecnalia.com with orein.](#register-in-gitcodetecnaliacom-with-orein) section. Do not forget to take note of the recovery codes.
Following the procedure shown in the [register in git.code.tecnalia.com with orein.](#register-in-gitcodetecnaliacom-with-orein) section. Do not forget to take note of the recovery codes.

{width=50%}
### Lost of the recovery codes
### Lost of the recovery codes
In case you have lost the recovery codes you can recover them from the the [2FA configuration](https://git.code.tecnalia.com/-/profile/two_factor_auth).
In case you have lost the recovery codes you can recover them from the the [2FA configuration](https://git.code.tecnalia.com/-/profile/two_factor_auth).
From there, you will be forwarded to the login page. After login you can be asked for the 2FA code. In case you have lost the authenticator you can use the recovery codes.
From there, you will be forwarded to the login page. After login you can be asked for the 2FA code. In case you have lost the authenticator you can use the recovery codes.