Nasazení desktopové aplikace

Jak nainstalovat desktopovou aplikaci Antimatter na počítače firmy nebo školy a centrálně nastavit její servery, uživatelské jméno a kontroly aktualizací v systémech Windows, macOS a Linux.

Stažení aplikace

Vydání desktopové aplikace jsou na GitHubu na adrese github.com/AntimatterChat/desktop-app/releases. Aplikace je, stejně jako server, v beta verzi: vydání, jehož verze má za pomlčkou příponu, je označeno jako Pre-release. Každé vydání obsahuje soubor SHA256SUMS s kontrolním součtem každého souboru. Stažený soubor zkontrolujte příkazem sha256sum --check --ignore-missing SHA256SUMS v Linuxu nebo porovnejte výstup příkazu Get-FileHash <file> -Algorithm SHA256 v PowerShellu s odpovídajícím řádkem v souboru SHA256SUMS.

• Windows (x64 a arm64): instalační program .exe, balíček .msi nebo archiv .zip. Například antimatter-desktop-<version>-win-x64.exe a antimatter-desktop-<version>-win-x64.msi.
• macOS: diskový obraz .dmg nebo archiv .zip pro Apple silicon (arm64), Macs s procesorem Intel (x64) nebo pro obě (universal).
• Linux (x64 a arm64): balíček .deb nebo .rpm, AppImage, svazek Flatpak nebo archiv .tar.gz.

Který instalační program pro Windows použít

Aplikace každou hodinu kontroluje na GitHubu nové verze a bere v úvahu pouze plnohodnotné verze, nikoli předběžné vydání. Když novou verzi najde, uživatele o ní informuje a nabídne odkaz ke stažení. Kopie nainstalovaná pomocí MSI tuto kontrolu ve výchozím nastavení neprovádí, protože uživatelé této instalace obvykle nemohou instalovat software. Kontrolu můžete pro tuto instalaci zapnout pomocí nastavení EnableAutoUpdater: nabídnutá stažení pak bude nový soubor .msi, který vyžaduje práva správce.

Použijte MSI pro správu nasazení pomocí SCCM (Configuration Manager), Intune nebo instalace softwaru přes Skupinové zásady. Instalace MSI odstraní kopii .exe účtu, který instalaci spouští, pokud taková existuje.

Nastavení, která můžete spravovat

Stejná nastavení existují na všech systémech. Ve Windows se jedná o hodnoty registru pod SOFTWARE\Policies\Antimatter, v HKEY_LOCAL_MACHINE (pro počítač) nebo HKEY_CURRENT_USER (pro jednoho uživatele). Na macOS a Linuxu se jedná o klíče spravovaných předvoleb nebo souboru zásad.

• Uživatelské jméno se předvyplňuje pouze na přihlašovací stránce serverů nastavených zásadou, nikdy ne na serveru, který osoba přidala sama, a nikdy nepřepíše to, co uživatel napsal. Uživatelé ho mohou stále změnit. Proměnné prostředí mezi procenty jsou nahrazeny, takže jedna hodnota vyhovuje všem: %USERNAME% ve Windows nebo %USER% na macOS a Linuxu zadá název účtu a %USERNAME%@example.com zadá e-mailovou adresu podle tohoto vzoru. Pokud proměnná není nastavena, aplikace nevyplní nic.
• Pokud vypnete správu serverů, nastavte alespoň jeden server v DefaultServerList.
• Ve Windows má zásada počítače (HKEY_LOCAL_MACHINE) přednost před zásadou uživatele (HKEY_CURRENT_USER). Seznamy serverů z obou úložišť jsou sloučeny.
• Aplikace načte nastavení při spuštění: po změně musí uživatelé aplikaci ukončit a znovu spustit.

Windows: tichá instalace pomocí MSI

MSI přijímá veřejné vlastnosti, které zapíšou nastavení jako zásady počítače do HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Antimatter. Použijte je v aplikaci SCCM, aplikaci Intune nebo ve skriptu. V PowerShellu:

msiexec /i antimatter-desktop-<version>-win-x64.msi /qn SERVERURL=https://chat.example.com SERVERNAME=Chat DEFAULTUSERNAME='%USERNAME%' AUTOUPDATE=0 SERVERMANAGEMENT=0

• Vlastnost, která není zadána, nezapíše nic, takže nepřepíše hodnotu nastavenou pomocí Zásad skupiny. AUTOUPDATE a SERVERMANAGEMENT přijímají pouze 0 nebo 1. MSI nastaví jeden server: pro více serverů použijte Zásady skupiny.
• DEFAULTUSERNAME musí být předán instalátoru jako text %USERNAME%, aby ho aplikace nahradila pro každého uživatele. Jinak ho shell spouštějící instalaci nahradí svým vlastním názvem účtu. V PowerShellu zachovejte jednoduché uvozovky. V souboru .bat napište %%USERNAME%%. Po testovací instalaci zkontrolujte v registru, zda DefaultUsername obsahuje %USERNAME%.
• Při každé aktualizaci zadejte vlastnosti znovu. Instalace nové verze MSI odstraní starou verzi včetně hodnot, které zapsala, a poté zapíše hodnoty z nového příkazového řádku. SCCM a Intune uchovávají příkazový řádek aplikace: znovu ho použijte pro každou novou verzi. Nebo nastavte zásady pomocí Zásad skupiny nebo Intune, které aktualizace neovlivní.
• Instalátor MSI a Zásadové skupiny zapisují stejné hodnoty registru. Pro každé nastavení použijte buď jedno, nebo druhé: odinstalací instalátoru MSI se odstraní hodnoty, které zapsal, i když je nastavila Zásadová skupina.
• Instalátor MSI také zaznamená instalační složku do HKEY_LOCAL_MACHINE\SOFTWARE\Antimatter\Desktop (InstallDir). Tak aplikace zjistí, že byla nainstalována pomocí instalátoru MSI.

Odinstalace: msiexec /x antimatter-desktop-<version>-win-x64.msi /qn. V Intune používá typ „Windows app (Win32)“ stejné příkazové řádky. Pro typ „Line-of-business app“ přidejte vlastnosti do argumentů příkazového řádku.

Windows: Zásadové skupiny a Intune

Spravované šablony, antimatter.admx a en-US\antimatter.adml, se nacházejí ve složce gpo nainstalované aplikace (C:\Program Files\Antimatter\gpo pro instalátor MSI) a ve složce resources/windows/gpo v repozitáři aplikace. Zobrazují tyto zásady v části Spravované šablony › Antimatter:

Zásadové skupiny v doméně

1. Zkopírujte antimatter.admx do centrálního úložiště, \\<domain>\SYSVOL\<domain>\Policies\PolicyDefinitions, a antimatter.adml do jeho složky en-US.
2. V Editoru správy zásadových skupin otevřete Konfigurace počítače (nebo Konfigurace uživatele) › Zásady › Spravované šablony › Antimatter.
3. Upravte zásadu, zvolte Zapnuto a vyplňte ji. Pro Servery klikněte na Zobrazit a přidejte jeden řádek pro každý server: název hodnoty je název karty, hodnota je URL serveru, například https://chat.example.com.

Zapnutí možnosti Povolit uživatelům přidávat a odebírat servery nebo Oznámit nové verze zapíše hodnotu 1; vypnutí zapíše hodnotu 0.

Intune

V Konfigurace › Konfigurace použijte Import ADMX k importu antimatter.admx spolu s en-US\antimatter.adml. Poté vytvořte profil z Šablony › Importované administrativní šablony a nastavte v něm zásady Antimatter.

Jeden počítač nebo skript

Zkopírujte šablony do C:\Windows\PolicyDefinitions, abyste je mohli použít v gpedit.msc (Windows Pro a Enterprise). Nebo napište hodnoty registru přímo do souboru .reg a importujte jej jako správce (reg import antimatter-policies.reg), například takto. Soubor example-policies.reg ve stejné složce obsahuje tyto hodnoty včetně komentářů.

REGEDIT4

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Antimatter]
"EnableServerManagement"=dword:00000000
"EnableAutoUpdater"=dword:00000000
"DefaultUsername"="%USERNAME%"

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Antimatter\DefaultServerList]
"Chat"="https://chat.example.com"

macOS: konfigurační profil

V systému macOS aplikace čte svá nastavení ze spravovaných předvoleb podle identifikátoru balíčku chat.antimatter.desktop s klíči tabulky nastavení. Nasadíte je pomocí nástroje MDM (Jamf, Intune, Kandji, Mosyle a dalších) jako konfigurační profil.

• Složka resources/mac/mdm v repozitáři aplikace obsahuje příklad profilu, antimatter.mobileconfig. Upravte jeho hodnoty, zadejte vlastní hodnoty PayloadIdentifier a PayloadUUID (nové UUID vygenerujete příkazem uuidgen) a nahrajte jej jako vlastní profil.
• Většina nástrojů MDM přijímá také samotné klíče jako payload „vlastní nastavení“ nebo „doména předvoleb“ pro chat.antimatter.desktop. Ve stejné složce je najdete v souboru example-managed-preferences.plist.

Nastavení uvnitř payloadu profilu:

<key>PayloadType</key>
<string>chat.antimatter.desktop</string>
<key>DefaultServerList</key>
<array>
    <dict>
        <key>name</key>
        <string>Chat</string>
        <key>url</key>
        <string>https://chat.example.com</string>
    </dict>
</array>
<key>DefaultUsername</key>
<string>%USER%</string>
<key>EnableServerManagement</key>
<false/>
<key>EnableAutoUpdater</key>
<false/>

Logické hodnoty lze zadat také jako celá čísla 0 a 1.

Linux: soubor se zásadami

V systému Linux aplikace čte soubor /etc/antimatter-desktop/policies.json, což je objekt JSON s klíči tabulky nastavení:

{
    "DefaultServerList": [
        {"name": "Chat", "url": "https://chat.example.com"}
    ],
    "DefaultUsername": "%USER%",
    "EnableServerManagement": false,
    "EnableAutoUpdater": false,
    "TrustedEmbeddedMediaOrigins": []
}

Nasaďte jej pomocí nástroje pro správu konfigurace (Ansible, Puppet, Salt a dalších). Vlastníkem souboru musí být uživatel root, soubor musí být čitelný pro všechny a zapisovatelný pouze uživatelem root:

sudo install -d /etc/antimatter-desktop
sudo install -m 644 policies.json /etc/antimatter-desktop/policies.json

Soubor, který není platným JSON, je ignorován a v protokolu aplikace se zobrazí upozornění. Verze Flatpak nevidí složku /etc hostitelského systému: povolte jí přístup pro čtení a aplikace bude číst soubor z /run/host/etc/antimatter-desktop/policies.json:

sudo flatpak override --system --filesystem=host-etc:ro chat.antimatter.desktop

Zásady nastavené pro desktopovou aplikaci Mattermost

Na Windows aplikace jako zálohu načítá také zásady nastavené pro desktopovou aplikaci Mattermost v SOFTWARE\Policies\Mattermost. Čte je podle umístění: hodnoty přímo pod klíčem zásad, podklíč DefaultServerList a podklíč TrustedEmbeddedMediaOrigins. Pro každé z těchto tří umístění čte klíč Mattermost pouze tehdy, pokud klíč Antimatter nemá v žádném registru žádné hodnoty. Jakmile je tedy přímo pod klíčem Antimatter nastavena jakákoli hodnota (například vlastností AUTOUPDATE v MSI), žádné hodnoty přímo pod klíčem Mattermost se nečtou. Převeďte všechny své zásady na klíč Antimatter najednou.

Na macOS se nenačítají spravované předvolby desktopové aplikace Mattermost (com.mattermost.desktop): nastavte je pro chat.antimatter.desktop.

Nepodpsané sestavení

Sestavení desktopové aplikace zatím nejsou podepsána certifikátem vydavatele.

• Windows. Když uživatel otevře stažený soubor .exe nebo .msi, Microsoft Defender SmartScreen oznámí, že Windows chránil počítač, a uvede neznámého vydavatele. Uživatel zvolí Více informací a poté Spustit přesto. SmartScreen kontroluje soubory, které uživatelé otevírají po stažení, takže toto upozornění se nezobrazí, pokud aplikaci nasadíte pomocí SCCM, Intune nebo Skupinových zásad. Pokud vaše počítače spouštějí pouze software od schválených vydavatelů (pravidla AppLocker nebo App Control for Business), povolte aplikaci podle instalační cesty nebo hash souboru.
• macOS. Aplikace je podepsána ad hoc, ale není ověřena (notarizována) společností Apple. Při prvním otevření stažené kopie macOS oznámí, že nemůže ověřit, zda je aplikace prostá malwaru, a neotevře ji. V systému macOS 15 a novější uživatelé otevřou Nastavení systému › Soukromí a zabezpečení a zvolí Otevřít přesto. Ve starších verzích kliknou na aplikaci pravým tlačítkem myši (nebo drží klávesu Control a kliknou) a zvolí Otevřít. Gatekeeper kontroluje pouze soubory označené jako stažené (s atributem karantény): pokud aplikaci instalujete vlastními nástroji, odeberte toto označení v instalačním skriptu příkazem xattr -dr com.apple.quarantine /Applications/Antimatter.app.