spid-ios

SPID authentication library for iOS

⚠️ Attenzione! Questo progetto non è più manutenuto dai suoi autori. Si consiglia di utilizzare SPIDlibraryIOS di INPS.

Configurazione dell'applicazione

Per la gestione delle dipendenze è stato utilizzato Carthage. Per il download delle dipendenze usare il comando da bash:

> carthage update

Per la generazione degli enum corrispondenti alle immagine, stringhe localizzate è stato utilizzato Swiftgen (https://github.com/SwiftGen/SwiftGen). Per la generazione delle classi Swift è stato creato uno script sh:

> ./GenerateResources.sh

Funzionamento dell'app

Tutti i file della libreria sono contenuti nella directory SPIDSDK. Per la gestione del pulsante e sua configurazione è necessario utilizzare la classe UISPIDButton:

Servizi REST

L'app richiama due servizi REST:

• Servizio per ottenere l'elenco degli identity providerà
• Servizio per ottenere l'url di login (verso cui eseguire il post dei dati) dell'identity provider passando in input l'identityId

I servizi sono mocked e sono pubblicati su mock.io (inizialmente si richiamavano i servizi REST implementati dal TEAM: https://github.com/Gianluke/spid-spring).

Workflow applicazione:

1) Tap sul pulsante "Entra in SPID" 2) Si richiama il servizio per ottenere gli identity provider 3) Tap su un identity provider 4) Si richiama il servizio REST per ottenere l'url dell'identità provider 5) Si carica l'url nella UIWebView 6) L'utente esegue la login con SPID (ora è configurato solo POSTE ID) 7) Se le credenziali sono corrette appare il messaggio di successo e viene chiusa la UIWebView

Screenshot

Pulsante SPID

Elenco degli Identity Providers

Webview con la pagina di login di PosteID

Login eseguita con successo

Info implementazione

L'sdk gestisce le chiamate verso la webview in POST. La funzionalità dovrà essere utilizzata per ottenere la pagina di login dell'identity provider. E' necessario utilizzare questo metodo:

fileprivate func openBrowser(url: String, body: String? = nil) 

La funzione accetta in input l'url da visualizzare nel browser e il body da inviare al post: I dati da utilizzare sono restituiti dal REST /auth-spid. La risposta è:

{
  "xmlAuthRequest": "Body da inviare al post",
  "destinationUrl": "url Identidy Provider"
}

L'sdk gestisce anche la risposta ottenuta dalla WebView. Il delegato da utilizzare è:

public protocol SwiftWebVCDelegate: class {
    func didStartLoading()
    func didFinishLoading(url: String?, body: String?, success: Bool)
}

Per ottenere il json di risposta è necessario utilizzare la funzione didFinishLoading ed ottenere il body. La decodifica della risposta è stata eseguita in modalità mock, questi sono i dati restituiti:

{
  "codiceFiscale": "string",
  "codiceIdentificativo": "string",
  "cognome": "string",
  "dataNascita": "2017-10-08T07:16:48.527Z",
  "dataScadenzaIdentita": "2017-10-08T07:16:48.527Z",
  "documentoIdentita": "string",
  "emailAddress": "string",
  "emailPec": "string",
  "indirizzoDomicilio": "string",
  "indirizzoSedeLegale": "string",
  "luogoNascita": "string",
  "nome": "string",
  "numeroTelefono": "string",
  "partitaIva": "string",
  "provinciaNascita": "string",
  "ragioneSociale": "string",
  "sesso": "string"
}

To do

1) Integrazione con i servizi reali 2) Chiamata POST verso l'url dell'identity provider (attualmente gestita con servizi MOCK) 3) Parsing della risposta (20X o 50X) ottenuta dopo aver eseguito la login (attualmente gestita con servizi MOCK)