Installare AssinaJá Certificados

Per firmare su AssinaJá con il certificato digitale che ha già sul computer — quello rilasciato dal suo Ordine professionale, per esempio —, Le serve AssinaJá Certificados, composto da due parti: un’applicazione sul computer e un’estensione nel browser. Questa pagina spiega che cosa sono, perché servono e come installarle.

Che cos’è

Sono due parti che lavorano insieme:

Parte	Che cosa fa
L’applicazione	Un piccolo programma installato sul suo computer. Trova i suoi certificati, Le mostra una finestra di conferma prima di ogni firma, e firma.
L’estensione	Un’estensione per Chrome, Edge o Firefox. È il ponte tra la pagina di firma di AssinaJá e l’applicazione.

Su Windows, l’applicazione compare nell’elenco delle app installate con il nome AssinaJá Certificados. L’estensione ha lo stesso nome nello store del browser.

A che cosa serve

Serve a una cosa sola: firmare documenti di AssinaJá con il Certificato digitale locale — il certificato digitale che è suo, installato in Windows o nel Portachiavi di macOS, salvato in un file .p12 o .pfx, oppure su una smart card collegata al computer.

Le serve solo se qualcuno Le invia un documento da firmare con il Certificato digitale locale. Per firmare con la Chave Móvel Digital o con una firma disegnata, non deve installare nulla.

Perché serve

Il browser, da solo, non può usare i certificati installati sul suo computer. È una scelta di sicurezza dei browser stessi: una pagina web non ha accesso ai certificati del sistema. Per questo chi firma PDF con il certificato del proprio Ordine usa Acrobat, e non il browser.

L’applicazione risolve il problema senza aprire la porta a nient’altro:

• La chiave del suo certificato non lascia mai il computer. AssinaJá invia all’applicazione solo l’impronta (hash) del documento; l’applicazione firma quell’impronta e restituisce la firma.
• L’applicazione non vede mai il documento, né indirizzi, né le sue credenziali di accesso ad AssinaJá — solo l’impronta, il nome del documento e l’indirizzo del sito che chiede la firma.
• La password del file o il PIN della smart card vengono chiesti solo in una finestra dell’applicazione, mai nella pagina.
• Firma solo per AssinaJá. L’applicazione e l’estensione rifiutano le richieste di qualsiasi altro sito.
• Nulla viene firmato senza la sua conferma. Prima di ogni firma si apre una finestra dell’applicazione, con i testi in portoghese — Assinar com o seu certificado («Firmi con il suo certificato») — con l’indirizzo che chiede la firma, il nome del documento, il certificato e l’emittente. Il pulsante selezionato per impostazione predefinita è Cancelar («Annulla»).

Legga la finestra prima di premere Assinar

La finestra di conferma termina con:

Só assine se foi você a pedir esta assinatura na AssinaJá.

(«Firmi solo se è stato Lei a richiedere questa firma su AssinaJá.») Se la finestra compare senza che Lei abbia chiesto una firma, o mostra un documento che non riconosce, prema Cancelar.

Che cosa serve

• Google Chrome, Microsoft Edge o Mozilla Firefox.
• Uno di questi sistemi:

Sistema	Versione	Certificati che l’applicazione trova	Installazione
Windows	10 o successivo, 64 bit	Quelli installati in Windows, quelli su smart card e i file .p12/.pfx	Solo per il suo utente, senza password di amministratore
macOS	14 (Sonoma) o successivo, Apple Silicon o Intel	Quelli del Portachiavi e i file .p12/.pfx	Per tutti gli utenti, con password di amministratore
Linux	64 bit: Ubuntu 22.04, Debian 12, Fedora, RHEL 9 o successivi	Solo file .p12/.pfx	Per tutti gli utenti, con sudo

Installare su Windows

1. Scaricare il programma di installazione

Apra la pagina Software del sito di AssinaJá e scarichi il programma di installazione per Windows. Il file si chiama assinaja-webid-win-x64.msi.

2. Eseguire il programma di installazione

1. Apra la cartella Download e faccia doppio clic sul file .msi.
2. Segua le istruzioni del programma di installazione fino alla fine.

Non Le viene chiesta la password di amministratore. L’applicazione viene installata nella sua cartella utente, in %LOCALAPPDATA%\Programs\AssinaJa\WebId\, e viene registrata nei tre browser — Chrome, Edge e Firefox — in un colpo solo.

Se compare una schermata blu di Windows

Quando apre il programma di installazione, Windows può mostrare una schermata blu con il titolo Windows ha protetto il PC. Non è un errore, e non significa che il file abbia qualche problema. È Microsoft Defender SmartScreen che segnala di non aver ancora visto questo file molte volte.

Il programma di installazione di AssinaJá è firmato digitalmente a nome della società che lo pubblica. Ciononostante, SmartScreen mostra l’avviso finché un programma di installazione non viene scaricato da molte persone — è una regola di Microsoft valida per qualsiasi programma, firmato o no, e l’avviso scompare con il tempo.

Per continuare:

1. Prema Ulteriori informazioni.
2. Controlli la riga Autore. Deve indicare RMB - SISTEMAS DE INFORMAÇÃO LDA.
3. Prema Esegui comunque. Il programma di installazione si apre normalmente.

Se l’autore risulta «Autore sconosciuto», si fermi

Se la riga Autore non indica RMB - SISTEMAS DE INFORMAÇÃO LDA, prema Non eseguire ed elimini il file. Scarichi di nuovo il programma di installazione, solo dalla pagina Software del sito di AssinaJá.

Può anche verificare la firma prima di aprire il file: faccia clic con il tasto destro sul .msi, scelga Proprietà e apra la scheda Firme digitali. Il nome del firmatario è RMB - SISTEMAS DE INFORMAÇÃO LDA.

In un’azienda, il reparto IT può autorizzare il programma di installazione in base all’autore della firma digitale, invece di autorizzarlo file per file.

Installare su macOS

1. Scaricare il programma di installazione

Dalla pagina Software del sito di AssinaJá, scarichi il programma di installazione per macOS. Il file si chiama assinaja-webid-macos-universal.pkg e funziona sui Mac con Apple Silicon e con Intel.

2. Aprire il programma di installazione

1. Apra la cartella Download e faccia doppio clic sul file .pkg.
2. Al primo tentativo macOS si rifiuta di aprirlo: il programma di installazione non è ancora registrato presso Apple. Chiuda l’avviso.
3. Apra Impostazioni di Sistema, poi Privacy e sicurezza. Più in basso compare una riga relativa a assinaja-webid-macos-universal.pkg: prema Apri comunque e confermi.
4. Segua il programma di installazione fino alla fine. Le viene chiesta la password di amministratore del Mac.

L’applicazione viene installata in /Library/Application Support/AssinaJa/WebId/, per tutti gli utenti del Mac, e viene registrata in Chrome, Edge e Firefox.

Installare su Linux

1. Scaricare il pacchetto

Dalla pagina Software del sito di AssinaJá, scarichi il pacchetto della sua distribuzione:

Distribuzione	File
Ubuntu, Debian	assinaja-webid-linux-x64.deb
Fedora, RHEL	assinaja-webid-linux-x64.rpm

2. Installare il pacchetto

Apra un terminale nella cartella in cui si trova il file e digiti il comando della sua distribuzione:

# Ubuntu, Debian
sudo apt install ./assinaja-webid-linux-x64.deb

# Fedora, RHEL
sudo dnf install ./assinaja-webid-linux-x64.rpm

Il gestore di pacchetti installa anche ciò di cui l’applicazione ha bisogno: OpenSSL e zenity, che disegna le finestre di conferma e di password. L’applicazione viene installata in /opt/assinaja/webid/, per tutti gli utenti, e viene registrata in Chrome, Edge e Firefox.

Solo certificati su file

Su Linux, l’applicazione usa solo certificati salvati in un file .p12 o .pfx. Le smart card — il Cartão de Cidadão (la carta d’identità portoghese), i token — non funzionano su Linux.

Browser installati come Snap o Flatpak

Usi Chrome, Edge o Firefox installati dai pacchetti ufficiali di ciascuno. Le versioni Snap o Flatpak — il Firefox fornito con Ubuntu è Snap — potrebbero non trovare l’applicazione.

Collegare l’estensione, su qualsiasi sistema

1. Installare l’estensione nel browser

Installi l’estensione AssinaJá Certificados dallo store del suo browser:

Browser	Dove
Google Chrome	Chrome Web Store
Microsoft Edge	Componenti aggiuntivi di Microsoft Edge
Mozilla Firefox	Firefox Add-ons

In Firefox, verifichi che l’estensione possa funzionare sui siti di AssinaJá. Se non può, l’icona dell’estensione mostra (in inglese):

The extension is not allowed to run on the AssinaJá sites.

Prema Allow on the AssinaJá sites.

2. Verificare che sia tutto collegato

Prema l’icona dell’estensione AssinaJá Certificados, nella barra del browser. Deve vedere:

AssinaJá application connected

con la Version dell’applicazione sotto. Se vede “The AssinaJá application is not installed”, torni all’installazione dell’applicazione per il suo sistema e poi prema Check connection.

3. Tornare al documento

Se era a metà di una firma, torni alla pagina del documento e prema Cerca di nuovo. Il passaggio Certificato mostra ora i certificati installati sul suo computer — veda Firmare con il Certificato digitale locale.

Aggiornare

Quando esce una nuova versione, scarichi il nuovo programma di installazione e lo installi sopra il precedente, allo stesso modo: sostituisce la versione installata.

Se la versione installata è troppo vecchia, la procedura guidata di firma lo segnala:

L’applicazione AssinaJá deve essere aggiornata

Disinstallare

• Windows: apra Impostazioni, poi App, cerchi AssinaJá Certificados e scelga Disinstalla.
• macOS: in un terminale, sudo "/Library/Application Support/AssinaJa/WebId/uninstall.sh".
• Linux: sudo apt remove assinaja-certificados (Ubuntu, Debian) oppure sudo dnf remove assinaja-certificados (Fedora, RHEL).

La disinstallazione rimuove l’applicazione e la registrazione nei browser. L’estensione si rimuove a parte, nel browser stesso.

Se non funziona

La procedura guidata di firma dice sempre che cosa manca. I messaggi che può vedere nel passaggio Certificato:

Messaggio	Che cosa fare
Manca l’estensione AssinaJá in questo browser	Installi l’estensione (Collegare l’estensione) e prema Cerca di nuovo. In Firefox, verifichi anche il permesso sui siti di AssinaJá.
Manca l’applicazione AssinaJá su questo computer	L’estensione è installata, ma l’applicazione no. Installi l’applicazione per il suo sistema e prema Cerca di nuovo.
L’applicazione AssinaJá deve essere aggiornata	Installi la versione più recente e prema Cerca di nuovo.
Impossibile comunicare con l’applicazione AssinaJá	Chiuda e riapra il browser e prema Cerca di nuovo. Se il problema persiste, reinstalli l’applicazione.
L’applicazione AssinaJá non riconosce questo indirizzo	L’applicazione firma solo per gli indirizzi di AssinaJá. Apra il documento dal link nell’email d’invito.
Questa pagina non usa una connessione sicura	Lo stesso: apra il documento dal link dell’invito.
Non è possibile firmare con certificato digitale su questo dispositivo	Sta usando uno smartphone o un tablet. Apra il documento sul computer in cui si trova il certificato.

Veda anche

• Firmare con il Certificato digitale locale
• Livelli di firma