Skip to main content

Overview

This guide provides instructions for configuring SDK signing in the Apptrove Flutter SDK to authenticate API requests, enhancing the security of data sent to Trackier's Mobile Marketing Platform (MMP).

Prerequisites​

  • A Flutter application with the Apptrove SDK installed and initialized
  • Access to the Trackier Panel to retrieve the secretId and secretKey
  • Flutter 2.0 or later, Dart 2.12 or later
  • Basic knowledge of Dart and Flutter development

SDK Signing​

SDK signing authenticates API requests using a secretId and secretKey, ensuring secure communication between your app and Trackier MMP. This prevents unauthorized access and enhances the integrity of tracked data.

Step 1: Retrieve secretId and secretKey​

  1. Log in to your Trackier Panel and select your application.
  2. In the Dashboard, click the SDK Integration option.
  3. Under the Advanced tab, locate and copy the secretId and secretKey.

Step 2: Configure SDK Signing​

Incorporate the secretId and secretKey into the Apptrove SDK configuration during initialization. Add the setAppSecret method to the TrackerSDKConfig object in your main.dart file.

main.dart
class _MyHomePageState extends State<MyHomePage> {
  @override
  void initState() {
    super.initState();
    initializeSdk();
  }

  Future<void> initializeSdk() async {
    String key = "xxxx-xx-4505-bc8b-xx"; // Please pass your Development key here

    /* While Initializing the Sdk, You need to pass the two arguments in the TrackierSDKConfig.
     * In First argument, you need to pass the Apptrove SDK api key
     * In second argument, you need to pass the environment which can be either "development", "production" or "testing". */

    TrackerSDKConfig trackerSDKConfig = TrackerSDKConfig(key, "production");
    trackerSDKConfig.setAppSecret("xxx", "xxx-xx"); // Pass your secretId and secretKey here
    Trackierfluttersdk.initializeSDK(trackerSDKConfig);
  }
}

Parameters​

  • secretId: The unique identifier for your app, retrieved from the Trackier Panel.
  • secretKey: The secret key for authentication, retrieved from the Trackier Panel.
important

Keep the secretId and secretKey secure and avoid exposing them in version control systems (e.g., Git). Use environment variables or secure storage if necessary.

Best Practices​

  • Secure Credentials: Store secretId and secretKey securely, such as in a .env file or secure vault, to prevent unauthorized access.
  • Test in Development Mode: Use the "development" environment to verify SDK signing before switching to "production".
  • Validate Configuration: Ensure the secretId and secretKey match those in the Trackier Panel to avoid authentication errors.
  • Monitor Logs: Check app logs during testing to confirm successful authentication with Trackier MMP.

Troubleshooting​

  • Authentication Errors:
    • Verify that the secretId and secretKey are correct and match the values in the Trackier Panel.
    • Ensure setAppSecret is called before initializeSDK.
  • SDK Initialization Issues:
    • Confirm the Apptrove SDK is properly initialized with a valid SDK key.
    • Check for network connectivity issues that may prevent authentication.
  • General Issues:
    • Review console logs for errors related to SDK signing.

For further assistance, refer to the Trackier Documentation Portal or contact Trackier support at support@trackier.com.