Deze handleiding gaat over de Drupal-module "Infomaniak_Connect", waarmee gebruikers zich kunnen aanmelden bij hun Drupal-website (ongeacht of deze bij Infomaniak wordt gehost of niet) door hun Infomaniak-inloggegevens te gebruiken.

Inleiding

• Door het inschakelen van aanmelden via een Infomaniak-account op uw Drupal-website, kunnen uw bezoekers met slechts één klik reacties plaatsen, zich aanmelden voor cursussen of toegang krijgen tot inhoud die alleen voor leden bedoeld is, zonder dat ze een nieuw account hoeven aan te maken.
• Dit bespaart hen tijd 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 "Aanmelden met Google", "Aanmelden met Facebook" of "Aanmelden met Apple"; het gebruikt de standaardprotocollen OAuth2 en OpenID Connect om een single sign-on (SSO)-authenticatie mogelijk te maken.

A. Maak een applicatie aan met Auth Infomaniak

Ga als volgt te werk:

1. Klik hier om toegang te krijgen tot het beheer van uw Auth-product in de Infomaniak Manager (Hulp nodig?).
2. Klik op de knop om een nieuwe applicatie aan te maken:
3. Selecteer het type "Web Front-End".
4. Geef uw applicatie een naam.
5. Voer in het URL-veld de **domeinnaam van uw Drupal-site** in, gevolgd door ` /openid-connect-authorize` (zie de GitHub-documentatie indien nodig).
6. Klik op de knop om de **app-creatie te voltooien**:
   
7. Noteer zorgvuldig de 2 stukken informatie die u ontvangt bij het voltooien van uw **OAuth2-applicatie**:
   

B. Drupal-extensie configureren

Installeer indien nodig **Composer** via SSH om de extensies `openid_connect` en `infomaniak_connect` te installeren. Ga als volgt te werk:

• U moet mogelijk 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 het installeren 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 onder uw vooraf geïnstalleerde modules.
2. Selecteer deze.
3. Klik op de knop **Installeren**:
   
4. De installatie van de afhankelijkheden verloopt als volgt:
   
5. Klik onder Configuratie om de OpenID-verbinding te configureren:
   
6. Klik op de knop Bewerken:
   
7. De enige velden die moeten worden ingevuld, zijn Client ID en Client Secret, en deze gegevens haalt u uit de informatie die u in het bovenstaande punt A heeft ontvangen:
    
8. Vergeet niet om de aangebrachte wijzigingen op te slaan in de instellingen van de extensie.
9. In het tabblad Instellingen kunt u het weergavetype voor uw inlogpagina selecteren; 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: