Working with Self Service Portal
- Martin Gudme Søndergaard
Introduction
This guide describes the first steps in getting started with CapaInstaller Self Service.
It outlines how to install, set up authentication, and create the first configuration for devices and users.
Installing
Follow the below steps to install the CapaInstaller Self Service Portal
Deploy a Back-end Service
Enable the Web Server
Execute the Windows Installer package
Execute the Windows Installer package (CapaInstaller Self Service Portal.msi) for the Self Service Portal.
Locate the file in the share of the root configuration management point e.g. "...\CMPDEV\Resources\Self Service Portal\CapaInstaller Self Service Portal.msi"
Follow the steps in the guided Setup and enter the URL to the relevant Back-end service, when asked.
Setting up IIS
Self Service Portal use SSL port 9443
Type: https
The IP address: All Unassigned
Port 9443
Hostname: (nothing)
SSL certificate: wildcard cert
Setting up access
To enable automatic access for devices and users without the need for login/password the below options should be configured
There are two methods of granting access to Self Service Configurations. One requires credentials and the other a specific link distributed as a Web clip on the relevant devices.
User Access
- Users will get access to a Self Service Configuration when they are linked to it. This can either be a direct link to a single user or by linking the Self Service Configuration to a group containing users.
- The user can manage the content of the Self Service Configuration on the devices where he/she is the primary user.
- The content is limited by BU and the type of device. If the device being managed is in a BU, content that is in other BUs, can not be installed.
- A web clip with the URL for the Self Service Portal must be created and linked to the user(s) or group of users.
- The user will have to login in order to use the Self Service Portal.
Device Access
- Access to the Self Service Portal without specifying credentials can be enabled/disabled in Options > System Administration > Self Service.
- Devices that are linked to one or more Self Service Configurations, will then be manageable in the Self Service Portal if specified in the URL. This can either be a direct link to a device or through a group with devices.
- When a Device is given access to a Self Service Configuration, a web clip is sent to the device, which will open the Self Service Portal for that specific device.
- The URL will contain the device token of the device, so anyone with access to the URL/device token will be able to manage that device from ANY device.
User access and device access can be combined to give access to both the device specified in the URL and the user's primary devices.
Specify the URL
- Specify the URL for the Self Service Portal
Enabling Device Acess with token in options
- In the top menu select Tools -> Options -> System Administration,
- Expand the Self Service section
- Select "Allow Access to Self Service Portal with token and without credentials"
To distribute and maintain the correct authentication links, a replicator must be assigned to the global task "Manage Self Service" and a Schedule for this task created.
- Select the Global Tasks button in the toolbar
- Right-click the Manage Self Service task on the list.
- Assign a replicator
- Create a schedule
Read more
- How to configure System Administration options
- How to Assign replicator to a global task
- How to use Scheduling
Adding a Self Service Configuration
Locate Self Service Configurations in Groups > System Groups in Configuration Management
Click on Create
- Enter a name for the configuration
- Select the applications that will be available via this configuration
The Self Service configuration is now ready. Users and devices can now be linked to the configuration using the buffer.
Content can be linked directly to a Self Service Configuration and consists of mobile applications. Content can not be linked through groups.
A Business Unit Self Service Configuration can only contain content which is in the same Business Unit as itself.
A Global Self Service Configuration can contain all content.
Setup complete
After completing the above steps, the Self Service Portal is ready!
Users and devices can now be linked to Self Service configurations using the buffer.
- Mobile applications can be linked directly to a Self Service Configuration
Links to the correct Self Service Portal will now be distributed as Web clips on devices added to the relevant Self Service configurations.
- Units and users added will now have access to download and install the selected applications.