iOS SDK'ya genel bakış
Prove ID iOS SDK; kimlik belgesi tarama, NFC çip okuma, hologram kontrolü ve canlılık doğrulamasını iOS uygulamanızda çalıştırmanızı sağlayan bir araç setidir. Ekranları ve akışın sırasını siz tasarlarsınız; SDK size kamera görünümlerini, NFC okuyucuyu ve Prove ID servisleri için bir Swift istemcisini hazır olarak verir.
Framework’ler
Bölüm başlığı “Framework’ler”Kamera ve NFC bileşenleri tek bir CocoaPods paketiyle, techsigncloudlibs ile gelir. Bu paketteki şu modülleri kullanırsınız:
| Modül | İçerik |
|---|---|
RKYC_iOS |
Oturum ve sunucu ayarları (Authentication, EndpointManager), canlılık (LivenessController) ve hologram (HologramController) görünümleri |
id_card_detection_ios_wrapper |
Kimlik belgesini cihaz üzerinde algılayıp yakalayan kamera görünümü (IDCardDetectionWrapper) |
id_card_detection_ios_cnn |
Kamera görünümlerinin kullandığı algılama modelleri ve ayarları (CNNUtil) |
passport_reader |
Kimlik kartı ve pasaport çipini NFC ile okuyan bileşen (PassportReader) |
LivenessWithCard |
İsteğe bağlı; kimlik kartıyla birlikte canlılık (LWICController) |
Prove ID servis çağrıları, Prove ID OpenAPI tanımından üretilen Swift istemcisi ProveIDApiClient ile yapılır (bkz. Kurulum).
Tipik bir doğrulama aşağıdaki adımlardan oluşur. Hangi adımların çalışacağını işlemi başlatırken belirlersiniz.
- İşlemi başlatma — Prove ID’de bir işlem (transaction) açılır ve bir işlem kimliği (
transactionId) alınır. - Belge ön yüzü — Belge kamerada otomatik algılanır, yakalanır ve doğrulanır.
- Belge arka yüzü — T.C. kimlik kartı gibi arka yüzü olan belgeler için.
- Hologram — İsteğe bağlı; kısa bir videoyla hologram kontrol edilir.
- NFC — İsteğe bağlı; belgedeki çip okunur ve doğrulanır.
- Canlılık — Kullanıcıdan kısa bir hareket istenir ve yüzü belgedeki fotoğrafla karşılaştırılır.
- Sonuç — Tüm kontrollerin sonucu işlem kimliğiyle sorgulanır.
Desteklenen belgeler
Bölüm başlığı “Desteklenen belgeler”| Belge | idType |
WrapperCardType |
|---|---|---|
| T.C. kimlik kartı | IDCARD |
.NEW_ID, .NEW_ID_BACK |
| Eski T.C. kimlik kartı | OLDIDCARD |
.OLD_ID |
| Sürücü belgesi | DRIVERCARD |
.NEW_DRIVER, .DRIVER_BACK |
| Pasaport | PASSPORT |
.PASSPORT |
| Mavi kart | BLUECARD |
.BLUE_CARD, .NEW_BLUE_CARD |
| Yabancı kimlik belgesi | FOREIGNID |
.FOREIGN_ID_TYPE_A … .FOREIGN_ID_TYPE_D, .WORK_PERMIT |
| Kart boyutundaki diğer belgeler | — | .CUSTOM(width:height:) (iOS 13+) |
Gereksinimler
Bölüm başlığı “Gereksinimler”- iOS 13.0 ve üzeri
- Xcode ve CocoaPods 1.16 veya üzeri
- Kamera
- NFC adımı için iPhone 7 veya üzeri
- İnternet bağlantısı