Buongiorno,

A partire dalla versione 20.04.01 di ESSE3 è stata introdotta una modifica alla configurazione del webESSE3, che impatta la fruizione del componente APi-Rest (E3Rest) di ESSE3.

Per tutti gli impianti ESSE3 in hosting CINECA, la modifica è stata effettuata "by-default" da CINECA.

La presente nota tecnica è rivolta agli atenei che hanno l'impianto ESSE3 "on premise" presso l'ente, per i quali è necessario provvedere ad apportare le modifiche di seguito descritte in concomitanza dell'aggiornamento alla versione 20.04.01, o successive, di ESSE3.

Modifiche da apportare alla configurazione dei tomcat di front-end di webESSE3, sia per l'ambiente di produzione che per quello di pre-produzione laddove presente.

  1. Aggiugere la libreria bouncy-castle-1.45.jar ( Download JAR ) ad ogni Tomcat di frontend di webesse3, dentro la cartella "endorsed". La cartella "endorsed" dovrà in ultimo contenere il bouncy-castle.jar oltre al già presente xalan.jar.
  2. Aggiungere nella configurazione dei virtual host di Apache (esse3.conf) le seguenti nuove entry:
    1. JkMount /*/angular/* esse3-unidemo-preprod
    2. JkMount /angular/* esse3-unidemo-preprod
    sostituendo all'esempio fornito "esse3-unidemo-preprod" il nome del proprio worker di fruizione del webESSE3.

NB.

Verificare che i servizi REST siano deployati sul path standard /e3rest  cioè è necessario che gli applicativi rispondano alle seguenti URL

https://<url-webesse3>  => url di prod/preprod di webesse3

https://<url-webesse3>/e3rest  => url di prod/preprod dei servizi REST 


Le modifiche necessitano di un riavvio dei tomcat per essere recepite.

Test di corretta applicazione

Aggiunta Bouncy Castle 

La mancanza del jar blocca l'avvio dei servizi REST, Per effettaure un test di corretta applicazione è sufficiente verificare che il sistema risponda ad una API pubblica, ad esempio

https://<url-webesse3/e3rest/api/offerta-service-v1/attivitaGeneriche

Redirect path /angular/

Per testare il punto 2. è semplicemente possibile effettuare le seguenti chiamate da browser 

https://<url_webesse3>/angular/test

https://<url_webesse3>/test/angular/test   

in queste prime due chiamate deve rispondere la parte Tomcat con la cornice applicativa di webesse3 indicando che la pagina non esiste (un esempio è disponibile qui)

https://<url-webesse3>/test  

in questa chiamata invece deve rispondere la parte apache con un not found (un esempio è disponibile qui)


Per eventuali chiarimenti o richiesta di supporto vi chiediamo cortesemente di aprire un ticket al customer-portal ambito Servizi Applicativi di ESSE3.

Cordialmente

Fabio Arcella