DigitalID iOS SDK

要求

iOS 11 及以上
将 NSCameraUsageDescription 添加到 info.plist
将 config.xml 文件添加到项目（文档末尾有示例）
不支持类似 custom-url-scheme://my-url 的自定义方案 URL

使用 Cocoapods 安装

Podfile

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '11.0'

pod ‘DigitalID_SDK’, ‘1.3.0’

依赖

- Cordova iOS
- DigitalIDZoomAuthenticationCordovaPlugin

示例

import UIKit
import DigitalID_SDK

class ViewController: UIViewController {
    
    private var didController: DIDViewController?

    override func viewDidLoad() {
        super.viewDidLoad()
        view.backgroundColor = .white
    }
    
    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)

        let options = DigitalIDOptions()
        options.language = "ru"

        didController = DIDViewController(url: "https://app.gov.stage.digital-id.kz/oauth?response_type=code&client_id={client_id}&scope=ID_CARD&redirect_uri=https://www.egov.kz/digital-id-callback&state=EGOV", redirectUrl: "site.com/digital-id-callback", options: options)
        didController?.didDelegate = self
        self.present(didController!, animated: true, completion: nil)
    }
}

extension ViewController: DIDViewControllerDelegate {
    func didViewController(_ viewController: DIDViewController,
                           didTriggerRedirectUrl redirectUrl: String) {
        didController?.dismiss(animated: true, completion: nil)
        didController = nil
    }
}

url - DigitalID 启动地址 redirectUrl - 客户端地址，应完全或部分匹配 url 参数中的 redirect_uri options - SDK 设置。例如，您可以设置 Digital ID 运行的语言。

当 DigitalID 跳转到 url 参数中的 redirect_uri 时，在 func didViewController(_ viewController: DIDViewController, didTriggerRedirectUrl redirectUrl: String) 中调用

🍂

DigitalID SDK - 在 DigitalIDZoomAuthenticationCordovaPlugin 框架中，我们使用了 FaceTec（iOS SDK），FaceTec 公司的 URL 为 https://www.facetec.com/

config.xml 文件示例

<?xml version='1.0' encoding='utf-8'?>
<widget id="io.cordova.helloCordova" version="2.0.0" xmlns="http://www.w3.org/ns/widgets">
    <name>HelloCordova</name>
    <description>
        A sample Apache Cordova application that responds to the deviceready event.
    </description>
    <author email="[email protected]" href="http://cordova.io">
        Apache Cordova Team
    </author>
    <content src="https://app.gov.stage.digital-id.kz/" />
handle
    <plugin name="cordova-plugin-whitelist" spec="1" />
    <access origin="*" launch-external="no"/>
    <allow-navigation href="http://*/*" />
    <allow-navigation href="https://*/*" />
    
    <access origin="*" />
    <allow-intent href="http://*/*" />
    <allow-intent href="https://*/*" />
    <allow-intent href="tel:*" />
    <allow-intent href="sms:*" />
    <allow-intent href="mailto:*" />
    <allow-intent href="geo:*" />
    <access origin="*" />
    <allow-intent href="http://*/*" />
    <allow-intent href="https://*/*" />
    <allow-intent href="tel:*" />
    <allow-intent href="sms:*" />
    <allow-intent href="mailto:*" />
    <allow-intent href="geo:*" />
    <allow-intent href="itms:*" />
    <allow-intent href="itms-apps:*" />
    <preference name="AllowInlineMediaPlayback" value="false" />
    <preference name="BackupWebStorage" value="cloud" />
    <preference name="DisallowOverscroll" value="false" />
    <preference name="EnableViewportScale" value="false" />
    <preference name="KeyboardDisplayRequiresUserAction" value="true" />
    <preference name="MediaPlaybackRequiresUserAction" value="false" />
    <preference name="SuppressesIncrementalRendering" value="false" />
    <preference name="SuppressesLongPressGesture" value="false" />
    <preference name="Suppresses3DTouchGesture" value="false" />
    <preference name="GapBetweenPages" value="0" />
    <preference name="PageLength" value="0" />
    <preference name="PaginationBreakingMode" value="page" />
    <preference name="PaginationMode" value="unpaginated" />
    <feature name="LocalStorage">
        <param name="ios-package" value="CDVLocalStorage" />
    </feature>
    <feature name="HandleOpenUrl">
        <param name="ios-package" value="CDVHandleOpenURL" />
        <param name="onload" value="true" />
    </feature>
    <feature name="IntentAndNavigationFilter">
        <param name="ios-package" value="CDVIntentAndNavigationFilter" />
        <param name="onload" value="true" />
    </feature>
    <feature name="GestureHandler">
        <param name="ios-package" value="CDVGestureHandler" />
        <param name="onload" value="true" />
    </feature>
    <feature name="Console">
        <param name="ios-package" value="CDVLogger" />
    </feature>
    <feature name="FaceTecSDK">
          <param name="ios-package" value="FaceTecCordovaSDK" />
    </feature>
    <preference name="StatusBarOverlaysWebView" value="false" />
    <preference name="StatusBarStyle" value="default" />
    <platform name="ios">
        <preference name="WKWebViewOnly" value="true" />

        <feature name="CDVWKWebViewEngine">
            <param name="ios-package" value="CDVWKWebViewEngine" />
        </feature>

        <preference name="CordovaWebViewEngine" value="CDVWKWebViewEngine" />
    </platform>
</widget>


依赖于
DigitalIDZoomAuthenticationCordovaPlugin	~> 0.6.0
Cordova	>= 0

DigitalID_SDK 1.3.1

DigitalID_SDK 1.3.1

DigitalID_SDK 1.3.1

DigitalID iOS SDK