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 title_image: spacex-uj3hvdfQujI-unsplash.jpg
data: 2021-06-23 data: 2021-06-23
authors: authors:
...@@ -10,46 +10,42 @@ categories: ...@@ -10,46 +10,42 @@ categories:
tags: tags:
- Helmholtz AAI - Helmholtz AAI
excerpt: > 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: #### Exemplary Helmholtz Cloud Service: Events Management Platform
* [**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 Cloud Service: HIFIS Events Management 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 %})
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)
for all Helmholtz and collaboration partners. 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 ### 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. Like for all Helmholtz Cloud Services, you can **use your home institution's login** to use the service seamlessly.
Unlike some other Indico instances (and the old HIFIS instance), specific Indico accounts are not necessary anymore and also not possible.
This is managed via the [Helmholtz AAI]({% link aai/index.md %}) (Authentication and Authorisation Infrastructure). 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 service via Helmholtz AAI
### Click-by-Click: Login to the HIFIS Event Management Platform via Helmholtz AAI
<i class="fas fa-lightbulb"></i> _Click to open screenshots for each step._ <i class="fas fa-lightbulb"></i> _Click to open screenshots for each step._
<details> <details class="my-2">
<summary>Open the <strong>HIFIS Event Management Platform</strong> in your browser: <a href="https://events.hifis.net">https://events.hifis.net</a>.</summary> <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> <div markdown=1>
{:.treat-as-figure} {:.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> </div>
</details> </details>
<details> <details class="my-2">
<summary>Click on <strong>Login</strong> at the top right.</summary> <summary>Click on <strong>Login</strong> at the top right.</summary>
<div markdown=1> <div markdown=1>
{:.treat-as-figure} {:.treat-as-figure}
...@@ -57,16 +53,18 @@ This is managed via the [Helmholtz AAI]({% link aai/index.md %}) (Authentication ...@@ -57,16 +53,18 @@ This is managed via the [Helmholtz AAI]({% link aai/index.md %}) (Authentication
</div> </div>
</details> </details>
<details> <details class="my-2">
<summary>Click on <strong>Helmholtz AAI</strong>.</summary> <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> <div markdown=1>
{:.treat-as-figure} {:.treat-as-figure}
![Keycloak login page, click on Helmholtz AAI]({% link assets/img/how-to-aai/events.hifis.net/2_keycloak.png %}) ![Keycloak login page, click on Helmholtz AAI]({% link assets/img/how-to-aai/events.hifis.net/2_keycloak.png %})
</div> </div>
</details> </details>
<details> <details class="my-2">
<summary>Select your home institution, i.e. the institution where you already have your home account. <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>. You can scroll down or use filtering, e.g. <i>helmholtz</i> or <i>desy</i>.
The example is about DESY. The example is about DESY.
You have to find your own Helmholtz Centre or institution. You have to find your own Helmholtz Centre or institution.
...@@ -77,15 +75,26 @@ 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> </div>
</details> </details>
<details> <details class="my-2">
<summary>Provide your username, passphrase for your home institution. There is no new password or username required.</summary> <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> <div markdown=1>
{:.treat-as-figure} {:.treat-as-figure}
![Login at home IdP]({% link assets/img/how-to-aai/events.hifis.net/4_home_idp.png %}) ![Login at home IdP]({% link assets/img/how-to-aai/events.hifis.net/4_home_idp.png %})
</div> </div>
</details> </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> <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> <div markdown=1>
{:.treat-as-figure} {:.treat-as-figure}
...@@ -93,8 +102,8 @@ You have to find your own Helmholtz Centre or institution. ...@@ -93,8 +102,8 @@ You have to find your own Helmholtz Centre or institution.
</div> </div>
</details> </details>
<details> <details class="my-2">
<summary>Only if you log in the first time -- <strong>Register at Helmholtz AAI</strong>.</summary> <summary>Only if you log in the first time &mdash; <strong>Register at Helmholtz AAI</strong>.</summary>
<div markdown=1> <div markdown=1>
* Click on **Register**. * Click on **Register**.
* Please check your name and mail address. * Please check your name and mail address.
...@@ -108,8 +117,8 @@ You have to find your own Helmholtz Centre or institution. ...@@ -108,8 +117,8 @@ You have to find your own Helmholtz Centre or institution.
</div> </div>
</details> </details>
<details> <details class="my-2">
<summary>Continue with normal log-in and enjoy access to to <a href="https://events.hifis.net">events.hifis.net</a>.</summary> <summary>Continue with normal log-in and enjoy access to the Helmholtz Cloud Service(s)!</summary>
<div markdown=1> <div markdown=1>
{:.treat-as-figure} {:.treat-as-figure}
![Successfully logged in to events.hifis.net]({% link assets/img/how-to-aai/events.hifis.net/6_events_logged_in.png %}) ![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 ...@@ -124,3 +133,9 @@ If you have persisting problems, please **contact us at <support@hifis.net>**, p
* The exact error your receive, * The exact error your receive,
* The URL / address of the error page, * The URL / address of the error page,
* The time point of your (failed) login attempt. * 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