Istruzioni per l'utilizzo dell'applicazione "sbusta"
Introduzione
La circolare 230/D del 13 dicembre 2000 prevede che i modelli Intra vengano trasmessi muniti di un codice di autenticazione, che consente all'Agenzia delle Dogane la verifica dell'integrità del messaggio ricevuto e dell'identità del soggetto autorizzato che lo trasmette. Analogamente, i file di risposta e di esito restituiti agli utenti sono corredati di un codice di autenticazione, che consente ai destinatari di effettuare le medesime verifiche.
Il calcolo dei codici di autenticazione e la loro verifica vengono effettuati dagli utenti autorizzati, con le modalità descritte nel manuale utente.
Per consentire ai fornitori di servizi di effettuare le proprie elaborazioni, è disponibile in questa sezione un prodotto software che elabora il file munito del codice di autenticazione, creando un file di output nel tracciato descritto in appendice del manuale utente.
Caratteristiche tecniche
Il prodotto è un'applicazione Java; per l'esecuzione, è necessario
installare il Java Runtime Enviroment (JRE), versione 1.2.2 o 1.3.0.
La directory <bin> del JRE deve essere presente nella variabile di ambiente <PATH>.
Installazione
Per lo scarico del software occorre eseguire le seguenti operazioni:
- creare una cartella temporanea sul proprio disco, denominata nel seguito <path_di_installazione>;
- effettuare lo scarico del file compresso in <path_di_installazione>; il file è disponibile in due formati:
- sbusta.zip (623 Kbyte), per ambiente windows
- sbusta.tar.gz (623 Kbyte), per ambiente Unix.
- decomprimere il file, utilizzando i programmi disponibili
Al termine, sul disco nel quale è stato effettuato lo scarico e la decompressione, viene creata la seguente struttura:
cartella <path_di_installazione> che contiene:
- il file sbusta.zip
- il file sbusta.bat
- il file sbusta.class
- la cartella <lib> che, a sua volta contiene:
- il file iaik_jce.jar
- il file iaik_smime.jar
- il file provider.jar
- il file signer.jar
- il file toolkit.jar
Esecuzione dell'applicazione
Per utilizzare l'applicazione, occorre utilizzare i comandi:
cd path_di_installazione
sbusta fileinput fileoutput
dove
fileinput è il nome del file munito del codice di autenticazione
fileoutput è il nome del file che l'applicazione creerà, nel tracciato riportato in appendice al
manuale utente.
L'applicazione restituisce i seguenti codici di ritorno.
0 Normale conclusione delle operazioni. Il file di output è stato creato
correttamente.
2 Errore di sintassi. Il numero di parametri passati
all'applicazione è errato.
10 Errore nella lettura del file munito del codice
di autenticazione. Il file non esiste o il formato non è corretto. Il file di
output non è stato creato.
11 Altri errori. Il file di output non è stato creato.