| Table of Contents |
|---|
How to upgrade from version 1.x - 2.4.x to version 2.5.x
Important changeovers were made from the previous version to the current version.
The operating system has been updated from CentOS6 to CentOS7
The application server was migrated from jboss 7 to WildFly 14.0.0.Final
In addition to a series of application improvements that you can find at the changelog https://namirial.atlassian.net/wiki/display/SWS/Changelog
To complete the update you need to create a new machine and proceed to a new appliance installation that you find at the following link History - SWS OnPremise - RPM package#HowtoobtaintheOVFvirtualappliance .
A step by step installation guide can be found at the following link History - SWS OnPremise - RPM package#Deploymentandtest.
Once the installation is complete you will need to reconfigure your VA with the production keystore, you can find at this link a detail on how to do this History - SWS OnPremise - RPM package#MigratefromTESTtoPRODenvironment.
If you want to stay up to date with the latest version we recommend you follow this guide. FAQ#FAQ#HowcaniupgradeSWSappliancetolatestversion?How can i export the log from SWS?
At this link:
History - SWS OnPremise - RPM package#ExportLogFiles
You can see the guide for export the files.
How can i see the SWS version?
There are two ways. First way:
Go to link:
| Code Block |
|---|
http://<IP-APPLIANCE>:8080/SignEngineWeb/help.xhtml |
And read the version software (starts with 2.x )
Or:
1) Login SSH to appliance and execute:
| Code Block |
|---|
rpm -q sws |
And read the version software (starts with 2.x)
NOTE: for the old appliance SWS is available only the second way.
How can i obtain the TEST Namirial App OTP?
If you download the Namirial App OTP from the official store (PlayStore and AppleStore), you can use ONLY the Namirial PROD enviroment.
If you need to use the Namirial TEST environment, you can download the app from this link:
For Android:
https://appdistribution.firebase.dev/i/e843f2440b8a7b69
For iOS:
Template support request in case of problems with integration
The fields required are:
DATE and TIME when you have received the error: ???
URL ENDPOINT: ???
METODO NAME CALLED: ???
INPUT PARAMETERS: ???
ERROR RECEIVED (from our server): ???
How can i
install SWS in standalone mode?Is possible to install SWS in standalone mode ONLY in server RedHat, Almalinux9 and CentOS (this OS is supported until June 2024). Below the procedure:
| Code Block |
|---|
wget https://sws.firmacerta.it/download/sws2_packages.tar.gz
tar xzfv sws2_packages.tar.gz |
Move into directory just extracted and run this command:
| Code Block |
|---|
./install.sh |
How can i TEST SWS onPremise?
SWS onPremise is distributed in two different ways:
standalone (the SWS application is installed on Linux server)
Below the link:
| Code Block |
|---|
https://namirial.atlassian.net/wiki/spaces/SWS/pages/257950448/SWS+OnPremise+-+Standalone#Installation |
Docker (the image is installed on orchestrator managed by the customer)
Below the link:
| Code Block |
|---|
https://namirial.atlassian.net/wiki/spaces/SWS/pages/211452317/SWS+OnPremise+-+Docker+container#How-can-i-obtain-the-SWS-on-Docker? |
How can i TEST SWS SaaS?
The url prefix for TEST SWS SaaS is:
| Code Block |
|---|
https://sws-companynamesaas.test.namirialtsp.com/SignEngineWeb |
This is the link for download SSL certificate on our service
For example during the integration the full url to use for SOAP request is:
| Code Block |
|---|
https://sws-companynamesaas.test.namirialtsp.com/SignEngineWeb/sign-service?wsdl |
And the full url for REST request is:
| Code Block |
|---|
https://sws-companynamesaas.test.namirialtsp.com/SignEngineWeb/rest/sign/signPades |
Where can i obtain all Namirial root CA?
At this link:
| View file | ||
|---|---|---|
|
you can download all root CA
I have received the mail about TLS deprecated, how can i do? (ITA)
Namirial al fine di aumentare la sicurezza nei suoi servizi offerti ha deciso di disabilitare i le comunicazioni che utilizzano il protocollo TLS inferiore a 1.2
Prima di continuare la lettura, l’aggiornamento di SWS non comporta nessuna modifica alle integrazioni effettuate in passato dai clienti, in quanto Namirial come primo obbiettivo ha quello di mantenere la retrocompatibilità nei suoi aggiornamenti.
Detto ciò, di seguito una breve descrizione di come ottenere la nuova versione di SWS conforme agli standard di sicurezza applicati da Namirial:
Negli anni abbiamo cambiato le modalità di distribuzione di SWS, la modalità di appliance come OVF non la forniamo più (per problemi di importazione nei vari cloud provider)
Attualmente abbiamo le seguenti modalità di distribuzione:
SWS onPremise -> STANDALONE
(che “gira” su server Linux, nella documentazione sono scritti quelli supportati, in caso se volete utilizzare un sistema operativo Linux non presente nella lista possiamo vedere se riusciamo a soddisfare la richiesta)
SWS onPremise -> DOCKER
(che "gira" su un immagine Docker, e l'orchestratore risiede nell'infrastruttura del cliente)
SWS OnPremise - Docker container
SWS SaaS
(in cui vi forniamo un endpoint ad hoc protetto da mutua autenticazione per poter firmare. Namirial si occupa della gestione dell'infrastruttura, aggiornamenti, patch ecc...)
NOTA: se volete utilizzare/passare alla versione SaaS potete contattare direttamente un nostro commerciale e valutare insieme se adottare o meno questa soluzione (in generale questa soluzione viene adottata dai clienti che appongono poche firme e la dimensione dei file da firmare non va oltre qualche MB)
Nel vostro caso che avete già un istanza di SWS che stiamo andando a dismettere (per motivi di sicurezza legati a TLS) e decidete di mantenere la versione onPremise:
Potete eseguire i vari STEP:
1 - Completate l'installazione di SWS onPremise (standalone o Docker) -> A questo punto siete pronti per "parlare" con l'ambiente di TEST di Namirial
2 - Recuperate il keystore di PROD (che usate attualmente su SWS per parlare con l'ambiente di PROD di Namirial) nel seguente modo:
dal server SWS Appliance recuperate il file "/home/[jboss|wildfly]/.SignEngine/keystore/prod_keystore.jks" e copiatelo nel vostro PC -> FILE_JKS
3 - Una volta che avete il FILE_JKS, potete configuare la nuova istanza di SWS per "parlare" con l'ambiente di PROD di Namirial nel seguente modo:
A questo punto la nuova istanza di SWS potrà “parlare” con il nostro ambiente di PROD
NOTA: se non volete fare il comando "curl" a mano, potete utilizzare la postman collection reperibile al seguente link:
IMPORTANTE: fino a che non avete completato i vari test con la nuova versione di SWS (chiamata SWS3x), potete tenere entrambe le istanze (la 1.2 e la 3x) attive per parlare con il nostro ambiente di PROD)