Click here to load reader

Latch Mediawiki español

  • View
    92

  • Download
    0

Embed Size (px)

Text of Latch Mediawiki español

  • ElevenPaths, innovacin radical y disruptiva en seguridad

    ElevenPaths [email protected] elevenpaths.com

    Gua de instalacin y uso del plugin de Latch

    para MediaWiki

    Versin 7.1 Noviembre 2016

  • Gua de instalacin y uso del plugin Latch para MediaWiki

    V.7.1 Noviembre 2016

    Pgina 2 of 14 2016 Telefnica Digital Espaa, S.L.U. Todos los derechos reservados.

    CONTENIDO

    1 Obtencin del plugin Latch ....................................................................................... 3

    1.1 Requisitos previos ..................................................................................................................... 3

    1.2 Obtencin del identificador de la aplicacin ............................................................................ 3

    1.3 Descarga del plugin ................................................................................................................... 6

    2 Instalacin del plugin .................................................................................................. 7

    2.1 Configurar el plugin instalado ................................................................................................... 9

    2.2 Desinstalacin del plugin .......................................................................................................... 9

    3 Uso del plugin Latch por el usuario .......................................................................... 10

    3.1 Parear un usuario ................................................................................................................... 10

    3.2 Desparear un usuario ............................................................................................................. 12

    4 Recursos .................................................................................................................... 13

  • Gua de instalacin y uso del plugin Latch para MediaWiki

    V.7.1 Noviembre 2016

    Pgina 3 of 14 2016 Telefnica Digital Espaa, S.L.U. Todos los derechos reservados.

    1 Obtencin del plugin Latch

    1.1 Requisitos previos

    MediaWiki versin 1.25.1 1.26.3.

    1.2 Obtencin del identificador de la aplicacin

    Para obtener el Application ID y el Secret, fundamentales para integrar Latch en un servicio, es

    necesario contar con una cuenta de usuario desarrollador en Latch: https://latch.elevenpaths.com.

    Para ello, hay que situarse en la parte superior derecha de la pantalla y acceder a la seccin rea de

    desarrolladores.

    Figura 01: Situacin del rea de Desarrolladores en la pgina de Latch.

    A continuacin, se selecciona la pestaa Crear una nueva cuenta de desarrollador, donde aparecer un formulario que el usuario tendr que rellenar para realizar el registro como desarrollador. Los datos obligatorios son el nombre, el correo electrnico y la contrasea.

    Figura 02: Formulario de alta de desarrollador.

    https://latch.elevenpaths.com/

  • Gua de instalacin y uso del plugin Latch para MediaWiki

    V.7.1 Noviembre 2016

    Pgina 4 of 14 2016 Telefnica Digital Espaa, S.L.U. Todos los derechos reservados.

    Una vez completado, el desarrollador recibir un correo electrnico en la direccin que ha indicado,

    con un cdigo para activar la cuenta recin creada.

    Figura 03: Formulario para insertar el cdigo de activacin enviado al usuario.

    Activada la cuenta, el desarrollador ya est en disposicin de crear aplicaciones con Latch y acceder a la documentacin para desarrolladores, incluyendo los SDKs y los plugins existentes.

    Para ello el desarrollador debe iniciar sesin en la pgina web de Latch y acceder de nuevo a la seccin rea de desarrolladores (https://latch.elevenpaths.com/www/developerArea), desde donde podr observar sus aplicaciones, a travs de la seccin Mis aplicaciones del men lateral.

    Figura 04: Seccin Mis aplicaciones con las aplicaciones que haya configurado el usuario.

    Desde el botn Aadir una nueva aplicacin, el desarrollador crear una nueva aplicacin, siendo el nombre indicado, el que desea que aparezca en la aplicacin mvil de los usuarios finales.

    https://latch.elevenpaths.com/www/developerArea

  • Gua de instalacin y uso del plugin Latch para MediaWiki

    V.7.1 Noviembre 2016

    Pgina 5 of 14 2016 Telefnica Digital Espaa, S.L.U. Todos los derechos reservados.

    Figura 05: Creacin de una aplicacin. El nombre indicado se mostrar en la aplicacin mvil.

    Al crear la aplicacin, se muestra informacin acerca de la misma, siendo parte de ella editable. Los datos fundamentales que el desarrollador deber utilizar cuando instale el plugin son el ID de aplicacin y el Secreto. Adems existen los siguientes parmetros adicionales que el desarrollador podr modificar en cualquier momento, y que establecen las caractersticas de su aplicacin:

    Nombre: Se corresponde con el nombre de la aplicacin que vern los usuarios finales en sus dispositivos cuando pareen el servicio. Ellos mismos podrn personalizarlo en su propio dispositivo si as lo desean.

    Figura: Se corresponde con el icono de la aplicacin que aparecer en el dispositivo del usuario final, su tamao no debe superar 1MB. Se recomienda que est en formato png de 24 bits sin canal alfa, y que sus proporciones sean 1:1.

    2 factor OTP (One-time password): Solo est disponible para desarrolladores con un modelo de suscripcin que no sea de tipo Community. Posibilita que el servicio est protegido adems por una contrasea, que se le enviara al usuario final en el momento en que quisiera acceder al servicio. La configuracin del OTP puede ser:

    o Deshabilitado: No aparecera la opcin en el dispositivo mvil del usuario final.

    o Opcional: El usuario final podra elegir si desea utilizar esta opcin para proteger el servicio.

    o Obligatorio: El usuario final recibira una contrasea cada vez quisiera acceder al servicio.

    Bloquear tras consultar: Solo est disponible para desarrolladores con un modelo de suscripcin que no sea de tipo Community. Posibilita que el servicio se bloquee automticamente una vez que se ha accedido al mismo. La configuracin de esta opcin puede ser:

    o Deshabilitado: No aparecera la opcin en el dispositivo mvil del usuario final.

    o Opcional: El usuario final podra elegir si desea utilizar esta opcin para proteger el servicio.

    o Obligatorio: El servicio se bloquear automticamente una vez que se hubiera accedido al mismo. En este ltimo caso, la opcin Programar bloqueo desaparecera de la vista de detalles del servicio.

    Correo electrnico de contacto y telfono de contacto: Estos datos se mostrarn en las notificaciones que recibirn los usuarios cuando haya un intento de acceso fraudulento al servicio o a alguna de sus operaciones.

    Operaciones: Se corresponde con cada una de las acciones incluidas en el servicio pero independientes entre s, y que el desarrollador quiere proteger con Latch. La cantidad de operaciones que se pueden incluir depende del modelo de suscripcin elegido. En cada una de las

    https://latch.elevenpaths.com/www/subscription.htmlhttps://latch.elevenpaths.com/www/subscription.htmlhttps://latch.elevenpaths.com/www/subscription.htmlhttps://latch.elevenpaths.com/www/subscription.html

  • Gua de instalacin y uso del plugin Latch para MediaWiki

    V.7.1 Noviembre 2016

    Pgina 6 of 14 2016 Telefnica Digital Espaa, S.L.U. Todos los derechos reservados.

    operaciones se puede utilizar un "2 factor OTP" (OTP) y un Bloquear tras consultar (LOR). La creacin de operaciones no es obligatoria y depender de la naturaleza del servicio que se desea proteger.

    Este plugin no soporta el uso de operaciones. Para aadirlas es necesario realizar una implementacin a medida mediante el SDK del lenguaje correspondiente.

    Una vez finalizada la configuracin y guardados los cambios, la nueva aplicacin aparecer en el listado de aplicaciones del desarrollador. Este podr editarla en el momento que desee.

    Figura 06: Aplicacin creada. Se puede editar de nuevo para cambiar las caractersticas indicadas anteriormente.

    1.3 Descarga del plugin

    Desde el men lateral de la pgina para desarrolladores, el desarrollador podr acceder a la seccin Documentacin & SDKs y, dentro de este apartado, al de SDKs y plugins. Aqu el desarrollador puede observar los diversos enlaces a los SDKs de distintos lenguajes de programacin, as como a los plugins desarrollados hasta el momento.

    Figura 07: Ejemplo de SDKs y Plugins disponibles.

    Desde la seccin de Plugins Standard el desarrollador debe pulsar el botn DESCARGAR

    correspondiente a este plugin para acceder al cdigo fuente del mismo. Adems podr descargarse

    un manual de instalacin y uso del plugin.

  • Gua de instalacin y uso del plugin Latch para MediaWiki

    V.7.1 Noviembre 2016

    Pgina 7 of 14 2016 Telefnica Digital Espaa, S.L.U. Todos los derechos reservados.

    2 Instalacin del plugin

    Cuando el administrador ha obtenido el plugin, debe aadirlo a MediaWiki. Para conseguirlo debe copiar el contenido del plugin en la carpeta "extensions", situada en el directorio en el que se instal MediaWiki.

    Imagen 08: Subida del plugin de Latch a MediaWiki.

    El siguiente paso es abrir el fichero "LocalSettings.php" con un editor de texto cualquiera y copiar las siguientes instrucciones al final del mismo:

    require_once "extensions/Latch/LatchConf.php";

    require_once "extensions/Latch/LatchOTP.php";

    # Crate Latch DB tables

    $wgHooks['LoadExtensionSchemaUpdates'][] = 'SpecialLatch::fnMyHook';

    # Adds a link in the user's preferences menu

    $wgHooks['GetPreferences'][] =