セキュアロガーでログを収集する

概要

セキュアロガーは NFC Wallet SDK の実行ログを収集します。アプリケーションのサンドボックス内に安全に保存されます。

お使いのデジタルウォレットアプリケーションは、ログファイルを取得し、トラブルシューティングのために Thales と共有できます。

SDK統合

ログレベルを設定する

セキュアロガーは既定で有効になっており、ログレベルは warn.

ログレベル	説明
debug	トラブルシューティングとデバッグのために詳細な情報を記録します。
info	API のエントリ／エグジットポイントや戻り値などの通常メッセージを記録します。
warn	通常実行中の警告および重大なフローの問題を記録します。
error	フローが正常に完了するのを妨げるエラーを記録します。
fatal	直ちに対応が必要な実行時エラーを記録します。
off	ログ記録を無効にします。

セキュアロガーのインスタンスを取得する

SDK からセキュアロガーのインスタンスを取得します:

// TSHPay SDK から securelog オブジェクトを取得
let securelog = TSHPay.secureLog

本番環境では、 warn 通常の状態に保ってください。

問題を再現するには、エンドユーザーにより詳細なレベルを有効にしてもらいます。その後、問題を再現し、ログファイルを共有してください。

セキュアロガーを無効にする

セキュアロガーを無効にするには:

// レベルを off に設定すると、ログは無効になります。MPA は別のレベルを選択することで有効にできます。たとえば debug
securelog.setLevel(.off)

ログファイルを取得する

ログファイルを取得するには:

// ファイル一覧を返す
let files = securelog.files()

ログファイルを削除する

ログファイルを削除するには:

// ファイルを削除
securelog.deleteFiles()

ログファイルを共有する（例）

この例では、ログを次の方法で共有します: UIActivityViewController.

デジタルウォレットアプリケーションは、ログをファイルサーバーにもアップロードできます。

承認済みの他のチャネルを通じてログを送信することもできます。

// ログを共有
    func archieveLogsURL(_ onComplete: @escaping (URL?) -> ()) {
        var error: NSError?
        guard let file = TSHPay.secureLog.files().first?.absoluteURL.deletingLastPathComponent(),
            let fileURL = URL(string: "file://\(file.absoluteString)") else {
            onComplete(nil)
            return
        }
        
        NSFileCoordinator().coordinate(
            readingItemAt: fileURL,
            options: [.forUploading],
            error: &error
        ) { zipUrl in
            do {
                let tmpUrl = try FileManager.default
                    .url(
                        for: .itemReplacementDirectory,
                        in: .userDomainMask,
                        appropriateFor: zipUrl,
                        create: true
                    )
                    .appendingPathComponent("archive.zip")
                
                try FileManager.default.moveItem(at: zipUrl, to: tmpUrl)
                onComplete(tmpUrl)
            } catch {
                onComplete(nil)
            }
        }
    }