Introduction


The Social Login feature allows users to log in and/or register to your BuddyBoss Web and App using Apple Social Login. 


Start by following the Social Login article to enable and configure this feature.


Overview


Create the Apple app and insert the required details in the pop-up box of Apple Social Login to enable and use it during log-in and/or user registration. 



  • Any changes here will require new builds for your iOS and Android apps to ensure they are updated.


  • If you have the BuddyBoss App and you enable Social Login, then Google and Apple Social Login:

    • Are required if you enable at least one Social Login (i.e. Google sign-in, Facebook login, X sign-in, or LinkedIn sign-in). 

      • It is a publishing requirement, as well as it ensures that any app users have the option to log in using their device-associated accounts when third-party login systems are present in your app.

    • Not required if your BuddyBoss App exclusively uses the account sign-in and set up systems of your company

  • Ensure that you have an active subscription to the Apple Developer Program before you proceed. This is necessary for both creating and maintaining an Apple app.

  • Ensure that your site has SSL as Apple only allows HTTPS URLs.


Pop-up Box

  • Private Key ID 

  • Private Key 

  • Team Identifier 

  • Service Identifier


 Create the Apple App


  1. Navigate to your Apple Developer account https://developer.apple.com/account to obtain the necessary keys

  2. Log in with your Apple Developer credentials


 I.    Create the Associated App 


      If you have an existing identifier for your app, you can skip creating a new identifier, and select it.

  1. From your Apple Developer Account > Program resources > Under Certificates, IDs & Profiles, click Identifiers


    

  1. In the Certificates, IDs & Profiles page, click blue + icon next to Identifiers



  1.  Select the App IDs option, and click the "Continue" button.



  2. Select “App” and click Continue



  3. Add details in the Description text field

    And at the     Bundle ID field, select the "Explicit" option and enter your domain name in a reverse-domain style, with the name of the app at its end (e.g. 
    Site.ddev.bbplatform.nslapp     ).



  4. Under the "Capabilities" section, check the "Sign In with Apple" checkbox and then the "Register" button



Once registered, you will be redirected to Identifiers and see the one you created reflecting


Existing Apple or IOS App
If you already have an existing Apple app, follow the steps below instead.

1. From your Apple Developer Account > Program resources > Under Certificates, IDs & Profiles, click Identifiers


2. Click the existing Identifier your Apple app is registered to


3. In the Edit your App ID Configuration page, enable "Sign in with Apple" and click the Save button


Note: Your Server-to-Server Notification Endpoint works natively with your app, so you don't need to fill in the pop-up shown below.


4. Go back to your WordPress admin dashboard > BuddyBoss App > Configure > IOS Settings > and under App Configuration, regenerate both your Signing Certificates and Provisioning Profiles


4.1. Regenerate Signing Certificates

4.1.1. Under Signing Certificates, disable the Generate Certificate checkbox or "Automatically generate signing certificates", and click the Save Changes button.


4.1.2. Remove the Release App Signing Certificate and Test App Signing Certificate, and click the Save Changes button.

4.1.3. Enable the Generate Certificate checkbox or "Automatically generate signing certificates", and click the Save Changes button to successfully regenerate Signing Certificates.

Proceed to regenerate and update your Provisioning Profiles.



4.2. Regenerate Provisioning Profiles

4.2.1. Under Provisioning Profiles, click the Generate New Profiles button.


Now, the Provisioning Profiles are regenerated based on the new Signing Certificates. Proceed to request a new iOS build.


II.    Create the Key

  1. From the same page, click the Keys tab on the left-hand side




  2. Click the blue + icon next to Keys



  3. Enter a name in the Key Name field



  4. Check the "Sign In with Apple" option, then click "Configure"

  • If you have multiple apps, then at the "Choose a Primary App ID" field select the App that you just created, then click "Save".


           



  1. Click Continue



     and then the "Register" button




  • Note: Don't download the key yet.

    After downloading your key, it cannot be re-downloaded as the server copy is removed. If you are not prepared to download your key at this time, click Done and download it at a later time. Be sure to save a backup of your key in a secure place.

III.    Create the Service:


  1. From the Download Your Key page, click All Keys



Click Identifiers

  1. In the “Identifiers” tab, click the blue + icon to go to the "Services IDs" section



  1. Select the "Services IDs" option, and click the "Continue" button



  1. Enter a "Description"



  2. In the "Identifier" field, enter your domain name in a reverse-domain name style, with the name of the client at its end (e.g. site.ddev.bbplatform.nslclient)

    • Note: This will also be used as a Service Identifier later on

  3. Click the "Continue" button and then the "Register" button



  4. In the "Services IDs" section, click the service you created



  1. Tick the "Sign In with Apple" option, and click the "Configure" button





    • If you have multiple Apps, then at the "Primary App ID" field, select the App that you just created



  • Fill the "Domains and Subdomains" field with your domain name (e.g. bbplatform.ddev.site)




  • You can obtain the URL from your WordPress admin dashboard, go to BuddyBoss Plugin, click the Settings menu option > General > Registration > click the pencil icon for Apple, and copy the Callback URI / Redirect URL.

    




  1. Click the "Next" button, then press the "Done" button



  2. Click the "Continue" button, and then the "Save" button






IV.    Configure Social Login With Your Credentials:

  1. From your WordPress admin dashboard, go to BuddyBoss, click the Settings menu option > General > Registration

  2. Click the checkbox for Social Login

  3. Click the pen icon next to the Apple Social Login icon for the pop-up box to appear. Add the following.



  1. You will find your "Private Key ID" under "Key ID".



  • Private Key:

    1. Click the "Download" button to download the key file.

      Note: Once this file is downloaded, it will no longer be available.       Ensure that you keep this file safe.


  1. Open the downloaded file with a text editor (e.g. Notepad) and copy all of its contents and paste it into the "Private Key" field of Settings

  • Team Identifier:

    1. A 10-character long identifier that you can find in the top-right corner, just under your name


               

  1. Once you fill in all the fields, click the "Save Changes" button

  2. Sign in on the Sign in to Apple Account pop-up



    And verify the sign in




Once done, there will be a notice in your X Social Login pop-up box: “Settings have    been verified. Please wait while we redirect you.”



6. You can now enable the Apple Social Login checkbox and click Save Settings




Note:

  • If you face the following errors, try to open your site in a private or Incognito window and authenticate again.

    • “Error: The username field is empty”

    • “Error: The password field is empty”


For site users:

  • When a user registers for the first time using their Apple credentials, the username is generated based on their Apple account information.

  • However, if the user registers again, the username is generated randomly instead of using their actual Apple account name.

This behavior is a limitation of the Apple registration process. Apple does not provide the user's actual name during subsequent registrations for privacy reasons.



If the checkbox for the Apple social login remains greyed out after clicking Save Changes, click the pencil icon again and then select Verify Settings.