This guide concerns the Drupal module "Infomaniak_Connect" which allows users to log in to your Drupal site (whether it is hosted by Infomaniak or not) using their Infomaniak credentials.

Introduction

• Allowing login via an Infomaniak account on your Drupal site enables your visitors to comment, register for courses, or access any content reserved for members with a single click, without having to create a new account.
• This saves them time and provides a more secure method for you, as you don't have to manage additional passwords.
• This external module functions identically to the "Log in with Google", "Log in with Facebook", or “Log in with Apple” options; it uses the standard OAuth2 and OpenID Connect protocols to enable single sign-on (SSO).

A. Create an application with Auth Infomaniak

To do this:

1. Click here to access the management of your Auth product on the Infomaniak Manager (need help?).
2. Click the button to Create a new application:
   
3. Choose the “Web Front-End” type.
4. Give your application a name.
5. In the URL field, enter the domain name corresponding to your Drupal site followed by /openid-connect-authorize (refer to the GitHub documentation if needed).
6. Click the button to complete the app creation:
   
7. Carefully note the 2 pieces of information obtained when finalizing your OAuth2 application:
   

B. Configure the Drupal extension

Via SSH, deploy Composer if necessary to retrieve the openid_connect and infomaniak_connect extensions. To do this:

• You may need to edit the composer.json file because the version of openid_connect is not yet considered stable. Add:

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

• The SSH commands for installing the 2 extensions are available here:
  • https://www.drupal.org/project/openid_connect
  • https://www.drupal.org/project/infomaniak_connect

Next, in Drupal:

1. Find the Infomaniak module among your pre-installed modules.
2. Select it.
3. Click on the Install button:
   
4. The dependencies will now be installed:
   
5. Under Configuration, click to configure the OpenID connection:
   
6. Click the edit button:
   
7. The only fields to fill in are Client ID and Client Secret, and these come from the information obtained in step A above:
   
8. Don't forget to save the changes made to the extension settings.
9. In the Settings tab, you can choose the display type for your login page; remember to save:
   
10. An additional button, for logging in with your Infomaniak credentials, is now visible on your login page for users: