Skip to content
Snippets Groups Projects
Commit d66a775e authored by Uwe Jandt (DESY, HIFIS)'s avatar Uwe Jandt (DESY, HIFIS)
Browse files

Update AAI tutorial

parent 971f60bc
No related branches found
No related tags found
1 merge request!682Update AAI tutorial
---
title: "AAI login to Helmholtz Cloud and Associated Services"
title: "Helmholtz AAI login to Helmholtz Cloud Services"
title_image: spacex-uj3hvdfQujI-unsplash.jpg
data: 2021-06-23
authors:
......@@ -10,46 +10,42 @@ categories:
tags:
- Helmholtz AAI
excerpt: >
Pictured tutorial on usage of Helmholtz AAI login and registration procedures for Helmholtz Cloud and Associated services, using the HIFIS Events Management Platform at <a href="https://events.hifis.net">events.hifis.net</a> as an example.
Pictured tutorial on usage of Helmholtz AAI login and registration procedures for Helmholtz Cloud Services, using the HIFIS Events Management Platform at <a href="https://events.hifis.net">events.hifis.net</a> as an example.
---
# Login to Helmholtz Cloud and Associated Services via Helmholtz AAI
# Login to Helmholtz Cloud Services via Helmholtz AAI
Helmholtz AAI allows seamless access to a large and growing number of Cloud Services, supported by [HIFIS](https://hifis.net).
Helmholtz AAI allows seamless access to a large and growing number of Cloud Services,
many of them accessible via the [Helmholtz Cloud Portal](https://helmholtz.cloud/services) and
supported by [HIFIS]({% link index.md %}).
The Services are distinguished in:
* [**Associated Services**](https://login.helmholtz.de/unitygw/VAADIN/files/connected-services.html),
* [**Helmholtz Cloud Services**](https://cloud.helmholtz.de/): The services are accessible through the Helmholtz Cloud Portal (beta).
#### Exemplary Helmholtz Cloud Service: Events Management Platform
#### Exemplary Cloud Service: HIFIS Events Management Platform
As a popular example, the [Event Management Platform](https://events.hifis.net/) of HIFIS has recently been
[made available](https://hifis.net/news/2021/04/27/announce-hifis-event-platform)
As a popular example, the HIFIS [Event Management Platform](https://events.hifis.net/) has been
[made available]({% post_url 2021/04/2021-04-27-announce-hifis-event-platform %})
for all Helmholtz and collaboration partners.
It is based on CERN's [Indico](https://getindico.io/) tool.
This Tutorial describes the login process for this exemplary service, however, all other services function analogously.
### Easy login via your username at your home institute
Like for all Cloud Services, you can **use your home institution's login** to use the Events Platform seamlessly.
Unlike some other Indico instances (and the old HIFIS instance), specific Indico accounts are not necessary anymore and also not possible.
Like for all Helmholtz Cloud Services, you can **use your home institution's login** to use the service seamlessly.
This is managed via the [Helmholtz AAI]({% link aai/index.md %}) (Authentication and Authorisation Infrastructure).
(As a fallback, a login from, e.g., ORCID, can also be performed. You might also try Github, or Google.)
### Click-by-Click: Login to the HIFIS Event Management Platform via Helmholtz AAI
#### Click-by-Click: Login to the service via Helmholtz AAI
<i class="fas fa-lightbulb"></i> _Click to open screenshots for each step._
<details>
<summary>Open the <strong>HIFIS Event Management Platform</strong> in your browser: <a href="https://events.hifis.net">https://events.hifis.net</a>.</summary>
<details class="my-2">
<summary><strong>Open the service</strong> &mdash; in this example the HIFIS Event Management Platform &mdash; in your browser.
Do so by <a href="https://helmholtz.cloud/services?search=hifis%20events&serviceDetails=svc-ec78dddd-f44b-4062-a1a1-ba9c0ddaa70b">locating it in the Helmholtz Cloud Portal</a> and clicking on "Go to service", or
direct access in the browser via <a href="https://events.hifis.net">https://events.hifis.net</a>.</summary>
<div markdown=1>
{:.treat-as-figure}
![URL to service]({% link assets/img/how-to-aai/events.hifis.net/0_url_to_service.png %})
![Cloud portal link to service]({% link assets/img/how-to-aai/events.hifis.net/0_cloud_portal.png %})
</div>
</details>
<details>
<details class="my-2">
<summary>Click on <strong>Login</strong> at the top right.</summary>
<div markdown=1>
{:.treat-as-figure}
......@@ -57,16 +53,18 @@ This is managed via the [Helmholtz AAI]({% link aai/index.md %}) (Authentication
</div>
</details>
<details>
<summary>Click on <strong>Helmholtz AAI</strong>.</summary>
<details class="my-2">
<summary>In some cases, you need to additionally click on <strong>Helmholtz AAI</strong>.
<i>This step is mostly skipped.</i>
</summary>
<div markdown=1>
{:.treat-as-figure}
![Keycloak login page, click on Helmholtz AAI]({% link assets/img/how-to-aai/events.hifis.net/2_keycloak.png %})
</div>
</details>
<details>
<summary>Select your home institution, i.e. the institution where you already have your home account.
<details class="my-2">
<summary><strong>Select your home institution</strong>, i.e. the institution where you already have your home account.
You can scroll down or use filtering, e.g. <i>helmholtz</i> or <i>desy</i>.
The example is about DESY.
You have to find your own Helmholtz Centre or institution.
......@@ -77,15 +75,26 @@ You have to find your own Helmholtz Centre or institution.
</div>
</details>
<details>
<summary>Provide your username, passphrase for your home institution. There is no new password or username required.</summary>
<details class="my-2">
<summary>Can't find your institution or it is not supported?
As a fallback, a <strong>login from ORCID, Github or Google</strong> can be performed.
Select it accordingly.
</summary>
<div markdown=1>
{:.treat-as-figure}
![Choice of institutions in Unity]({% link assets/img/how-to-aai/events.hifis.net/3_unity_orcid.png %})
</div>
</details>
<details class="my-2">
<summary>Provide your <strong>username, passphrase</strong> of your home institution. There is no new password or username required.</summary>
<div markdown=1>
{:.treat-as-figure}
![Login at home IdP]({% link assets/img/how-to-aai/events.hifis.net/4_home_idp.png %})
</div>
</details>
<details>
<details class="my-2">
<summary>Accept data transmissions from your home institution's identity provider (IdP) to Helmholtz AAI, and further to events.hifis.net.</summary>
<div markdown=1>
{:.treat-as-figure}
......@@ -93,8 +102,8 @@ You have to find your own Helmholtz Centre or institution.
</div>
</details>
<details>
<summary>Only if you log in the first time -- <strong>Register at Helmholtz AAI</strong>.</summary>
<details class="my-2">
<summary>Only if you log in the first time &mdash; <strong>Register at Helmholtz AAI</strong>.</summary>
<div markdown=1>
* Click on **Register**.
* Please check your name and mail address.
......@@ -108,8 +117,8 @@ You have to find your own Helmholtz Centre or institution.
</div>
</details>
<details>
<summary>Continue with normal log-in and enjoy access to to <a href="https://events.hifis.net">events.hifis.net</a>.</summary>
<details class="my-2">
<summary>Continue with normal log-in and enjoy access to the Helmholtz Cloud Service(s)!</summary>
<div markdown=1>
{:.treat-as-figure}
![Successfully logged in to events.hifis.net]({% link assets/img/how-to-aai/events.hifis.net/6_events_logged_in.png %})
......@@ -124,3 +133,9 @@ If you have persisting problems, please **contact us at <support@hifis.net>**, p
* The exact error your receive,
* The URL / address of the error page,
* The time point of your (failed) login attempt.
---
### Changelog
- 2022-12-13 Removed some outdated or irrelevant information, some formulation fixes.
\ No newline at end of file
assets/img/how-to-aai/events.hifis.net/0_cloud_portal.png

46.6 KiB

assets/img/how-to-aai/events.hifis.net/0_url_to_service.png

12.4 KiB

assets/img/how-to-aai/events.hifis.net/3_unity_orcid.png

11.4 KiB

0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment