01. Introduction
There is a general documentation available for the EBF Onboarder, where you can find information about its prerequisites and the whole migration project. It describes how you can setup a migration project, how you can setup invitation emails and reminders which guide your users through the migration. It also tells you how to initiate the migration process and how to track the migration status.
This documentation complements the general EBF Onboarder documentation and provides more detailed information about the prerequisites for the source system BlackBerry UEM Cloud.
ATTENTION: This documentation does not replace any BlackBerry documentation. It is only describing prerequisites for the EBF Onboarder. Please consult the BlackBerry documentation and support if necessary.
02. Prerequisites for the source system BlackBerry UEM Cloud
If your source system is BlackBerry UEM Cloud, it is recommended that you login to your BlackBerry UEM Cloud console to make the changes which are described in the following chapters.
02.1. Create a client app
To communicate with your BlackBerry UEM Cloud tenant a client app needs to be created in your BlackBerry account. App values will be used by the EBF Onboarder to setup and run the migration.
NOTE: Do not use an existing client app. To be able to have a better control about the client apps, each topic should get its own client app.
Follow these steps to create the client app:
- Login to your account: https://myaccount.blackberry.com/myaccount.html.
- Go to ‘myAccount’ >> ‚BlackBerry Support Community‘ >> ‚My Organization‘ >> ‚Overview‘.
- Click on ‘Applications’ >> ‘Add Application’.
- Enter a name and select ‘BlackBerry Platform APIs’.
- Click on ‘Template’ >> ‘Add Template’.
- Enter the following details:
- Redirect URLs: Enter your FQDN. Example: https://p1234.cp1.uem.blackberry.com.
- Type: Select ‘web’.
- Grant Type: Select ‘client_credentails’.
- Response Types: Select ‘none’.
- Token Endpoint Auth Method: Select ‘client_secret_basic’.
- API Scopes: Select ‘Mobile Device Management’.
- Click on ‘Register’.
- Click on ‘Client’ >> ‘Add Client’.
- Enter a name.
- Select your source system’s tenant SRP number (move it from the Available container to the Selected container).
- Leave ‘Post Logout Redirect URLs’ empty.
- Set ‚Id Token Signed Response Alg‘ to ES256.
- Click on ‘Register’.
- You can review the required details for your EBF Onboarder setup under ‘Applications’ >> ’Application Name’ >> ‘BlackBerry Platform APIs’ >> ‘Client’.
- Assign the app to an admin in your source UEM Cloud who has permission to ‘View users, devices’ and ‘Manage devices’, ‘Delete only work data, Delete all device data, Delete device’. This can be found under ‘Settings’ >> ‘Administrators’ >> ‘Web service clients’.
Add the apps also in OpenID Connect-Apps under Settings > BlackBerry Enterprise identity > Services to the OpenID Connect-Apps.
03. Source system selection for the source system BlackBerry UEM Cloud
When you setup a migration project with the EBF Onboarder, you will be asked to define the source system (please read the general documentation to learn more about this).
Select BlackBerry UEM Cloud as target system. The EBF Onboarder will display a set of values which are required to connect to your BlackBerry UEM Cloud system: Host, BlackBerry Tenant Id, BlackBerry Client Id, BlackBerry Client Secret, BlackBerry eId.
Please check the table below to find the parameters:
Parameter | Location |
BlackBerry UEM Client | BlackBerry myAccount >> ‚BlackBerry Support Community‘ >> ‚My Organization‘ >> ‚Overview‘ >> ‘Applications’ >> Open your client app |
Host | ‘BLACKBERRY PLATFORM APIS’ >> ‘CLIENT’: Redirect URL, without https:// |
BlackBerry Tenant Id | ‘BLACKBERRY PLATFORM APIS’ >> ‘CLIENT >> Tenants: A tenant within ‘Selected’ can be used (S only + number, not SRP). |
BlackBerry Client Id | ‘BLACKBERRY PLATFORM APIS’ >> ‘CLIENT’: Client Id |
BlackBerry Client Secret | ‘BLACKBERRY PLATFORM APIS’ >> ‘CLIENT’: Client Secret |
BlackBerry eId | https://idp.blackberry.com |
04. Device selection for the source system BlackBerry UEM Cloud
When you setup a migration project with the EBF Onboarder, you will be asked to select the devices you want to migrate (please read the general documentation to learn more about this).
A filter for the devices needs to be already existing or needs to be created in the source system before you setup the migration project. For the first tests you can use a test filter. For the real migration it is recommended to create filters like wave1, wave 2 etc. and to create single migration sets to have control over each wave.