-
Notifications
You must be signed in to change notification settings - Fork 13
Installation checklist
If you experience any issues after installing freeRASP, please go through the following checklist to ensure you've done everything right.
Double-check that you've set the correct values for all variables. Make sure you haven't made any typos or mistakes during installation and that you've set up a valid email address for receiving Security Reports.
You can do that in the following steps:
-
Setting the correct values in the configuration.
For Android that includes:
Having a correct URL in
build.gradle
.maven { url "https://developer.huawei.com/repo/" } maven { url "https://nexus3-public.monetplus.cz/repository/ahead-talsec-free-rasp" } maven { url "https://jitpack.io" }
Going over the values in
companion object
.companion object { private const val expectedPackageName = "com.aheaditec.talsec.demoapp" // Don't use Context.getPackageName! private const val expectedSigningCertificateHashBase64 = ["mVr/qQLO8DKTwqlL+B1qigl9NoBnbiUs8b4c2Ewcz0k="] // Replace with your release (!) signing certificate hash(es) private const val watcherMail = "john@example.com" // for Alerts and Reports private val supportedAlternativeStores = arrayOf( // Google Play Store and Huawei AppGallery are supported out of the box, you can pass empty array or null or add other stores like the Samsung's one: "com.sec.android.app.samsungapps" // Samsung Store ) }
For iOS, check the values in
AppDelegate
:let config = TalsecConfig(appBundleIds: ["YOUR_APP_BUNDLE_ID"], appTeamId: "YOUR TEAM ID", watcherMailAddress: "WATCHER EMAIL ADDRESS")
For Flutter, go over the configuration for Android, iOS or both:
TalsecConfig config = TalsecConfig( // For Android androidConfig: AndroidConfig( expectedPackageName: 'YOUR_PACKAGE_NAME', expectedSigningCertificateHashes: ['HASH_OF_YOUR_APP'], supportedAlternativeStores: ["com.sec.android.app.samsungapps"], ), // For iOS iosConfig: IOSconfig( appBundleId: 'YOUR_APP_BUNDLE_ID', appTeamId: 'YOUR_APP_TEAM_ID', ), // Common email for Alerts and Reports watcherMail: 'your_mail@example.com', );
-
Choosing the Dev version when debugging and the Release version on publishing.
Android
// Talsec Release releaseImplementation 'com.aheaditec.talsec.security:TalsecSecurity-Community:X.X.X-release' // Talsec Debug debugImplementation 'com.aheaditec.talsec.security:TalsecSecurity-Community:X.X.X-dev'
iOS
// Release version ./Release/TalsecRuntime.xcframework/ // Debug version ./Debug/TalsecRuntime.xcframework/
-
Flutter and Android version require Computing the Signing certificate hash correctly and converting it to Base64 form. You should follow this guide on how to do that. If you are experiencing problems with hash conversion, use the approach outlined in this thread.
As the older versions of freeRASP may cause some issues, switching to the latest release is recommended. Furthermore, the current version includes essential fixes and additions.
You can check the latest version for each freeRASP submodule:
Someone may have already solved the problem you are currently experiencing. You can check out all closed issues and look for the similarities. If your problem is new, feel free to open up a new issue in a corresponding Android, iOS, or Flutter repository or contact us, as our team is always ready to help.