Download COFIGURACION DE APACHE _TOMCAT.

Document related concepts

no text concepts found

Transcript

COFIGURACION DE APACHE - TOMCAT COMO SERVIDOR WEB
INDEPENDIENTE
INDICE
1)---------------------------------------------------------------INSTALACION DE TOMCAT EN UN S.O WINDOWS
2)---------------------------------------------------------------MODIFICACION DEL ARCHIVO SERVER.XML
2.1)-----------------------------------------------------------MODIFICAR EL SERVER.XML PARA QUE TOMCA
ESCUCHE POR EL PUERTO DE INTERNE(80)
2.2)----------------------------------------------------- MODIFICAR EL SEVER.XML PARA CONECXIONES
SEGURAS (SSL)
2.3)----------------------------------------------------- MODIFICAR EL SERVER.XML PARA CREAR UN HOST
VIRTUAL
3) ---------------------------------------------------------CREACION E INSTALACION DE CERTIFCADOS VALIDOS
3.1) --------------------------------------------------INDICARLE AL TOMCAT QUE PAGINAS DE LA
APLICACIÓN SE SIRVE OBLIGATORIAMENTE POR EL PUERTO SSL.
4) ---------------------------------------------------------COFIGURAR EL MANAGER PARA ACCESO LOCAL
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 1
INSTALACION DE APACHE -TOMCAT EN UN S.O WINDOWS.
Se asume que el lector ya ha descargado el archivo binario de instalación de tomcat par Windows.
De no ser así lo puedes des cargar de este en lace.
Una vez descargado el archivo lo descomprimes y mueves la carpeta descomprimida a un sitio de
fácil acceso.
Dentro de la carpeta descomprimida viene un archivo tomcat.exe dale dobleclik para que inicie la
instalación del tomcat.
Durante la instalación te pedirá: La ruta de la carpeta de instalación puedes escoger una o dejar la
que aparece allí, el nombre del administrador y la contraseña y el puerto de escucha que debe ser
el puerto 80.
Cuando termina el proceso de instalación para verificar que tomcat quedo bien instalado abre una
ventana en tu navegador y escribe http://localhost y luego pulsa enter te debe aparecer la
ventana de inicio de tomcat de no ser si quiere decir que hay algún error; es posible que durante
la instalación se halla pasado por alto el argumento del puerto de escucha(80) y por esta razón no
lo modifico en el archivo serve.xml, de ser este el problema tocara modificar el archivo
manualmente. Si el problema es el mencionado entonces escribe en tu navegador lo siguiente:
http://localhost:8080 y te debe aparecer la ventana de inicio de tomcat, si no es asi quiere desir
que el tomcat no instalo correctamente y hay que desinstalarlo.
Ventana de inicio de tomcat.
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 2
ARAQUE MANUAL DEL TOMCAT
En al guanas ocasiones el instalador que viene con el tomcat no funciona correctamente y
por esta razón toca iniciar el tomcat manualmente.
Las líneas a continuación describen 2 archivos con extensión .bat que sirven para iniciar y
parar el tomcat.
-----------------------------<archivo para iniciarel tomcat>-------------------------------------------set catalina_home=E:\apache-tomcat-6.0.18
set tomcat_home=E:\apache-tomcat-6.0.18
set java_home=C:\Archivos de programa\Java\jdk1.6.0_10
set CLASSPATH=%JAVA_HOME%\lib\tools.jar
set jre_home=C:\Archivos de programa\Java\jdk1.6.0_10\jre
E:
cd apache-tomcat-6.0.18
cd bin
set catalina_base=E:\apache-tomcat-6.0.18
startup
------------------------------------------------------------------------------------------------------------------------------------------------------------<archivo para detener al tomcat>------------------------------------------set java_home=C:\Archivos de programa\Java\jdk1.6.0_10
set jre_home=C:\Archivos de programa\Java\jdk1.6.0_10\jre
set catalina_home=E:\apache-tomcat-6.0.18
E:
cd apache-tomcat-6.0.18
cd bin
shutdown
--------------------------------------------------------------------------------------------------------------------------------
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 3
En estos archivos tienes que modificar las rutas de acceso a tu instalación de java(jdk y jre) y la
ruta en donde tienes guardado el tomcat. Por ejemplo: en estos archivos se asume que tomcat
está guardado en la unidad E: en la carpeta “apache-tomcat-6.0.18”.
catalina_home: Es pesifica la ruta en donde esta guardado el tomcat.
jre_home: Espesifica laruta en donde esta instalado el jre de java.
java_home: Espesifica la ruta endonde esta instalado el jdk de java.
Utiliza el bloc denotas o cualquier otro editor de texto para modificar estos archivos y los guardas
con extensión .bat
Una vez listos estos dos archivos puedes iniciar y parar el tomcat a tu gusto.
Modificando el server.xml
El server.xml es el archivo de configuración del tomcat así que cualquier cambio en las
definiciones para el servidor se debe realizar allí.
Haciendo que el servidor escuche por el puerto 80
Para modificar el sever.xml nos vamos ala carpeta de tomcat luego la carpeta conf y estado allí le
damos click derecho a el serve.xml y escogemos editar si aparece como opción, sino le damos abrir
con y escogemos bloc denotas. Cuando este listo es server.xml para editar buscamos en el cuerpo
del archivo este bloque de instrucciones:
 
<-- <Connector executor="tomcatThreadPool"
port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />-->
en donde te muestran dos opciones de conector para el http, el primero es más bien utilizado en
sistemas operativo que ejecutan un proceso a la vez el Segundo conector es para S.O que ejecutan
varios procesos a la vez como es el caso de Windows.
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 4
Entonces le quitamos el coment ario al segundo conector y cambiamos el número de puerto por el
que escucha las peticione http que dando así:
<Connector executor="tomcatThreadPool"
port="80" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="443" />
También hemos modificado el redirectPort="443" envista que el puerto para conexiones seguras
es el 443.
Modificando el sever.xml para conexiones seguras(ssl)
Enseguida del bloque anterior esta el bloque de códigos que nos permitirá realizar conexiones
segura en nuestro servidor tomcat. Posdata si el bloque de códigos no está enseguida búscalo en
el cuerpo del archivo.
Este es el bloque a modificar:

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS" />
El bloque de código modificado que dara asi:

Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 5
<Connector port="443" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true"
keystorePass="aqui escribes el password del almacén de claves"
clientAuth="false" sslProtocol="TLS" />
Donde keystorepass es la contraseña del almacén jks de donde tomcat lee los certificados. Es
tema lo tocaremos más adelante.
Modificando el server.xml para crear un host virtu
El uso de un host virtual se hace muy útil cuando tomcat esta funcionado como servidor principal
conectado al internet, un host virtual sirve para separar dominios y para indicarle directamente al
tomcat adonde debe ir cuando llega una petición desde internet. Estas son unas de las pocas
utilidades del host virtual.
Dentro del cuerpo del server.xml buscamos el siguiente bloque de código:


<Engine name="Catalina" defaultHost="localhost">

Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 6
<!-<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>
-->

<!-<Valve className="org.apache.catalina.valves.RequestDumperValve"/>
-->

<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"/>

<Host name="localhost" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

<!-<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 7
-->

<!-<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt" pattern="common" resolveHosts="false"/>
-->
</Host>
Que dando modificado de la siguiente manera:


<Engine name="Catalina" defaultHost="www.tudominio.com" >

<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>

<!-<Valve className="org.apache.catalina.valves.RequestDumperValve"/>
-->
<Host name="www.tudominio.com" appBase="www.tudominio.com"/>

<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"/>

<Host name="localhost" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

<!-<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
-->

<!-<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt" pattern="common" resolveHosts="false"/>
-->
</Host>
Realizados estos pasos nos vamos al directorio de instalación del tomcat y estando allí creamos un
nuevo directorio con el nombre www.tudominio.com y dentro de esta carpeta creamos un nuevo
directorio con el nombre ROOT. En esta carpeta se instala la aplicación principal del dominio. Para
instalar otras aplicaciones dentro de este host virtual lo único que hay que hacer es pegar el
directorio que contiene la aplicación en el directorio www.tudominio.com .
I de esta manera queda configurado el host virtual y así tenemos a nuestro tomcat es cuchando
peticiones para localhost y para www.tudominio.com de forma directa.
Puedes remplazar el bloque de código en tu archivo server.xml por el anterior cambiando
obviamente www.tudominio.com por un dominio real.
Creación e instalación de certificados validos.
Para la creación de certificados podemos utilizar la herramienta keytool de java pero por razones
de manejo prefiero utilizar Openssl.
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 9
Para utilizar OpenSsl hay que descargar la herramienta de este sitio:
http://www.openssl.org/related/binaries.html
Cuando hallas descargado los binarios de Openssl para Windows dale dolbleclik al
instalador y de allí en adelante la instalación es muy sencilla solo sigue los pasos que se te
indican.
Una vez instalado el Openssl procedemos a generar dos certificados con sus
correspondientes claves de la siguiente manera:
Desde la línea de comandos (cmd) utilizando la instrucion cd te posicionas en la carpeta en
donde se instalo Openssl y luego pasas al directorio bin que se encuentra allí dentro. E.j:
cd c:\Openssl
cd bin
Una vez se está dentro del directorio bin se ejecutan los siguientes comandos:
Nota: no es conveniente que copies y pegues las instrucciones siguientes en el cmd por que podría
genera errores de sintaxis. Es mejor que las escribas.
openssl req -x509 -newkey rsa:2048 -keyout cakey.pem -days 3650 -out cacert2.pem
esta instrucción genera un certificado público(cacer2.pem) que se deposita en el directorio
bin o en el directorio Openssl. Este certificado posteriormente lo utilizaremos como el
certificado de la CA certificadora para firmar nuestro certificado.
Nota: los comandos siguientes generaran archivos que se depositaran en el directorio bin o
en el directorio Openssl.
Listo el paso anterior procedemos a generar la clave privada para nuestro certificado:
openssl genrsa -des3 -out key_priv.pem -passout pass:tucontraseña 2048
Este comando genero un archivo key_priv.pem que contiene la clave privada de nuestro
certificado.
Listo el paso anterior procedemos a realizar la petición de firmado para nuestro certificado.
openssl req -new -subj "/DC=tudominio/DC=com/CN=www.tudominio.com" -key
key_priv.pem -passin pass:tucontraseña -out request_cer_ key_priv.pem
Listo el paso anterior procedemos a generar nuestro certificado:
Bueno antes de llevar a cabo este paso hacemos lo siguiente: Abrimos el bloc de notas y en el
escribimos las dos líneas siguientes:
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 10
basicConstraints = critical,CA:FALSE
extendedKeyUsage = serverAuth
Y lo guardamos con el nombre de confi.txt en el directorio bin.
Listo esto ejecutamos el siguiente comando:
openssl x509 -CA cacert2.pem -CAkey cakey.pem -req -in request_cer_ key_priv.pem days 3650 -extfile confi.txt -sha1 -CAcreateserial -out micerti.pem
Una vez ejecutado este comando se te pedirá la contraseña dela CA firmadora, esta contraseña
debe ser la misma que se avenido usando durante el proceso.
Listo el paso anterior procedemos a exportar nuestro certificado a un almacén pk12 para luego
ser importado al jks que es el almacén de certificados de java.
Para exportar nuestro certificado a un almacen pk12 realizamos el siguiente comando:
openssl pkcs12 –export –out micerti.pk12 -in micerti.pem -inkey
key_priv.pem
Una vez ejecutado este comando es posible que te pida una clave
entonces escribes la misma que se ha venido usando.
Luego de exportar el certificado a micerti.pk12 en la línea de
comando (cmd) agregamos a la variable de entorno la ruta al
directorio bin del jdk de java. E.j:
set path=%path%;c:java\jdk_5.1\bin
Una vez establecida la variable de entorno podemos utilizar
keytool de java si problemas.
Utilizamos el keytool de java para importar el primer certificado
que generamos que vendría siendo como ya dije la CA firmadora y
nuestro certificado que está almacenado en micerti.pk12
Primero importamos el certificado de la CA firmadora con el
siguiente comando:
Keytool –importcert –alias cualquiercosa –file cacert2.pem
Cuando ejecutes este comando se te pedirá la contraseña del jks la
escribes y luego te preguntara si confías en el certificado y entonces le
dices que sí.
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 11
A hora vamos a importar el certificado para el servidor:
keytool -importkeystore -srckeystore micerti.pk12 -srcstoretype PKCS12
La ejecución de este comando guarda el certificado en el jks predeterminado que genera keytool.
Nota: si no has ejecutado keytool antes es probable que el comando anterior sea rechazado de ser
así entonces ejecuta el comando siguiente: keytool -genkey -alias cualquiercosa cuando hallas
ejecutado este comando sete pedirá que ingreses unos datos; cundo sete pida la contraseña
escribe la misma que hemos venido usando. Luego ejecutas este comando para borrar la clave
recién creada keytool –delete –alias cualquiercosa –storepass micontraseña.
Si ya has usado keytool antes entonces verifica que la contraseña del almacén jks sea igual a la
que sea usado en el proceso. Con este comando puedes cambiar la contraseña keytool storepasswd -new clavenueva -storepass clavevieja”
Nota: es conveniente que en el almacén de claves solo estén los 2 certificados que hemos creado
para verificar que es asi utiliza este comando: keytool -list si hay certificados diferentes borralos
con este comando: keytool –delete –alias cualquiercosa –storepass micontraseña.
Listos todos estos pasos procedemos a instalar el certificado en el explorador para que lo
reconozca como certificado de confianza.
Antes de todo abre el archivo cacert2.pem con el bloc de notas y luego lo guardas como cacert.crt
Listo.. Entonces continuamos.
En Internet explorer se hace de la siguiente manera: abrimos una ventana del explorador ->nos
vamos a la pestaña de herramientas ->opciones de internet -> contenido -> certificados; estando
en la ventana de certificados te vas a la pestaña personal y allí le das al botón importar >examinar y buscas la carpeta donde tienes el archivo micerti.pk12 lo seleccionas y le das aceptar
y terminas el proceso de importación.
A hora te posicionas en la pestaña entidades de certificación raíz de confianza y le das clik al
botón importa ->examinar y buscas la carpeta en donde tienes el archivo cacert.crt lo seleccionas
y ledas aceptar y terminas el proceso de importación.
En Mozilla Firefox se hace de la siguiente manera: abrimos una ventana del explorador ->nos
vamos a la pestaña de herramientas ->opciones..-> Avanzado; estando en la ventana de Avazado
te vas a la pestaña cifrado y allí le das al botón ver certificados estando en esa ventana te
posicionas en la pestaña Sus certificados e importas el archivo micerti.pk12, luego te posicionas
en la pestaña Autoridades e importas el archivo cacert.crt
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 12
Indicarle al tomcat que paginas obligatoriamente se deben
servir por el puerto SSl
Para indicarle al tomcat que paginas atenderá obligatoriamente el
el puerto ssl se debe agregar al archivo web.xml de la aplicación
el siguiente bloque de código:
<security-constraint>
<web-resource-collection>
<web-resource-name>Entire Application</web-resource-name>
<url-pattern>/mipagina.jsp</url-pattern>
<url-pattern>/mipagina.html</url-pattern>
</web-resource-collection>
<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>
Donde caca element <url-pattern>/mipagina.jsp </url-pattern>
Especifica la dirección relativa de la pagina que debe ser
accedida por el puerto ssl. Puedes agregar todos los elementos
<url-pattern>/mipagina.jsp </url-pattern> que necesites.
Configuración del manager para acceso local
Para configurar el manager para acceso local lo único que debes hacer es
ir al archivo tomcat-user.xml que se encuentra en el directorio conf de
la carpeta en donde se instalo tomcat.
Abres el archivo tomcat-user.xml para editar con el bloc de notas y te
debe aparecer lo siguiente:
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
</tomcat-users>
Y lo modificas agregando las siguientes líneas:
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role rolename="manager"/>
<role rolename="admin"/>
<user username="miusuario" password="tu contraseña"
roles="admin,manager"/>
</tomcat-users>
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 13
La etiqueta <role rolename="nobre del role"/> se utilize para llamar alos
roles definidos en tomcat. Con la etiqueta <user username="miusuario"
password="tu contraseña" roles="admin,manager"/> defines un nobre de
usuario y una contraseña además defines los roles para el <tomcat-user>
que acabas de crear. Pueden haber tantos <tomcat-user> como desees y
definir roles diferentes para cada uno.
Para tener más idea sobre los reles que soporta el manager consulta la
documentación en línea de tomcat 6.0.x
Esta es la ventana principal del manager
Configurando el manager para un host virtual
Envista de que la
tomcat 6.0.x para
aquí presento una
pero que al final
información que viene en la documentación de
este tipo de configuración es un poco enredada
manera poco ortodoxa de hacer esta configuración
resulta ser una solución útil.
Para realizar esta configuración se siguen los siguientes pasos:
1. Te posisionas en el directorio conf de la carpeta de
instalación de tomcat.
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 14
2. Buscas un directorio de nombre “enginename” y dentro de este
directorio creas un nuevo directorio con el nombre exacto del
hos virtual creado en la sección anterior.
Si la carpeta enginename no esta lacreas y punto.
3. Abres el bloc de notas y en el copias lo siguiente:
<Context path="/manager" privileged="true"
docBase = "ruta ala carpeta de
instalacion/webapps/manager">
<Valve
className="org.apache.catalina.valves.RemoteAddrValve"
allow = "127 \ .0 \ .0 \ .1" />
</ Context>
4. guardas este archivo con el nombre manager.xml en la carpeta
del host virtual creada en el 2 paso; luego vuelves a guardar
el archivo en la misma carpeta con el nombre contex.xml
5. luego tevas al directorio webapps en lacarpeta de instalación
de tomcat y estado allí copias el directorio manager que allí
se encuentra.
6. Te vas a la carpeta base de tu host virtual y en ella pegas
el directorio manager que acabas de copiar.
Ahora ya tienes el manager funcionado para el local host y
para el host virtual.
Nota: si deseas acceder al manager de forma remota quita la
restricción allow=”127 \ .0 \ .0 \ .1” de los archivos
contex.xml y manager.xml y sería bueno que agregaras la ruta
relativa del manager al web.xml de la aplicación manager de
esta manera:
<security-constraint>
<web-resource-collection>
--------------------------------<url-pattern>/manager</url-pattern>
-----------------</web-resource-collection>
--------------------<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 15
Una vez el manager está instalado la Interfax principal te brinda
la posibilidad de: detener, reinicias y pausar las aplicaciones
instaladas en ese host virtual. Las funciones arriba mencionadas
solo son una parte de las funciones que brinda el manager.
Bueno y esto es todo..
Ha antes de terminar esto no va dentro del alcance del manual pero
sería bueno que lo tuviese en cuenta; para que tu host sea
encontrado en una consulta DNS debe estar inscrito en el archivo
host de window que se encuentra en la siguiente ruta:
C:\Windows\System32\drivers\etc, lo abres y te debe aparecer algo
asi:
# Copyright (c) 1993-2006 Microsoft Corp.
#
# This is a sample HOSTS file used by Microsoft TCP/IP for Windows.
#
# This file contains the mappings of IP addresses to host names. Each
# entry should be kept on an individual line. The IP address should
# be placed in the first column followed by the corresponding host name.
# The IP address and the host name should be separated by at least one
# space.
#
# Additionally, comments (such as these) may be inserted on individual
# lines or following the machine name denoted by a '#' symbol.
#
# For example:
#
#
102.54.94.97
#
38.25.63.10
127.0.0.1
rhino.acme.com
# source server
x.acme.com
# x client host
localhost
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 16
Bueno debajo de la instrucción “127.0.0.1 localhost” copias
la ip de tu maquina y al frente el nombre del host virtual
que hemos creado quedando a si:
127.0.0.1
localhost
Ip_de tu pc
www.tudominio.com
Bueno a hora si esto es todo…
CON ENTUSIASMO ESPERANDO LE SEA DE AYUDA A MUCHOS....
ESCRITO POR: JACKSON PEREA
19/10/2009
Este manual asido escrito por Jackson Perea, dueño de los derechos de autor, para
www.facilbus.com.
Página 17

Top subcategories

Top subcategories

Top subcategories

Top subcategories

Top subcategories

Top subcategories

Top subcategories

Download COFIGURACION DE APACHE _TOMCAT.