PROGETTO TESSERA SANITARIA WEB SERVICES DI GESTIONE PASSWORD

Transcript

1 PROGETTO TESSERA SANITARIA WEB SERVICES DI GESTIONE PASSWORD

2 Pag. 2 di 7 1 GENERALITÀ CANALI DI COMUNICAZIONE DEI SISTEMI RILASCIO DELLE CREDENZIALI DI TEST REGOLE DI CAMBIO PASSWORD DEFINITE PER SISTEMATS UTILIZZO DEI SERVIZI SERVIZIO DI CAMBIO PASSWORD SERVIZIO DI CAMBIO PASSWORD SCADUTA SERVIZIO DI VERIFICA GIORNI SCADENZA PASSWORD RECUPERA DOMANDE DI SICUREZZA RIPRISTINO PASSWORD CODIFICA ESITO OPERAZIONE... 7

3 Pag. 3 di 7 1 Generalità I servizi in oggetto consentono agli utenti accreditati presso il SistemaTS in possesso di un pincode, di gestire tutte le funzioni legate alla scadenza, al ripristino ed al cambio della propria password di accesso ai servizi autenticati, al pari di quanto avviene tramite l utilizzo del portale SistemaTS. Le funzionalità di gestione della password, in coerenza con le password policy proprie del SistemaTS, permettono ad ogni utente per la propria utenza di: 1) Cambiare la password prima della scadenza 2) Cambiare la password scaduta 3) Verificare quanti giorni mancano alla scadenza della password 4) Recuperare le domande di sicurezza 5) Reimpostare la password attraverso l utilizzo delle risposte alle domande di sicurezza Per motivi di sicurezza, a differenza delle funzioni disponibili attraverso il portale SistemaTS, le operazioni consentite tramite l utilizzo del web service, saranno fruibili solo attraverso l utilizzo dello username (nickname) e del pincode assegnato all utente dal sistema, e non attraverso il codice fiscale. Le richieste di autenticazione ai servizi, eseguite tramite codice fiscale saranno immediatamente rigettate. Tutte le funzionalità disponibili, prevedono l utilizzo della basic authentication, ma solamente le prime tre funzionalità prevedono un autenticazione canonica, infatti nei casi in cui l utente si suppone abbia completamente dimenticato la password, quindi chieda di recuperate le domande di sicurezza o di reimpostare la password utilizzando le risposte alle domande di sicurezza, la password che dovrà essere comunque valorizzata insieme allo username, potrà essere una qualsiasi tra quelle utilizzate nell ultimo anno. 1.1 Canali di comunicazione dei sistemi I servizi esposti da SistemaTS tramite modello Web Service sono fruibili attraverso canali di comunicazione sicuri data la sensibilità dei dati scambiati. Tutte le operazioni effettuate vengono monitorate e tracciate. Nel caso in cui fossero rilevate attività automatiche anomale (es. richieste multiple durante una stessa giornata di verifica dei giorni di scadenza password), l utenza interessata potrebbe essere soggetta a revoca automatica.

4 Pag. 4 di 7 La cooperazione tra utente interessato e SistemaTS, verrà effettuata attraverso un canale https in basic authentication. Gli ambienti previsti sono: 1) Validazione: contiene dati non reali, è esposto su Internet e viene usato per effettuare i test: 2) Produzione: contiene dati reali: Rilascio delle credenziali di test Per il rilascio del set di credenziali da utilizzare in ambiente di validazione per effettuare i test, è necessario inviare una PEC di richiesta all indirizzo assistenzasts@pec.sistemats.it indicando i riferimenti del soggetto persona fisica a cui vengono rilasciate le credenziali per lo svolgimento dei test. Nella mail è obbligatorio indicare: Nome, Cognome, data di nascita, codice fiscale e numero di telefono cellulare per eventuale ricontatto. La password associata all utente assegnato nasce scaduta, quindi il primo servizio da richiamare e testare è il Regole di cambio password definite per SistemaTS 1) La password deve avere una lunghezza minima di 8 caratteri 2) La password non può contenere il proprio nome, cognome o codice fiscale 3) La password deve rispettare le regole della complessità, quindi rispettare almeno 3 di queste 4 regole: - deve contenere caratteri maiuscoli - deve contenere caratteri minuscoli - deve contenete caratteri numerici - deve contenere i caratteri speciali ( `~!@#$%^&*()_+-={} []"\+:;'<>?,./ ) 4) La password deve essere diversa dalle 8 precedenti

5 Pag. 5 di 7 2 Utilizzo dei servizi Di seguito il riferimento per l utilizzo dei servizi. 2.1 Servizio di cambio password Basic authentication composta da nickname e password corrente. Nei campi applicativi occorre inserire i seguenti dati: 1) Il pincode associato all utente autenticato 2) La password corrente, già impostata nella basic authentication 3) La nuova password, che rispetti i vincoli di password policy definiti da SistemaTS Se il cambio password va a buon fine, è necessario attendere qualche secondo prima di utilizzare la nuova password per l operazione di login. 2.2 Servizio di cambio password scaduta Basic authentication composta da nickname e password corrente ma scaduta. Nei campi applicativi occorre inserire i seguenti dati: 1) Il pincode associato all utente autenticato 2) La nuova password, che rispetti i vincoli di password policy definiti da SistemaTS Attenzione, il servizio verifica che la password sia effettivamente scaduta. In caso contrario viene restituito un messaggio di errore specifico. Se il cambio password va a buon fine, è necessario attendere qualche secondo prima di utilizzare la nuova password per l operazione di login. 2.3 Servizio di verifica giorni scadenza password Basic authentication composta da nickname e password corrente.

6 Pag. 6 di 7 Nei campi applicativi occorre inserire i seguenti dati: 1) Il pincode associato all utente autenticato 2.4 Recupera domande di sicurezza Pseudo basic authentication composta da nickname associato all utente effettivo e password valorizzata con una qualsiasi tra quelle utilizzate nell ultimo anno. Nei campi applicativi occorre inserire i seguenti dati utente: 1) Il pincode associato all utente che vuole effettuare il cambio password 2.5 Ripristino password Pseudo basic authentication composta da nickname associato all utente effettivo e password valorizzata con una qualsiasi tra quelle utilizzate nell ultimo anno. Nei campi applicativi occorre inserire i seguenti dati utente: 1) Il pincode associato all utente che vuole effettuare il cambio password 2) La nuova password, che rispetti i vincoli di password policy definiti da SistemaTS 3) Risposta alla domanda 1 4) Risposta alla domanda 2 Se il ripristino password va a buon fine, è necessario attendere qualche secondo prima di utilizzare la nuova password per l operazione di login.

7 Pag. 7 di 7 3 Codifica Esito Operazione Codice Esito Descrizione Esito 000 operazione conclusa correttamente 101 tipo utente non autorizzato al cambio password 102 pincode non valido 103 la password non rispetta i criteri di complessita' previsti 104 la password non risulta scaduta 105 non risultano inserite domande di sicurezza inserire domande e risposte tramite portale 106 risposte non valide 107 password scaduta - usare funzione di cambio password scaduta 108 la nuova password deve essere diversa dalle 8 precedenti 109 la nuova password deve avere la lunghezza minima di 8 caratteri 110 operazione non consentita 200 errore nell'applicazione - contattare l'assistenza Nel caso in cui l autenticazione ai servizi dovesse fallire, ad esempio per password errata il messaggio restituito sarà del tipo: HTTP/ Unauthorized Content-Type: text/xml WWW-Authenticate: Basic realm=login X-Backside-Transport: FAIL FAIL Connection: close <?xml version="1.0" encoding="utf-8"?> <env:envelope xmlns:env=" ejected by policy. (from client)</faultstring></env:fault></env:body></env:envelope> Nel caso in cui invece l utente non sia valido il messaggio sarà il seguente: HTTP/ Internal Server Error Content-Type: text/xml X-Backside-Transport: FAIL FAIL Connection: close <?xml version="1.0" encoding="utf-8"?> <env:envelope xmlns:env=" ickname invalido (from client)</faultstring></env:fault></env:body></env:envelope>