Contents

Instalar DokuWiki como Wiki personal (Parte 3): Postinstalación de DokuWiki

Después de la anterior entrega del tutorial ya tendremos nuestra Wiki instalada y, si quisiéramos, lista para ponernos manos a la obra con la introducción de contenido. Si bien la configuración por defecto de DokuWiki nos ofrecerá una Wiki totalmente funcional, siempre es interesante sumergirnos en la configuración del software para intentar sacarle el máximo partido y conseguir adaptarla a nuestras necesidades.

/wp-content/uploads/2014/07/banner-tutorial-dokuwiki_-postinstalacion.png
Postinstalación de DokuWiki

Índice de tutoriales

  1. Preguntas y respuestas.
  2. Instalación de Apache, PHP y DokuWiki.
  3. Postinstalación de DokuWiki.

Antes de ponernos con los puntos más extensos de esta entrada, seguiremos una recomendación que veremos en varias entradas de la web de DokuWiki como esta, se trata de eliminar el archivo install.php una vez realizada la instalación:

1
$ sudo rm /var/www/dokuwiki/install.php

Advertencia “It seems your data directory is not properly secured”

Como norma general, inmediatamente después de instalar cualquier software, deberíamos consultar las recomendaciones de seguridad que el fabricante/desarrollador nos ofrece.

DokuWiki en su página de seguridad indica que los siguientes directorios no deberían ser accesibles desde el navegador:

  • /data
  • /conf
  • /bin
  • /inc

De hecho, si nos dirigimos a la sección de administración de nuestra recién instalada Wiki nos encontraremos con el siguiente error:

It seems your data directory is not properly secured. Please read http://www.dokuwiki.org/security

Dokuwiki dispone de archivos .htaccess que lo que harán será deshabilitar el acceso a estos directorios. El problema es que en una instalación estándar estos archivos** .htaccess** no se leerán puesto que **no están habilitados los Overrides de Apache**.

Para ello editaremos el archivo:

1
$ sudo nano /etc/apache2/sites-available/default

Dentro de este archivo buscaremos el apartado <Directory /var/www/> y dentro de este la configuración “AllowOverride”, que deberemos dejarla en:

1
AllowOverride all

Este cambio en la configuración hará que cuando se pida una página de un determinado directorio antes se consulte al archivo .htaccess del mismo (en caso de existir). Si navegamos a los anteriormente citados directorios que deben estar protegidos veremos que hay archivos .htaccess con este contenido:

1
2
order allow,deny
deny from all

Que impedirá que desde el navegador podamos ver los archivos contenidos en estas carpetas.

Para que se aplique la configuración deberemos recargar el servicio de Apache con:

1
$ sudo service apache2 reload

Podemos comprobar si nuestra seguridad está bien implementada intentando acceder al directorio bin (http://ip_del_servidor/dokuwiki/bin/) que debería darnos el siguiente error:

You don’t have permission to access /dokuwiki/bin/ on this server.

Después de eso, si nos dirigimos al área de administración veremos como ha desaparecido el error “It seems your data directory is not properly secured”.

Usar URL’s bonitas en Dokuwiki

Por defecto las URL’s en DokuWiki son carros enormes de caracteres, muy poco amigables, que no hacen más que estorbar en nuestra barra de direcciones del navegador. En DokuWiki podemos habilitar una opción llamada “URL’s bonitas” (Nice URL’s), que hará que, como su nombre indica, las URL’s sean más bonitas y amigables. Esta opción suele utilizarse por temas de posicionamiento web, puesto que los buscadores no son muy partidarios de estas rutas, pero aunque no queramos posicionar nuestra Wiki en Google puede ser interesante habilitar las Nice URL’s por temas estéticos.

Para ello, antes que nada, habilitaremos el módulo de rewrite a nivel de Apache:

1
$ sudo a2enmod rewrite

Después de esto, descomentaremos las líneas que contienen las reglas de los rewrite de URL en el archivo .htaccess.dist ubicado en el document root de DokuWiki:

1
$ sudo nano /var/www/dokuwiki/.htaccess.dist

Dejándolo así:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
## Uncomment these rules if you want to have nice URLs using
## $conf['userewrite'] = 1 - not needed for rewrite mode 2
RewriteEngine on
#
RewriteRule ^_media/(.*) lib/exe/fetch.php?media=$1 [QSA,L]
RewriteRule ^_detail/(.*) lib/exe/detail.php?media=$1 [QSA,L]
RewriteRule ^_export/([^/]+)/(.*) doku.php?do=export_$1&id=$2 [QSA,L]
RewriteRule ^$ doku.php [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule (.*) doku.php?id=$1 [QSA,L]
RewriteRule ^index.php$ doku.php
#
## Not all installations will require the following line. If you do,
## change "/dokuwiki" to the path to your dokuwiki directory relative
## to your document root.
RewriteBase /dokuwiki

Después renombramos el archivo para que nuestro servidor Apache lo interprete correctamente:

1
$ sudo mv /var/www/dokuwiki/.htaccess.dist /var/www/dokuwiki/.htaccess

Para finalizar, habilitaremos los rewrites desde nuestra instalación de DokuWiki:

Administrar > Parámetros de configuración > Parámetros avanzados

Y configuramos la sección userwrite y useslash así:

/wp-content/uploads/2014/07/niceurls-e1405718004594.png
Nice URL's en DokuWiki

Habilitar ACL’s

Puesto que este tutorial está orientado a la instalación de DokuWiki como Wiki personal es interesante habilitar el uso de ACL’s (control de acceso) en la plataforma.

Hacerlo es muy fácil, simplemente deberemos dirigirnos a:

Administrar > Parámetros de configuración > Parámetros de autenticación

Y habilitar la opción “Usar listas de control de acceso (ACL)”:

/wp-content/uploads/2014/07/acls.png
ACL's en DokuWiki

Conclusión

Ahora sí que sí tenemos nuestra flamante Wiki lista para ser llenada del contenido que queramos. Si tenéis curiosidad por seguir personalizando la plataforma recomiendo encarecidamente que os paséis por las secciones de plugins y templates para dejar aún más a tu gusto tu nueva Wiki.