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 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. Mehr erfahren…

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
PlattformAndroid
SystemvoraussetzungAndroid 5.0+
Unterstützte ProfilartenAndroid Enterprise / Managed Configurations
PlattformiOS
SystemvoraussetzungiOS 7+
Unterstützte ProfilartenManaged App Configuration

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

Unterstützte Konfigurationsparameter

Name
Type
Min
Max
OS
Renewable1
User-editable2
Standardwert

Nutzerverwaltung

th_license_username
Benutzername, der zur Aktivierung der App benötigt wird (erfordert ein externes MDM-System und ist in Threema-MDM nicht verfügbar)
Type:string
Min:1
Max:255
OS:Alle
Renewable:Nein
User-editable:Nein
Standardwert:-
Benutzername, der zur Aktivierung der App benötigt wird (erfordert ein externes MDM-System und ist in Threema-MDM nicht verfügbar)
th_license_password
Passwort, das zur Aktivierung der App benötigt wird (erfordert ein externes MDM-System und ist in Threema-MDM nicht verfügbar)
Type:string
Min:1
Max:-
OS:Alle
Renewable:Nein
User-editable:Nein
Standardwert:-
Passwort, das zur Aktivierung der App benötigt wird (erfordert ein externes MDM-System und ist in Threema-MDM nicht verfügbar)
th_csi
Als CSI (Customer Specific Identifier) kann ein beliebiger Wert gesetzt werden (z.B. eine interne Mitarbeiternummer); der Wert ist sowohl in der Nutzerübersicht im Management-Cockpit wie auch bei der Suche im Unternehmensverzeichnis in der App ersichtlich und erleichtert die eindeutige Identifizierung von Mitarbeitern (z.B. bei gleichlautenden Namen).
Type:string
Min:-
Max:255
OS:Android (3.43k)
iOS (3.0.9k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Als CSI (Customer Specific Identifier) kann ein beliebiger Wert gesetzt werden (z.B. eine interne Mitarbeiternummer); der Wert ist sowohl in der Nutzerübersicht im Management-Cockpit wie auch bei der Suche im Unternehmensverzeichnis in der App ersichtlich und erleichtert die eindeutige Identifizierung von Mitarbeitern (z.B. bei gleichlautenden Namen).
th_category
Benutzerkategorie (z.B. Gruppe, Abteilung o.ä.); in Management-Cockpit und API ersichtlich.
Type:string
Min:-
Max:255
OS:Android (3.43k)
iOS (3.0.9k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Benutzerkategorie (z.B. Gruppe, Abteilung o.ä.); in Management-Cockpit und API ersichtlich.
th_skip_wizard
Wenn true, wird der Einrichtungsassistent beim ersten Start der App übersprungen. (Im Einrichtungsassistenten lassen sich th_linked_phone, th_linked_email, th_contact_sync sowie Parameter für Threema Safe festlegen.)
Type:bool
Min:-
Max:-
OS:Android (3.2k)
iOS (3.0.6k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, wird der Einrichtungsassistent beim ersten Start der App übersprungen. (Im Einrichtungsassistenten lassen sich th_linked_phone, th_linked_email, th_contact_sync sowie Parameter für Threema Safe festlegen.)

Nutzerprofil

th_nickname
Der Nickname erscheint in den Kontaktdetails (sowie u.U. in Push-Benachrichtigungen).
Type:string
Min:-
Max:32
OS:Alle
Renewable:Ja
User-editable:Ja
Standardwert:-
Der Nickname erscheint in den Kontaktdetails (sowie u.U. in Push-Benachrichtigungen).
th_linked_email
Die mit einer Threema-ID verknüpfte E-Mail-Adresse dient zur Kontakt-Synchronisation.
Type:string
Min:-
Max:-
OS:Alle
Renewable:Nein
User-editable:Ja
Standardwert:-
Die mit einer Threema-ID verknüpfte E-Mail-Adresse dient zur Kontakt-Synchronisation.
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:Alle
Renewable:Nein
User-editable:Ja
Standardwert:-
Die mit einer Threema-ID verknüpfte Telefonnummer dient zur Kontakt-Synchronisation. Die Telefonnummer muss im internationalen Format angegeben sein, z.B. +41555114900.
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, 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:Alle
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, können folgende Profil-Einstellungen nicht verändert werden: Nickname, Profilbild, Verknüpfung der ID mit einer E-Mail-Adresse/Handynummer, 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.
th_disable_id_export
Wenn true, wird das Exportieren der ID unterbunden.
Type:bool
Min:-
Max:-
OS:Android (3.7k)
iOS (4.2.1k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, wird das Exportieren der ID unterbunden.
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)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, wird das Profilbild des Nutzers nicht mit anderen geteilt.

Kontakte

th_firstname
Vorname des Benutzers; in Management-Cockpit und API ersichtlich.
Type:string
Min:-
Max:255
OS:Android (3.43k)
iOS (3.0.9k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Vorname des Benutzers; in Management-Cockpit und API ersichtlich.
th_lastname
Nachname des Benutzers; in Management-Cockpit und API ersichtlich.
Type:string
Min:-
Max:255
OS:Android (3.43k)
iOS (3.0.9k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Nachname des Benutzers; in Management-Cockpit und API ersichtlich.
th_contact_sync
Wenn true, wird die Synchronisation mit dem lokalen Adressbuch aktiviert. Unter Android sowie in früheren Versionen (<4.5k) der iOS-App ist dieser Parameter nicht renewable.
Type:bool
Min:-
Max:-
OS:Alle
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, wird die Synchronisation mit dem lokalen Adressbuch aktiviert. Unter Android sowie in früheren Versionen (<4.5k) der iOS-App ist dieser Parameter nicht renewable.
th_block_unknown
Wenn true, werden unbekannte Kontakte (d.h. solche, die nicht in der Kontaktliste aufgeführt sind) blockiert.
Type:bool
Min:-
Max:-
OS:Alle
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, werden unbekannte Kontakte (d.h. solche, die nicht in der Kontaktliste aufgeführt sind) blockiert.
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)
Renewable:Ja
User-editable:Nein
Standardwert:-
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.
th_disable_work_directory
Wenn true, ist der Zugriff auf das interne Threema Work-Nutzerverzeichnis verwehrt.
Type:bool
Min:-
Max:-
OS:Android (4.55k)
iOS (4.6.9k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, ist der Zugriff auf das interne Threema Work-Nutzerverzeichnis verwehrt.

Backup: Allgemein

th_id_backup
Über diesen Parameter können vorberechnete Schlüsselpaare (Threema-IDs) übergeben werden und ID-Backups (neu «ID-Exporte» genannt) zurückgespielt werden. Erfordert ein externes MDM-System; in Threema-MDM nicht verfügbar.
Type:string
Min:99
Max:99
OS:Alle
Renewable:Nein
User-editable:Nein
Standardwert:-
Über diesen Parameter können vorberechnete Schlüsselpaare (Threema-IDs) übergeben werden und ID-Backups (neu «ID-Exporte» genannt) zurückgespielt werden. Erfordert ein externes MDM-System; in Threema-MDM nicht verfügbar.
th_id_backup_password
Passwort zu ID-Backup/Export in th_id_backup. Erfordert ein externes MDM-System; in Threema-MDM nicht verfügbar.
Type:string
Min:8
Max:-
OS:Alle
Renewable:Nein
User-editable:Nein
Standardwert:-
Passwort zu ID-Backup/Export in th_id_backup. Erfordert ein externes MDM-System; in Threema-MDM nicht verfügbar.
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:Alle
Renewable:Ja
User-editable:Nein
Standardwert:-
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.
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)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, wird das Erstellen von Daten-Backups unterbunden (nur unter Android möglich).
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)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, werden Threema-Daten von iTunes/iCloud-Backups ausgeschlossen. Nicht relevant für Android.

Backup: Threema Safe

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)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, muss Threema Safe verwendet werden; wenn false, kann Threema Safe nicht verwendet werden. (Wenn nicht gesetzt, kann Threema Safe optional verwendet werden.)
th_safe_password
Passwort zum Verschlüsseln (bzw. Wiederherstellen, vgl. th_safe_restore_id ) des Threema Safe-Backups (erfordert ein externes MDM-System und ist in Threema-MDM nicht verfügbar)
Type:string
Min:8
Max:4096
OS:Android (3.62k)
iOS (4.2.1k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Passwort zum Verschlüsseln (bzw. Wiederherstellen, vgl. th_safe_restore_id ) des Threema Safe-Backups (erfordert ein externes MDM-System und ist in Threema-MDM nicht verfügbar)
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)
Renewable:Ja
User-editable:Nein
Standardwert:-
URL für eigenen Threema Safe-Server, z.B. musterfirma.com/threemasafe
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)
Renewable:Ja
User-editable:Nein
Standardwert:-
Benutzername für HTTPS-Authentisierung des in th_safe_server_url festgelegten Threema Safe-Servers (falls benötigt)
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)
Renewable:Ja
User-editable:Nein
Standardwert:-
Passwort für HTTPS-Authentisierung des in th_safe_server_url festgelegten Threema Safe-Servers (falls benötigt)
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)
Renewable:Nein
User-editable:Nein
Standardwert:-
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).
th_safe_restore_id
Aus Threema Safe wiederherzustellende Threema-ID, wenn th_safe_restore_enable true ist. Falls auch th_safe_password gesetzt ist, wird die ID ohne Zutun des Nutzers wiederhergestellt.
Type:string
Min:8
Max:8
OS:Android (3.62k)
iOS (4.2.1k)
Renewable:Nein
User-editable:Nein
Standardwert:-
Aus Threema Safe wiederherzustellende Threema-ID, wenn th_safe_restore_enable true ist. Falls auch th_safe_password gesetzt ist, wird die ID ohne Zutun des Nutzers wiederhergestellt.
th_safe_password_pattern
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)
Renewable:Ja
User-editable:Nein
Standardwert:-
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.
th_safe_password_message
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)
Renewable:Ja
User-editable:Nein
Standardwert:-
Fehlermeldung, die angezeigt wird, wenn das vom Benutzer für Threema Safe gewählte Passwort nicht dem Muster th_safe_password_pattern entspricht.
th_hide_inactive_ids
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)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, werden inaktive IDs (d.h. solche, die während mehr als drei Monaten nicht in Gebrauch waren) und widerrufene IDs ausgeblendet.
th_disable_share_media
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. Aus technischen Gründen ist das Speichern und Teilen von Medien und Dateien mittels Desktop-App und Web-Client weiterhin möglich (es sei denn, th_disable_web ist true).
Type:bool
Min:-
Max:-
OS:Android (4.2k)
iOS (4.4k)
Renewable:Ja
User-editable:Nein
Standardwert:-
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. Aus technischen Gründen ist das Speichern und Teilen von Medien und Dateien mittels Desktop-App und Web-Client weiterhin möglich (es sei denn, th_disable_web ist true).

Chats und Anrufe

Wenn true, wird das automatische Speichern von Medien in der lokalen Galerie unterbunden.
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
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, wird unter Android das Erstellen von Screenshots sowie das Anzeigen von Vorschaubildern im App Switcher unterbunden.
th_disable_export
Wenn true, wird das Exportieren von Chats unterbunden.
Type:bool
Min:-
Max:-
OS:Alle
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, wird das Exportieren von Chats unterbunden.
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)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, wird die Nachrichten-Vorschau in Push-Benachrichtigungen deaktiviert.
th_disable_calls
Wenn true, werden jegliche Threema-Anrufe (Sprach-, Video- und Gruppenanrufe) deaktiviert; auch der Beitritt zu einem Gruppenanruf ist nicht möglich.
Type:bool
Min:-
Max:-
OS:Android (3.2k)
iOS (3.0k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, werden jegliche Threema-Anrufe (Sprach-, Video- und Gruppenanrufe) deaktiviert; auch der Beitritt zu einem Gruppenanruf ist nicht möglich.
th_disable_video_calls
Wenn true, wird die Videofunktion in Einzelanrufen, nicht aber in Gruppenanrufen deaktiviert. Soll die Videoübertragung bei Gruppenanrufen deaktiviert werden, müssen Gruppenanrufe ganz deaktiviert werden (th_disable_group_calls auf An und true setzen).
Type:bool
Min:-
Max:-
OS:Android (4.41k)
iOS (4.6.1k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, wird die Videofunktion in Einzelanrufen, nicht aber in Gruppenanrufen deaktiviert. Soll die Videoübertragung bei Gruppenanrufen deaktiviert werden, müssen Gruppenanrufe ganz deaktiviert werden (th_disable_group_calls auf An und true setzen).
th_disable_group_calls
Wenn true, werden Gruppenanrufe deaktiviert.
Type:bool
Min:-
Max:-
OS:Android (5.0k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, werden Gruppenanrufe deaktiviert.
th_disable_create_group
Wenn true, wird das Erstellen von Gruppen unterbunden.
Type:bool
Min:-
Max:-
OS:Android (3.3k)
iOS (3.0.4k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, wird das Erstellen von Gruppen unterbunden.
th_disable_web
Wenn true, sind die Desktop-App und der Web-Client («Threema Web») deaktiviert.
Type:bool
Min:-
Max:-
OS:Android (3.551k)
iOS (4.0.3k)
Renewable:Ja
User-editable:Nein
Standardwert:-
Wenn true, sind die Desktop-App und der Web-Client («Threema Web») deaktiviert.
th_web_hosts
Falls gesetzt, können sich die Desktop-App und der Web-Client 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)
Renewable:Ja
User-editable:Nein
Standardwert:-
Falls gesetzt, können sich die Desktop-App und der Web-Client 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

1 Renewable

Ja: Es kann bis zu 24 Stunden dauern, bis Änderungen an diesem Wert bei den Nutzern wirksam werden (Nutzer können durch Herunterziehen der Kontaktliste in der App manuell eine Synchronisation anstossen, um die neuesten Werte zu erhalten). Die Parameter th_safe_password, th_safe_server_url, th_safe_server_username und th_safe_server_password werden erst beim Neustart der App aktualisiert.

Nein: Dieser Wert wird einmalig beim Lizenzieren der App gesetzt. Bei Nutzern, welche den Einrichtungsprozess abgeschlossen haben, wird diese Einstellung nur aktualisiert, wenn die App neu installiert oder eine neue ID generiert wird.

2 User-editable

Ja: Diese Einstellung kann durch Nutzer in der App angepasst werden, es sei denn, th_readonly_profile ist true.

Nein: Diese Einstellung kann nicht durch Nutzer in der App angepasst werden, wenn sie via MDM festgelegt wurde.