Introduction

The SDK for drupal7 allows you to add the authentication functions of tuidd to your site simply and quickly.

This page details the features of the module and a quick guide on how to install it .

Installation

The installation is done through the following steps, for the detail of each one
You can see below in the following sections.

1. Create a tuidd account
   As a Service Provider or Wholesale Agent and register your site or application in the tuidd management portal .

2. Download the SDK
   You can download the latest version of the sdk from here

3. Install it
   Unzip the ZIP file that contains the SDK in the sites / all / modules / directory. It will create a directory called tuidd

4. Configure the SDK
   You must enter the module section and enable it. Then enter the SDK configuration
   

5. Integrate the Button to your site
   Select a block on your page to display the button.

SDK configuration

The configuration is done following these steps ::

1. Enter the following location in the menu:

Configuration > Web services > tuidd Configuration

2. Configure the parameters:

1. client_id :

   It is the ID of the application generated during the registration of your site in the tuidd administration portal. You can find it by entering the management site in the menu My Applications .
   Example: 73958620d779-4fdc-bc09-7d521af91278

   client_secret :
   It is the key that was automatically assigned to the application during registration in the management site of tuidd. You can find it by entering the management site in the menu My Applications .
   Example: 45759620e745-4adb-b329-5d521af3433

   home_page_url:
   It's the URL where you put the login button. It is used for the SDK to redirect when the user was not authenticated or the session expired.
   Example: https://example.com

   home_login_url :
   It is the URL to which the user will be redirected at the end of the authentication process.
   Example: https://example.com/admin

   default_language :
   Language in which the texts are displayed. The possible values ​​are: English (en), Spanish (es), Portuguà © s (pt) or Francà © s (fr).
   Example: es

Security

The SDK comes with security configurations for Apache. If you use this WEB server, you should not make any additional configuration to the one of your site.

In case of using another Web server, you must configure in it, that you DO NOT have access to the following SDK directories:

Advanced configuration

The configuration is done following these steps :

1. Configure the parameters:

callback_function : Example: myCallbackFuncion

The name of the provider's function that will be executed in the SDK and to which the authentication result data will be passed. The function must receive an object with the data per parameter.

callback_function_file : Example: 'myfuncs / myfunction.php'

Absolute path of the file that contains the callback function, defined in callback_function.

scope : Example: openid profile

List of ASCII strings "case-sensitive" with values ​​of the scope of the authentication requirement, of the OAuth 2.0 standard. According to the standard it must contain the at least the value openid.

Other possible values ​​are: profile, email, address, phone, offline_access, tuidd_notification, tuidd_advertising, tuidd_survey, tuidd_payment, tuidd_coupon.

By default, the SDK requests all the user.

For more information about the values ​​of scope see the Authentication section of the Authentication REST API .

security_level : Example: 3 2

Are the security level values ​​(LOAs) required by the application, in order of preference, according to ISO / IEC 29115 Clause 6 "1, 2, 3, 4" representing the LOW, MEDIUM, HIGH and VERY HIGH levels respectively. Keep in mind that tuidd currently only supports the values ​​2 and 3. The value finally used is returned in the field "acr" in the authentication.

The default value is 2.

For more information see the Authentication section of the Authentication REST API.

redirect_uri : Example: http: //domain/dir/tuidd/index.php

Absolute URI to which it is redirected once the user is authorized.

It must match the one registered in the tuidd administration site, in the RETURN URL parameter of the creation of the application.

container_div : Example: tuidd-sdk

Id of the referring to the wrapper of the tuidd button. By default, the value is tuidd-sdk.

Requirements

• Drupal 7.x

Current Release

Version	v2.0.0
Date	31/01/2020
Description	SDK Integration with Drupal
Compatibility	-
Discharge	SDK DRUPAL

Historical of changes

v2.0.0	31/01/2020	References to mcg are modified by tuidd. Services API is added. Page is added for service tests. Notification endpoint is added. Lib jquery itself is added, so as not to depend on external sources.
v1.0.0	01/02/2018	First version