App-Konfiguration

Threema Work erlaubt, App-Einstellungen ferngesteuert vorzunehmen. Sie haben Kontrolle über die Konfiguration der App, können gezielt Funktionen deaktivieren, und der Endnutzer braucht den Einrichtungsprozess u.U. gar nicht zu durchlaufen.

Konfiguration via MDM-Software

Unter Android und iOS besteht die Möglichkeit, Apps in einem sogenannten «Managed Profile» zu installieren, um die geschäftliche von der privaten Nutzung zu trennen. So installierte Apps können über ein MDM-System ferngesteuert konfiguriert werden.

Threema Work unterstützt folgende Plattformen und Profilart:
Plattform Systemvoraussetzung Unterstützte Profilarten
Android Android 5.0+ Android Enterprise / Managed Configurations
iOS iOS 7+ Managed App Configuration
Windows Phone WP 8.1+ Konfiguration mittels URL-Aktionen (Windows Phone)

Kontaktieren Sie bitte Ihren MDM-Anbieter für verbindliche Informationen betreffend Kompatibilität.

Nähere Angaben zu Rollout und Verteilung finden Sie in der Dokumentation.

Konfiguration via Management-Cockpit (Threema-MDM)

Falls Sie kein MDM-System verwenden oder gewisse Nutzergruppen nicht darüber verwalten möchten, können Sie mit Threema-MDM die App-Konfiguration direkt im Management-Cockpit vornehmen. Threema-MDM unterstützt grundsätzlich dieselben Konfigurationsparameter, die bei Verteilung über ein MDM-System zur Verfügung stehen.

Unterstützte Konfigurationsparameter

Name
Type
Min
Max
OS
Renewable1
User-editable2
Standardwert
Threema-MDM
th_license_username
Benutzername, der zur Aktivierung der App benötigt wird
Type
string
Min
1
Max
255
OS
All
Renewable1
Nein
User-editable2
Nein
Standardwert
-
Threema-MDM
Nein
th_license_password
Passwort, das zur Aktivierung der App benötigt wird
Type
string
Min
1
Max
-
OS
All
Renewable1
Nein
User-editable2
Nein
Standardwert
-
Threema-MDM
Nein
th_nickname
Der Nickname erscheint in den Kontaktdetails (sowie u.U. in Push-Benachrichtigungen).
Type
string
Min
0
Max
32
OS
All
Renewable1
Nein
User-editable2
Ja
Standardwert
-
Threema-MDM
Ja
th_firstname
Vorname des Benutzers; im Work-Cockpit/API ersichtlich.
Type
string
Min
-
Max
255
OS
Android (3.43k), iOS (3.0.9k), WP (2.3.0k)
Renewable1
Ja
User-editable2
Ja
Standardwert
-
Threema-MDM
Ja
th_lastname
Nachname des Benutzers; im Work-Cockpit/API ersichtlich.
Type
string
Min
-
Max
255
OS
Android (3.43k), iOS (3.0.9k), WP (2.3.0k)
Renewable1
Ja
User-editable2
Ja
Standardwert
-
Threema-MDM
Ja
th_csi
Als CSI (Customer Specific Identifier) kann ein beliebiger Wert gesetzt werden (z.B. eine interne Mitarbeiternummer); der Wert ist nur im Management-Cockpit ersichtlich, nicht in der App.
Type
string
Min
-
Max
255
OS
Android (3.43k), iOS (3.0.9k), WP (2.3.0k)
Renewable1
Ja
User-editable2
Ja
Standardwert
-
Threema-MDM
Ja
th_category
Benutzerkategorie (z.B. Gruppe, Abteilung o.ä.); ist im Work-Cockpit/API ersichtlich.
Type
string
Min
-
Max
255
OS
Android (3.43k), iOS (3.0.9k), WP (2.3.0k)
Renewable1
Ja
User-editable2
Ja
Standardwert
-
Threema-MDM
Ja
th_linked_email
Die mit einer Threema-ID verknüpfte E-Mail-Adresse dient zur Kontakt-Synchronisation.
Type
string
Min
-
Max
-
OS
All
Renewable1
Nein
User-editable2
Ja
Standardwert
-
Threema-MDM
Ja
th_linked_phone
Die mit einer Threema-ID verknüpfte Telefonnummer dient zur Kontakt-Synchronisation. Die Telefonnummer muss im internationalen Format angegeben sein, z.B. +41555114900.
Type
string
Min
-
Max
-
OS
All
Renewable1
Nein
User-editable2
Ja
Standardwert
-
Threema-MDM
Ja
th_id_backup
Über diesen Parameter können vorberechnete Schlüsselpaare (Threema-IDs) übergeben werden und ID-Backups zurückgespielt werden
Type
string
Min
99
Max
99
OS
All
Renewable1
Nein
User-editable2
Nein
Standardwert
-
Threema-MDM
Ja
th_id_backup_password
Passwort, das zum ID-Backup in th_id_backup gehört.
Type
string
Min
8
Max
-
OS
All
Renewable1
Nein
User-editable2
Nein
Standardwert
-
Threema-MDM
Ja
th_safe_enable
Wenn true, muss Threema Safe verwendet werden; wenn false, kann Threema Safe nicht verwendet werden. (Wenn nicht gesetzt, kann Threema Safe optional verwendet werden.)
Type
bool
Min
-
Max
-
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Ja
User-editable2
Nein
Standardwert
-
Threema-MDM
Ja
th_safe_password
Passwort zum Verschlüsseln (bzw. Wiederherstellen, vgl. th_safe_restore_id ) des Threema Safe-Backups (in Threema-MDM nicht verfügbar)
Type
string
Min
8
Max
4096
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Ja
User-editable2
Nein
Standardwert
-
Threema-MDM
Nein
th_safe_server_url
URL für eigenen Threema Safe-Server, z.B. musterfirma.com/threemasafe
Type
string
Min
-
Max
-
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Ja
User-editable2
Nein
Standardwert
-
Threema-MDM
Ja
th_safe_server_username
Benutzername für HTTPS-Authentisierung des in th_safe_server_url festgelegten Threema Safe-Servers (falls benötigt)
Type
string
Min
-
Max
-
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Ja
User-editable2
Nein
Standardwert
-
Threema-MDM
Ja
th_safe_server_password
Passwort für HTTPS-Authentisierung des in th_safe_server_url festgelegten Threema Safe-Servers (falls benötigt)
Type
string
Min
-
Max
-
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Ja
User-editable2
Nein
Standardwert
-
Threema-MDM
Ja
th_safe_restore_enable
Wenn false, ist die Wiederherstellung von Threema Safe-Backups nicht möglich. Wenn true, ist die Wiederherstellung von Threema Safe-Backups im Einrichtungsprozess optional (falls th_safe_restore_id nicht gesetzt ist) bzw. obligatorisch (falls th_safe_restore_id gesetzt ist).
Type
bool
Min
-
Max
-
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Nein
User-editable2
Nein
Standardwert
-
Threema-MDM
Ja
th_safe_restore_id
Aus Threema Safe wiederherzustellende Threema-ID, wenn th_safe_restore_enable true ist
Type
string
Min
8
Max
8
OS
Android (3.62k), iOS (4.2.1k)
Renewable1
Nein
User-editable2
Nein
Standardwert
-
Threema-MDM
Ja
th_safe_password_patternNeu
Regulärer Ausdruck (Regex), der das Format des vom Benutzer gewählten Passworts für Threema Safe bestimmt. Falls nicht gesetzt, gilt nur die Regel, dass das Passwort mindestens 8 Zeichen haben muss. Der reguläre Ausdruck muss mit Java Pattern (Android) und NSRegularExpression (iOS) kompatibel sein.
Type
string
Min
-
Max
-
OS
Android (4.2k), iOS (4.4k)
Renewable1
Ja
User-editable2
Nein
Standardwert
-
Threema-MDM
Ja
th_safe_password_messageNeu
Fehlermeldung, die angezeigt wird, wenn das vom Benutzer für Threema Safe gewählte Passwort nicht dem Muster th_safe_password_pattern entspricht.
Type
string
Min
-
Max
-
OS
Android (4.2k), iOS (4.4k)
Renewable1
Ja
User-editable2
Nein
Standardwert
-
Threema-MDM
Ja
th_contact_sync
Wenn true, wird die Synchronisation mit dem lokalen Adressbuch aktiviert.
Type
bool
Min
-
Max
-
OS
All
Renewable1
Nein
User-editable2
Ja
Standardwert
false
Threema-MDM
Ja
th_hide_inactive_idsNeu
Wenn true, werden inaktive IDs (d.h. solche, die während mehr als drei Monaten nicht in Gebrauch waren) und widerrufene IDs ausgeblendet.
Type
bool
Min
-
Max
-
OS
Android (4.2k), iOS (4.4k)
Renewable1
Ja
User-editable2
Ja
Standardwert
false
Threema-MDM
Ja
th_readonly_profile
Wenn true, können folgende Profil-Einstellungen nicht verändert werden: Nickname, Profilbild, Verknüpfung der ID mit einer E-Mail-Adresse/Handynummer, Kontaktsynchronisation, ID exportieren, ID löschen, Passwort für ID-Widerruf. Die Verwendung von Threema Safe und der ID-Export lassen sich mit den entsprechenden Parametern (th_safe_enable und th_disable_id_export) unterbinden.
Type
bool
Min
-
Max
-
OS
All
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_block_unknown
Wenn true, werden unbekannte Kontakte (d.h. solche, die nicht im lokalen Adressbuch aufgeführt sind) blockiert.
Type
bool
Min
-
Max
-
OS
All
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_screenshots
Wenn true, wird unter Android das Erstellen von Screenshots sowie das Anzeigen von Vorschaubildern im App Switcher unterbunden.
Type
bool
Min
-
Max
-
OS
Android, WP
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_add_contact
Wenn true, wird das manuelle Hinzufügen von Kontakten unterbunden. Kontakte können nur durch Kontakt-Synchronisation (sofern nicht deaktiviert, s. th_contact_sync) oder durch Nachrichten-Empfang (sofern unbekannte Kontakte nicht blockiert sind, s. th_block_unknown) hinzugefügt werden.
Type
bool
Min
-
Max
-
OS
Android (2.82k), iOS (2.7.3k), WP
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_export
Wenn true, wird das Exportieren von Chats unterbunden.
Type
bool
Min
-
Max
-
OS
All
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_backups
Wenn true, wird das Erstellen jeglicher Backups unterbunden. Dieser Parameter übersteuert th_safe_enable, th_disable_data_backups, th_disable_system_backups und th_disable_id_export.
Type
bool
Min
-
Max
-
OS
All
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_id_export
Wenn true, wird das Exportieren der ID unterbunden.
Type
bool
Min
-
Max
-
OS
Android (3.7k), iOS (4.2.1k)
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_data_backups
Wenn true, wird das Erstellen von Daten-Backups unterbunden (nur unter Android möglich).
Type
bool
Min
-
Max
-
OS
Android (3.7k)
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_system_backups
Wenn true, werden Threema-Daten von iTunes/iCloud-Backups ausgeschlossen. Nicht relevant für Android.
Type
bool
Min
-
Max
-
OS
iOS (4.2.1k)
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_message_preview
Wenn true, wird die Nachrichten-Vorschau in Push-Benachrichtigungen deaktiviert.
Type
bool
Min
-
Max
-
OS
Android (3.02k), iOS (2.9.1k)
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_send_profile_picture
Wenn true, wird das Profilbild des Nutzers nicht mit anderen geteilt.
Type
bool
Min
-
Max
-
OS
Android (3.14k), iOS (2.10.1k)
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_calls
Wenn true, werden Threema-Anrufe deaktiviert.
Type
bool
Min
-
Max
-
OS
Android (3.2k), iOS (3.0k)
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_skip_wizard
Wenn true, wird der Einrichtungsdialog beim ersten Start der App nicht angezeigt.
Type
bool
Min
-
Max
-
OS
Android (3.2k), iOS (3.0.6k), WP (2.1.0k)
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_create_group
Wenn true, wird das Erstellen von Gruppen unterbunden.
Type
bool
Min
-
Max
-
OS
Android (3.3k), iOS (3.0.4k), WP (2.2.0k)
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_disable_web
Wenn true, wird Threema Web deaktiviert.
Type
bool
Min
-
Max
-
OS
Android (3.551k), iOS (4.0.3k)
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja
th_web_hostsNeu
Falls gesetzt, kann sich Threema Web nur mit den definierten Servern verbinden. Als Wert ist eine kommagetrennte Liste von Hostnamen zu verwenden. Wenn ein Hostname mit * beginnt, wird Suffix Matching angewendet, andernfalls muss der Hostname vollständig übereinstimmen. Beispiel: signaling.threema.ch,*-signaling-test.threema.ch
Type
string
Min
-
Max
-
OS
Android (4.1k), iOS (4.4k)
Renewable1
Ja
User-editable2
Nein
Standardwert
-
Threema-MDM
Ja
th_disable_share_mediaNeu
Wenn true, ist das Speichern und Teilen von Medien und Dateien ausserhalb von Threema Work unterbunden. Unter Android systembedingt nur bei Bildern, Videos und Sprachnachrichten.
Type
bool
Min
-
Max
-
OS
Android (4.2k), iOS (4.4k)
Renewable1
Ja
User-editable2
Nein
Standardwert
false
Threema-MDM
Ja