# SWS Documentation -- FAQ & Troubleshooting

## Table of Contents

- [How can I export the log from SWS?](#how-can-i-export-the-log-from-sws)
- [How can I see the SWS version?](#how-can-i-see-the-sws-version)
  - [Method 1 -- Web Interface](#method-1----web-interface)
  - [Method 2 -- SSH Command](#method-2----ssh-command)
- [How can I obtain the TEST Namirial App OTP?](#how-can-i-obtain-the-test-namirial-app-otp)
- [Template Support Request in Case of Problems with Integration](#template-support-request-in-case-of-problems-with-integration)
- [How can I TEST SWS OnPremise?](#how-can-i-test-sws-onpremise)
  - [Standalone](#standalone)
  - [Docker](#docker)
- [How can I TEST SWS SaaS?](#how-can-i-test-sws-saas)
- [Where can I obtain all Namirial Root CA?](#where-can-i-obtain-all-namirial-root-ca)
- [I have received the mail about TLS deprecated, what should I do?](#i-have-received-the-mail-about-tls-deprecated-what-should-i-do)
  - [SWS OnPremise -- Standalone](#sws-onpremise----standalone)
  - [SWS OnPremise -- Docker](#sws-onpremise----docker)
  - [SWS SaaS](#sws-saas)
  - [Migration steps for customers keeping OnPremise](#migration-steps-for-customers-keeping-onpremise)
- [Since mid July 2025 my SWS appliance stopped working in TEST environment](#since-mid-july-2025-my-sws-appliance-stopped-working-in-test-environment)
  - [Step 1 -- Login via SSH](#step-1----login-via-ssh)
  - [Step 2 -- Stop WildFly](#step-2----stop-wildfly)
  - [Step 3 -- Download the new truststore](#step-3----download-the-new-truststore)
  - [Step 4 -- Verify checksum](#step-4----verify-checksum)
  - [Step 5 -- Restart the application](#step-5----restart-the-application)


## How can I export the log from SWS?

You can follow the guide available at the following link:

History - SWS OnPremise - RPM package → ExportLogFiles

This guide explains how to export all SWS log files from the appliance.

# How can I see the SWS version?

There are two ways.

## Method 1 -- Web Interface

Go to link:


```
http://`<IP-APPLIANCE>`{=html}:8080/SignEngineWeb/help.xhtml
```

And read the version software (starts with 2.x )

## Method 2 -- SSH Command

Login to the appliance via SSH and execute:


```
rpm -q sws
```

And read the version software (starts with 2.x)

NOTE: For older SWS appliances only this method is available.

# How can I obtain the TEST Namirial App OTP?

If you download the **Namirial App OTP** from the official stores:

- Google Play Store
- Apple App Store


you can use **only the Namirial PROD environment**.

If you need to use the **TEST environment**, download the app from the
following links.

### Android

[link](https://appdistribution.firebase.dev/i/e843f2440b8a7b69)

### iOS

[link](https://testflight.apple.com/join/4ZUE4zjf)

# Template Support Request in Case of Problems with Integration

The fields required are:

- DATE and TIME when the error occurred
- URL ENDPOINT
- METHOD NAME CALLED
- INPUT PARAMETERS
- ERROR RECEIVED (from our server)


# How can I TEST SWS OnPremise?

SWS OnPremise is distributed in two different ways.

## Standalone

The SWS application is installed directly on a Linux server.

Documentation:


```
https://namirial.atlassian.net/wiki/spaces/SWS/pages/257950448/SWS+OnPremise+-+Standalone#Installation
```

## Docker

The Docker image is installed on an orchestrator managed by the
customer.

Documentation:


```
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:


```
https://sws-companynamesaas.test.namirialtsp.com/SignEngineWeb
```

br
This is the link for download SSL certificate on our service: [link](https://namirial.atlassian.net/wiki/download/attachments/95617156/TEST_SWS_SaaS.zip?version=2&modificationDate=1720452893236&cacheVersion=1&api=v2)

br
For example during the integration the full url to use for SOAP request is:


```
https://sws-companynamesaas.test.namirialtsp.com/SignEngineWeb/sign-services?wsdl
```

br
And the full url for REST request is:


```
https://sws-companynamesaas.test.namirialtsp.com/SignEngineWeb/rest/sign/signPades
```

# Where can I obtain all Namirial Root CA?

You can download all the root CA certificates from:

[Download All Namirial Root CA](../files/All_Namirial_RootCA.zip)

# I have received the mail about TLS deprecated, what should I do? (ITA)

Namirial al fine di aumentare la sicurezza nei suoi servizi offerti ha deciso di disabilitare 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)

[Documentation](/it/products/sws/enterprise_documentation/onpremise-standalone)

## SWS OnPremise -- Docker

(che "gira" su un immagine Docker, e l'orchestratore risiede nell'infrastruttura del cliente)

[Documentation](/it/products/sws/enterprise_documentation/onpremise-dockercontainer)

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

1. 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:


[Migration documentation](/it/products/sws/enterprise_documentation/onpremise-dockercontainer)

Postman collection: [link](https://namirial.atlassian.net/wiki/spaces/SWS/pages/95617087)

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

br
Di seguito potete scaricare un tool per:

- provare un apposizione di firma in ambiente di TEST (vi consiglio di eseguirlo al termine de punto 1 indicato sopra)
- migrare l’applicativo SWS da TEST a PROD (sarebbe il punto 3 indicato sopra)


[TOOL](./../files/TOOL_FOR_MIGRATE_SWS.zip)

# Since mid July 2025 my SWS appliance stopped working in TEST environment

The vendor of SSL certificates used by Namirial changed the root
certificates used for HTTPS communications.

Therefore **SWS versions older than 3.x stopped working**.

Follow these steps.

## Step 1 -- Login via SSH

Login to the SWS appliance.

## Step 2 -- Stop WildFly


```
sudo service wildfly stop
```

## Step 3 -- Download the new truststore


```
sudo curl https://sws.namirialtsp.com/download/truststore.jks -o /home/wildfly/.SignEngine/keystore/truststore.jks
```

## Step 4 -- Verify checksum


```
sudo sha1sum /home/wildfly/.SignEngine/keystore/truststore.jks
```

The output **must be**:


```
0566247408cf2d4200dffa7e024594d9adbb45fd
```

If the checksum is **different**, the download **failed**.

## Step 5 -- Restart the application


```
sudo service wildfly start
```