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.