Transition to Claimed HTTPS URIs

Get Help
,
3

Hi @gluten

Welcome to the Auth0 Community!

I believe the issue is caused by an architectural clash between Apple’s underlying authentication API (ASWebAuthenticationSession ) and https Universal Links. Apple explicitly designed ASWebAuthenticationSession to listen for a Custom URL Scheme (e.g., myapp:// ) to know when to dismiss its modal window.

When you use an https scheme for an OAuth callback, iOS successfully routes the link to your app, but it fails to notify the authentication session to close, leaving the browser window hanging permanently on the screen.

  1. In your Auth0 Dashboard → Applications → [Your App] → Settings, add a custom scheme to your Allowed Callback URLs and Allowed Logout URLs . A reverse-DNS format is recommended (e.g., com.yourcompany.app://callback ).
  2. Register your new custom scheme in your MAUI project’s Platforms/iOS/Info.plist file so the OS knows your app owns it:
<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>Auth0</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>com.yourcompany.app</string>
        </array>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
    </dict>
</array>
  1. Inside your MAUI code, you will need to conditionally use the Custom Scheme for iOS while retaining your https link for Android (if you prefer to keep Android on App Links):
#if IOS
    var redirectUri = "com.yourcompany.app://callback";
#else
    var redirectUri = "https://yourcompany.com/callback";
#endif

Let me know if that does the trick for you!

Kind Regards,
Nik