Platform Setup

​

iOS

​

URL Scheme Configuration

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>mygame</string>
        </array>
    </dict>
</array>

1. Go to Edit → Project Settings → Player → iOS
2. Expand Other Settings
3. Add your URL scheme under Supported URL schemes

​

Deep Link Handling

// Must match your URL scheme
passport = await Passport.Init(
    clientId: "YOUR_CLIENT_ID",
    environment: Environment.Sandbox,
    redirectUri: "mygame://callback",      // ← mygame matches Info.plist
    logoutRedirectUri: "mygame://logout"
);

​

Build Settings

1. Set Target minimum iOS Version to 13.0 or higher
2. Enable Automatically Sign or configure your provisioning profile

​

iOS-Specific Notes

• The login flow uses ASWebAuthenticationSession, which shows a system alert: “[App] Wants to Use ‘immutable.com’ to Sign In”. This cannot be removed or customized.
• Deep links work via URL schemes (not Universal Links) for PKCE security.

​

Android

​

AndroidManifest Configuration

<activity android:name="com.immutable.passport.PassportActivity"
          android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="mygame" android:host="callback" />
    </intent-filter>
</activity>

<!-- For logout redirect -->
<activity android:name="com.immutable.passport.PassportLogoutActivity"
          android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="mygame" android:host="logout" />
    </intent-filter>
</activity>

​

Unity 6 Configuration

1. Go to Project Settings → Player → Android → Configuration
2. Set Application Entry Point to Activity (not GameActivity)
3. Remove UnityPlayerGameActivity from your AndroidManifest if present

​

Build Settings

1. Set Minimum API Level to 24 or higher
2. Set Target API Level to 33 or higher
3. Enable Custom Main Manifest if you need to modify AndroidManifest.xml

​

Android-Specific Notes

• The login flow uses Chrome Custom Tabs
• Ensure Chrome is installed on test devices
• The SDK automatically handles the manifest merge for most cases

​

WebGL

​

Authentication Flow

#if UNITY_WEBGL
    await passport.LoginWithPopup();
#else
    await passport.Login();
#endif

​

Build Settings

1. Go to Project Settings → Player → WebGL → Publishing Settings
2. Enable Decompression Fallback
3. Set Compression Format to Gzip or Disabled for development

​

Hosting Requirements

• Host on HTTPS (required for secure authentication)
• Configure CORS headers if calling external APIs
• Add your hosting domain to redirect URIs in Hub

​

WebGL Template

<!-- In your index.html template -->
<script src="Build/{{{ LOADER_FILENAME }}}"></script>

​

WebGL-Specific Notes

• Popup blockers may interfere with login. Ensure LoginWithPopup() is called from a user gesture (button click)
• localStorage is used for session persistence
• Some browser features may be restricted in WebGL context

​

macOS

​

URL Scheme Configuration

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>mygame</string>
        </array>
    </dict>
</array>

​

Build Settings

1. Set Target minimum macOS Version to 10.15 or higher
2. Sign your application for distribution

​

Windows

​

Default WebView

​

IL2CPP Support

​

Build Settings

1. Set Scripting Backend to Mono for default WebView compatibility
2. Or configure a custom WebView for IL2CPP

​

Platform Detection

async void Login()
{
    #if UNITY_WEBGL && !UNITY_EDITOR
        await passport.LoginWithPopup();
    #else
        await passport.Login();
    #endif
}

​

Testing

​

Next Steps