Versions Compared

Version Old Version 19 New Version Current
Changes made by

Lorenzo Cardinali

Lorenzo Cardinali

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
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://confluence.namirial.com/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 SWS Appliance Installation Guide .

A step by step installation guide can be found at the following link SWS Appliance Installation Guide.

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 SWS Appliance Installation Guide.

If you want to stay up to date with the latest version we recommend you follow this guide. HowcaniupgradeSWSappliancetolatestversion?

How can i export the log from SWS?

At this link:

SWS Appliance Installation GuideHistory - 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

upgrade SWS appliance to latest version?

1) Login SSH to SWS appliance

2) Execute:

Code Block
sudo yum update https://cms.namirialtsp.com/download/sws.rpm

How can i upgrade SWS appliance menu to latest version?

1) Login SSH to SWS appliance

2) Execute:

Code Block
sudo yum update https://cms.namirialtsp.com/download/sws_menu.rpm

How can i obtain the TEST Namirial App OTP?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:

https://testflight.apple.com/join/4ZUE4zjf

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

TEST SWS

in standalone mode

onPremise?

Is possible to install SWS in standalone mode ONLY in server RedHat and CentOS. Below the procedureSWS onPremise is distributed in two different ways:

  • standalone (the SWS application is installed on Linux server)

Below the link:

Code Block
wget https://cmsnamirial.firmacerta.it/download/sws2_packages.tar.gz
tar xzfv sws2_packages.tar.gz
./install.shatlassian.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
nameAll_Namirial_RootCA.zip

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 - Standalone

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:

https://namirial.atlassian.net/wiki/spaces/SWS/pages/211452317/SWS+OnPremise+-+Docker+container#How-can-i-migrate-from-TEST-to-PROD-environment ?

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:

Configure Postman

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)