Biocryptology Login Magento 1.x Installation and Configuration Instalación y Configuración
3 16 2018 Biocryptology. All rights reserved. All information and pictures contained herein are subject to change without notice. Biocryptology shall not be liable for technical errors or omissions contained herein. The purchased product may differ from the product as described in this guide, since Biocryptology reserves the right to modify product s specifications and design at any time without prior notice. Our most recent guides can be requested at our Support Service. All pictures included in this document are based on the browser Google Chrome. Biocryptology has been certified to international standards for quality management (ISO 9001:2015) and information security management (ISO/IEC 27001:2013) following external audits assessed by BSI, a business standards company, in 2017. 2018 Biocryptology. Todos los derechos reservados. La información e ilustraciones contenidas en el presente documento están sujetas a cambios sin previo aviso. Biocryptology no será responsable de posibles errores técnicos u omisiones en el presente documento. El producto adquirido puede diferir del producto descrito en esta guía, ya que Biocryptology se reserva el derecho a modificar las especificaciones y diseño de productos en cualquier momento sin previo aviso. Nuestras guías más recientes pueden solicitarse a través de nuestro Servicio de Soporte. Todas las ilustraciones incluidas en este documento se basan en el navegador web Google Chrome. Biocryptology está certificada en las normativas ISO 9001:2015 Sistemas de gestión de la calidad e ISO/IEC 27001:2013 Sistemas de gestión de la seguridad de la información, a través de la entidad de normalización empresarial BSI. 2018 Biocryptology. All rights reserved. 2
Biocryptology and Magento Version 2.0 October 2018. This document is aimed at administrators of e-commerce sites developed in Magento (in its version 1.x), who desire to integrate Biocryptology and offer a secure and transparent access to their user s accounts. Integrating Biocryptology in Magento 1.x is very simple, just follow the steps indicated below in this document: installation and configuration. However, for a correct configuration of the Biocryptology extension for Magento 1.x, it is required to be registered in Biocryptology. If you still have questions or comments, please contact the Biocryptology Support Service at: support@biocryptology.com. Thank you for being part of #AWorldWithoutPasswords. If you want to be aware of our latest news and future features, we will welcome you on our website and social networks ( Ctrl + click on each icon for direct access): 2018 Biocryptology. All rights reserved. 3
Contents Biocryptology and Magento... 3 Contents... 4 Biocryptology Login Installation... 5 1.1 Requirements and Technical Features... 5 Mobile Phones... 5 PC and Laptops... 5 1.2 Installation Process... 6 Biocryptology Login Configuration... 8 2018 Biocryptology. All rights reserved. 4
Biocryptology Login Installation Biocryptology Login Installation This section describes the step-by-step installation process of Biocryptology Login for Magento 1.x, as well as the requirements and technical considerations for a successful performance of this extension. 1.1 Requirements and Technical Features Mobile Phones PC and Laptops To be able to configure Biocryptology Login, it is required to create an account using the Biocryptology App from a mobile phone. The installation and configuration process of Biocryptology Login for Magento 1.x is performed from a PC or laptop. Languages supported: English (default), Spanish and Dutch. Biometric identification system installed (fingerprint reader or face recognition). OS supported: ios 10.x and later versions. Android 6.x and later versions. PC or laptop with Internet connection. Web browsers supported: Google Chrome (version 65.0.3325.181 or later). Mozilla Firefox (version 59.0.2 or later). Safari (version 11 or later). 2018 Biocryptology. All rights reserved. 5
1.2 Installation Process Once the Biocryptology Login extension has been correctly downloaded from the Magento Marketplace (https://marketplace.magento.com), perform the following steps to proceed with the installation process: 1. Decompress the installation package: 1a. Unzip the installation package, presented in.zip format, in a local directory. It contains three folders: app, lib and skin. 2018 Biocryptology. All rights reserved. 6
2. Transfer the installation package via FTP: 2a. Connect to the corresponding machine with an FTP client, such as FilleZilla or WinSCP. 2b. Transfer (copy) the app, lib and skin folders to the Magento installation directory from the Biocryptology Login installation file. 2c. Thus, both folders and their content will be included into the Magento installation directory, adding the Biocryptology Login extension to the Magento platform. After installation of Biocryptology Login for Magento 1.x, you must configure it for its correct integration and operation. 2018 Biocryptology. All rights reserved. 7
Biocryptology Login Configuration Once Biocryptology Login for Magento 1.x is successfully installed, it must be configured for its correct integration with the desired e-commerce site. The configuration process is performed from the web administrator s dashboard in Magento, as well as from the user private area from Biocryptology, so it is required to own a user account on Biocryptology (www.biocryptology.com). You will get your Biocryptology account when entering for the first time the Biocryptology app. Go through the wizard to get registered. During this process, you will only need to provide a valid email address and mobile phone number. For more information, visit the Biocryptology Support webpage (https://support.biocryptology.com). To configure the Biocryptology extension for e-commerce sites based on Magento 1.x, perform the following steps: 1. Sign in Magento 1.x with administrator privileges: In order to complete this process, you must log into Biocryptology and Magento, simultaneously. For convenience, it is recommended to use different tabs within the web browser used. 1a. Access with your Magento username and password. 2018 Biocryptology. All rights reserved. 8
2. Go to the configuration settings for Biocryptology Login: 2a. In the dashboard of Magento 1.x select the System menu. 2b. Then select the Configuration submenu. 2c. Finally, select the Biocryptology Login > Biocryptology Login Configuration option. 2018 Biocryptology. All rights reserved. 9
3. Set the appropriate configuration settings for a correct operation of Biocryptology Login. 3c. Click on Save Config to complete the activation of the Biocryptology Login extension. Go to your Biocryptology account. 3a. Select Yes in the Enable Biocryptology Login dropdown list to activate the Biocryptology extension. Additional configuration options will display. 3b. Copy the URLs in the Post Login URL and Post Logout URL fields. By default, in the Logout URL field the homepage of the corresponding website is set to redirect users upon logout. However, this field is editable and customizable according to the preferences of the administrator. 2018 Biocryptology. All rights reserved. 10
4. Access your Biocryptology user account and enable Biocryptology Login for Magento 1.x within your domain settings: 4a. In another browser s tab, sign into Biocryptology at https://id.biocryptology.com. To sign in you need to use the Biocryptology app to scan the QR code that appears on screen. 4b. Go to My domains and click on Plugins to assign the Biocryptology Login extension for Magento 2.x to the desired domain. Before configuring Biocryptology Login, you must enable your domain in Biocryptology. 2018 Biocryptology. All rights reserved. 11
4c. Select a picture that illustrates the site developed with Magento (optional field). 4d. This field indicates the domain associated to the plugin (field automatically set by default). 4e. Indicate a descriptive name for the site that is being integrated with Biocryptology (required field). 4e. In the Callback URL to validate field paste the URL copied previously in step 3b from the Post login URL field to redirect users after signing in with Biocryptology. 4f. In the Callback URLs field paste the URL copied previously in step 3b from the post logout URL field to redirect users after signing out with Biocryptology. 4g. Once completed, click on Save to enable the plugin and save settings. You can add more post logout URLs using the Add URL button. 2018 Biocryptology. All rights reserved. 12
4h. The extension for Magento 1.x will show up in the list of plugins within the selected domain. Click the corresponding Edit button to view its details. 4i. When enabling the new extension, the system automatically assigns it an ID. Copy the Client identifier number from the Client ID field. Then go back to Magento 1.x to paste the Client ID previously copied. 2018 Biocryptology. All rights reserved. 13
5. Go back to your Magento account and complete the configuration by indicating the Client ID: 5a. Return to the Biocryptology Login Configuration screen. 5b. Paste the plugin identifier (previously copied in step 4h) in the Client ID field. 5c. Finish by clicking the Save Config button to complete the process. Now Biocryptology Login for Magento 2.x is properly configured. 2018 Biocryptology. All rights reserved. 14
Once Biocryptology Login is correctly installed and configured, the button to sign in with Biocryptology will be automatically displayed in the login page of the corresponding e-commerce. Thus, the site s users will login securely via Biocryptology. Design and location may vary depending on the proper pluigin or the website. 2018 Biocryptology. All rights reserved. 15
Biocryptology y Magento Versión 2.0 Octubre, 2018. Este documento está dirigido a aquellos administradores de comercios electrónicos desarrollados en Magento (en su versión 1.x), que desean integrar Biocryptology y ofrecer un acceso seguro y transparente a las cuentas de sus usuarios. Integrar Biocryptology en Magento 1.x resulta muy sencillo si sigues los pasos indicados en este documento: instalación y configuración. No obstante, para una correcta configuración de Biocryptology Login necesitas estar registrado en Biocryptology como usuario. Para cualquier duda o comentario, puedes ponerte en contacto con el Servicio de Soporte de Biocryptology, a través de su dirección de correo electrónico: support@biocryptology.com. Gracias por formar parte de #AWorldWithoutPasswords. Si quieres estar al tanto de las últimas novedades y futuras funcionalidades, te esperamos en nuestra página web y redes sociales (pulsa Ctrl + clic en cada icono para acceder). 2018 Biocryptology. Todos los derechos reservados. 16
Contenidos Biocryptology y Magento... 16 Contenidos... 17 Instalación de Biocryptology Login... 18 1.1 Requisitos y características técnicas... 18 Teléfonos móviles... 18 Equipos de sobremesa... 18 1.2 Proceso de instalación manual... 19 Configuración de Biocryptology Login... 21 2018 Biocryptology. Todos los derechos reservados. 17
Instalación de Biocryptology Login Instalación de Biocryptology Login En este apartado se describe el proceso de instalación paso a paso de Biocryptology Login para Magento 1.x, además de los requisitos y consideraciones a tener en cuenta para conseguir una correcta instalación y funcionamiento. 1.1 Requisitos y características técnicas Teléfonos móviles Equipos de sobremesa Para la configuración de Biocryptology Login, es necesario registrarse en Biocryptology usando nuestra app con un teléfono móvil. El proceso de instalación y configuración de Biocryptology Login para Magento 1.x se realiza desde un pc o portátil. Idiomas: inglés (predeterminado), español y neerlandés. Sistema de reconocimiento biométrico (lector de huella o reconocimiento facial) instalado. Sistemas operativos: ios 10.x y versiones posteriores. Android 6.x y versiones posteriores. PC u ordenador portátil con conexión a Internet. Navegadores web: Google Chrome (versión 65.0.3325.181 o posterior). Mozilla Firefox (versión 59.0.2 o posterior). Safari (versión 11 o posterior). 2018 Biocryptology. Todos los derechos reservados. 18
Instalación de Biocryptology Login 1.2 Proceso de instalación manual Una vez descargada la extensión Biocryptology Login desde Magento Marketplace (https://marketplace.magento.com), sigue los pasos descritos a continuación para su correcta instalación: 1. Descomprime el paquete de instalación: 1a. Descomprime el paquete de instalación, presentado en formato.zip, en un directorio local. Observa que contiene tres carpetas: app, lib y skin. 2018 Biocryptology. Todos los derechos reservados. 19
Instalación de Biocryptology Login 2. Copia el paquete de instalación a través de un cliente FTP: 2a. Conéctate a la máquina correspondiente desde un cliente FTP, como FilleZilla o WinSCP. 2b. En el directorio de instalación de Magento copia (transfiere) las carpetas app, lib y skin del archivo de instalación de Biocryptology Login. 2c. De esta manera, el contenido de ambas carpetas (app, lib y skin) se añade al directorio de instalación de Magento, incluyendo la extensión Biocryptology Login a la plataforma de Magento. Tras instalar la extensión Biocryptology Login para Magento 1.x, debes configurarla para su correcta integración y operación. 2018 Biocryptology. Todos los derechos reservados. 20
Configuración de Biocryptology Login Configuración de Biocryptology Login Una vez instalado Biocryptology Login for Magento 1.x, es necesario configurarlo para su correcta integración con el comercio electrónico deseado. El proceso de configuración se realiza tanto desde el panel de control (dashboard) del administrador web en Magento, como desde el área privada de Biocryptology, por lo que es necesario estar previamente registrado en Biocryptology (www.biocryptology.com). Puedes obtener tu cuenta de Biocryptology al iniciar por primera vez la app, siguiendo las instrucciones del asistente. Durante el proceso de registro, únicamente tendrás que indicar una dirección de correo electrónico y un número de teléfono válidos. Para más información, consulta la información facilitada en la página web de soporte de Biocryptology (https://support.biocryptology.com). Para configurar Biocryptology Login en comercios electrónicos desarrollados en Magento 1.x, realiza los siguientes pasos: 1. Inicia sesión en Magento 1.x con permisos de administrador: Para realizar este proceso será necesario tener abiertas las sesiones de usuario de Biocryptology y Magento de manera simultánea. Para mayor comodidad, te recomendamos utilizar pestañas distintas dentro del navegador web utilizado. 1a. Accede con tu nombre de usuario y contraseña. 2018 Biocryptology. Todos los derechos reservados. 21
Configuración de Biocryptology Login 2. Accede a los ajustes de configuración de Biocryptology Login: 2a. En el panel de control (dashboard) de Magento 1.x, selecciona el menú System. 2b. Luego selecciona el submenú Configuration. 2c. Selecciona la opción Biocryptology Login > Biocryptology Login Configuration. 2018 Biocryptology. Todos los derechos reservados. 22
Configuración de Biocryptology Login 3. Establece los ajustes de configuración adecuados para el correcto funcionamiento de Biocryptology Login. 3c. Pulsa en Save Config para completar la activación de la extensión Biocryptology Login. Ve a tu cuenta de Biocryptology. 3a. Selecciona Yes en la lista desplegable Enable Biocryptology Login para activar la extensión (plugin). Se mostrarán opciones adicionales de configuración. 3b. Copia las URL facilitadas en los campos Post Login URL y Post Logout URL. En el campo Logout URL se muestra por defecto la página de inicio del comercio electrónico correspondiente para redirigir a los usuarios tras cerrar sesión. Este campo es editable de acuerdo con las preferencias del administrador. 2018 Biocryptology. Todos los derechos reservados. 23
Configuración de Biocryptology Login 4. Accede a tu cuenta de usuario de Biocryptology y habilita Biocryptology Login para Magento 1.x dentro de los ajustes de configuración de tu dominio. 4a. En una pestaña nueva del navegador, inicia sesión en Biocryptology a través de https://id.biocryptology.com. Recuerda que para iniciar sesión necesitas tener instalada la app de Biocryptology para escanear el código QR que aparece en pantalla. 4b. En el menú My domains pulsa el botón Plugins para configurar y asignar Biocryptology Login para Magento 1.x al dominio deseado. Para configurar Biocryptology Login primero has de dar de alta tu dominio en Biocryptology. 2018 Biocryptology. Todos los derechos reservados. 24
Configuración de Biocryptology Login 4c. Selecciona una imagen que represente al comercio electrónico desarrollado con Magento (campo opcional). 4d. Campo que automáticamente muestra el dominio asociado. 4e. Indica un nombre descriptivo para el comercio electrónico donde se va a integrar Biocryptology (campo obligatorio). 4e. En el campo Callback URL to validate pega la URL copiada del campo post login URL (ver paso 3b) para redirigir al usuario tras iniciar sesión con Biocryptology. 4f. En el campo Callback URLs pega la URL copiada del campo post logout URL (ver paso 3b), y redirigir al usuario tras cerrar sesión con Biocryptology. 4g. Una vez completados los campos, pulsa Save para habilitar y guardar la configuración. Puedes añadir más URL a este campo con el botón Add URL. 2018 Biocryptology. Todos los derechos reservados. 25
Configuración de Biocryptology Login 4h. Biocryptology Login para Magento 1.x aparecerá en el listado de plugins dentro del dominio seleccionado. Pulsa el botón Edit correspondiente para acceder al detalle. 4i. Siempre que se habilita un nuevo plugin, el sistema le asigna automáticamente un identificador. Copia dicho identificador del campo Client ID. A continuación, regresa a Magento 1.x para copiar el identificador recientemente copiado. 2018 Biocryptology. Todos los derechos reservados. 26
Configuración de Biocryptology Login 5. Regresa a tu cuenta de Magento para finalizar el proceso de configuración indicando el identificador: 5a. Regresa al menú Biocryptology Login Configuration. 5b. Pega el identificador (previamente copiado en el paso 4i) en el campo Client ID. 5c. Pulsa el botón Save Config para finalizar el proceso. De esta manera, Biocryptology Login para Magento 1.x queda debidamente configurado. 2018 Biocryptology. Todos los derechos reservados. 27
Configuración de Biocryptology Login Tras instalar y configurar debidamente Biocryptology Login para Magento 1.x, el botón para iniciar sesión con Biocryptology aparecerá en la pantalla de inicio de sesión del comercio electrónico correspondiente. De esta manera, gracias a Biocryptology, se habilita un acceso para los usuarios, a través de una conexión segura. El diseño y ubicación del botón puede variar en función del plugin o sitio web. 2018 Biocryptology. Todos los derechos reservados. 28