feat: add ios screenshot blocking, external id support (freeRASP 2.1.0) (#32)

* feat: add ios screenshot blocking, external id support

* fix docs

* chore: add condition for ios screen blocking

Author: tompsota

CHANGELOG.md

@@ -5,6 +5,42 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.0] - 2025-05-15
+
+- iOS SDK version:  6.11.0
+- Android SDK version: 15.1.0
+
+### Capacitor
+
+#### Added
+
+- Added interface for screenshot / screen recording blocking on iOS
+- Added interface for external ID storage
+
+### Android 
+
+#### Added
+
+- Added externalId to put an integrator-specified custom identifier into the logs.
+- Added eventId to the logs, which is unique per each log. It allows traceability of the same log across various systems.
+
+#### Changed
+
+- New root detection checks added
+
+### iOS
+
+#### Added
+
+- Added externalId to put an integrator-specified custom identifier into the logs.
+- Added eventId to the logs, which is unique per each log. It allows traceability of the same log across various systems.
+- Screen capture protection obscuring app content in screenshots and screen recordings preventing unauthorized content capture. Refer to the freeRASP integration documentation.
+
+#### Fixed
+
+- Resolved an issue with the screen recording detection.
+- Resolved an issue that prevented Xcode tests from running correctly.
+
 ## [2.0.0] - 2024-03-25
 
 - iOS SDK version:  6.9.0

android/build.gradle

@@ -76,5 +76,5 @@ dependencies {
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
 
-    implementation 'com.aheaditec.talsec.security:TalsecSecurity-Community-Capacitor:15.0.0'
+    implementation 'com.aheaditec.talsec.security:TalsecSecurity-Community-Capacitor:15.1.0'
 }

android/src/main/java/com/aheaditec/freerasp/FreeraspPlugin.kt

@@ -207,6 +207,25 @@ class FreeraspPlugin : Plugin() {
         }
     }
 
+    @PluginMethod
+    fun storeExternalId(call: PluginCall) {
+        val externalId = call.getString("data")
+        if (externalId.isNullOrEmpty()) {
+            call.reject(
+                "External ID not provided", "MissingArgumentError"
+            )
+        }
+        try {
+            Talsec.storeExternalId(context, externalId)
+            call.resolve(JSObject().put("result", true))
+        } catch (e: Exception) {
+            call.reject(
+                "Error during storeExternalId operation in freeRASP Native Plugin",
+                "NativePluginError"
+            )
+        }
+    }
+
     internal fun notifyListeners(threat: Threat) {
         notifyListeners(THREAT_CHANNEL_NAME, JSObject().put(THREAT_CHANNEL_KEY, threat.value), true)
     }

dist/esm/definitions.d.ts

@@ -30,6 +30,11 @@ export interface FreeraspPlugin {
     isScreenCaptureBlocked(): Promise<{
         result: boolean;
     }>;
+    storeExternalId(options: {
+        data: string;
+    }): Promise<{
+        result: boolean;
+    }>;
 }
 export type FreeraspConfig = {
     androidConfig?: AndroidConfig;

dist/esm/definitions.js.map

@@ -7,5 +7,6 @@ declare const addToWhitelist: (packageName: string) => Promise<boolean>;
 declare const getAppIcon: (packageName: string) => Promise<string>;
 declare const blockScreenCapture: (enable: boolean) => Promise<boolean>;
 declare const isScreenCaptureBlocked: () => Promise<boolean>;
+declare const storeExternalId: (data: string) => Promise<boolean>;
 export * from './definitions';
-export { Freerasp, startFreeRASP, setThreatListeners, removeThreatListeners, addToWhitelist, getAppIcon, blockScreenCapture, isScreenCaptureBlocked, };
+export { Freerasp, startFreeRASP, setThreatListeners, removeThreatListeners, addToWhitelist, getAppIcon, blockScreenCapture, isScreenCaptureBlocked, storeExternalId, };