Mobile App setup

Table of Contents

• Components
• ServiceAPI
• Setup Script
• Manual Setup
  • ServiceAPI Configuration
  • Azure App Configuration

Components

The Content Manager Mobile App requires an instance of the ServiceAPI configured to use OpenId Connect for authentication.

ServiceAPI

The ServiceAPI must be installed and must have a valid HTTPS certificate, any HTTP errors will cause the Mobile App to fail.

Setup Script

The simplest way to setup Azure AD and the ServiceAPI is to run the setup script which will create:

• an Azure App, and
• sample authentication settings for the ServiceAPI hptrim.config.
  

To use the script:

1. install the Azure CLI
2. download and run the script.

Once the script is complete there will be a new Azure AD App in your tenant and some sample configuration to be pasted into your ServiceAPI hptrim.config file.

Manual Setup

ServiceAPI Configuration

The ServiceAPI must be configured to support OpenId Connect authentication as detailed in the authentication section. In addition the hptrim.config file must contain an 'add' element with the name 'mobile' and the redirectUri 'trimapp://mobile'.

<authentication corsAllowedOrigins="https://mydev.dev:3000" allowAnonymous="false" slidingSessionMinutes="30" redirectURI="">
  <openIdConnect>
    ...
 
    <add name="mobile" clientID="[YOUR CLIENT id]" clientSecret="[YOUR SECRET]"  issuerURI="[YOUR ISSUER URI]" redirectUri="trimapp://mobile" />
  </openIdConnect>
</authentication>

Azure App Configuration

Ensure the Azure AD App created in the previous step has the following settings (both all in lower case):

• Authentication > Web > Redirect URIs - [SERVICEAPIURI]/auth/mobile (e.g https://acme.com/cmserviceapi/auth/mobile)
• Authentication > Mobile and desktop applications > Redirect URIs - trimapp://mobile