Iit Istituto di Informatica e Telematica

Transcript

1 C Consiglio Nazionale delle Ricerche ARP: il Portale di Accreditamento dei Registrar del Registro.it M. Loffredo, F. Marra, M. Martinelli, G. Raciti, G. Succurro IIT B4-04/2016 Nota Interna Marzo 2016 Iit Istituto di Informatica e Telematica

2 ARP: il Portale di Accreditamento dei Registrar del Registro.IT Mario Loffredo, Francesco Marra, Maurizio Martinelli, Gabriella Raciti, Giuseppe Succurro

3 Sommario 1 Introduzione Il Test di Accreditamento Caratteristiche del Portale ARP Funzionalità del Portale Utenti Registrar Operatore Amministratore Documentazione Regolamenti, Linee Guida e RFC in vigore Guida al Test La Libreria Client EPP del Registro.it Passi per l'accreditamento Registrazione Dati Prenotazione del Test Esito del Test Configurazione del portale ARP Scelte Implementative Database di Accreditamento Bibliografia... 20

4 1 Introduzione Il sistema sincrono di gestione dei nomi a dominio sotto il cctld.it è basato sul protocollo EPP (1) e consente la registrazione e la gestione dei nomi a dominio in tempo reale. A differenza del precedente sistema asincrono, basato sull invio di documentazione cartacea, i Registrar devono, per portare avanti la propria normale operatività, dotarsi di un client EPP che comunichi con il server EPP (11) del Registro.it. Un aspirante Registrar deve, pertanto, superare una fase di accreditamento tecnico per dimostrare che il proprio client abbia correttamente implementato il protocollo EPP in accordo alle linee guida tecniche del Registro.it. Rispetto al protocollo EPP standard, le linee guida definiscono: Gli oggetti supportati I comandi disponibili su ciascuno degli oggetti Gli stati nei quali in ogni momento possono trovarsi gli oggetti Le estensioni definite dal Registro.it agli oggetti, ai comandi e agli stati Il portale ARP (Accreditation Registrar Portal) è lo strumento messo a disposizione dal Registro.it per supportare un aspirante Registrar durante la fase di accreditamento tecnico. 2 Il Test di Accreditamento La fase di accreditamento tecnico prevede che un aspirante Registrar debba eseguire un test cioè una serie di operazioni descritte in un apposito documento entro un tempo prestabilito interagendo con una versione dedicata del server EPP del Registro.it detta server di accreditamento. Per eseguire il test di accreditamento, un aspirante Registrar deve eseguire i seguenti passi: 1. Accedere al portale ARP con le credenziali fornite dall amministrazione del Registro.it che poi saranno le stesse che il Registrar potrà utilizzare, una volta superata la procedura di accreditamento, per poter interagire con il server EPP di produzione 2. Registrare una serie di dati necessari a creare l ambiente per il server di accreditamento; fra i vari dati, vale la pena evidenziare l indirizzo IP statico della macchina client dalla quale il Registrar eseguirà il proprio test di accreditamento 3. Prenotare in una data una sessione di test di accreditamento su una delle istanze del server di accreditamento messi a disposizione in uno degli slot temporali previsti 4. Eseguire il test 5. Verificare l esito del test 1

5 3 Caratteristiche del Portale ARP Il portale ARP comprende 6 voci di menù principali (Fig.1): Home: link alla pagina iniziale del portale; Documenti: link alla pagina dedicata ai documenti ufficiali del sistema sincrono; Accreditamento: elenco dei sottomenù dedicati alle varie fasi dell'accreditamento con funzionalità diversificate in base al ruolo. I ruoli definiti sono quelli di Amministratore, Registrar e Operatore. EPP Client: link alla pagina dedicata alla documentazione relativa alla libreria client messa a disposizione dal Registro.it; English: link che modifica la lingua del portale in lingua Inglese; se si è già in lingua inglese la voce di menù diventa Italiano per consentire la modifica inversa; Logout: link per uscire dal portale. Fig.1 Pagina iniziale di ARP (utente Registrar) L utente Operatore ha una voce in più nel menù Accreditamento (Fig.2), rispetto all utente Registrar, in quanto può visionare anche la lista dei Registrar accreditati. 2

6 Fig.2 Pagina iniziale di ARP (utente Operatore) L utente Amministratore ha una ulteriore voce in più nel menù Accreditamento (Fig.3), rispetto all utente Operatore, in quanto può configurare il portale ARP attraverso la sottovoce di menù Inserimento date. Fig.3 Pagina iniziale di ARP (utente Amministratore) 4 Funzionalità del Portale Il portale ha lo scopo di guidare l'utente attraverso le varie fasi dell'accreditamento tecnico in funzione del proprio ruolo. 3

7 4.1 Utenti Il portale associa al momento dell'autenticazione in base allo username utilizzato un ruolo e, di conseguenza, modifica le voci disponibili del sottomenù Accreditamento Registrar L utente Registrar può: Consultare la documentazione Scaricare il documento di guida al test di accreditamento Inserire i dati obbligatori per poter procedere con la prenotazione del test di accreditamento Consultare il calendario per prenotare la propria sessione di test Verificare l'esito dei test svolti Visualizzare il dettaglio dei test di accreditamento svolti Operatore L utente Operatore monitora le prenotazioni effettuate dai Registrar ed ha la funzione di seguire i test di cui ha preso la gestione, curandosi di ricordare ai Registar le prenotazioni effettuate, fornire l assistenza tecnica necessaria per lo svolgimento del test ed infine verificarne l'esito per: Rispondere alle eventuali richieste di chiarimento conseguenti ad un test terminato con insuccesso Comunicare all amministrazione il completamento della procedura di accreditamento tecnico in caso di test terminato con successo Amministratore L utente Amministratore, oltre ad accedere alle stesse funzionalità dell utente Operatore, è l unico che può configurare il portale modificando gli host, le date, gli orari dei test disponibili, oltre ad essere l unico a poter modificare l'indirizzo IP di un Registrar una volta che quest'ultimo lo abbia impostato dal pannello dedicato alla registrazione dei propri dati. 4.2 Documentazione Sul portale sono disponibili tutti i documenti necessari per poter effettuare il test di accreditamento. Questi documenti si dividono in due categorie: 4

8 I documenti propedeutici relativi al protocollo EPP in generale e relativi alla politica di registrazione e gestione dei nomi a dominio nel cctld.it e alla particolare implementazione del protocollo EPP del Registro.it Il documento specifico del test di accreditamento Regolamenti, Linee Guida e RFC in vigore Tramite la voce di menù Documenti del portale ARP è possibile accedere alla pagina (Fig.4) che riporta i link ai documenti della prima categoria: Regolamento di assegnazione dei nomi a dominio (7) : detta i principi generali che governano la registrazione dei nomi a dominio nel cctld.it. Linee Guida tecniche sincrono (8) : descrivono dettagliatamente tutti gli aspetti tecnici correlati alle varie operazioni consentite sui nomi a dominio, con particolare riferimento alla sintassi esatta dei comandi EPP specifici di ogni operazione Gli RFC del protocollo EPP: o RFC Extensible Provisioning Protocol (EPP) (1) o RFC Extensible Provisioning Protocol (EPP) Domain Name Mapping (2) o RFC Extensible Provisioning Protocol (EPP) Host Mapping (3) o RFC Extensible Provisioning Protocol (EPP) Contact Mapping (4) o RFC3735 Guidelines for Extending the Extensible Provisioning Protocol (EPP) (5) o RFC Domain Registry Grace Period Mapping for the Extensible Provisioning Protocol (EPP) (6) Fig.4 Pagina Documenti 5

9 4.2.2 Guida al Test Il documento indispensabile per la fase di accreditamento tecnico del Registrar è senza dubbio il documento di guida al test il cui link è disponibile alla pagina (Fig.5) accessibile dalla sottovoce Test di Accreditamento del menù Accreditamento. Fig.5 Pagina Test di accreditamento Il documento descrive in modo dettagliato le operazioni da eseguire durante la sessione di test, elencando ad ogni passo, i comandi da eseguire, i dati da utilizzare e le corrispondenti risposte attese. Una versione sintetica del test di accreditamento in vigore è disponibile sul sito del Registro.it (9). La pagina contiene una serie di indicazioni sulla corretta modalità di esecuzione del test suddivise in: Durata e tempi del test Il Registrar ha a disposizione 60 minuti per poter effettuare il test di accreditamento. Durante il test non è previsto alcun supporto da parte degli operatori del Registro. 6

10 Il test di accreditamento deve essere superato entro 5 mesi dalla data di sottoscrizione del contratto da parte del Registrar. Esso deve essere effettuato con un intervallo minimo di 7 giorni tra una prova e la successiva per un numero massimo di prove non superiore a 12. Accounts I test di accreditamento sono effettuati su due macchine dedicate del Registro, eppacc1.nic.it e epp-acc2.nic.it. Il Registrar dovrà collegarsi alla macchina a lui assegnata in fase di prenotazione del test e eseguire le operazioni richieste dalla procedura di accreditamento. La connessione client-server è di tipo HTTPS. Corretta esecuzione e completamento del test di accreditamento Il Registrar dovrà completare il test in maniera corretta, rispettando l ordine di esecuzione delle varie operazioni e terminando entro il tempo previsto. Le operazioni devono essere eseguite su un unica sessione HTTPS, se non diversamente richiesto dalla sequenza dei comandi presenti nel test. La procedura di accreditamento non prevede la configurazione, da parte del Registrar, dei nameserver utilizzati durante il test La Libreria Client EPP del Registro.it Dalla voce di menù EPP client è possibile accedere ad una pagina (Fig.6) contenente il link all'ultima versione della libreria client EPP sviluppata dal Registro.it in linguaggio Java (10). La libreria contiene una serie di classi che implementano le seguenti funzionalità: Creazione di una connessione HTTPS Creazione e mantenimento della sessione di lavoro Generazione dell XML per l invio delle richieste Parsing delle risposte ed estrazione delle informazioni di interesse E quindi sufficiente per un Registrar costruire la propria interfaccia client sulla base delle funzionalità messe a disposizione dalla suddetta libreria. 7

11 4.3 Passi per l'accreditamento Fig.6 Pagina EPP Client Passiamo adesso a vedere come un aspirante Registrar può praticamente eseguire il test di accreditamento. Per ogni passo riporteremo le diverse viste per gli utenti Registrar, Operatore e Amministratore laddove tali differenze saranno presenti Registrazione Dati Il primo passo che l utente Registrar deve eseguire è la registrazione dei dati propedeutici per il test di accreditamento ed è possibile effettuarlo accedendo alla pagina dedicata (Fig.7) tramite la sottovoce Registrazione dei Dai contatto del menù Accreditamento 8

12 Fig.7 Pagina Dati Contatto (utente Registrar) I dati richiesti sono: I dati del contatto di riferimento per la procedura tecnica di accreditamento che permettono al Registro.it di avere la possibilità di contattare telefonicamente o via mail il Registrar per comunicazioni relative allo svolgimento del test (Reminder, Solleciti, ecc.); L'indirizzo IP è indispensabile in quanto durante il test il server accetterà richieste esclusivamente provenienti dall'ip abilitato, salvaguardando il sistema da intrusioni esterne durante il test stesso. Inoltre l'indirizzo IP da abilitare per il test di accreditamento dovrà essere univoco, cioè l'ip da abilitare non dovrà essere già stato precedentemente abilitato da altri Registrar per il test di accreditamento. Infine gli ultimi 2 campi, non modificabili da parte del Registrar, segnalano il numero di tentativi ancora disponibili sul massimo dei 12 concessi e la data limite oltre la quale non e' più consentito sostenere il test di accreditamento, anche nel caso di tentativi ancora disponibili. La stessa pagina si presenta per l utente Operatore in maniera leggermente differente. 9

13 In pratica la pagina (Fig.8) ha puramente la finalità di consultazione dei dati registrati da ciascun aspirante Registrar. Fig.8 Pagina Dati Contatto (utente Operatore) L unica differenza con l utente Amministratore è che questo può modificare l indirizzo IP della macchina client scelta per eseguire il test di accreditamento Prenotazione del Test Completata la fase di registrazione dei dati è possibile procedere con la prenotazione del test di accreditamento accedendo alla pagina dedicata (Fig. 9) dalla sottovoce Prenotazione del Test del menù Accreditamento. Prenotando uno degli slot temporali liberi, il portale impedisce l effettuazione di una nuova prenotazione prima di aver eseguito il test nella data e l ora stabilite. Comunque, in caso di fallimento del test, le date disponibili per la successiva prenotazione partiranno dopo 7 giorni dall ultimo test prenotato. In caso di superamento del test di accreditamento il portale non permette di effettuare nuove prenotazioni. Alternativamente è possibile cancellare una prenotazione effettuata precedentemente, entro 30 minuti dalla stessa, deselezionando la casella relativa alla prenotazione. 10

14 Fig.9 Pagina Prenotazione del test (utente Registrar) La corrispondente pagina per l utente Operatore (Fig. 10) permette ad un operatore di visualizzare i test di accreditamento prenotati e l associazione fra i suddetti test e gli operatori: 11

15 In rosso, i test a cui, al momento, non è associato alcun operatore: è possibile cliccare sul test per associare il test all operatore corrente; In celeste, i test a cui, al momento, è associato l operatore corrente: è possibile cliccare sul test per dissociare il test dall operatore corrente; In grigio, i test a cui, al momento, è associato un operatore diverso da quello corrente: è possibile cliccare sul test per associare il test all operatore corrente; Fig.10 Pagina Prenotazione del test (utente Operatore) L utente Amministratore può cliccando su una prenotazione effettuare una serie di azioni (Fig.11): Associare un operatore alla prenotazione 12

16 Annullare la prenotazione Inserire un altra prenotazione per un Registrar Esito del Test Fig.11 Pagina Cambia Prenotazione (utente Amministratore) Dopo l effettuazione del test di accreditamento, l utente Registrar può verificare l esito dei test sostenuto accedendo all apposita pagina (Fig.12) dalla sottovoce Prenotazioni ed Esiti dei test del menù Accreditamento. 13

17 Fig.12 Pagina Prenotazioni ed esiti dei test (utente Registrar) Per quanto riguarda invece la corrispondente pagina dell utente Operatore (Fig.13), è possibile selezionare un Registrar è visualizzare lo stesso contenuto della pagina per l utente Registrar. Fig.13 Pagina Prenotazioni ed esiti dei test (utente Operatore) Cliccando sul link view è possibile visualizzarne i dettagli del relativo test effettuato (Fig.14) cioè la sequenza cronologica di tutti i comandi inviati durante la sessione di test dal Registrar in modo da permettergli di analizzare i comandi inviati e, nel caso di fallimento, verificare quali comandi sono andati a buon fine e quali sono stati gli errori commessi. 14

18 Fig.14 Pagina Dettagli (utente Registrar) In tal modo è possibile capire quali passi del test non si è riusciti a superare, così da poter concentrare la propria attenzione sui comandi falliti. 15

19 A differenza della vista per l utente Registrar, l utente Operatore può non solo visionare le richieste EPP inviate ma anche confrontare le richieste inviate con quelle attese (Fig.15). Fig.15 Dettaglio di test di accreditamento (utente Operatore) Configurazione del portale ARP La configurazione del portale ARP avviene attraverso la pagina Inserimento date per test ed è una funzionalità disponibile solo per l utente Amministratore. E possibile impostare: Il range di date per le prenotazioni; i giorni della settimana; gli slot temporali; 16

20 gli host che ospitano il server di accreditamento. Di seguito (Fig.16) sono riportate le impostazioni attuali del portale ARP. Gli slot temporali delle ore e delle ore sono stati attivati in periodi di particolare concentrazione delle prenotazioni al test di accreditamento. Fig.16 Configurazione del portale ARP (utente Amministratore) 17

21 5 Scelte Implementative Per lo sviluppo del portale si è deciso di optare per un insieme di pagine HTML al cui interno vengono effettuate chiamate ai vari moduli di elaborazione implementati come Servlet Java che restituiscono pagine HTML dinamiche. Nello specifico la parte del portale sviluppata come Servlet riguarda il salvataggio dei dati del contatto, l elaborazione del calendario in base agli slot disponibili ed ai dati specifici del Registrar (test già sostenuti, termine ultimo per il superamento del test) ed infine per la visualizzazione delle prenotazioni effettuate e dell esito dei test sostenuti. 5.1 Database di Accreditamento Il portale ARP preleva le informazioni necessarie per l autenticazione direttamente dal database centrale NIC, su cui operano anche le altre applicazioni del Registro.it, come Il server EPP ed il portale RAIN-NG. Per quanto riguarda i dati generali del test di accreditamento (lista dei comandi della specifica versione del test di accreditamento assegnato) e quelli particolari del Registrar (dati del contatto, prenotazioni effettuate e dettaglio dei test sostenuti) il portale ARP preleva e modifica le informazioni necessarie dal database Accreditation. Di seguito lo schema dettagliato del database Accreditation (Fig.17). 18

22 Fig.17 Schema del database Accreditation 19

23 Bibliografia 1. Hollenbeck, S. (2009, August). Extensible Provisioning Protocol (EPP). Tratto da 2. Hollenbeck, S. (2009, August). Extensible Provisioning Protocol (EPP) Domain Name Mapping. Tratto da 3. Hollenbeck, S. (2009, August). Extensible Provisioning Protocol (EPP) Host Name Mapping. Tratto da 4. Hollenbeck, S. (2009, August). Extensible Provisioning Protocol (EPP) Contact Mapping. Tratto da 5. Hollenbeck, S. (2004, March). Guidelines for Extending the Extensible Provisioning Protocol (EPP). Tratto da 6. Hollenbeck, S. (2004, September). Domain Registry Grace Period Mapping for the Extensible Provisioning Protocol (EPP). Tratto da 7. Registro.it. (2012, Luglio). Assegnazione e gestione dei nomi a dominio nel cctld.it. Tratto da 8. Registro.it. (2012, Luglio). Gestione delle operazioni sui nomi a dominio nel cctld.it. Tratto da 9. Registro.it (2015, Settembre). Procedura tecnica di accreditamento dei Registrar. Tratto da pdf 10. Loffredo M., Martinelli M., Lucchesi C. (2010). La libreria client EPP del registro italiano, Technical Report IIT TR-35/ Martinelli M, Loffredo M., Lucchesi C., Luconi Trombacchi L. (2010): The EPP server of the.it Registry: main features and functionalities, Technical Report IIT TR-15/