Il 30 settembre 2024 è stata rilasciata la versione 1.1 delle Domino REST API, che introduce una serie di nuove funzionalità, miglioramenti e correzioni di bug significative. Queste novità migliorano la sicurezza dei dati, l'integrazione con altri sistemi, l'efficienza della gestione e l'usabilità complessiva delle API. Vediamo insieme le principali novità.
Novità principali
1. Crittografia e Firma dei Documenti
La grande novità di questa versione è la possibilità di crittografare i campi dei documenti e firmare i documenti utilizzando le chiavi memorizzate nel file ID Notes. Questa funzione migliora notevolmente la sicurezza dei dati, proteggendoli da accessi non autorizzati e garantendo l'integrità delle informazioni.
· Per ulteriori dettagli, consultare la documentazione su l’uso della crittografia, decrittazione e firma.
2. Abilitazione di HTTPS
Ora è possibile configurare HTTPS in Domino utilizzando la configurazione dei certificati di Domino. Questo semplifica la configurazione di connessioni sicure, migliorando la protezione dei dati durante le comunicazioni.
· Per ulteriori informazioni, consultare l'abilitazione di HTTPS con il Domino Certificate Manager.
3. Supporto per IdP esterni
È stato aggiunto il supporto per l'uso di Identity Provider (IdP) esterni per migliorare l'integrazione con servizi esterni. In particolare, questo supporto è stato esteso all'Office Round Trip Experience.
· Maggiori informazioni nella guida alla configurazione di IdP esterni per l'Office Round Trip Experience.
4. Nuovi Endpoint per la Gestione dei Documenti
Sono stati introdotti nuovi endpoint per la gestione di documenti nominati:
· DELETE: /v1/nameddocument per eliminare un documento nominato.
· GET: /v1/nameddocument per recuperare un documento nominato tramite il nome.
· GET: /v1/nameddocumentlist per ottenere una lista di documenti nominati.
· POST: /v1/nameddocument per creare o aggiornare un documento nominato.
Nota importante: Durante l'uso dell'endpoint POST, viene sostituito l'intero contenuto dei campi nel documento in base allo schema fornito. È quindi fondamentale includere tutti i campi e valori desiderati nella richiesta.
5. Rich Text API consolidata
È stato aggiunto un nuovo endpoint per la gestione dei campi di testo formattato:
· GET: /v1/richtext/{richTextAs}/{unid} restituisce uno stream di dati da un campo di testo formattato nel formato specificato (Markdown, MIME o testo normale). Questo endpoint unisce le funzionalità di vari endpoint preesistenti, semplificando l’uso per tutti i processori di Rich Text.
Miglioramenti
1. Messaggi di stato migliorati
Il task Domino REST API ora fornisce messaggi di avvio e arresto più chiari:
· Durante l'avvio, vengono visualizzati i messaggi REST API: Starting... e successivamente REST API Started.
· Durante lo spegnimento, viene mostrato REST API: Shutdown, sostituendo un output JSON prolisso.
2. Integrazione migliorata con il processo Domino
Il processo Java della Domino REST API è ora integrato direttamente con il processo Domino principale. Questo migliora l'affidabilità e rende il prodotto più robusto.
3. Statistiche REST API accessibili dalla Console Domino
Le statistiche della Domino REST API possono ora essere visualizzate tramite il comando SHOW STAT nella console Domino. Per visualizzare esclusivamente le statistiche REST API, usare il comando SHOW STAT restapi.
4. Rimozione della necessità della gestione della porta
La linea KeepManagementPort nel file notes.ini non è più necessaria e, se presente, verrà ignorata.
5. Miglioramenti all'interfaccia utente e alla gestione degli schemi
· È stata migliorata la tabella di origine sotto la gestione degli schemi nell'interfaccia Admin UI.
· Aggiunta l'opzione per esportare lo schema del database come file JSON copiando lo schema e creando un file contenente lo schema copiato.
Risoluzione dei problemi
Questa versione risolve diversi problemi noti:
· Il problema in cui l'endpoint GET admin-v1/access/users restituiva un errore 404 se il parametro di ricerca startsWith includeva un carattere slash (/).
· I caratteri svedesi non venivano codificati correttamente nel corpo della risposta durante l'uso dell'Office Round Trip Experience con contenuti RichText.
· Problemi di login con MS-OFBA in Internet Explorer 8 a causa di funzioni di login non supportate da questo browser.
Aggiornamenti vari
1. Aggiornamenti endpoint Rich Text
Gli endpoint seguenti sono stati sostituiti con il nuovo endpoint consolidato /v1/richtext/{richTextAs}/{unid}:
· GET v1/richtext/markdown/{unid}
· GET v1/richtext/mime/{unid}
· GET v1/richtext/plain/{unid}
2. File di installazione aggiornati
I nuovi file jar di installazione per Domino 12 e 14 sono:
· Domino 14: restapiInstall-r14.jar
· Domino 12: restapiInstall-r12.jar
Inoltre, per l'utilizzo di Docker, le immagini per la versione 1.1 sono:
· Domino 14: domino-rest-api:1.1.0-r14
· Domino 12: domino-rest-api:1.1.0-r12
Conclusione
La versione 1.1 delle Domino REST API porta con sé una serie di funzionalità cruciali per migliorare la sicurezza, l'integrazione e la gestione dei dati. Con l'introduzione della crittografia, la firma digitale dei documenti e l'abilitazione di HTTPS, le organizzazioni possono ora contare su una piattaforma più sicura. Inoltre, i miglioramenti all'usabilità e alle prestazioni rendono l'API più facile da gestire e da integrare in ambienti complessi.
Per maggiori dettagli e informazioni sulle nuove funzionalità, visita la documentazione ufficiale.
0 Commenti:
Nessun Commento Trovato