MarketingCloudSDK iOS (v8.1.2)

• Home
• Documentation
• AppleDoc
• MobilePush
• Get Started
• Overview
• 1. Provision for Push
• 2. Setup MobilePush Apps
• 3. Add the SDK
• 4. Configure the SDK
• 5. Enable Push
• 6. Migrating to 8.x
• Testing the SDK
• Development / Xcode
• Production / Distribution
• SDK Implementation
• Data Protection and Privacy
• Device and Contact Registration
• Handle URLs
• Runtime Toggles
• Push Notifications
• Customize Push Notifications
• Custom Sound
• Interactive Notifications
• Rich Notifications
• OpenDirect
• Custom Keys
• Application Badging
• Application Badge Override
• Event Tracking
• Mobile App Event Tracking
• In-App Messaging
• In-App Messaging
• Inbox Messaging
• Inbox Messaging
• Location Messaging
• Geofence and Beacon Messaging
• Background Location Updates
• Location Message Segmentation
• Analytics
• Analytics
• Einstein Recommendations and Collect API Integration
• Use Cases
• MobilePush SDK Privacy Manifest
• MobilePush SDK Use Cases
• Troubleshooting
• App Submission
• Push Setup
• Multiple Push SDKs
• iOS Data Protection
• Data Merge
• Keychain Crash
• MarketingCloudSDK.bundle inclusion Crash

If a device is setup with FaceId or Passcode based authentication, and if an application (with MarketingCloudSDK integrated) accesses the Keychain when the device is in a locked state, a fatal exception is thrown. The SDK cannot access these files due to the iOS Data Protection mode.

Common Exceptions with Keychain thrown by the SDK

errSecInteractionNotAllowed

1. Fatal Exception: com.salesforce.security.keychainException dictionaryItemFromKeychain: Error attempting to look up keychain item: errSecInteractionNotAllowed

2. Fatal Exception: com.salesforce.security.keychainException setObject:forKey:: Error saving value to the keychain: errSecInteractionNotAllowed.

3. Fatal Exception: com.salesforce.security.keychainException writeToKeychain: Error adding keychain item: errSecInteractionNotAllowed.

Solution:

• Upgrade to MarketingCloudSDK version - 8.0.8 and SFMCSDK version - 1.0.6
• Before initializing the SDK, add the code to setKeychainAccessErrorsAreFatal as false as => SFMCSdk.setKeychainAccessErrorsAreFatal(errorsAreFatal: false)
  • The above logs the exception to console instead of crashing the application.

Note: setKeychainAccessErrorsAreFatal is by default set to true in the SDK.

Unknown status code (-34018)

Terminating app due to uncaught exception 'com.salesforce.security.keychainException', reason: 'dictionaryItemFromKeychain: Error attempting to look up keychain item: Unknown status code (-34018)'

Solution:

Enable Keychain sharing in the Xcode Signing & Capabilities. Please note that no identifiers need to be added specific to SDK in keychain sharing.

Related Items

Learning App

• Please note that the code sample shows how to integrate SDK, not all piece of code is mandatory and it is up to the consuming application.