Home page Customization

Make the shared iPad fit your team.

All optional. Add the blocks you want to the managed app config you push from Intune. For type, allowed values, and default of every key, see Configuration keys.

Shortcut tiles

shortcut_list adds tiles to the home screen. Each tile is a dict with three keys:

  • title — label under the tile.
  • url — where it opens; accepts the tokens below.
  • iconName — remote icon, fetched as <name>.png from your image host; unresolved name = no icon.

teams, outlook, myapps below are icons the host already serves.

<key>shortcut_list</key>
<array>
  <dict>
    <key>title</key>
    <string>Teams</string>
    <key>url</key>
    <string>msteams://</string>
    <key>iconName</key>
    <string>teams</string>
  </dict>
  <dict>
    <key>title</key>
    <string>Outlook</string>
    <key>url</key>
    <string>ms-outlook://</string>
    <key>iconName</key>
    <string>outlook</string>
  </dict>
  <dict>
    <key>title</key>
    <string>My Apps</string>
    <key>url</key>
    <string>https://myapps.microsoft.com</string>
    <key>iconName</key>
    <string>myapps</string>
  </dict>
</array>

A tile or redirect URL can carry who’s signed in. The app substitutes these tokens:

TokenBecomes
{email}Email address
{username}Username
{name}Display name
{realm}Realm
{organization}Organization
{tenantID}Tenant ID

Drop a token into a URL:

<key>url</key>
<string>https://myapps.microsoft.com/?login_hint={email}</string>

Automatic logout

auto_logout signs the iPad out after a set time. Use one of the buckets in Configuration keys. never, one-time use, and any unrecognized value mean no timer.

<key>auto_logout</key>
<string>5m</string>

Require a PIN or second factor

authentication_type — when the user proves themselves a second time:

ValuePrompts
noneNever; sign-in is the only step
oninitOnce, right after sign-in
onuseEach time an app or tile needs it
<key>authentication_type</key>
<string>oninit</string>

Open an app or page automatically

The two URL keys accept the tokens above:

  • default_sp_for_auto_login — auto-starts sign-in for one service provider by name.
  • open_url_after_login — opens a URL right after sign-in.
  • open_url_after_logout — opens a URL right after logout.
<key>open_url_after_login</key>
<string>https://myapps.microsoft.com/?login_hint={email}</string>

Self-service for users who aren’t enrolled yet

self_service_url — where an unenrolled user goes to enroll. Build the workflow in the IDmelon Admin Panel, then paste its URL here.

<key>self_service_url</key>
<string>https://your-self-service-workflow-url</string>

In-app browser vs Safari

use_internal_browser — on, links open in the in-app browser; off, links hand to Safari. See the default in Configuration keys.

<key>use_internal_browser</key>
<true/>

Where this fits

Each block goes inside the same <dict> from Set up a shared iPad. Add the keys you want, push, and sync.

Edit this page on GitHub
×