1. はじめに

本ドキュメントは Trust Idiom/ID を導入される企業様に向けた、モバイルアプリ (iOS) 向けの SDK で　LIQUID eKYCサービスを利用する際のインストール方法、実装方法などをまとめたマニュアルです。

本ドキュメントはTrust Idiom/ID SDK for iOS V2 導入マニュアルにてSDKの導入が完了していることを前提としています。

本ドキュメント及び SDK の構成については今後変更される場合があります。

1.1. 動作環境

SDK は以下の環境での動作を保証しています。

Table 1. 動作環境

OS

iOS 13.x 以上

アーキテクチャ

ARM

1.2. LIQUID eKYC Applicant SDK について

LIQUID eKYC Applicant SDK は株式会社 LIQUID 製のネイティブアプリ向け本人確認業務の自動化に対応した SDK です。

1.2.1. Xcode へのインポート

Zip ファイルを解凍すると次のファイル構成になっていることが確認できます。

Table 2. SDK のファイル構成
ファイルまたはフォルダ名 説明

Liquid.xcframework

LIQUID フレームワーク

ItrustEkycLibrary.xcframework

LIQUID フレームワーク

TrustID-Info.plist

Trust Idiom/ID SDK の設定ファイル

LiquidAdapter.framework

LIQUID 拡張フレームワーク

eKYC / Auth Face に関わる機能は LiquidAdapter フレームワークで提供しています。

一般的な手順で各フレームワーク を導入してください。

1.3. Info.plistの設定追加

  • Info.plist を開きます。もし存在しない場合、一般的な手順で追加してください

    • 「NFC の使用目的」および「対象となるカードの Application ID (略称、AID)」を記載します

  • NFCの使用目的

    • 以下の通り追加してください。Key は、入力ボックスのリストから選択してください

    • Key : Privacy - NFC Scan Usage Description

    • Value : 本人確認のためにNFCを利用します / NFC is used for KYC

  • 対象となるカードの Application ID (略称、AID)

    • 以下の通り追加してください。Key は、 入力ボックスのリストから選択してください

    • Key : ISO7816 application identifiers for NFC Tag Reader Session

    • Value : 以下の英数文字列のうち、利用する書類の英数文字列をすべて指定

      • 運転免許証用 / for Driver License

      • 在留カード用 / for Residence Car

      • マイナンバーカード用 / for Individual Number Card

利用する本人確認書類に応じた値を設定します。具体的な値はLIQUID 営業担当へお問い合わせください。

1.3.1. Trust Idiom/ID SDK への設定追加

Trust Idiom/ID SDK の設定ファイル TrustID-Info.plistに設定を追加します。

Table 3. TrustID-Info.plist 設定値
key 説明

LIQUID_ENDPOINT

LIQUIDのURL ※1

LIQUID_API_KEY

LIQUIDのAPI-KEY ※1

※1 は LIQUID で発行した値を設定する必要があります。担当者までご連絡ください。

1.4. クイックスタート

Trust Idiomの画面が起動することを確認します。

import UIKit
import TrustIDSDK

class LoginViewController: UIViewController {

    let service = TrustIDV2Service.shared

    override func viewDidLoad() {
        super.viewDidLoad()
        service.configure()
    }

    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        service.login(from: self, clientId: "", scope: ["openid"])
    }
}

2. ekycの動作確認

LIQUID の機能はモジュールを組み込むだけで利用可能です。

FIDO登録後に、口座開設または口座連携の申込みを実施することで、ekycの動作確認を実施できます。