Set up Apple Sign In (Recommended)

We recommend you use Apple Sign In. Compared to traditional registration and login processes, Apple Sign In provides a better overall user experience. of course, if you don't plan to use Apple Sign In, you can skip this step.

Configure Apple Sign In

First, make sure you have an available Apple Developer account. If you haven't registered yet, please refer to the official documentation to register. After registration, log in to your developer account and go to the Identifiers page, click the + button

Step 1: Register Services ID

Select Services IDs and click the Continue button

Description can be named using your app name + Services ID.

Identifier is recommended to be named as bundleID.ServicesID. Where bundleID is your app's unique identifier.

Click the Continue button

Click the Register button

After completion, return to the Identifiers page and click the Services IDs we just created

Enable Sign in with Apple function and click the Configure button

In the popup window, you need to configure the following options:

1. In Primary App ID, select your App's Bundle Identifier from the dropdown.
2. In the Domains and Subdomains field, enter supabase.co,SUPABASE_PROJECT_ID.supabase.co
3. In the Return URLs field, enter https://SUPABASE_PROJECT_ID.supabase.co/auth/v1/callback
4. Click the Next button and Done button

Click the Continue button and click the Save button

Step 2: Create .p8 Authentication Key for Apple Sign In

Go to the Keys page and click the + button

1. Enter your Key Name, for easier identification later, we recommend naming it with your app name + Keys.
2. Select Sign in with Apple function and click the Configure button.
3. After clicking the Configure button, select your App ID from the Primary App ID dropdown.
4. Click the Save button

Then click the Continue button and click the Register button

Step 3: Integrate Apple Sign In with Supabase

Go to your Supabase project, click the sidebar Authentication, click Sign In/Providers, click the Apple button.

In the popup window, you need to configure the following information:

1. Enable Enable Sign in with Apple function
2. In the Client IDs field, enter your Services ID and your app's unique identifier bundleID. (separated by commas, no spaces)

The Secret Key (for OAuth) field can be left empty.

3. Click save

Step 4: Test Apple Sign In

Go back to the Supabase console and check the Users table, you can see the user information from your Apple Sign In.

Congratulations 🎉🎉🎉, you have successfully integrated the Apple Sign In function.

Support Email Verification Function

Supabase enables email authentication by default, and EasyApp of course supports it. But you need to configure Deep Linking. The configuration process is very simple.

1. Set URL Type in Xcode

In the screenshot, you need to fill in identifier and URL Schemas

• identifier is recommended to use Bundle Identifier.
• URL Schemas is recommended to use your App name.

2. Configure Deep Linking in Supabase

Next, go to the Supabase Authentication page and click the URL Configuration button.

Click the Add URL button and enter your App's URL.

When filling in Deep Linking, we recommend using the format YourAppName://user?type=sign_up.

Let me explain why we set it up this way, where user represents the module name, type represents the type, and sign_up represents email verification. The user module has the following types:

• sign_up: email verification
• reset_password: password reset

So we use type to distinguish.

In SwiftUI, we distinguish through module name + type.

.onOpenURL { url in
  let value = url.getEaspAppDeepLinkUrlParam(hostKey: "user", name: "type")
  guard value == "reset_password" else { return }

  /// Handle password reset logic
}

.onOpenURL { url in
  let value = url.getEaspAppDeepLinkUrlParam(hostKey: "user", name: "type")
  guard value == "sign_up" else { return }

  /// Handle email verification logic
}

At this point, you can normally use Email authentication function.

Process: User registration successful -> Supabase sends email -> User clicks link in email -> Directly returns to the App -> Login successful.

3. Resend verification email

For user experience, we have made the following optimizations:

• After successful user registration, assuming the user does not verify the email in time, when they reopen the app at some point, we will check whether the current user has verified the email If the user has not verified the email, we will prompt the user to verify the email.

So we provide a VerifyEmailView

This component will automatically pop up when the user has not verified the email and supports users to resend verification emails.

Disable Email Verification Function

If you don't plan to use Email authentication function, you can disable them.