Leer Primero
------------

Estas aplicaciones son de distrubicin gratuita con cdigo fuente bajo la licencia de uso GPLv2
(ver archivos "Licencia GPLv2-sp.txt" y/o "License GPLv2-en.txt")

Tienen por objetivo proveer un mecanismo sencillo de integracin para aquellos sistemas pre existentes
en instalaciones de exportadores y/o despachantes de aduana. Est orientado su uso al rea de sistemas
de dichas entidades

La integracin se realiza a travs de la ejecucin de acciones desde la lnea de comandos de consola.
La informacin se ingresa a travs de parmetros pasados en lnea y se devuelve a travs de arcvhivos
de texto como salida

Las aplicaciones funcionan en cualquier plataforma que ejecute Java y en donde se dispongan drivers o
contraoladores para el acceso a los token de seguridad por hardware


Contenidos
----------

- En el directorio principal hay documentos que contienen:

leeme.txt                           -  Este documento
ALADI_SEC_di2327_rev12.pdf          -  Ultima normativa para la implementacin de COD de ALADI
cod_ver_1.8.0.xsd                   -  Archivo XSD de validacin de XML de COD de ALADI versin 1.8.0
cod_ver_1.8.2.xsd                   -  Archivo XSD de validacin de XML de COD de ALADI versin 1.8.2
cod_ver_1.8.3.xsd                   -  Archivo XSD de validacin de XML de COD de ALADI versin 1.8.3 (A72)
cod_ver_1.8.2_exporter_unsigned.xsd -  Archivo XSD de validacin de archivo XML enviado por el Exportador sin Firma Digital
cod_ver_1.8.2_exporter_signed.xsd   -  Archivo XSD de validacin de archivo XML enviado por el Exportador CON Firma Digital
cod_ver_1.8.3_exporter_unsigned.xsd -  Archivo XSD de validacin de archivo XML enviado por el Exportador sin Firma Digital
cod_ver_1.8.3_exporter_signed.xsd   -  Archivo XSD de validacin de archivo XML enviado por el Exportador CON Firma Digital
certorig_nopref_unsigned.xsd        -  Archivo XSD de validacin de archivo XML con certificado de origen No Preferencial SIN Firma Digial

certificados (carpeta)              -  Certificados de AC Raiz
ejemplos     (carpeta)              -  Ejemplos de archivos XML para cada uno de los Acuerdos y certificados de origen No Preferenciales

- En el directorio principal hay archivos que contienen:

*.jar                     - programas Java compilados y ejemplos 
*.txt                     - configuracin, derechos de autor y licencias de uso

- En el directorio principal tambin encontrar:

safenet_config.txt   -  Archivo de configuracin de driver SafeNet iKey para Windows
athena_config.txt    -  Archivo de configuracin de driver Athena para Windows
cryptoid_config.txt  -  Archivo de configuracin de driver mToken+CryptoID para Windows
epass2003_config.txt -  Archivo de configuracin de driver ePass para Windows
test_sauken.pem      -  Certificado de prueba con firma digital para test de firma por software
*_config.txt         -  Archivos de configuracin por Entidad para aquellas entidades con servidor propio en LAN

Notas: 

- La ejecucin de las aplicaciones Java requieren tener instalado el "Oracle JRE o SDK Java 1.8.0"
- Los archivos *.jar se ejecutan desde la linea de comandos de consola con "java -jar nombre.jar"
- Debe posicionarse sobre el directorio principal para proceder a la ejecucin de las aplicaciones
- El archivo "firmar-gui.jar" se lo puede ejecutar desde el navegador de archivos haciendo doble-click

Contenidos importantes:

firmar-gui.jar   -  Interface grfica para la ejecucin de los comandos comunes de integracin

certificado.jar  -  Funciones para la extraccin de los datos que permitan firmar digitalmente desde 
                    un certificado contenido en un archivo "pem" o bien desde token de seguridad por hardware

firmar.jar       -  Programa que permite firmar a un Exportador o Funcionario Habilitado un Certificado de Origen
                    Para ayuda de uso ejecute: "java -jar firmar.jar --help"

validar.jar      -  Programa que permite validar las firmas digitales presentes en un COD
                    Para ayuda de uso ejecute: "java -jar validar.jar --help"

validar-xsd.jar  -  Programa que permite validar la estructura y el contenido de un archivo XML de ALADI contra
                    el archivo de esquema XSD de ALADI segn la versin del mismo
                    Para ayuda de uso ejecute: "java -jar validar-xsd.jar --help"

Archivo de configuracin del token:

El driver compatible con PKCS#11 que provee el fabricante del token (normalmente un archivo .DLL ubicado en
"C:\Windows\System32\") debe introducirse dentro de un archivo de texto (.TXT) con su ubicacin completa (ver
ejemplo enumerados arriba). Importante: notar en Windows que la barra invertida en el path del driver debe
escribirse dos veces seguidas (\\). Esto no es un error, debe representarse de esta manera.

En caso de que no exista un archivo de configuracin del driver de su marca y modelo de token, debe crear uno.
Antes que nada acceda a la documentacin del token y verifique si es compatible con el protocolo PKCS#11. De serlo,
entonces averigue donde esta ubicado el driver y crguelo en un nuevo archivo de configuracin.
