This extension is no longer maintained. The PHP SDK, which this extension makes calls through, is still available at https://github.com/getyoti/yoti-php-sdk
This repository contains the tools you need to quickly integrate your Joomla back-end with Yoti so that your users can share their identity details with your application in a secure and trusted way. The extension uses the Yoti PHP SDK. If you're interested in finding out more about the SDK, click here.
To import the Yoti Joomla extension inside your project:
-
Log on to the admin console of your Joomla website. e.g.
https://www.joomladev.com/administrator -
Navigate at
Extensions-> Manage -> Installand do one of the following:- click the
Install from Weblink and search forYoti - click
Upload Package Fileand upload the downloaded zip file from our extension page. - alternatively, you can use the
Install from URLorInstall from folderoptions
- click the
-
Install and enable
Yoti loginmodule andYoti - User profileplugin.
To set Yoti up follow the instruction below:
- Navigate on Joomla to
Components-> Yoti(details in the Yoti Components settings section below) - Navigate to
Extensions -> Modules, search for theYoti Loginmodule and publish it. - Navigate to
Extensions -> Plugins, search for theYoti - User Profileplugin and enable it.
After you have registered your Yoti, access the Yoti Hub to create a new application.
Specify the basic details of your application such as the name, description and optional logo. These details can be whatever you like and will not affect the extensions' functionality.
The Data tab - Specify any attributes you'd like users to share. You must select at least one. If you plan to allow new user registrations, we recommended choosing Given Name(s), Family Name and Email Address at a minimum.
The Integration tab - Here is where you specify the callback URL. This can be found on your Yoti settings page in your Joomla admin panel.
To set things up, navigate on Joomla to the Yoti extension. You will be asked to add the following information:
Yoti App IDis the unique identifier of your specific application.Yoti Scenario IDidentifies the attributes associated with your Yoti application. This value can be found on your application page in Yoti Hub.Yoti Client SDK IDidentifies your Yoti Hub application. This value can be found in the Hub, within your application section, in the keys tab.Company Namewill replace Joomla wording in the warning message displayed on the custom login form.Yoti PEM Fileis the application pem file. It can be downloaded only once from the Keys tab in your Yoti Hub.
Please do not open the .pem file as this might corrupt the key and you will need to create a new application.
Only allow existing Joomla users to link their Yoti account - This setting allows a new user to register and log in by using their Yoti. If enabled, when a new user tries to scan the Yoti QR code, they will be redirected back to the login page with an error message displayed.
Attempt to link Yoti email address with Joomla account for first time users - This setting enables linking a Yoti account to a Joomla user if the email from both platforms is identical.
Upon registration using Yoti, user data will be stored as serialized data into {DB_prefix}_yoti_users table in the data field.
You can write a query to retrieve all data stored in {DB_prefix}_yoti_users.data, which will return a list of serialized data.
We provide a Docker container that includes the Yoti extension.
Clone this repository and go into the folder:
$ cd yoti-joomlaCopy .env.example to .env and set environment variables.
Rebuild the images if you have modified the docker-compose.yml file:
$ cd docker
$ docker-compose build --no-cacheInstalling Joomla:
$ cd docker
$ ./install-joomla.shAfter the command has finished running, go to https://localhost:6001 and follow our extension setup process.
To fetch the latest SDK and place in ./yoti/site/sdk directory:
$ ./checkout-sdk.shTo run the local working copy of the extension:
$ cd docker
$ ./install-joomla.sh joomla-devAfter the command has finished running, go to https://localhost:6002
Run Joomla without the plugin:
$ cd docker
$ ./install-joomla.sh joomla-baseAfter the command has finished running, go to https://localhost:6003 and install the plugin through the administrator UI.
$ cd docker
$ ./run-tests.shRun the following commands to remove docker containers:
$ cd docker
$ docker-compose downFor any questions or support please email sdksupport@yoti.com.
Please provide the following to get you up and working as quickly as possible:
- Computer Type
- OS Version
- Version of Joomla being used
- Screenshot
Once we have answered your question we may contact you again to discuss Yoti products and services. If you’d prefer us not to do this, please let us know when you e-mail.