Bug RNDT API: link alternate nei risultati search puntano a IP interno (192.168.3.34)

[aborruso]

Descrizione

L'API REST del RNDT restituisce, nel campo `links` di ogni risultato di ricerca, URL con un indirizzo IP privato interno (`192.168.3.34:8080`) al posto dell'URL pubblico del geoportale. Questi link sono irraggiungibili da qualsiasi client esterno.

Chiamata di test riproducibile

curl -s "https://geodati.gov.it/RNDT/rest/metadata/search?q=catasto&num=1&f=json" \
  | jq '.results[0].links[] | select(.rel == "alternate")'

Output attuale (errato):

{
  "rel": "alternate",
  "type": "application/json",
  "href": "http://192.168.3.34:8080/geoportal-catalog/rest/metadata/item/c_l219%3Aa883ab12-e713-41fe-b2a2-34c7756dc4e2"
}
{
  "rel": "alternate",
  "type": "text/html",
  "href": "http://192.168.3.34:8080/geoportal-catalog/rest/metadata/item/c_l219%3Aa883ab12-e713-41fe-b2a2-34c7756dc4e2/html"
}
{
  "rel": "alternate",
  "type": "application/xml",
  "href": "http://192.168.3.34:8080/geoportal-catalog/rest/metadata/item/c_l219%3Aa883ab12-e713-41fe-b2a2-34c7756dc4e2/xml"
}

Output atteso (corretto):

{
  "rel": "alternate",
  "type": "application/json",
  "href": "https://geodati.gov.it/RNDT/rest/metadata/item/c_l219%3Aa883ab12-e713-41fe-b2a2-34c7756dc4e2"
}

Causa probabile

Il parametro di configurazione del base URL pubblico nel server Esri Geoportal Server (il motore che alimenta il catalogo RNDT) non è allineato con l'URL esposto all'esterno. Il server genera i link alternate usando il suo indirizzo interno (192.168.3.34:8080) invece dell'URL pubblico (https://geodati.gov.it/RNDT).

Nei prodotti Esri Geoportal Server il parametro da correggere è tipicamente base.url o system.context.path nel file gpt.properties (o equivalente nella versione in uso).

Impatto

Colpisce tutti i risultati dell'endpoint /rest/metadata/search. Chi consuma l'API programmaticamente e usa i link alternate per navigare il catalogo (recuperare JSON, XML ISO 19139 o HTML di un metadato) ottiene un errore di connessione. I link ai servizi dati reali (WMS, WFS) presenti in _source.links_s non sono affetti.

Contesto

Scoperto durante lo sviluppo di openrndt, CLI Python per il RNDT. Verificato il 2026-06-10.

Azione

• Inviare segnalazione ai devops RNDT tramite il form di contatto del geoportale o la casella istituzionale, allegando la chiamata curl sopra e l'output osservato.

[aborruso]

Aggiornamento: comportamento verificato live per --xml e --html

Verificato live il comportamento dell'API RNDT per path /xml e /html con ID inesistente:

curl -s -o /dev/null -w "%{http_code}" "https://geodati.gov.it/RNDT/rest/metadata/item/id_inesistente/xml"
# → 500  ({"error":{"message":"Exception: java.lang.NullPointerException"}})

curl -s -o /dev/null -w "%{http_code}" "https://geodati.gov.it/RNDT/rest/metadata/item/id_inesistente/html"
# → 501

A differenza del path base (che torna 200+found:false), i sub-path /xml e /html restituiscono errori HTTP reali (5xx), già catturati dal try/except HTTPStatusError esistente. Aggiunto un secondo bug noto da segnalare.

[aborruso]

Testo proposto per la segnalazione a RNDT

---

Oggetto: Segnalazione bug API REST RNDT — link interni non raggiungibili e comportamento anomalo endpoint item

---

Gentile team RNDT,

vi segnalo due anomalie riscontrate nell'API REST del geoportale RNDT (https://geodati.gov.it/RNDT/rest/) durante lo sviluppo di uno strumento open source per l'accesso programmatico al catalogo.

---

Bug 1 — Link alternate nei risultati di ricerca puntano a un IP interno

Endpoint: GET /RNDT/rest/metadata/search

I risultati JSON contengono un campo links con link di tipo alternate (JSON, HTML, XML del singolo metadato) che puntano a un indirizzo IP privato non raggiungibile dall'esterno:

curl -s "https://geodati.gov.it/RNDT/rest/metadata/search?q=catasto&num=1&f=json" \
  | jq '.results[0].links[] | select(.rel == "alternate")'

Output attuale:

{
  "rel": "alternate",
  "type": "application/json",
  "href": "http://192.168.3.34:8080/geoportal-catalog/rest/metadata/item/..."
}

Output atteso:

{
  "rel": "alternate",
  "type": "application/json",
  "href": "https://geodati.gov.it/RNDT/rest/metadata/item/..."
}

Il problema colpisce tutti i risultati dell'endpoint di ricerca. La causa probabile è la configurazione del base URL pubblico nel server Esri Geoportal Server (base.url o system.context.path in gpt.properties).

---

Bug 2 — Endpoint /item/{id}/xml restituisce 500 per ID inesistente, /item/{id}/html restituisce 501

Endpoint: GET /RNDT/rest/metadata/item/{id}/xml e .../html

Per ID non presenti nel catalogo, i due sub-endpoint restituiscono rispettivamente HTTP 500 e HTTP 501 invece del più appropriato HTTP 404.

curl -s -o /dev/null -w "%{http_code}" \
  "https://geodati.gov.it/RNDT/rest/metadata/item/id_inesistente/xml"
# → 500  (body: {"error":{"message":"Exception: java.lang.NullPointerException"}})

curl -s -o /dev/null -w "%{http_code}" \
  "https://geodati.gov.it/RNDT/rest/metadata/item/id_inesistente/html"
# → 501

Il 500 con NullPointerException suggerisce che il server non gestisce il caso "ID non trovato" prima di accedere all'oggetto metadato. Sarebbe opportuno restituire HTTP 404 con un messaggio strutturato.

Nota: l'endpoint base /item/{id} si comporta diversamente — restituisce HTTP 200 con {"found": false} nel body, che è comunque non convenzionale ma almeno non un errore di server.

---

Verificato il 2026-06-10. Le chiamate di test riportate sopra sono riproducibili da qualsiasi client esterno.

Resto disponibile per ulteriori dettagli.

Cordiali saluti

[aborruso]

Riconfermato live 2026-07-17. Il link alternate restituisce ancora http://192.168.3.34:8080/geoportal-catalog/rest/metadata/item/... (identico al report).

Nuova osservazione: il bug colpisce anche la UI ufficiale. Sulla pagina risultati del geoportale (metadata-search-results) i link "Display in HTML / Json / GeoRSS / Atom" puntano a http://192.168.3.34:8080/geoportal-catalog/rest/metadata/search?..., quindi sono rotti per l'utente esterno. Nel JS del portale compare anche un secondo host interno: http://192.168.1.58:8080/geoportalRNDT/rest/index/stats.

[aborruso]

Aggiornamento 2026-07-18 — il percorso pubblico corretto esiste già: manca solo l'host.

Ispezionando il traffico del GeoViewer ufficiale (cattura HAR) si vede che interroga il catalogo su:

https://geodati.gov.it/geoportal-catalog/rest/metadata/search?start=1&num=10&f=json&q=...&bbox=...

È lo stesso percorso che compare nei link alternate rotti — cambia solo l'host. Sostituendo l'IP privato con il dominio pubblico, l'URL funziona:

URL	Esito
http://192.168.3.34:8080/geoportal-catalog/rest/metadata/item/{id}	irraggiungibile dall'esterno
https://geodati.gov.it/geoportal-catalog/rest/metadata/item/{id}	HTTP 200
https://geodati.gov.it/geoportal-catalog/rest/metadata/item/{id}/xml	HTTP 200
https://geodati.gov.it/geoportal-catalog/rest/metadata/item/{id}/html	HTTP 200

Verificato anche che /geoportal-catalog/rest/metadata/search e /RNDT/rest/metadata/search sono la stessa applicazione servita su due percorsi: stesso total (8.827 su q=catasto), stesso comportamento del sort (apiso_Modified_dt ordina, apiso_PublicationDate_dt no), nessuna aggregazione in entrambi.

La correzione è quindi limitata all'allineamento del base URL pubblico nella configurazione di Esri Geoportal Server: il percorso è già corretto e già pubblicamente servito.