Los CGI

Los CGI (Common Gateway Interface) son programas que se ejecutan en el servidor y permiten que se genere una p�gina web de forma din�mica.

�Puedo tener mis propios CGI?

S�, siempre que se cumpla:

1. Deben estar en un directorio cgi-bin de su web. Este directorio ha de tener permisos de ejecuci�n. Un CGI en un directorio sin permisos de ejecuci�n no funcionar�. Por ello deber� solicitar a [email protected] que le asigne este permiso de ejecuci�n al directorio.
2. Deben estar compilados para Windosw NT sobre plataformas Intel o bien estar escritos en Perl para Win 32 (versi�n de Active State).

Tenga en cuenta que el funcionamiento de sus propios CGIs es cuesti�n suya y no est� inclu�do en el soporte t�cnico de los servidores.

Permisos de ejecuci�n

Los CGI no pueden ser colocados en cualquier directorio y esperar que funcionen. Un CGI ha de estar en un directorio que tenga permisos de ejecuci�n de scripts, si se trata de un script en Perl, o de ejecuci�n de archivos exe (que incluye scripts) si se trata de un ejecutable.

El directorio cgi-bin al crearse y notificar la intencion de uso de cgi a [email protected] se le dispone de permisos de ejecuci�n y se eliminan los permisos de lectura y listado para proteger mejor los fuentes. Normalmente colocar� ah� sus propios CGI.

Escritura en el servidor

Si estos CGI han de escribir en algun fichero este ha de tener permisos de escritura. Por ello deber� solicitar a [email protected] que le asigne este permiso de escritura en los directorios que desee.

Por motivos de seguridad no es aconsejable que el directorio cgi-bin tenga permiso de escritura por lo que no debe crear CGI que escriban en el. Dirija sus escrituras contra un directorio de datos fuera de cgi-bin.

De todas formas, hay CGI disponibles freeware en Internet que escriben en archivos que se encuentran en el mismo directorio del Script. Esta es una pr�ctica poco recomendable. Para que estos CGI funcionen es necesario que al directorio en el que se encuentran se le asignen permisos de ejecuci�n y de escritura simult�neamente. Y esto constituye un importante agujero de seguridad para su sitio web.

�Hay alguna librer�a interesante de Perl en AdsoNet?

S�, se trata de CGI.pm. Facilita much�simo las tareas de la programaci�n de CGIs. La documentaci�n la puede encontrar http://www.genome.wi.mit.edu/ftp/pub/software/WWW/cgi_docs.html.

El Perl y Windows NT

Nuestros servidores funcionan sobre el sistema operativo Windows NT. Una de las ventajas del Perl es que al ser interpretado es muy portable. Sin embargo no lo es del todo. Hay funciones de la biblioteca est�ndar que s�lo existen en sistemas Unix y no en Windows NT.

Debe tener esto en cuenta y que no se puede garantizar que los scripts en Perl que encuentre en Intenet vayan a funcionar sin cambios en Windows NT. Hay algunos que s�, pero normalmente es porque est�n dise�ados con idea de portabilidad desde el principio.

Adem�s, los CGI de terceros casi siempre requieren una adaptaci�n previa (customize) para que funcionen. El motivo es que suelen depender de par�metros como rutas de directorios, nombres de archivos, etc. Por suerte, la zona de customizaci�n suele estar clara en la mayor�a de los scripts y consiste simplemente en cambiar valores de ciertas variables.

La versi�n de Perl for Win32 de que disponemos es la de ActiveState y procuramos que est� actualizada.

Tenga en cuenta los siguientes puntos si piensa utilizar scripts en Perl que est�n escritos para Unix:

En Unix el int�rprete de un script se lanza seg�n la informaci�n de la primera l�nea, mientras que en Windows NT es seg�n la extensi�n del archivo. Por ello, todos los scripts CGI en Perl deben llevar la extensi�n .pl y no la extensi�n .cgi
• En Windows NT no existe el comando MAIL que env�a archivos por email mediante una tuber�a. Aqu� es necesario utilizar Blat (vea m�s adelante la secci�n dedicada a �l).
• El servidor Web de Microsoft (IIS) es "Non parsed header" (NPH), lo que significa que cuando ejecuta un CGI no env�a ninguna cabecera. Muchos scripts para UNIX asumen que el sevidor web enviar� la cabecera, por lo que tal vez deba retocarlos. Los env�os de informaci�n deber�an comenzar de esta forma (o con otra cabecera):

          print "HTTP/1.0 200 OK\n";
          print "Content-type: text/html\n\n";               

  El m�dulo de biblioteca CGI.pm resuelve estos problemas de forma elegante (Vea m�s adelante).

�Por qu� no funcionan los CGI?

La experiencia dice que en la gran mayor�a de los casos es por culpa de los permisos. Si el CGI intenta hacer algo para lo que no tiene permiso (mayormente, escribir alg�n dato), terminar� silenciosamente.
• Otra causa de los problemas puede ser la extensi�n del archivo (tiene que ser .pl y no vale .cgi).
• Aseg�rese de que el script no utiliza caracter�sticas de Unix que no est�n en Windows NT, como el MAIL.
• Otra fuente de problemas son las rutas de directorio.
  En Unix se escriben de la siguiente forma: ($mypath = '/usr/bin/mydir';) Sin embargo, en Windows NT hay que usar el separador de directorios \ y comenzar las rutas absolutas por la letra de unidad. Es decir, la ruta anterior podr�a quedar de esta forma: ($mypath = 'c:\usr\bin\mydir';) Suponiendo que existiese el directorio c:\usr. Hay muchos directorios est�ndar en Unix que no existen en Windows NT.
  • Cuando utilice rutas de este tipo tenga mucho cuidado con el tipo de comillas que utiliza para la cadena. Si utiliza comillas dobles (a veces es necesario si el path utiliza una variable) entonces debe utilizar \\ para evitar la interpolaci�n. Nuestro ejemplo quedar�a de la siguiente forma con comillas dobles: ($mypath = "c:\\usr\\bin\\mydir";)
  • Piense en las sentencias de su script que escriben en archivos o leen de ellos como las mayores candidatas a provocar el error.
  • En Windows NT no es necesario saber la ruta del int�rprete Perl. Basta con que el script tenga la extensi�n .pl para que el servidor web encuentre y lance el int�rprete de Perl.

  Blat.exe (env�o por correo desde los scripts)

  La utilidad FreeWare Blat.exe es un programa que env�a correo electr�nico y que funciona con opciones desde la l�nea de comandos, por lo que es ideal para ser utilizado desde scripts.

  El modo de funcionamiento es b�sicamente el siguiente:

  1. El mensaje que se quiere mandar por correo debe estar guardado en el disco duro. Por ello, normalmente guardaremos un temporal con el mensaje.
  2. Invocamos a blat con los par�metros necesarios. Por ejemplo:
     system ("blat.exe archivo -t [email protected] -f [email protected] -s \"El asunto\" ");
  3. Borramos el archivo temporal.

  Las opciones completas de blat son las siguientes:

  Blat <filename> -t <recipient> [optional switches (see below)]
  Blat -install <server addr> <sender's addr> [<try>[<port>[<profile>]]] [-q]
  Blat -profile [-delete | "<default>"] [profile1] [profileN] [-q]
  Blat -h [-q]
  
  -install <server addr> <sender's addr> [<try n times> [<port> [<profile>]]]
  : set's SMTP server, sender, number of tries and port for profile
  (<try n times> and <port> may be replaced by '-').
  
  <filename> : file with the message body ('-' for console input, end with ^Z)
  -t <recipient> : recipient list (comma separated)
  -s <subj> : subject line
  -f <sender> : overrides the default sender address (must be known to server)
  -i <addr> : a 'From:' address, not necessarily known to the SMTP server.
  -c <recipient> : carbon copy recipient list (comma separated)
  -b <recipient> : blind carbon copy recipient list (comma separated)
  -o <organization>: Organization field
  -h : displays this help.
  -q : supresses *all* output.
  -noh : prevent X-Mailer header from showing homepage of blat
  -noh2 : prevent X-Mailer header entirely
  -p <profile> : send with SMTP server, user and port defined in <profile>.
  -server <addr> : Specify SMTP server to be used. (optionally, addr:port)
  -port <port> : port to be used on the server, defaults to SMTP (25)
  -hostname <hst>: select the hostname used to send the message
  -mime : MIME Quoted-Printable Content-Transfer-Encoding.
  -uuencode : Send (binary) file UUEncoded
  -base64 : Send (binary) file using base64 (binary Mime)
  -try <n times> : how many time blat should try to send. from '1' to 'INFINITE'
  -attach <file> : attach binary file to message (may be repeated)
  -attacht <file>: attach text file to message (may be repeated)
  
  Note that if the '-i' option is used, <sender> is included in 'Reply-to:'
  and 'Sender:' fields in the header of the message.      

  La URL que mantiene actualmente el programa es http://www.interlog.com/~tcharron/blat.html

  La biblioteca CGI.pm

  Se trata de un m�dulo orientado a objetos de enorme utilidad si uno piensa dedicarse al desarrollo de CGIs en Perl. B�sicamente sustituye con ventaja a la biblioteca cgi-lib.

  Como est� disponible en la biblioteca, no es necesario colocar el m�dulo en el servidor. Se puede usar directamente mediante una sentencia use. Lo que s� es imprescindible es estudiar la documentaci�n. Puede encontrar todo lo referente a esta biblioteca en http://stein.cshl.org/WWW/software/CGI/cgi_docs.html.

  Ejemplo de uso

  use CGI qw(:standard :nph);	Aqu� se incluye el m�dulo en la forma nph
  $query = new CGI;	creamos un objeto CGI
  print $query->header;	Esto env�a las cabeceras adecuadas
  print $query->start_html();	Esto env�a los tags HTML hasta el <body> incluido.
  print "<h1>Hola amigos</h1>";	Esto se muestra en la p�gina web
  print $query->end_html();	Muestra el </body> y el </html>.

  CGI FormMail.pl

  Usted no tiene acceso al c�digo de dichos CGI, aunque s� puede usarlos a trav�s de su URL. En el panel de control encontrar� asistentes gr�ficos que le permiten generar c�modamente el c�digo HTML tanto de contadores como de formularios

  Caracter�sticas

  Se trata de una adaptaci�n del CGI de dominio p�blico FormMail disponible en http://www.worldwidemart.com/scripts con los siguientes cambios y mejoras:

  Adaptado a Windows NT. Se cambia la tuber�a con MAIL de Unix por una llamada a Blat.exe
  • Adaptado a un servidor web NPH (non parser header). Hay que hacer que el CGI env�e todas las cabeceras.
  • Chequeo de cuentas bancarias y tarjetas de cr�dito. Si en el formulario existen controles de nombres especiales dispuestos para meter n�meros de cuentas bancarias espa�olas o tarjetas de cr�dito, el CGI puede hacer una validaci�n algor�tmica de los n�meros y no enviar el formulario si son incorrectos.

  Modo de uso

  En la marca FORM del formulario hay que poner lo siguiente:

  <form action="http://cgi.adso.net/FormMail.pl">

  Los par�metros del formulario se introducen mediante campos ocultos (tags tipo hidden). Los campos ocultos y la informaci�n que suminitran es la siguiente:

  <input type=hidden name=recipient [email protected]>
  La variable de nombre recipient contiene la direcci�n email a la que se enviar�n los campos del formulario. Cambie [email protected] por la direcci�n de correo que recibir� los campos del formulario.
  • <input type=hidden name=subject value="El asunto del mensaje">
    La variable de nombre subject contiene el asunto del mensaje de correo que se enviar�. Util para clasificar los mensajes provenientes del formulario.
  • <input type=hidden name=redirect value=http://www.dominio.com/FinFormulario.html>
    La variable de nombre redirect contiene la direcci�n web de la p�gina que se mostrar� tras el env�o del formulario. Si esta variable no est� definida, se muestra una p�gina por defecto.
  • <input type=hidden name=required value="campo1,campo2">
    La variable de nombre required contiene los nombres de los campos del formulario en los que es obligatorio introducir datos. Cambie campo1, campo2, etc. por los nombres reales de los campos obligatorios.
  • <input type=hidden name=sort value="order:campo1,campo2">
    Esto permite ordenar los campos del formulario en el mensaje de correo electr�nico recibido.

  Adem�s, si se introduce en el formulario un campo cuyo nombre sea email, los mensajes de correo proceder�n del valor de dicha variable. En otras palabras, si en el formulario sus usuarios han de poner su direcci�n de correo, llame a dicho campo email para que los mensajes que reciba provengan de la direcci�n de correo de los usuarios y se puedan contestar f�cilmente.

  Validaci�n de cuentas bancarias y tarjetas de cr�dito

  La validaci�n se realiza bas�ndose en los nombres de los campos. Para las cuentas bancarias, los nombres deben ser:

  CCC-Entidad. Para el c�digo de 4 cifras de la entidad bancaria
  • CCC-Oficina. Para el c�digo de 4 cifras de la oficina
  • CCC-Dc. Para los 2 d�gitos de control
  • CCC-Cuenta. Para los 10 d�gitos de la cuenta

  Si existen campos con los nombres anteriores, el CGI verificar� la validez algor�tmica de la cuenta y dar� un error si no es correcta.

  Para las tarjetas de cr�dito los campos deben ser:

  CreditCard debe ser el nombre de la variable que contiene el tipo de tarjeta y los valores posibles han de ser Visa, MasterCard, Discover o AmericanExpress. Lo mejor es poner un campo tipo Select para obtener estos valores.
  • CreditCardNumber es la variable que contiene el n�mero de la tarjeta.

  El CGI valida que el n�mero corresponda al tipo de tarjeta especificado y que sea algor�tmicamente correcto.

  Uso del CGI de formularios con FrontPage

  Si utiliza FrontPage para crear sus p�ginas, puede utilizar el CGI de formularios mediante el cuadro de di�logo de Propiedades de Formulario.

  Pulse con el bot�n derecho del rat�n sobre el formulario y escoja la opci�n Propiedades de Formulario. Despu�s elija enviar a secuencia de comandos CGI personalizada. Haga click en opciones y en el campo Accion escriba la direcci�n web del CGI: cgi.adso.net/FormMail.pl . Como m�todo escoja POST.

  Con esto el CGI recibir� los datos del formulario, pero no funcionar� a menos que especifique las variables nombradas anteriormente mediante campos ocultos (type=hidden). Vaya a la ventana de c�digo HTML y despu�s de la marca FORM introduzca las marcas correspondientes a los campos ocultos que se menciona en el p�rrafo anterior de uso con HTML.

  Naturalmente, la alternativa para los desarrolladores de FrontPage es utilizar las extensiones de FrontPage para enviar los datos del formulario bien a una direcci�n de correo o bien a un archivo.

  Puede ver un ejemplo operativo en http:www.adso.net/servicios/sugerencias.htm.

  ---

  Para cualquier duda no dejen de consultar a [email protected]

  ---