Deze handleiding gaat over de Drupal-module "Infomaniak_Connect", waarmee gebruikers kunnen inloggen op uw Drupal-site (ongeacht of deze gehost wordt door Infomaniak of niet) met behulp van hun Infomaniak-inloggegevens.

Inleiding

• Door inloggen via een Infomaniak-account op uw Drupal-site mogelijk te maken, kunnen uw bezoekers met één klik commentaar geven, zich voor cursussen aanmelden of toegang krijgen tot alle inhoud die alleen voor leden beschikbaar is, zonder dat ze een nieuw account hoeven aan te maken.
• Dit bespaart tijd voor hen en is een veiligere methode voor u, omdat u geen extra wachtwoorden hoeft te beheren.
• De werking van deze externe module is identiek aan de opties "Inloggen met Google", "Inloggen met Facebook" of “Inloggen met Apple”; het maakt gebruik van de standaardprotocollen OAuth2 en OpenID Connect om eenmalige aanmelding (SSO) mogelijk te maken.

A. Een applicatie aanmaken met Auth Infomaniak

Hiervoor:

1. Klik hier om naar het beheer van uw Auth-product in het Infomaniak Manager te gaan (hulp nodig?).
2. Klik op de knop om een nieuwe applicatie aan te maken:
   
3. Kies het type “Web Front-End”.
4. Geef uw applicatie een naam.
5. Vul in het URL-veld het domeinnaam dat bij uw Drupal-website hoortwaaraan u /openid-connect-authorize toevoegt (raadpleeg indien nodig de GitHub-documentatie).
6. Klik op de knop om de aanmaak van de app te voltooien:
   
7. Noteer zorgvuldig de 2 gegevens die u krijgt bij het afronden van uw OAuth2-applicatie:
   

B. De Drupal-extensie configureren

Via SSH kunt u, indien nodig, Composer installeren om de extensies openid_connect en infomaniak_connect te downloaden. Ga als volgt te werk:

• U moet indien nodig het bestand composer.json bewerken, omdat de versie van openid_connect nog niet als stabiel wordt beschouwd. Voeg het volgende toe:

• "minimum-stability": "dev",
  "prefer-stable": true

• De SSH-opdrachten voor de installatie van de 2 extensies vindt u hier:
  • https://www.drupal.org/project/openid_connect
  • https://www.drupal.org/project/infomaniak_connect

Vervolgens, in Drupal:

1. Zoek de module Infomaniak op tussen uw vooraf geïnstalleerde modules.
2. Selecteer deze.
3. Klik op de knop Installeren:
   
4. De benodigde software wordt nu geïnstalleerd:
   
5. Onder Configuratie klikt u om de OpenID-verbinding in te stellen:
   
6. Klik op de knop bewerken:
   
7. De enige velden die u hoeft in te vullen, zijn Client ID en Client Secret. Deze gegevens vindt u in de informatie die u in stap A hierboven heeft verkregen:
    
8. Vergeet niet de wijzigingen in de instellingen van de extensie op te slaan.
9. In het tabblad Instellingen kunt u het type weergave voor uw inlogpagina kiezen; vergeet niet om op te slaan:
   
10. Een extra knop voor het inloggen met uw Infomaniak-account is nu zichtbaar op uw inlogpagina voor gebruikers: