eGate Admin Guide

Installation

eGate must be installed as the device owner. Android only allows this on a device with no accounts, so start from a factory reset.

1. Factory reset the device.
2. Go through setup. Connect to Wi-Fi, but don't add a Google account or any other account.
3. Turn on Developer options and USB debugging.
4. Install eGate, then connect the device to a computer and run:

   adb shell dpm set-device-owner "com.oss.egate/.a"
   adb shell pm grant com.oss.egate android.permission.WRITE_SECURE_SETTINGS

5. Open eGate. Enter your dealer code or licence, then set the administrator password.

If the first command fails, the device still has an account on it. Remove it or factory reset again.

To check that eGate is the device owner:

adb shell dumpsys device_policy | grep -i "device owner"

Write the password down somewhere safe. Set a password reset email under Security as soon as you can.

Logging in

eGate always opens on the login screen. Enter the administrator password and tap Log in.

Also on this screen:

• App store: opens the eGate app store without logging in.
• Let Google Play Services bypass the filter: on by default, so notifications and Google services keep working. Turn it off to filter Play Services too.
• Download configuration: downloads this licence's settings from the server and applies them.
• Open captive portal: opens the sign-in page for hotel, school or airport Wi-Fi.

The version number is shown at the bottom.

Opening eGate when its icon is hidden

Open the phone app and dial *#*#34283#*#*. eGate opens on the login screen.

The settings screen

After logging in you see a list of sections. Tap a section to open it and tap it again to close it.

Each section shows a short summary, such as Nothing blocked or DNS off, so you can check a device at a glance.

Changes apply as soon as you flip a switch. There is no save button. If Android refuses a setting, the switch turns back off and eGate shows a message.

The back button does nothing on this screen. To leave eGate, use Exit at the bottom.

Reset protection

Set a password reset email before turning these on.

User control

App control

Choosing apps

• Hide apps: the app disappears and can't run. Its data is kept. Works on system apps too.
• Unhide apps: brings hidden apps back.
• Block uninstall and Allow uninstall: protect chosen apps from being removed.

Each of these opens a list of installed apps. Search by name, tick the apps, and go back.

Switches

Installation blacklist

Open it from the bottom of App control.

The list holds known apps, grouped by type, such as other app stores and dating apps. Tick the apps to block, or use Toggle all for a whole group, then tap Save.

If a blacklisted app is installed later, eGate hides it straight away.

Block apps by category

Switches for whole groups of apps:

• Adult content apps
• Crypto and trading apps
• Gaming apps
• Gambling apps

eGate hides installed apps that match the category.

Connectivity

System

Kyocera

Extra settings for Kyocera phones. They need the Kyocera Device Config Plugin installed on the phone. Without it, the section shows Device Config Plugin not installed.

Call restrictions

Choose a rule for incoming calls and one for outgoing calls:

• No restriction
• Only allowlisted numbers
• Only contacts
• Contacts and allowlisted numbers
• Block all calls

Add numbers under Allowed phone numbers, then tap Save. The list is only used by the rules that include allowlisted numbers.

DNS filter

The DNS filter works for every app and browser. The user can't change it.

To use your own server, tick Custom DNS server, enter the hostname, and tap save.

Turn off DNS filtering removes the filter.

Also turn on Block VPN configuration and Block tethering so the filter can't be bypassed.

Proxy

1. Turn on Use proxy.
2. Enter the Host and Port.
3. Optional: in Exclusion list, enter hosts that skip the proxy, separated by commas.
4. Tap Save.

Clear proxy removes the settings. If the proxy filters HTTPS, also turn on Chrome certificate integration under App control.

Accessibility filter

Blocks content inside apps. Turn on Enable accessibility filter first.

App store

eGate has its own app store with approved apps, sorted into categories. Users can install from it even when other installs are blocked.

Security

Push and pull ask you to confirm first. Pull overwrites any changes made on the device.

Appearance and maintenance

Danger zone

Exit closes eGate. All settings stay in force.

Remove eGate removes device ownership and turns off every restriction. It can't be undone without a factory reset. Only use it when a device is leaving your control.