Tareas iniciales

Antes de empezar con la instalación de phpMyAdmin, realizaremos una serie de tareas de administración necesarias para que el proceso que vamos a describir en los siguientes apartados funcione correctamente:

• Instalar el paquete php56-bz2 de php en nuestro sistema utilizando el instalador de paquetes pkg sino lo tenemos instalado (librería de php necesaria para trabajar con archivos comprimidos bz2).

# pkg install php56-bz2

Si optamos por la opción del instalador de paquetes esta librería se instalará de forma automática.

• Necesitamos un usuario que pertenezca al grupo ‘www’ para subir al servidor los archivos que vamos a descargar de la web oficial, ya que en el directorio donde vamos a subir los archivos (DocumentRoot de apache) sólo tienen permiso de escritura los miembros de este grupo (y por supuesto el usuario administrador root).

Este usuario puede ser uno nuevo cuyo grupo sea www o añadir a este grupo un usuario existente como nuestro usuario super (lo creamos en el momento de instalar FreeBSD) con el que hemos estado trabajando durante todo el curso.

Crear un nuevo usuario:

• Utilizando el comando adduser crearemos un usuario que pertenezca al grupo www:

 $ su
Password:
# adduser
Username: usrweb
Full name: usuario con acceso al directorio www
Uid (Leave empty for default):
Login group [usrweb]: www
Login group is www. Invite usrweb into other groups? []:
Login class [default]:
Shell (sh csh tcsh nologin) [sh]:
Home directory [/home/usrweb]: 
Home directory permissions (Leave empty for default):
Use password-based authentication? [yes]:
Use an empty password? (yes/no) [no]:
Use a random password? (yes/no) [no]:
Enter password:
Enter password again:
Lock out the account after creation? [no]:
Username  : usrweb
Password  : *****
Full Name : usuario con acceso al directorio www
Uid    : 1002
Class   :
Groups   : www
Home    : /home/usrweb
Home Mode :
Shell   : /bin/sh
Locked   : no
OK? (yes/no): yes
adduser: INFO: Successfully added (usrweb) to the user database.
Add another user? (yes/no): no
Goodbye!

Añadir el usuario super al grupo www:

• Para esta tarea utilizaremos el comando pw (revisar tema un poco de FreeBSD) que permite la gestión de usuarios.

# pw groupmod www –M super

Instalar phpMyAdmin

Ir a la página de descargas de la web oficial de phpMyAdmin para obtener la última versión (Enlace descargas phpMyAdmin).

Descargar el archivo para todos los lenguajes en formato zip (en el momento de realizar esta documentación es phpMyAdmin-4.5.4.1-all-languages.zip).

Descomprimir el archivo y renombrar la carpeta que nos crea con el nombre phpMyAdmin.

Antes de iniciar el proceso de subida (upload) del phpMyAdmin descargado, tendremos que modificar los permisos y grupo del directorio www de Apache.

# cd /usr/local/
# chgrp -R www www     → Cambiamos el grupo al que pertenecen todos los archivos ← 
# chmod –R 775 www     → Cambiamos los permisos del directorio www ← 

Subir phpMyAdmin a nuesto servidor

Abrir el programa WinSCP (ver tema Introducción y Software necesario) e iniciar sesión en nuestro servidor indicando la ip que tenga asignada y como usuario usrweb o super.

Cuando se inicie la sesión, se nos mostrará la ventana principal de WinSCP, con dos paneles. El panel de la izquierda representa el árbol de carpetas de nuestro ordenador y el de la derecha el de nuestro servidor.

Desplazarnos dentro del panel izquierdo hasta donde tenemos descomprimido el paquete de phpMyAdmin y en el panel de la derecha desplazarnos hasta el directorio DocumentRoot inicial de nuestro servidor web que estaba establecido en el directorio /usr/local/www.

Pulsaremos con el botón derecho sobre la carpeta de phpMyAdmin y ejecutaremos la orden ‘Upload..’ para subir la carpeta que hemos renombrado de nuestro pc al servidor.

Nos solicitará confirmación para iniciar la subida de archivos. Tras confirmar la subida se iniciará el proceso de transferencia de archivos y al finalizar tendremos en nuestro servidor copiado phpMyAdmin en la carpeta DocumentRoot.

Una vez finalizado el proceso, editaremos el fichero de configuración de apache (httpd.conf) para crear un alias a la ruta donde hemos descargado phpMyAdmin. Este proceso lo podemos ver en el siguiente apartado del módulo donde se describe como realizar la instalación por medio del comando pkg.

Instalar el paquete phpmyadmin

Para instalar el paquete de phpMyAdmin en nuestro servidor utilizaremos el comando pkg.

# pkg install phpmyadmin
Updating FreeBSD repository catalogue...
Fetching meta.txz: 100%    944 B   0.9kB/s    00:01
Fetching packagesite.txz: 100%    5 MiB   2.8MB/s    00:02
Processing entries: 100%
FreeBSD repository update completed. 24679 packages processed.
The following 2 package(s) will be affected (of 0 checked):

New packages to be INSTALLED:
 phpMyAdmin: 4.5.4
 php56-bz2: 5.6.18
The process will require 32 MiB more space.
6 MiB to be downloaded.

Proceed with this action? [y/N]: y
Fetching phpMyAdmin-4.5.4.txz: 100%    6 MiB   3.0MB/s    00:02
Fetching php56-bz2-5.6.18.txz: 100%   11 KiB  10.8kB/s    00:01
Checking integrity... done (0 conflicting)
[1/2] Installing php56-bz2-5.6.18...
[1/2] Extracting php56-bz2-5.6.18: 100%
[2/2] Installing phpMyAdmin-4.5.4...
===> Creating users and/or groups.
Using existing group 'www'.
[2/2] Extracting phpMyAdmin-4.5.4: 100%
Message from phpMyAdmin-4.5.4:
phpMyAdmin-4.5.4 has been installed into:

    /usr/local/www/phpMyAdmin

Please edit config.inc.php to suit your needs.

To make phpMyAdmin available through your web site, I suggest
that you add something like the following to httpd.conf:

For Apache versions earlier than 2.4:

    Alias /phpmyadmin/ "/usr/local/www/phpMyAdmin/"

    <Directory "/usr/local/www/phpMyAdmin/">
    Options none
    AllowOverride Limit
    
      Order Deny,Allow
    Deny from all
    Allow from 127.0.0.1 .example.com
  </Directory>

For Apache version 2.4.x or above:

  Alias /phpmyadmin/ "/usr/local/www/phpMyAdmin/"
  
   <Directory "/usr/local/www/phpMyAdmin/">
    Options None
    AllowOverride Limit
    
      Require local
    Require host .example.com
  </Directory>
  
SECURITY NOTE: phpMyAdmin is an administrative tool that has had several
remote vulnerabilities discovered in the past, some allowing remote
attackers to execute arbitrary code with the web server's user credential.
All known problems have been fixed, but the FreeBSD Security Team strongly
advises that any instance be protected with an additional protection layer,
e.g. a different access control mechanism implemented by the web server
as shown in the example.  Do consider enabling phpMyAdmin only when it
is in use.

Como se puede comprobar con esta opción nos ahorramos las tareas iniciales de instalar la librería bz2,  crear un usuario del grupo www y subir los archivos al servidor.

Si nos fijamos en las últimas líneas de instalación del paquete, se nos indica que tenemos que editar el archivo de configuración httpd.conf de Apache para crear el Alias que nos permita acceder a la aplicación web que hemos instalado. Este paso es obligatorio ya que los archivos de phpMyAdmin no se instalan en la carpeta DocumentRoot de nuestro servidor web.

Establecer permisos para el grupo www

Antes de iniciar este proceso tendremos que dar permisos de lectura/escritura a los miembros del grupo www sobre los archivos de la carpeta donde se ha instalado phpMyAdmin.

→ Acordaos que Si la instalación la hemos realizado subiendo por ftp los archivos la ruta será otra ←
# cd /usr/local/www/phpMyAdmin 
→ Cambiamos el grupo al que pertenecen todos los archivos ←
# chgrp -R www .

Editar fichero de configuración de Apache

Una vez cambiado el grupo de los archivos de phpMyAdmin, editamos el archivo de configuración de Apache y realizamos los cambios.

# cd /usr/local/etc/apache24
# ee httpd.conf

→ Nos desplazaremos hasta el final del archivo e incluiremos las siguientes líneas ←
# Creamos dos alias para que se pueda acceder tanto en minúsculas como en mayúsculas
Alias /phpmyadmin /usr/local/www/phpMyAdmin/
Alias /phpMyAdmin /usr/local/www/phpMyAdmin/
<Directory /usr/local/www/phpMyAdmin/>
 Options None
 AllowOverride none
 Require all granted
</Directory>

→ Guardamos los cambios y reiniciamos el servidor Apache ←

# apachectl restart
Performing sanity check on apache24 configuration:
Syntax OK
Stopping apache24.
Waiting for PIDS: 1176.
Performing sanity check on apache24 configuration:
Syntax OK
Starting apache24.

Ya estamos preparados para iniciar sesión en phpMyAdmin.

Abrimos nuestro navegador e indicamos la dirección de  nuestro servidor seguido de /phpmyadmin. Si todo funciona se nos mostrará la pantalla de inicio con la que tendremos que indicar un usuario de MySQL y su clave para acceder al mantenimiento de nuestro servidor MySQL.

Para nuestro primer acceso como aún no hemos creado usuarios de MySQL, tendremos que acceder con el usuario root de MySQL que configuramos en el tema de instalación de MySQL.

Cuando accedamos a la aplicación web, podremos observar las bases de datos existentes en el panel de la izquierda, información acerca del sistema en el que estamos trabajando en el panel de la derecha y en la parte inferior unas leyendas que nos recuerdan que phpMyAdmin todavía no está configurado de forma correcta.

Estas configuraciones son las que vamos a tratar en el siguiente apartado de este módulo.

Crear la base de datos phpmyadmin

Para crear la base de datos ‘phpmyadmin’ y sus tablas, phpMyAdmin nos ofrece un script sql llamado create_tables.sql que se encuentra en el directorio phpMyAdmin/sql.

Para llevar a cabo la ejecución del script sql, iniciaremos una sesión de mysql desde consola.

# cd /usr/local/www/phpMyAdmin/sql
# mysql -u root -p < create_tables.sql
Enter password:
#

Finalizado el script, tendremos una nueva base de datos en nuestro servidor MySQL.

Ahora es el momento de asignarle a la base de datos ‘phpmyadmin’ que acabamos de crear, un usuario al que le otorgaremos todos los permisos necesarios para administrarla. Esta tarea la podemos realizar de dos formas distintas:

• Con una sesión de consola de mysql.
• Desde el propio phpMyAdmin

Crear usuario y otorgar permisos desde consola

# mysql -u root -p
Enter password:
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 15
Server version: 5.7.10 Source distribution

Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

→ Creamos el usuario con la sentencia CREATE USER ←

mysql> CREATE USER 'pma'@'localhost' IDENTIFIED BY 'password'; → Indicar el password del usuario ←
Query OK, 0 rows affected (0.00 sec)

→ Otorgamos todos los permisos sobre la base de datos con la sentencia GRAN ALL PRIVILEGES ←

mysql> GRANT ALL PRIVILEGES ON `phpmyadmin`.* TO 'pma'@'localhost';
Query OK, 0 rows affected (0.00 sec)
mysql> quit
Bye
#

Crear usuario y otorgar permisos desde phpMyAdmin

Iniciamos sesión en phpMyAdmin como root.

Seleccionamos de la lista de bases de datos del servidor la base de datos ‘phpmyadmin’.

Pulsamos sobre la ficha ‘Privilegios’ para mostrar la lista de todos los usuarios con acceso a ‘phpmyadmin’.

Pulsamos sobre el enlace ‘Agregar cuenta de usuario’ para añadir un nuevo usuario a la lista de usuarios con acceso a la base de datos.

Escribimos el nombre del usuario ‘pma’, servidor desde el que accede ‘localhost’ y la contraseña. Dejamos marcada la opción ‘Otorgar todos los privilegios para la base de datos "phpmyadmin"’ y pulsamos el botón Continuar.

Se nos informará de que se ha agregado un nuevo usuario, mostrándonos la instrucción SQL que se ha ejecutado, así como los privilegios que se le han concedido para la base de datos.

Como habréis podido comprobar el proceso es muy sencillo e intuitivo consiguiendo el mismo efecto que si lo hubiéramos realizado desde la sesión de consola de mysql.

Opciones de configuración de phpMyAdmin

phpMyAdmin tiene un archivo donde se almacenan opciones de configuración llamado config.inc.php que se encuentra en el directorio principal de phpMyAdmin.

Inicialmente este archivo nos lo encontraremos vacío, pero disponemos de un archivo llamado config.sample.inc.php que podemos utilizar de plantilla para realizar la configuración.

Lo primero que tenemos que hacer es desplazarnos hasta el directorio donde está instalado phpMyAdmin y realizar una copia de la plantilla config.sample.inc.php con el nombre config.inc.php.

# cd /usr/local/www/phpMyAdmin
# cp config.sample.inc.php config.inc.php

Una vez que tenemos la copia, editaremos el archivo config.inc.php para realizar los siguientes cambios:

• Establecer frase secreta (blowfish_secret), utilizada como semilla cuando se lleve a cabo la encriptación de contraseñas cuando se utilice la autentificación por medio de cookies
• Descomentar las líneas que hacen referencia a los ajustes de almacenamiento de configuración de phpMyAdmin.

A continuación os dejo una muestra de cómo quedaría el archivo de configuración:

<?php
/*
* This is needed for cookie based authentication to encrypt password in
* cookie
*/
$cfg['blowfish_secret'] = 'ax1@fH6(5jkz)lr69'; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

/*
* Servers configuration
*/
$i = 0;

/*
* First server
*/
$i++;
/* Authentication type */
$cfg['Servers'][$i]['auth_type'] = 'cookie';
/* Server parameters */
$cfg['Servers'][$i]['host'] = 'localhost';
$cfg['Servers'][$i]['connect_type'] = 'tcp';
$cfg['Servers'][$i]['compress'] = false;
$cfg['Servers'][$i]['AllowNoPassword'] = false;
/*
* phpMyAdmin configuration storage settings.
*/

/* User used to manipulate with storage */
$cfg['Servers'][$i]['controlhost'] = '';
$cfg['Servers'][$i]['controlport'] = '';
$cfg['Servers'][$i]['controluser'] = 'pma';
$cfg['Servers'][$i]['controlpass'] = 'password'; → Indicar el password del usuario pma ←
/* Storage database and tables */
$cfg['Servers'][$i]['pmadb'] = 'phpmyadmin';
$cfg['Servers'][$i]['bookmarktable'] = 'pma__bookmark';
$cfg['Servers'][$i]['relation'] = 'pma__relation';
$cfg['Servers'][$i]['table_info'] = 'pma__table_info';
$cfg['Servers'][$i]['table_coords'] = 'pma__table_coords';
$cfg['Servers'][$i]['pdf_pages'] = 'pma__pdf_pages';
$cfg['Servers'][$i]['column_info'] = 'pma__column_info';
$cfg['Servers'][$i]['history'] = 'pma__history';
$cfg['Servers'][$i]['table_uiprefs'] = 'pma__table_uiprefs';
$cfg['Servers'][$i]['tracking'] = 'pma__tracking';
$cfg['Servers'][$i]['userconfig'] = 'pma__userconfig';
$cfg['Servers'][$i]['recent'] = 'pma__recent';
$cfg['Servers'][$i]['favorite'] = 'pma__favorite';
$cfg['Servers'][$i]['users'] = 'pma__users';
$cfg['Servers'][$i]['usergroups'] = 'pma__usergroups';
$cfg['Servers'][$i]['navigationhiding'] = 'pma__navigationhiding';
$cfg['Servers'][$i]['savedsearches'] = 'pma__savedsearches';
$cfg['Servers'][$i]['central_columns'] = 'pma__central_columns';
/* Contrib / Swekey authentication */
// $cfg['Servers'][$i]['auth_swekey_config'] = '/etc/swekey-pma.conf';
/*
* End of servers configuration
*/

Una vez realizados los cambios, guardamos el archivo, cerramos el navegador y volvemos a cargar phpMyAdmin.

Si todo es correcto, los mensajes que nos mostraba la primera vez en la parte inferior de la página donde se nos advertía de que la configuración no estaba completa, tendrán que haber desaparecido.