Mobile SDK Development Guide

Introduction to Mobile Development
Introduction to Salesforce Mobile SDK Development
What’s New in Mobile SDK 11.1
Getting Started With Mobile SDK 11.1 for iOS and Android
Updating Apps (5.0 and Later) Apps (5.0 and Later)
Native iOS Development
Native Android Development
HTML5 and Hybrid Development
Using Lightning Web Components in Hybrid Apps
React Native Development
Offline Management
Files and Networking
Push Notifications and
Authentication, Security, and Identity in Mobile Apps
OAuth Terminology
OAuth 2.0 Authentication Flow
OAuth 2.0 Web Server Flow
OAuth 2.0 User-Agent Flow
OAuth 2.0 Refresh Token Flow
Mobile SDK Login and Authentication Flow—Detailed Look
Scope Parameter Values
Using Identity URLs
Setting Custom Login Servers in Android Apps
Setting Custom Login Servers in iOS Apps
Revoking OAuth Tokens
Refresh Token Revocation in Android Native Apps
Connected Apps
Portal Authentication Using OAuth 2.0 and Salesforce Sites
Using MDM with Mobile SDK Apps
Using Advanced Authentication
Upgrading Android Single Sign-On Apps to Google Login Requirements
Using OpenID Tokens to Access External Services
Secure Key Storage in iOS
Secure Key Storage in Android
Login Screen Customization
Identity Provider Apps
Using Key-Value Stores for Secure Data Storage
Dark Mode and Dark Theme Settings
Using Experience Cloud Sites With Mobile SDK Apps
Multi-User Support in Mobile SDK
Mobile SDK Tools for Developers
Logging and Analytics
Migrating from the Previous Release
Reference
iOS Current Deprecations
iOS APIs Removed in Mobile SDK 11.0
Android Current Deprecations
Android APIs Removed in Mobile SDK 11.0
Trademark Attributions
Removing UIWebView from iOS Hybrid Apps
PDF

Setting Custom Login Servers in iOS Apps

For special cases—for example, if you’re a Salesforce partner using Trialforce—you can redirect your user’s login requests to a custom login URI.

In iOS apps, login servers are often called login hosts. Mobile SDK defines standard login URIs for production and sandbox servers in the SalesforceSDKCore project. These two login hosts appear in the Choose Connection login screen.

For iOS, the default login host can potentially be set through any of the following means.
  1. MDM enforced
    • At startup, your app’s MDM provider configures the login URI.
    • The MDM policy can also hide the navigation bar and Settings icon to prevent users from changing the login host.
  2. App configuration through the info.plist file
    • Your app can configure the default login URI in the project’s info.plist properties file. The login host property name is SFDCOAuthLoginHost.

    • At startup, the SFDCOAuthLoginHost setting overrides user-defined login hosts.
    • By default, SFDCOAuthLoginHost property is set to “login.salesforce.com”.
    • Do not use a protocol prefix such as “https://” when specifying the login URI.
  3. User configuration through the Add Connection screen
    Here’s how a user can configure a custom login server.
    1. Start the app without logging in.
    2. In the login screen, tap the Settings, or ”gear,” icon Settings icon in the top navigation bar.
    3. In the Choose Connection screen, tap the Plus icon Plus icon.
    4. (Optional but recommended) To help identify this configuration in future visits, enter a label.
    5. Enter your custom login host’s URI. Be sure to omit the https:// prefix. For example, here’s how you enter a typical Experience Cloud site URI:
      1MyDomainName.my.site.com/fineapps
    Mobile SDK enables this functionality by default. You can disable the Add Connection option by setting SFLoginHostViewController properties.
  • At startup, MDM runtime configuration overrides compile-time settings.
  • Before version 4.1, Mobile SDK apps for iOS defined their custom login URIs in the app’s Settings bundle. In Mobile SDK 4.1 and later, iOS apps lose the Settings bundle. Instead, you can use the SFDCOAuthLoginHost property in the app’s info.plist file to build in a custom login URI.

Important