SDK Initialization
Import Castled SDK dependency
Initialize the SDK
Initialize the SDK by setting the app id available in the Castled Settings page in the didFinishLaunchingWithOptions method of the AppDelegate class and call the initialize method.
User Identification
To identify the user associated with this app instance, use the following method. This is typically invoked immediately after user completes the
sign-in flow of your app. user-id is the id that you use internally within your organisation to identify a user.
It is recommended to pass an optional user-token as the second parameter
to setUserId to mitigate any risk of user impersonation. In the absence of a
user-token, no additional verifications will be done to enforce user
authenticity. If your user-id is random id such as a UUID, user-token
is probably not required. More info on user-token can be found in the next
section.
Secure User Identification
user-token is a unique token for each user generated by your app server. This token is usually issued by the app server after the user
completes the login flow within your app.
user-token is a Base64 encoded Hash-based Message Authentication Code (HMAC). Ensure the hash computation happens in your app server so that api-key
is not exposed. You can create an api-key in the Setting > API Keys page within your Castled account. Contact Castled support for help with integration.
Find sample server code snippets to generate HMAC for the user-id.