Integration of SDK APIs

Android integration

First, add the ShieldSDK-config Maven dependency to your Android project. This can be found in the SDK/maven/ directory of the App Shielding package. For more information on importing App Shielding libraries, refer to the "Shield APIs" section in OneSpan App Shielding for Android Reference Documentation.pdf.

You can then use the ShieldConfig class with the following methods:

The following example demonstrates how these methods can be used:

ShieldConfig.requestUpdate();
ShieldConfig.setUpdateCustomId("my-token".getBytes(StandardCharsets.UTF_8));

ShieldConfig.setUpdateCallbacks(new UpdateCallbacks() {
    @Override
    public void configUpdateReceived(String timestamp) {
        // handle callback logic
        ...
    }
});

iOS integration

First, add the ShieldSDK.xcframework bundle from the App Shielding package to your iOS project. For more information on importing App Shielding libraries, see Adding the framework.  

You can then use the PRMShieldConfig class with the following methods:

The following example demonstrates how these methods can be used:

[PRMShieldConfig requestUpdate];
[PRMShieldConfig setUpdateCustomId:[NSData dataWithBytes:"my-token" length:8]];

For callbacks, you can start with the ConfigUpdateCallbacks interface.

Objective-C example

@interface ConfigUpdateCallbacks : NSObject <PRMShieldConfigUpdateCallbacks>
@end 

@implementation ConfigUpdateCallbacks
- (void)configUpdateReceived:(NSString *)timestamp 
{
  // handle callback logic
  ... 
}
@end

During the app initialization (e.g., in didFinishLaunchingWithOptions), call the setUpdateCallbacks method in the following manner:

[PRMShieldConfig setUpdateCallbacks:[[ConfigUpdateCallbacks alloc] init]];

Swift example

If you are using Swift instead of Objective-C, you can set up the callback as follows:

class ConfigUpdateCallbacks: NSObject, PRMShieldConfigUpdateCallbacks {
  func configUpdateReceived(_ timestamp: String) { 
    // handle callback logic
      ... 
    }
  }

...
PRMShieldConfig.setUpdateCallbacks(ConfigUpdateCallbacks())