Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/italia/spid-ios-sdk
SPID authentication library for iOS
https://github.com/italia/spid-ios-sdk
ios objective-c sdk spid swift
Last synced: 21 days ago
JSON representation
SPID authentication library for iOS
- Host: GitHub
- URL: https://github.com/italia/spid-ios-sdk
- Owner: italia
- License: bsd-3-clause
- Created: 2017-09-28T09:09:37.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2021-03-31T09:44:59.000Z (over 3 years ago)
- Last Synced: 2024-04-13T09:20:02.707Z (3 months ago)
- Topics: ios, objective-c, sdk, spid, swift
- Language: Swift
- Size: 13.4 MB
- Stars: 6
- Watchers: 11
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- .github - spid-ios-sdk
README
----------
# spid-ios
SPID authentication library for iOS
⚠️ Attenzione! Questo progetto non è più manutenuto dai suoi autori. Si consiglia di utilizzare [SPIDlibraryIOS di INPS](https://github.com/INPS-it/SPIDlibraryIOS).
# 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)