Drupal 7

PixelPin OpenID Connect

Updated June 28th 2017

Step-by-step installation guide

PixelPin OpenID Connect is a Drupal 7 Module for authenticating with PixelPin using the OpenID Connect API.

PixelPin OpenID Connect allows you to connect your website to PixelPin and let users authenticate using passwordless pictures. With PixelPin OpenID Connect module, your user's to log in to your website using their PixelPin pictures. With PixelPin OpenID Connect, user's will no longer need to complete numerous forms for a successful registration.

To complete the installation, you'll need to create your PixelPin developer account.

Download the module

  1. Click on the link to download the PixelPin OpenID Connect module.

Dependencies

  1. PixelPin OpenID Connect requires the Drupal 7 Chaos tool suite module (ctools-7.x-1.12) and the Entity API module (entity-7.x-1.8). Download, install and enable these dependencies to require you to be able to enable and use PixelPin OpenID Connect. The dependencies will download in a .zip file. Once installed you only need to enable 'Chaos tools' and 'Entity API'.

Installation

  1. Log into the admin account of your Drupal 7 website and click on Modules.

  2. Click + install new module.

  3. Click Choose File.

  4. Locate the PixelPin OpenID Connect module .zip file and select open.

  5. Click install to install the PixelPin OpenID Connect module.

  6. Click Enable newly added modules.

  7. Repeat steps 3 - 7 for Chaos tools and Entity API modules.

  8. The page should open on the modules page. Scroll down until you find Chaos tools and Entity API (near the bottom). Check the checkboxes for each and then click save configuration at the bottom of the page. Then check the PixelPin OpenID Connect checkbox, and then click save configuration at the bottom of the page.

  9. All three modules are now installed.

Enabling PixelPin OpenID Connect

  1. Staying on the module page. Click configure next to PixelPin OpenID Connect.

  2. The page should open on the PixelPin OpenID Connect configuration page. Check the Enable checkbox to enable PixelPin OpenID Connect.

  3. The Client ID and Client Secret fields should appear along with the Redirect URI field which you'll need to create the PixelPin developer account required to use the PixelPin OpenID Connect module. If you haven't created a PixelPin developer account before, a guide can be found here to guide you throught the steps to create a PixelPin developer account.

  4. Once you've onbained your Client ID and Client Secret after creating a PixelPin developer account, type/paste them into the Client ID and Client Secret fields.

  5. (Optional) You can configure where the user's data will be saved and which field it'll appear on. The PixelPin OpenID Connect automatically adds these fields with the preferred user claims mappings to save you time creating them.

  6. Remember to save the configuration by pressing Save configuration at the bottom of the page!

  7. You've now enabled PixelPin OpenID Connect on your Drupal 7 website.

Additional Information

Click here to find out how you can add the PixelPin logo to the SSO button.

Testing the module

Logging in on the front page

An additional button has been added to the front page sidebar. The user can log in and register using this button if they have a PixelPin Account.

Logging in on the log in page

An additional button has been added to the bottom of the login page. The user can log in and register using this button if they have a PixelPin Account.

Registration

An additional button has been added to the top of the registration page. The user would use this button to register of your website, saving time filling in all the fields themselves.

Existing Users

Existing users can connect their existing account to PixelPin to be able to log in using PixelPin. The user can find this when they click on my account then connected accounts.

Contributing

PixelPin OpenID Connect is an open-source project that allows developers using PixelPin to improve the plugin. The Github Repo can be found here.