… y mi primera incursi\u00f3n en la ampliaci\u00f3n del programa.<\/p>\n
<\/p>\n
Tal y como tengo ahora mismo configurada la recepci\u00f3n de correo en taquiones.net<\/em> no tengo control sobre la comprobaci\u00f3n de los buzones locales; esa tarea est\u00e1 en manos del despachador real<\/em> de correo, exim4<\/em>, que hace lo que puede con ellos ya que no tiene posibilidad de rechazarlos en tiempo de conexi\u00f3n. qpsmtpd<\/em> ya los ha aceptado y se los ha pasado como si fuesen aceptables.<\/p>\n He estado buscando complementos que hiciesen dicha comprobaci\u00f3n y lo m\u00e1s parecido que he encontrado ha sido aliases <\/a>de Peter J. Holzer. Lo he descartado porque el archivo de alias usa las direcciones completas y no s\u00f3lo los nombres locales. Salvo eso est\u00e1 muy bien; expande los alias para que puedan ser reutilizados en otros complementos, como un gestor de listas de correo, se me ocurre, y permite tener opciones para dichas direcciones que tambi\u00e9n puede usar otras partes del programa.<\/p>\n Aunque tampoco es que tenga un mont\u00f3n de alias de correo en mis m\u00e1quinas prefiero no tener que aprender una s\u00edntaxis nueva. Si emplease el formato de alias de sendmail<\/a> ni lo hubiese dudado, pero como tambi\u00e9n estoy buscando una excusa para ponerme manos a la obra he empezado con ello. He creado un peque\u00f1o repositorio<\/a> que contendr\u00e1 el software y me facilitar\u00e1 empaquetarlo y he comenzado a revisar la documentaci\u00f3n:<\/p>\n Aunque estoy traduciendo plugin<\/em> por complemento en realidad no est\u00e1n ampliando el programa: son el programa<\/strong>.<\/p>\n qpsmtpd<\/em> est\u00e1 escrito de tal forma que si no se declara la carga de ninguno de ellos no sirve para nada. Incluso tiene uno llamado rcpt_to<\/em> que debe ser insertado a modo de centinela al final de la configuraci\u00f3n para que termine aceptando el mensaje de correo.<\/p>\n comenzando por cero.<\/li>\n<\/ul>\n El programa qpsmtd espera encontrarse los complentos en dos sitios:<\/p>\n Ejemplo de declaraci\u00f3n de complementos:<\/p>\n Todos descienden de la clase <\/p>\n que ya incluye al menos la funci\u00f3n plugin_name <\/em>que devuelve su nombre.<\/p>\n Tras cargar el complemento en el programa \u00e9ste lo inicializa llamando a la funci\u00f3n init()<\/em> si existe con los siguientes par\u00e1metros:<\/p>\n es una referencia al objeto que lo contiene de clase <\/p>\n y que se ha creado durante la carga.<\/li>\n es una referencia al objeto <\/p>\n .<\/li>\n es una lista de par\u00e1metros definidos en el archivo config\/plugins<\/em> separados por espacios en blanco.<\/li>\n<\/ul>\n Existe un mecanismo de acceso a archivos de configuraci\u00f3n disponible en cada funci\u00f3n con la cadena de m\u00e9todos<\/p>\n Siendo myconfig<\/em> el nombre del archivo y @lines<\/em> donde se recoge su contenido. El formato es sencillo: texto plano del que se descartan las l\u00edneas vac\u00edas y las que comiencen por el car\u00e1cter #<\/em>.<\/p>\n Estos archivos se leen durante el arranque de qpsmtpd<\/em> y pueden modificarse sin reiniciarlo.<\/p>\n Para registrar lo que ocurre durante la ejecuci\u00f3n los complementos disponen de un mecanismo que permite reunificar el destino de los mismos.<\/p>\n $loglevel<\/em> contiene los valores habituales para los servidores: LOGDEBUG, LOGINFO, LOGNOTICE, LOGWARN, LOGERROR, LOGCRIT, LOGALERT, LOGEMERG.<\/p>\n Los complementos disponen de un mecanismo de introspecci\u00f3n que les permite saber en qu\u00e9 punto est\u00e1n entre otras cosas. Todos son m\u00e9todos que heredan de Qpsmtpd::Plugin<\/em> y son:<\/p>\n retorna el nombre del complemento que est\u00e1 funcionando ahora.<\/li>\n retorna el nombre de la fase en la que est\u00e1 (nombre del anclaje).<\/li>\n : retorna el nombre del cliente tras la identificaci\u00f3n.<\/li>\n : retorna el mecanismo de identificaci\u00f3n empleado.<\/li>\n retorna el objeto Qpsmtpd::Connection<\/em> asociado a la conexi\u00f3n actual.<\/li>\n : retorna el objeto Qpsmtpd::Transaction<\/em> asociado a la transacci\u00f3n actual.<\/li>\n<\/ul>\n Para comunicar informaci\u00f3n entre complementos e incluso entre fases (hooks<\/em>) dentro de un mismo c\u00f3digo existe un mecanismo que permite almacenar y recuperar textos.<\/p>\n Se puede hacer tanto en una conexi\u00f3n (Qpsmtpd::Connection<\/em>) como en una transacci\u00f3n (Qpsmtpd::Transaction<\/em>). La conexi\u00f3n y la transacci\u00f3n se diferencian en su tiempo de vida. La primera comprende desde que se abre el puerto hasta que se cierra y la segunda abarca la recepci\u00f3n de un mensaje para despacho. Por si quedan dudas, una conexi\u00f3n puede comprender varias transacciones.<\/p>\n qpsmtpd<\/em> pone a disposici\u00f3n de los complementos un juego de funciones para manipular archivos temporales que luego se encarga de limpiar.<\/p>\n () retorna el nombre de un archivo temporal sin abrirlo.<\/li>\n crea y retorna un nombre de directorio \u00fanico bajo el directorio temporal con permisos 0700<\/em>.<\/li>\n retorna el directorio temporal global.<\/li>\n<\/ul>\n Los complementos se ejecutan en el orden en que aparecen definidos en la configuraci\u00f3n del programa y durante su funcionamiento pueden forman una cadena de respuestas que permita seguir con el siguiente de la lista. Esto es, todos los complementos para una fase determinada son invocados hasta que uno retorna un c\u00f3digo diferente a <\/p>\n . El c\u00f3digo de respuesta es obligatorio pero tambi\u00e9n se puede a\u00f1adir un texto para el cliente.<\/p>\n El m\u00f3dulo Qpsmtpd::Constants<\/em> define los c\u00f3digos de retorno con el siguiente significado:<\/p>\n : indica que el complemento no va a hacer nada y que la ejecuci\u00f3n debe continuar.<\/li>\n significa que se permite realizar la acci\u00f3n (y ya depende de la fase o del contexto).<\/li>\n es lo contrario: la acci\u00f3n no se permite.<\/li>\n indica que tambi\u00e9n que la acci\u00f3n no se permite pero con un car\u00e1cter m\u00e1s temporal.<\/li>\n deniega la acci\u00f3n y fuerza la desconexi\u00f3n con el cliente.<\/li>\n igual que el anterior pero retornando un c\u00f3digo temporal.<\/li>\n se emplea para terminar el proceso de la petici\u00f3n.<\/li>\n<\/ul>\n\n
Lo que m\u00e1s o menos alcanzo a entender por ahora<\/h4>\n
\n
:N<\/pre>\n
Carga de complementos<\/h5>\n
\n
# S\u00f3lo el nombre\r\ncheck_relay\r\n\r\n# Directorio y nombre\r\nvirus\/clamdscan\r\n\r\n# Nombre y par\u00e1metros \r\nspamassassin reject_threshold 7\r\n\r\n# Dos instancias con diferentes par\u00e1metros\r\nmy_rcpt_check example.com\r\nmy_rcpt_check:0 example.org\r\n\r\n# M\u00f3dulo Perl formal\r\nMy::Plugin<\/pre>\n
Qpsmtpd::Plugin<\/pre>\n
Inicializaci\u00f3n<\/h5>\n
\n
$self<\/pre>\n
Qpsmtpd::Plugin<\/pre>\n
<\/pre>\n
$qp<\/pre>\n
Qpsmtpd<\/pre>\n
@args<\/pre>\n
Configuraci\u00f3n<\/h5>\n
@lines = $self->qp->config('myconfig');\r\n<\/pre>\nRegistro de eventos<\/h5>\n
$self->qp->log( $loglevel, $logmessage );\r\n<\/pre>\n
Introspecci\u00f3n<\/h5>\n
\n
plugin_name()<\/pre>\n
hook_name()<\/pre>\n
auth_user()<\/pre>\n
auth_mechanism()<\/pre>\n
connection():<\/pre>\n
transaction()<\/pre>\n
Comunicaci\u00f3n interna<\/h5>\n
# Consulta y almacenamiento de notas en una transacci\u00f3n\r\n$self->qp->transaction->notes('nota');\r\n$self->qp->transaction->notes('nota','Hola');\r\n\r\n# Consulta y almacenamiento de notas en una conexi\u00f3n\r\n$self->qp->connection->notes('total');\r\n$self->qp->connection->notes('total','zero');\r\n<\/pre>\nArchivos temporales<\/h5>\n
\n
temp_file<\/pre>\n
temp_dir()<\/pre>\n
spool_dir()<\/pre>\n
C\u00f3digos de retorno<\/h5>\n
DECLINED<\/pre>\n
\n
DECLINED<\/pre>\n
OK<\/pre>\n
DENY<\/pre>\n
DENYSOFT<\/pre>\n
DENY_DISCONNECT<\/pre>\n
DENYSOFT_DISCONNECT<\/pre>\n
DONE<\/pre>\n
Resumiendo …<\/h5>\n