Trust Idiom/ID SDK for Android Polarify & BizPICO 導入マニュアル

1. 変更履歴

Table 1. 1.0.2変更点
変更箇所	内容
`画面表示`	Action Barの非活性化および、画面回転防止が含まれています。

2. はじめに

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

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

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

3. 動作環境

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

Table 2. 動作環境
OS	Android 8.0 以上
minSdk	26 以上

4. ライブラリー設定

4.1. trustid-ekyc-adapter

trustid-ekyc-adapter.zip ファイルを解凍すると次のファイル構成になっていることが確認できます。

Table 3. ファイル構成
ファイルまたはフォルダ名	説明
`trustid-ekyc-adapter.aar`	TrustIdiomEKYCSDKの本体

4.2. trust-idiom-ekyc-sdk

trust-idiom-ekyc-sdk.zip ファイルを解凍すると次のファイル構成になっていることが確認できます。

Table 4. ファイル構成
ファイルまたはフォルダ名	説明
`trust-idiom-ekyc-sdk.aar`	TrustIdiomEKYCSDKの本体
`trust-idiom-ekyc.json`	TrustIdiomEKYCSDKの設定ファイル

4.3. Polarify

polarify-comply-ho-adapter.zip ファイルを解凍すると次のファイル構成になっていることが確認できます。

Table 5. ファイル構成
ファイルまたはフォルダ名	説明
`polarify-comply-ho-adapter.aar`	Polarify拡張モジュール

4.4. BizPICO

bizpico-comply-wa-adapter.zip ファイルを解凍すると次のファイル構成になっていることが確認できます。

Table 6. ファイル構成
ファイルまたはフォルダ名	説明
`bizpico-comply-wa-adapter.aar`	BizPICO拡張モジュール
`mnc_library_module-release-x.x.x.aar`	BizPICOサービス提供のマイナンバーカード読取機能モジュール※1
`F_JLA_ALC-x.x.x.aar`	BizPICOサービス提供の証明書解析機能モジュール※1

※1 詳細はBizPICOサービスから提供されたドキュメントをご確認ください。

4.5. 設定ファイル

設定ファイル trust-idiom-ekyc.json　を assets に配置します。

Table 7. trust-idiom-ekyc.json 設定値
key	説明
env	動作環境 (開発用: DEBUG、本番用: RELEASE)※1
webViewVersion	WebViewのバージョン※2
complyHoClassName	jp.trustid.sdk.ekyc.polarify.complyho.PolarifyComplyHoClient
complyWaClassName	jp.trustid.sdk.ekyc.bizpico.complywa.BizPICOComplyWaClient

※1 Trust Idiom/ID SDK の設定と一致させる必要があります。 ※2 2025/03時点でのWebViewのバージョンは 1.0 です。

4.5.1. build.gradle の編集

Android アプリモジュールの build.gradle に以下を追記し、libs ディレクトリに .aar ファイル及び必要な依存関係を追加します。

// x.x.x は導入するファイルのバージョンに置き換え
dependencies {
    implementation files('libs/trustid-ekyc-adapter.aar')
    implementation files('libs/trust-idiom-ekyc-sdk.aar')
    implementation files('libs/polarify-comply-ho-adapter.aar')
    implementation files('libs/bizpico-comply-wa-adapter.aar')
    implementation files('libs/mnc_library_module-release-x.x.x.aar')
    implementation files('libs/F_JLA_ALC-x.x.x.aar')
    //Polarify用
    implementation 'androidx.browser:browser:x.x.x'
    //BizPICO用
    implementation 'org.bouncycastle:bcprov-jdk18on:1.77'
    implementation 'org.bouncycastle:bcpkix-jdk18on:1.77'
    implementation 'androidx.activity:activity-ktx:x.x.x'
}

    // 20250307時点
    implementation files('libs/mnc_library_module-release-1.4.1.aar')
    implementation files('libs/F_JLA_ALC-1.0.1.aar')
    //Polarify用
    implementation 'androidx.browser:browser:1.6.0'
    //BizPICO用
    implementation 'org.bouncycastle:bcprov-jdk18on:1.77'
    implementation 'org.bouncycastle:bcpkix-jdk18on:1.77'
    implementation 'androidx.activity:activity-ktx:1.9.3'

4.5.2. AndroidManifest の設定

本 SDK は NFC の機能を利用します。利用に当たって、AndroidManifest に以下 Android パーミッションの定義を追加してください。

<uses-permission android:name="android.permission.NFC " />

5. クイックスタート

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

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import jp.trustid.sdk.api.*
import jp.trustid.sdk.api.exception.TrustIDError
import jp.trustid.sdk.api.util.LoginResponse
import jp.trustid.sdk.nc_adapter.FidoClient

class MainActivity : AppCompatActivity(), LoginCallback {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val service = TrustIDV2ServiceFactory.INSTANCE.create(this);
        service.login(
            query = hashMapOf(),
            clientId = "clientId",
            scope = listOf("openid", "profile", "phone", "email"),
            customHeaders = hashMapOf(),
            handler = this)
    }

    override fun onFailure(error: LoginError, cause: TrustIDError) {
        // 失敗時のハンドリング
    }

    override fun onSuccess(response: LoginResponse) {
        // 成功時のハンドリング
    }

}

6. ekycの動作確認

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

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