...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
| Excerpt | |||||
|---|---|---|---|---|---|
Step 1 - Update the Gradle Build Properties to Integrate Cardinal Mobile SDKIn Android Studio, open the app directory (which can also be labeled Module: app) and then open the build.gradle file. Double-check to make sure that you edit the Gradle file that is located in the app directory. Add the following contents to the Gradle file.
|
...
Step 2 - Configure Cardinal Mobile SDK |
.png?version=1&modificationDate=1570110063548&cacheVersion=1&api=v2&height=250)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
private Cardinal cardinal = Cardinal.getInstance();
@Override
protected void onCreate(Bundle savedInstanceState) {
CardinalConfigurationParameters cardinalConfigurationParameters = new CardinalConfigurationParameters();
cardinalConfigurationParameters.setEnvironment(CardinalEnvironment.STAGING);
cardinalConfigurationParameters.setRequestTimeout(8000);
cardinalConfigurationParameters.setChallengeTimeout(5);
JSONArray rType = new JSONArray();
rType.put(CardinalRenderType.OTP);
rType.put(CardinalRenderType.SINGLE_SELECT);
rType.put(CardinalRenderType.MULTI_SELECT);
rType.put(CardinalRenderType.OOB);
rType.put(CardinalRenderType.HTML);
cardinalConfigurationParameters.setRenderType(rType);
cardinalConfigurationParameters.setUiType(CardinalUiType.BOTH);
UiCustomization yourUICustomizationObject = new UiCustomization();
cardinalConfigurationParameters.setUICustomization(yourUICustomizationObject);
cardinal.configure(this,cardinalConfigurationParameters);
} |
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
private val cardinal: Cardinal = Cardinal.getInstance()
override fun onCreate(savedInstanceState: Bundle?) {
val cardinalConfigurationParameters = CardinalConfigurationParameters()
cardinalConfigurationParameters.environment = CardinalEnvironment.STAGING
cardinalConfigurationParameters.requestTimeout = 8000
cardinalConfigurationParameters.challengeTimeout = 5
val rTYPE = JSONArray()
rTYPE.put(CardinalRenderType.OTP)
rTYPE.put(CardinalRenderType.SINGLE_SELECT)
rTYPE.put(CardinalRenderType.MULTI_SELECT)
rTYPE.put(CardinalRenderType.OOB)
rTYPE.put(CardinalRenderType.HTML)
cardinalConfigurationParameters.renderType = rTYPE
cardinalConfigurationParameters.uiType = CardinalUiType.BOTH
val yourUICustomizationObject = UiCustomization()
cardinalConfigurationParameters.uiCustomization = yourUICustomizationObject
cardinal.configure(this, cardinalConfigurationParameters)
} |
| Info | ||
|---|---|---|
| ||
After you configure cardinalSession, call method getWarnings to get the list of all the warnings for the particular device. Take further action based on the warnings found. List of warnings can be accessed as follows: List<Warning> warnings = cardinal.getWarnings(); Goto Security Guidance for detail. |
Available Configurations
| Anchor | ||||
|---|---|---|---|---|
|
| Method | Description | Default Values |
|---|---|---|
| setEnvironment( |
...
957513771 environment) | Sets the environment the SDK has to connect to | CardinalEnvironment.PRODUCTION |
...
...
|
...
setUiType(CardinalUiType uiType) | Sets all UI types that the device supports for displaying specific challenge user interfaces within the SDK | CardinalUiType.BOTH |
setRenderType(org.json.JSONArray renderType) | Sets renderLists all UI types that the device supports for displaying specific challenge user interfaces within the SDK | JSONArray rType = new JSONArray(); |
setProxyAddress(java.lang.String proxyAddress) | Sets the proxy the SDK has to connect to | "" |
| setEnableQuickAuth(boolean enableQuickAuth) | Sets enable quick auth | false |
setUICustomization(UiCustomization UI Customization) |
...
...
| Device Default Values | ||
| setEnableDFSync(boolean enableDFSync) | On setting true, onSetupCompleted in step 4, will be called after device data collected is sent to the server | false |
| setRequestTimeout(int requestTimeout) | Sets the maximum amount of time (milliseconds) for all exchanges | 8000 |
| setChallengeTimeout(int challengeTimeout) | Sets the maximum amount of time (minutes) for challenge | 5 |
| setThreeDSRequestorAppURL(String threeDSRequestorAppURL) | The setThreeDSRequestorAppURL method may set the 3DS Requestor App URL. If the app sets the URL, then the SDK shall pass the URL to the server. | "" |
CardinalUiType
| Anchor | ||||
|---|---|---|---|---|
|
| Enum Constant |
|---|
| BOTH |
| NATIVE |
| HTML |
CardinalRenderType
| Anchor | ||||
|---|---|---|---|---|
|
| Enum Constant and Description |
|---|
| HTML |
| MULTI_SELECT |
| OOB |
OTP |
| SINGLE_SELECT |
CardinalEnvironment Anchor CardinalEnvironment CardinalEnvironment
| CardinalEnvironment | |
| CardinalEnvironment |
| Enum Constant |
|---|
| PRODUCTION |
| STAGING |
...