Vipps Login for Drupal
This plugin is built and maintained by Frontkom and hosted on GitHub.
This project is based on Social API and Social Auth.
The module lets you log in to Drupal using the Vipps app. It's a secure and reliable way to handle user authentication.
The module adds two things:
An alternative URL for login:
/user/login/vipps
A button that can be positioned as a block or as part of the standard login form
See how it works in this video:
Requirements
- Drupal 8.x
- Composer
- Social API
- Social Auth
- Working Vipps account (see below)
Getting started
- Sign up to use Vipps på Nett.
- After 1-2 days you will get an email with login details to Vipps Developer Portal. This is where you can retrieve the API credentials used to configure the module in Drupal.
- Proceed to Installation below.
Installation
- Install dependencies
- Install the module
If you install the module using Composer, the dependencies will be added automatically:
composer require "drupal/social_auth_vipps"
Configuration
- Add your Vipps project OAuth information in Configuration > User Authentication > Vipps*.
- Place a Social Auth Login block in Structure > Block Layout.
OR: Click Show in login form
If you already have a Social Auth Login block on the site, rebuild the cache.
How it works
The user can click on the Vipps logo in the Social Auth Login block. You can also add a button or link anywhere on the site that points to /user/login/vipps
, so theming and customizing the button or link is very easy.
After Vipps has returned the user to your site, the module compares the user ID or email address provided by Vipps. If the user has previously registered using Vipps or your site already has an account with the same email address, the user is logged in. If not, a new user account is created. Also, a Vipps account can be associated with an authenticated user by matching the email address.
Frequently Asked Questions
How can I get help with the module?
First, check out the documentation pages for the module on Drupal.org. If you still have issues,
please create an issue in the issue queue for the module. Before posting a support request, please check the Recent Log entries at admin/reports/dblog
.
Where can I use Vipps?
Vipps is only available in Norway at the moment and only users who have the Vipps app installed will be able to log in with Vipps.