Installing and Configuring App Broker Proxy
App Broker Cloud requires a Proxy setup to be installed on your server to communicate with your on-premises deployment systems (such as Configuration Manager).
Installing App Broker Proxy setup accomplishes the following tasks:
| • | Deploys the Proxy API. |
| • | Registers the Proxy App into the Proxy Manager. |
| • | Allows you to manually configure multiple Configuration Manager sites to your App Broker Cloud instances. |
Note:To download the App Broker Proxy setup, visit the Flexera Product and License Center.
To Install the App Broker Proxy App
To install the App Broker Proxy App, perform the following steps.
To install the App Broker Proxy App:
| 1. | Launch the App Broker Proxy Setup. The Welcome panel of the wizard opens. |
| 2. | Click Next. The Customer Information panel appears, |
| 3. | In the OrgId field, enter the organization ID that was provided by Flexera. |
| 4. | In the Refresh Token field, enter the refresh token. |
Note:To generate a refresh token, refer to Generating a Refresh Token for API Access.
| 5. | Click Validate to validate the customer information and click Next. The Configuration Manager Information panel opens. |
| 6. | Enter details for the following fields: |
| • | Central Site Server—Enter the machine name of the Configuration Manager (current branch) server. |
| • | Central Site Code—Enter the Central Site Code. |
| • | User Name—Enter the user name of the user account that has permission to access Configuration Manager (current branch). |
| • | Password—Enter the password associated to the user name that was entered. |
| • | User Device Association Type—Select one the following association types from the drop- down list: |
| • | Last log on— The user-to-computer relationship uses SMS last logon user. |
| • | User Affinity—In System Center Configuration Manager (current branch), you can directly define the users for a computer and the computers for a user. Choose this option if that is how you want to define the user-to-computer relationship. |
Tip:While Installing App Broker Proxy, you can configure only one Configuration Manager primary site; however, after installation you can manually configure multiple Configuration Manager sites. See Manually Configuring Multiple Configuration Manager Sites.
| 7. | Click Test to test the Configuration Manager details entered, and then click Next. The Ready to Install panel opens. |
| 8. | Click Install to start the installation. |
| 9. | When installation is complete, click the Finish button. |
Important:Verify the wstunnel.exe process is running in your system Task Manager (by pressing Ctrl+Alt+Delete, clicking Task Manager, and reviewing).
Manually Configuring Multiple Configuration Manager Sites
App Broker Cloud has the capability to support multiple Configuration Manager primaries, which means that in the same catalog item, the admin can add an application or package from multiple Configuration Manager primaries. This supports users who have clients from multiple Configuration Managers in their devices. It allows users to request software from different Configuration Manager client devices.
After successful installation of App Broker Proxy, you can manually configure multiple Configuration Manager Sites.
The following table lists the properties required when manually configuring a Configuration Manager site.
|
Property |
Description |
|
IsDefault |
This property sets ConfigMgr site as the default site code. If you have configured multiple ConfigMgr sites, only one of the ConfigMgr sites can be set, as default, to True. |
|
Central Site Server |
Enter the machine name of the System Center Configuration Manager (current branch) server. |
|
Central Site Code |
Defines the central site code. |
|
User Name |
This user should have permissions to access Configuration Manager (current branch). |
|
Password |
Provide the password for the above user name. |
|
UserFolderId |
Provide the UserFolderId of the folder in ConfigMgr where user collections should get created. You can enter “0” if you don’t have any specific folder; the user collections are created under the root folder User Collections in ConfigMgr. |
|
DeviceFolderId |
Provide the DeviceFolderId of the folder in ConfigMgr where device collections should get created. You can enter “0” if you don’t have any specific folder; the user collections are created under the root folder Device Collections in ConfigMgr. |
|
AdvertisementFolderId |
Provide the AdvertisementId of the folder in ConfigMgr where Advertisements should get created. You can enter “0” if you don’t have any specific folder. |
Manually Configuring Multiple Configuration Manager Sites
To manually configure multiple Configuration Manager sites, perform the following steps.
To manually configure multiple Configuration Manager sites:
| 1. | On the server machine where the Proxy App is installed, navigate to the installed location of the App Broker Proxy. |
| 2. | In the API folder, open the appsettings.json file. |
| 3. | Locate the Connections section: |
"Connections": [
{
"IsDefault": true,
"CentralSiteServer": "ConfigMgr server name 1",
"CentralSiteCode": "ConfigMgr Site code",
"UserName": "ConfigMgr username",
"Password": "Password",
"UserFolderId": "0",
"DeviceFolderId": "0",
"AdvertisementFolderId": "0"
}
Note:In the above Connections section, the Configuration Manager details that are displayed are captured during the Proxy App installation.
| 4. | Add the second Configuration Manager primary site details, separated by comma as shown following: |
"Connections": [
{
"IsDefault": true,
"CentralSiteServer": "ConfigMgr server name 1",
"CentralSiteCode": "ConfigMgr Site code",
"UserName": " ConfigMgr username",
"Password": "Password",
"UserFolderId": "0",
"DeviceFolderId": "0",
"AdvertisementFolderId": "0"
},
{
"IsDefault": false,
"CentralSiteServer": "ConfigMgr server name 2",
"CentralSiteCode": "ConfigMgr Site code",
"UserName": "ConfigMgr username",
"Password": "Password",
"UserFolderId": "0",
"DeviceFolderId": "0",
"AdvertisementFolderId": "0"
}
Note:The default value can be updated to any one of the Configuration Manager primary.
| 5. | After you successfully enter the configuration details, save the appsettings.json , and close the file. |
| 6. | Restart Internet Information Services (IIS). This completes the multiple Configuration Manager configuration. |
Tip:Similarly, you can add multiple number of Configuration Manager primary site settings separated by commas as shown in the above example.
App Broker Cloud Release NotesOctober 2020 |