Recopilar registros con el registrador seguro

Descripción general

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

Tu aplicación de billetera digital puede recuperar los 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 de forma predeterminada con el nivel de registro establecido en advertencia.

Nivel de registro	Descripción
depuración	Registra información detallada para la resolución de problemas y la depuración.
información	Registra mensajes de rutina, como los puntos de entrada/salida de la API y los valores devueltos.
advertencia	Registra advertencias y problemas críticos de flujo durante la ejecución normal.
error	Registra errores que impiden que un flujo se complete correctamente.
fatal	Registra errores en tiempo de ejecución que requieren acción inmediata.
desactivado	Deshabilitar el registro.

Obtener la instancia del registrador seguro

Obtén la instancia del registrador seguro desde el SDK:

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

En producción, mantén advertencia en condiciones normales.

Para reproducir un problema, permite que el usuario final habilite un nivel más detallado. Luego reproduce el problema y comparte los archivos de registro.

Deshabilitar el registrador seguro

Para deshabilitar el registrador seguro:

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

Recuperar archivos de registro

Para recuperar los archivos de registro:

// devolver la 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 los registros usando UIActivityViewController.

Tu aplicación de billetera digital también puede cargar los registros en un servidor de archivos.

También puedes enviar los 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)
            }
        }
    }