Introducción

El SDK para drupal7 permite agregar las funciones de autenticación de tuidd a su sitio de forma simple y rápida.

En esta página se detallan las características del módulo y una guía rápida de cómo instalarlo.

Instalación

La instalación se realiza mediante los siguientes pasos, para el detalle de cada uno
podes ver más abajo en las siguientes secciones.

1. Créate una cuenta tuidd
   Como Proveedor de Servicio o Agente Mayorista y registra tu sitio o aplicación en el portal de gestión de tuidd .

2. Descarga el SDK
   Podes bajar la ultima versiòn del sdk desde aquí

3. Instalalo
   Descomprimir el archivo ZIP que contiene el SDK en el directorio sites/all/modules/. Te creará un directorio llamado tuidd

4. Configura el SDK
   Deberás Ingresar a la sección de módulos y habilitarlo. Luego ingresa a la Configuración del SDK
   

5. Integrar el Botón a tu sitio
   Selecciona un bloque de tu página para desplegar el botón.

Configuración del SDK

La configuración se realiza siguiendo estos pasos ::

1. Ingresar a la siguiente ubicación en el menú:

Configuration > Web services > tuidd Configuration

2. Configurar los parámetros:

1. client_id :

   Es el ID de la aplicación generado durante el registro tu sitio en el portal de administración tuidd. Lo puedes encontrar en ingresando al sitio de gestión en el menú Mis Aplicaciones .
   Ejemplo: 73958620d779-4fdc-bc09-7d521af91278

   client_secret :
   Es la clave que se asignó automáticamente a la aplicación durante el registro en el sitio de gestión de tuidd. La puedes encontrar en ingresando al sitio de gestión en el menú Mis Aplicaciones .
   Ejemplo: 45759620e745-4adb-b329-5d521af3433

   home_page_url:
   Es la URL donde pusiste el botón de login. Se usa para que el SDK redirija cuando el usuario no fue autenticado o se venció la sesión.
   Ejemplo: http://ejemplo.com

   home_login_url :
   Es la URL a la cual se va a redirigir al usuario al finalizar el proceso de autenticación.
   Ejemplo: http://ejemplo.com/admin

   default_language :
   Idioma en el cual se muestran los textos. Los valores posibles son: Inglés (en), Español (es), Portugués (pt) o Francés (fr).
   Ejemplo: es

Seguridad

El SDK viene con configuraciones de seguridad para Apache. Si utilizas este servidor WEB, no deberás realizar ninguna configuración adicional a la propia de tu sitio.

En caso de utilizar otro servidor Web, deberás configurar en el mismo, que NO se tenga acceso a los siguientes directorios del SDK:

Configuración avanzada

La configuración se realiza siguiendo estos pasos :

1. Configurar los parámetros:

• callback_function : Ejemplo: myCallbackFuncion

Nombre de la función del proveedor que se ejecutará en el SDK y a la cual se le pasarán los datos del resultado de la autenticación. La función debe recibir por parámetro un objeto con los datos.

• callback_function_file : Ejemplo: 'myfuncs/myfunction.php'

Path absoluto del archivo que contiene la función de callback, definida en callback_function.

• scope : Ejemplo: openid profile

Lista de strings ASCII “case-sensitive” con valores del alcance del requerimiento de autenticación, del estándar OAuth 2.0. Según el estándar debe contener el al menos el valor “openid”.

Otros valores posibles son: profile, email, address, phone, offline_access, tuidd_notification, tuidd_advertising, tuidd_survey, tuidd_payment, tuidd_coupon.

Por defecto, el SDK solicita todos al usuario.

Para obtener más información acerca de los valores de “scope” ver la sección Autenticación de la API REST De Autenticación .

• security_level : Ejemplo: 3 2

Son los valores del nivel de seguridad (LOAs) requeridos por la aplicación, en orden de preferencia, de acuerdo a la norma ISO/IEC 29115 Clause 6 – 1, 2, 3, 4 – representando los niveles LOW, MEDIUM, HIGH y VERY HIGH respectivamente. Tener en cuenta que tuidd actualmente sólo soporta los valores 2 y 3. El valor finalmente utilizado es devuelto en el campo “acr” en la autenticación.

El valor por defecto es “2”.

Para obtener más información ver la sección Autenticación de la API REST De Autenticación.

• redirect_uri : Ejemplo: http://dominio/dir/tuidd/index.php

URI absoluta a la que se redirige una vez autorizado el usuario.

Debe coincidir con la registra en el sitio de administración de tuidd, en el parámetro URL RETORNO de la creación de la aplicación.

• container_div : Ejemplo: tuidd-sdk

Id de div referente al wrapper del botón de tuidd. Por defecto, el valor es “tuidd-sdk”.

Requerimientos

• Drupal 7.x

Release Actual

Versión	2.0.0
Fecha	31/01/2020
Descripción	SDK Integración con Drupal
Compatibilidad	-
Descarga	SDK DRUPAL

Histórico de cambios

v2.0.0	31/01/2020	Se modifican referencias a mcg por tuidd. Se agrega API de servicios. Se agrega Pagina para tests de servicios. Se agrega endpoint de notificaciones. Se agrega lib jquery propia, para no depender de fuentes externas.
v1.0.0	1/2/2018	Primera versión