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

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).

Akış

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

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

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ı