Skip to content

Update the configuration keys list of the Kiosk app #487

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
id-melon merged 1 commit into from
Jan 27, 2026
Merged

Update the configuration keys list of the Kiosk app #487

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 20 additions & 3 deletions content/en/docs/software_and_hardware/idmelon_kiosk/deploy_idmelon_kiosk.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,9 @@ Editing the **configs.xml** file enables you to tailor the IDmelon Kiosk app to
### Configuration Keys

```xml
<KioskURL>https://myapps.microsoft.com</KioskURL>
<KioskURLs>
<URL auth_required="true">https://myapps.microsoft.com</URL>
</KioskURLs>
<SelfService>false</SelfService>
<MultiTabMode>true</MultiTabMode>
<ExtensionEnabled>true</ExtensionEnabled>
Expand All @@ -119,8 +121,8 @@ Editing the **configs.xml** file enables you to tailor the IDmelon Kiosk app to
</Policies>
```

- **KioskURL:** The default webpage the kiosk app loads upon startup.
- **SelfService:** Set it true if the **KioskURL** is a custom url (e.g., self-service url).
- **KioskURLs:** The addresses that must be opened when the kiosk app starts.
- **SelfService:** Set it true if the **KioskURLs** are anything other than myapps.microsoft.com.
- **MultiTabMode:** Enables (true) or disables (false) multi-tab browsing. Setting this to false activates full-screen mode.
- **ExtensionEnabled:** Toggles browser extensions on (true) or off (false).
Note: The Browser extension is required for the automation process. (When a card taps on the reader, the login automation will start).
Expand All @@ -139,6 +141,21 @@ Editing the **configs.xml** file enables you to tailor the IDmelon Kiosk app to
- **KeepDisplayAwake:** Controls whether the system is allowed to follow normal power‑saving rules (default = false) or whether it should keep the display awake at all times.
- **Policies:** Configurable rules that define the app’s behavior and user experience, such as allowed/blocked URLs, editing permissions, and security limits. (see [Policies](#policies) for more details)

#### Kiosk URLs

Add your URLs inside `<KioskURLs>` as `<URL>` elements.
If the URL requires authentication, set `auth_required="true"`.

If multiple URLs are authenticated by the same platform, set `auth_required="true"` on only one of them. For example:

```xml
<KioskURLs>
<URL auth_required="true">https://myapps.microsoft.com</URL>
<URL auth_required="false">https://excel.cloud.microsoft</URL>
<URL auth_required="false">https://idmelon.com</URL>
</KioskURLs>
```

#### Configuring Server Address

The IDmelon Kiosk app allows you to specify the target server address using the ServerAddress tag in the configuration file. By default, it connects to the IDmelon server. If you need to connect to a dedicated environment, follow these steps:
Expand Down
Loading