VSP Connection and Authentication
Assemble needs connection and authentication settings for the VSP API.
Create/Edit VSP Connection Details
Opening vsp.exe will launch a GUI for filling in and saving VSP connection details.
Click <Save> after filling in all the connection details. It will save the settings to the specified filename in the same directory as the tool. The password is encrypted using AES-256 encryption and a 100 character key.
| NOTE: | The API user’s password cannot contain the symbol “@”. If it does, the symbol must be removed from the password or Assemble will not function correctly. |
If your VSP is a Connected Cloud installation hosted by MobileIron, the VSP FQDN should be in the format “m.mobileiron.net/customername”.
[VSP]
vsp=vsp1.company.com
username=apiuser
password=0x86DD0705488F2C78D17F19A1FT45460C
Multiple INI files can be saved with different connection settings if a company has multiple VSPs they want to apply Assemble rules against.
Click the “Load” button to choose and edit a previously created VSP INI file.
To prompt for the user’s password each time Assemble is run, manually change the password key to “prompt”.
[VSP]
vsp=vsp1.company.com
username=apiuser
password=prompt
If you need to use a web proxy server to access the VSP, enter in the proxy settings. The proxy address syntax must be “ipaddress:port”. If the proxy requires authentication, also fill in the proxy username and password.
[VSP]
vsp=vsp1.company.com
username=apiuser
password=0x86DD0705488F2C78D17F19A1FT45460C
proxy=192.168.1.100:8080
proxyusername=proxyuser
proxypassword=0x86DD0705488F2C78D17F19A2894659674
If wget=no in the section [RuleNum], no other proxy setting is needed. If wget=yes or is not set (yes is the default), you must set the above key in the vsp.ini file and also see the details for the key wget in the section in the Assemble documentation to set the wget proxy.
If the proxy server requires authentication, set the proxy username and password using vsp.exe and set “wget=no” in the [RuleNum] section.
The only NTLM proxy authentication method will work properly. Basic proxy authentication does not work at this time.