Deze handleiding gaat over de Drupal-module "Infomaniak_Connect", waarmee gebruikers kunnen inloggen op uw Drupal-website (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 aanmelden voor cursussen 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-beheerportaal 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 overeenkomt met uw Drupal-sitewaarna 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 kunnen installeren. 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 om 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. Er is nu een extra knop zichtbaar op uw inlogpagina voor gebruikers, waarmee ze kunnen inloggen met hun Infomaniak-gegevens: