Configure Matter Certificate Profiles

This topic describes how to configure Matter certificate profiles for your OEM app on the Apple Developer platform. These profiles are required for the iOS app to support Matter features.

Before you start

Log in to the Apple Member Center and select Certificates, Identifiers & Profiles.

Step 1: Create App Group

To enable Matter for your existing app (referred to as the main application in this topic), you need to create an App Group.

1. Go to the Identifiers page and click +.

   

2. Select App Groups, and in the top right corner of the page, click Continue.

   

3. Fill in the following information:

   • Description: Enter a name for the App Group.

   • Identifier: Enter an identifier for the main application, in the following format: group.com.xxx.xxx. com.xxx.xxx is the bundle ID of your existing app. Then, click Continue.

     

4. Confirm the information about the app group.

   • To rectify any error, click Back and modify the information.

   • After all information is confirmed, click Register.

     

Now, the App Group is created.

Step 2: Enable Matter for main application ID

1. In the top right corner of the Identifiers list, select App Groups > App IDs.

   

2. Find and click the App ID of the main application to enter the configuration page.

   

3. Check whether the feature App Groups is enabled. If not, select the checkbox ☑️ for this feature.

   

4. Then, click Configure and select the previously created App Group. Scroll down the page and check whether the feature Matter Allow Setup Payload is enabled. If not, select the checkbox ☑️ for this feature.

   

5. Click Save in the top right corner of the page.

6. Select App Groups and click Continue.

   

Step 3: Create Matter App ID

1. Go to the Identifiers page and click +.

   

2. Select the App IDs option and click Continue.
   

3. Fill in the following information:

   • Name: Enter a name for Matter.

   • Bundle ID: Enter a Bundle ID for Matter, in the format of Bundle ID of main application.matter.

   • Select the checkbox ☑️ for App Groups and click Continue.

     

4. Select the previously created App ID and click Configure.

   

5. Select the App Group created in Step 1 to bind the Matter App ID with the App Group.
   

Step 4: Generate new .mobileprovision profile for main application

The configuration of the main application has been modified with Matter added, so a new .mobileprovision profile must be generated.

1. Go to the Profiles page and click the main application to modify its information.

   

2. In the Certificates section, select a new distribution certificate. In this section, multiple distribution certificates with the same name might occur. In this case, determine the creation time of each certificate by the expiration time next to the certificate name. If the creation time is uncertain, select the last certificate and click Save.

   

3. Now, the .mobileprovision profile for the main application is configured. Click Download to download the profile.

   

Step 5: Generate .mobileprovision profile for Matter

1. Go to the Profiles page and click +.

   

2. In the Distribution section, select App Store and click Continue.

   

3. From the App ID drop-down list, select the app ID in the format of Bundle ID of main application.matter, and click Continue.

   

4. Select the same distribution certificate as selected in Step 6 for the main application and click Continue.

   

5. In the Provisioning Profile Name field, enter the name of the .mobileprovision profile for Matter.

   

6. Now, the .mobileprovision profile for Matter is configured. Click Download to download the profile.

   

Step 6: Upload provisioning profiles to Tuya IoT Development Platform

1. Go to Certificate for iOS on the Tuya IoT Development Platform.

   You can click Change App beside Required Setting on the top and find your desired app.

   

2. Upload the downloaded provisioning profiles.

   

   

Things to note

• The distribution certificate takes effect only after you rebuild the app.