1) Connected Apps

ImBlaze Student Mobile App > STEP 1

Connected Apps

A connected app is a framework that allows an external application to integrate with Salesforce using APIs and standard protocols. To enable the ImBlazeStudent mobile app to interface with your Salesforce organization, you will need to create corresponding Connected Apps for each platform.

Pre-Requisites for Connected Apps

During the configuration of the connected apps, you will need specific details and files. Please reach out to the BPL team and ensure you have all the necessary information ready before proceeding to the next step.

Push Notification Certificates for IOS ImBlazeStudent App
Push Notification Certificate Password for IOS ImBlaze Student App
API Server Key for Android ImBlazeStudent app

1.1 Connected App for iOS ImBlazeStudent app

This connected app enables the seamless connectivity between Salesforce and ImBlazeStudent IOS mobile app.

Click on Setup
Search for Apps in Quick Find box
Click on App Manager
Click New Connected App button.

5. In Basic Information, give the app a Name (give a name that indicates iOS ImBlazeStudent for easier identification. For eg: ImBlazeStudent IOS). Tab through the api field so it will self-populate in the correct format, and enter a Contact Email for the app.

API (Enable OAuth Settings) Section

6. Check Enable OAuth Settings

7. Give the Callback URL as imblaze://auth/success

8. Select the following OAuth Scopes:

Manage user data via APIs (api)
- Manage user data via Web browsers (web)
Full access (full)
Access Connect REST API resources (chatter_api)
Perform requests at any time (refresh_token, offline_access)

9. Uncheck below fields:

Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows
Require Secret for Web Server Flow
Require Secret for Refresh Token Flow

10. Under Mobile App Settings section, Check Push Messaging Enabled

11. Select Platform as Apple

12. Select Environment as Production

Certificate Authentication Settings

13. Push Certificate - Upload the iOS ImBlazeStudent app push notification certificate.

14. Certificate Password - Enter the certificate password.

15. Click Save

Setting the OAuth Policies

TODO: Adding profiles

Now set the OAuth policies, so users do not have to explicitly authorize Salesforce once they login to the mobile app.

Go to Setup.
Search Connected Apps in Quick find box.
Click on Manage Connected Apps.
Click Edit against the ImBlazeStudent iOS connected app.
Go to OAuth Policies section.
Select Admin approved users are pre-authorized in Permitted Users field.
Click Save.

1.2 Connected App for Android ImBlazeStudent app

This connected app enables the seamless connectivity between ImBlaze portal and Imblaze Android mobile app.

Click on Setup
Search for Apps in Quick Find box
Click on App Manager
Click New Connected App button.

5 In Basic Information, give the app a Name (give a name that indicates Android ImBlazeStudent for easier identification. For eg: ImBlazeStudent Android. Tab through the api field so it will self-populate in the correct format, and enter a Contact Email for the app.

API (Enable OAuth Settings) Section

6. Check Enable OAuth Settings

7. Callback URL: imblaze://auth/success

8. Selected OAuth Scopes :

Move below values from Available OAuth Scopes to Selected OAuth Scopes :

Manage user data via APIs (api)
Manage user data via Web browsers (web)
Full access (full)
Access Connect REST API resources (chatter_api)
Perform requests at any time (refresh_token, offline_access)

9. Uncheck below fields:

Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows
Require Secret for Web Server Flow
Require Secret for Refresh Token Flow

10. Under Mobile App Settings section, Enable Push Messaging checkbox

11. Select Platform as Android

12. Enter the API Server Key in API Key for Server Applications field.

13. Click Save

Setting the OAuth Policies

Now set the OAuth policies, so users do not have to explicitly authorize Salesforce once they login to the mobile app.

Go to Setup.
Search Connected Apps in Quick Find box.
Click on Manage Connected Apps.
Click Edit against the ImBlazeStudent Android connected app.
Go to OAuth Policies section.
Select Admin approved users are pre-authorized in Permitted Users field.
Click Save.

1.3 Consumer key from Connected Apps

After creating the Connected App, you must obtain the Consumer Key for use in ImBlaze configuration settings. It's advisable to maintain a table of this data for different configurations. This information should also be forwarded to the BPL team for activating multi-instance login.

Search Apps in Quick Find box
Click on App Manager
Click View on the iOS ImBlazeStudent Connected app, which you created in section 1.1 above.
Copy the API name of the connected app for future reference.
Click on Manage Consumer Details button in API (Enable OAuth Settings) section.

5. Copy the Consumer key and Save it against the API name of the connected app for future reference.

6. Repeat the above steps from 1 to 5 for the Android ImBlazeStudent Connected App which you created in section 1.2 above. Get the Connected App API name and the consumer key.

1.4 ImBlaze Profile access

Each ImBlaze profile requires access to the connected apps, ensuring users are automatically authorized at login.

Go to Setup.
Search Profiles in Quick Find box.
Click on ImBlaze Profile.
Click on Assigned Connected Apps.
Click Edit
Select the ImBlazeStudent iOS and Android connected apps that you created and move to Enabled Connected Apps section.
Click Save.

Repeat same steps for All ImBlaze Profiles.

1.5 Multi-Instance Login

To enable multi-instance login from the ImBlazeStudent mobile apps to your Salesforce org, pass the following information to the Big Picture Learning team:

ImBlaze Site URL
API Name and Consumer key of ImBlazeStudent iOS connected app configured in Section 1.1
API Name and Consumder key of ImBlazeStudent Android connected app configured in Section 1.2

Page updated

Report abuse