Recopilar registros con el registrador seguro

Resumen

El registrador seguro recopila registros de ejecución del SDK de billetera NFC. Los almacena de forma segura en el sandbox de la aplicación.

Su aplicación de billetera digital puede recuperar archivos de registro y compartirlos con Thales para la resolución de problemas.

Integración del SDK

Establecer el nivel de registro

El registrador seguro está habilitado por defecto con el nivel de registro establecido en warn.

Nivel de registro	Descripción
depuración	Registrar información detallada para la solución de problemas y la depuración.
info	Registrar mensajes rutinarios, como puntos de entrada/salida de la API y valores devueltos.
warn	Registrar advertencias y problemas críticos de flujo durante la ejecución normal.
error	Registrar errores que impiden que un flujo se complete con éxito.
fatal	Registrar errores en tiempo de ejecución que requieren acción inmediata.
off	Desactivar el registro.

Obtener la instancia del registrador seguro

Obtenga la instancia del registrador seguro desde el SDK:

// obtener el objeto securelog del sdk TSHPay
let securelog = TSHPay.secureLog

En producción, mantenga warn en condiciones normales.

Para reproducir un problema, permita que el usuario final habilite un nivel más detallado. Luego reproduzca el problema y comparta los archivos de registro.

Deshabilitar el registrador seguro

Para deshabilitar el registrador seguro:

// Al establecer el nivel en off, los registros se desactivan. MPA puede activarlo seleccionando un nivel diferente. Por ejemplo, debug
securelog.setLevel(.off)

Recuperar archivos de registro

Para recuperar los archivos de registro:

// devolver lista de archivos
let files = securelog.files()

Eliminar archivos de registro

Para eliminar los archivos de registro:

// eliminar archivos
securelog.deleteFiles()

Compartir archivos de registro (ejemplo)

Este ejemplo comparte registros usando UIActivityViewController.

Su aplicación de billetera digital también puede cargar registros a un servidor de archivos.

También puede enviar registros a través de otros canales aprobados.

// compartir registros
    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)
            }
        }
    }