Asztali alkalmazás telepítése

Hogyan telepítse az Antimatter asztali alkalmazását egy vállalat vagy iskola számítógépeire, és állítsa be központilag a szervereket, a felhasználónevet és a frissítésvizsgálatokat Windows, macOS és Linux rendszereken.

Az alkalmazás letöltése

Az asztali alkalmazás kiadásai a GitHub-on érhetők el a github.com/AntimatterChat/desktop-app/releases címen. A szerverhez hasonlóan az alkalmazás is béta verzióban van: a kötőjel utáni utótaggal ellátott verziószámú kiadások Pre-release jelölést kapnak. Minden kiadáshoz tartozik egy SHA256SUMS fájl, amely minden fájl ellenőrző összegét tartalmazza. A letöltés ellenőrzéséhez Linuxon használja a sha256sum --check --ignore-missing SHA256SUMS parancsot, vagy hasonlítsa össze a PowerShell-ben a Get-FileHash <file> -Algorithm SHA256 parancs kimenetét a SHA256SUMS fájl megfelelő sorával.

• Windows (x64 és arm64): .exe telepítő, .msi csomag vagy .zip archívum. Például antimatter-desktop-<version>-win-x64.exe és antimatter-desktop-<version>-win-x64.msi.
• macOS: .dmg lemezimage vagy .zip, Apple-siliconhoz (arm64), Intel Mac-ekhez (x64) vagy mindkettőhöz (universal).
• Linux (x64 és arm64): .deb vagy .rpm csomag, AppImage, Flatpak-csomag vagy .tar.gz archívum.

Melyik Windows telepítőt használja

Az alkalmazás óránként, futása alatt ellenőrzi a GitHubon a új verziókat, és csak a teljes kiadásokat, nem pedig az előzetes verziókat veszi figyelembe. Ha talál egyet, értesíti a felhasználót, és letöltési linket kínál. Az MSI-vel telepített példány alapértelmezetten nem hajt végre ellenőrzést, mivel a felhasználói általában nem telepíthetnek szoftvert. Ezt a beállítással kapcsolhatod be: EnableAutoUpdater. Ekkor a letöltési link a új .msi fájlt kínálja, amelyhez rendszergazdai jogosultságok szükségesek.

Az MSI-t használj a SCCM (Configuration Manager), Intune vagy a csoportos házirend (Group Policy) szoftvertelepítésével történő központi telepítéshez. Az MSI telepítése eltávolítja a telepítést futtató fiók .exe példányát, ha ilyen létezik.

Kezelhető beállítások

Ezek a beállítások minden rendszeren léteznek. Windows alatt a SOFTWARE\Policies\Antimatter alatt található regiszterértékek, a HKEY_LOCAL_MACHINE (a számítógép számára) vagy a HKEY_CURRENT_USER (egy felhasználó számára) kulcs alatt. macOS és Linux alatt a kezelt preferenciák vagy a házirend-fájl kulcsai.

• A felhasználónév csak az általános beállítások által meghatározott szerverek bejelentkezési oldalán töltődik be, soha nem egy olyan szerveren, amelyet a felhasználó manuálisan adott hozzá, és soha nem írja felül azt, amit valaki beírt. A felhasználók továbbra is módosíthatják. A százalékjelek közötti környezeti változók helyettesítve vannak, így egyetlen érték mindenki számára működik: a Windows-on %USERNAME%, a macOS-en és a Linuxon %USER% adja meg a fiók nevét, a %USERNAME%@example.com pedig egy e-mail-címet, amely ezt a mintát követi. Ha egy változó nincs beállítva, az alkalmazás nem ír be semmit.
• Ha a szerverkezelést kikapcsolja, állítson be legalább egy szervert a DefaultServerList-ben.
• A Windowson a számítógépes házirend (HKEY_LOCAL_MACHINE) elsőbbséget élvez a felhasználói házirenddel (HKEY_CURRENT_USER) szemben. A két szerverlista összevonásra kerül.
• Az alkalmazás induláskor olvassa be a beállításokat: egy módosítás után a felhasználóknak le kell zárniuk, majd újra nyitniuk kell.

Windows: csendes telepítés MSI-vel

Az MSI nyilvános tulajdonságokat fogad el, amelyek a beállításokat számítógépes házirendként írják a HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Antimatter alá. Használja ezeket SCCM-alkalmazásban, Intune-alkalmazásban vagy szkriptben. PowerShell-ben:

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

• Ha egy tulajdonság nincs megadva, nem ír be semmit, így nem írja felül a Csoportos házirend által beállított értéket. Az AUTOUPDATE és a SERVERMANAGEMENT csak 0-t vagy 1-et fogad el. Az MSI egyetlen szervert állít be: többhöz használja a Csoportos házirendet.
• A DEFAULTUSERNAME-nak a telepítőig a %USERNAME% szövegként kell eljutnia, hogy az alkalmazás minden felhasználó számára külön helyettesítse. Egyébként a telepítést futtató parancssor helyettesíti a saját fióknevével. PowerShell-ben tartsa meg az egy idézőjeleket. Egy .bat fájlban írja be %%USERNAME%%. Egy teszttelepítés után ellenőrizze a rendszerkönyvtárban, hogy a DefaultUsername tartalmazza-e a %USERNAME% szöveget.
• Adja át a tulajdonságokat minden frissítéskor újra. Az MSI új verziójának telepítése eltávolítja a régit, az általános beírta értékekkel együtt, majd beírja az új parancssor értékeit. Az SCCM és az Intune megtartja az alkalmazás parancssorát: használja újra minden új verzióhoz. Vagy állítsa be a házirendeket Csoportos házirenddel vagy Intune-nal, amelyeket a frissítések nem érintenek.
• Az MSI és a csoportos házirend ugyanazokat a regiszterértékeket írja. Minden beállításnál használja az egyiket vagy a másikat: az MSI eltávolítása törli az általánosított értékeket, még akkor is, ha a csoportos házirend is beállította őket.
• Az MSI rögzíti a telepítőkönyvtárat is a HKEY_LOCAL_MACHINE\SOFTWARE\Antimatter\Desktop (InstallDir) alatt. Így ismeri fel az alkalmazás, hogy MSI-vel telepítették.

Eltávolítás: msiexec /x antimatter-desktop-<version>-win-x64.msi /qn. Az Intune-ban a „Windows app (Win32)” típus ugyanazokat a parancssori utasításokat használja. A „Line-of-business app” típusnál adja hozzá a tulajdonságokat a parancssori argumentumokhoz.

Windows: csoportos házirend és Intune

Az adminisztratív sablonok, antimatter.admx és en-US\antimatter.adml, a telepített alkalmazás gpo mappájában találhatók (MSI esetén: C:\Program Files\Antimatter\gpo), valamint az alkalmazás tárhelyének resources/windows/gpo mappájában. Ezek a házirendek a Administrative Templates › Antimatter alatt jelennek meg:

Csoportos házirend domainben

1. Másolja az antimatter.admx fájlt a központi tárhelyre, \\<domain>\SYSVOL\<domain>\Policies\PolicyDefinitions, és az antimatter.adml fájlt az en-US almappájába.
2. A Csoportos Házirend Kezelő szerkesztőben nyissa meg a Computer Configuration (vagy User Configuration) › Policies › Administrative Templates › Antimatter elemet.
3. Szerkessze meg a házirendet, válassza a Bekapcsolva lehetőséget, és tölje ki. A Szerverek esetén kattintson a Megjelenítés gombra, és adjon hozzá egy sort minden szerverhez: az érték neve a fül neve, az érték pedig a szerver URL-je, például https://chat.example.com.

A Szerverek hozzáadása és eltávolítása vagy az Értesítés új verziókról bekapcsolása 1-et ír, a kikapcsolása pedig 0-t.

Intune

A(z) Eszközök › Konfiguráció menüben használja az ADMX importálása funkciót az antimatter.admx és az en-US\antimatter.adml fájlok importálásához. Ezután hozzon létre egy profilt a(z) Sablonok › Importált adminisztratív sablonok menüpontból, és állítsa be benne az Antimatter-szabályokat.

Egyetlen számítógép, vagy egy szkript

Másolja a sablonokat a(z) C:\Windows\PolicyDefinitions mappába, hogy használhassa őket a(z) gpedit.msc (Windows Pro és Enterprise) felületen. Vagy írja be közvetlenül a registry-értékeket, egy .reg fájl rendszergazdaként történő importálásával (pl. reg import antimatter-policies.reg), például így. A(z) example-policies.reg fájl a ugyanazon mappában található, és kommentekkel ellátottan tartalmazza ezeket az értékeket.

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: konfigurációs profil

A macOS-en az alkalmazás a bundle azonosítójának, a(z) chat.antimatter.desktop kezelt preferenciáiból olvassa be a beállításait, a(z) beállítások táblázat kulcsaival. Telepítse ezeket MDM rendszere (Jamf, Intune, Kandji, Mosyle stb.) segítségével konfigurációs profilként.

• Az alkalmazás repozitóriumának resources/mac/mdm mappájában található egy minta profil, az antimatter.mobileconfig. Szerkessze meg az értékeit, adja meg saját PayloadIdentifier és PayloadUUID értékeit (új UUID-eket a uuidgen generál), és töltsse fel egyedi profilként.
• A legtöbb MDM rendszert elfogadja a kulcsokat is, mint „egyedi beállítások” vagy „preferencia-domen” terhelést a(z) chat.antimatter.desktop számára. Ugyanez a mappa tartalmazza ezeket az example-managed-preferences.plist fájlban.

A profil terhelésében lévő beállítások:

<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/>

A booleán értékeket 0 és 1 egész számokként is meg lehet adni.

Linux: szabályfájl

A Linuxon az alkalmazás a(z) /etc/antimatter-desktop/policies.json fájlból olvassa be a beállításait, amely egy JSON objektum a(z) beállítások táblázat kulcsaival:

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

Telepítse konfigurációs kezelőeszközével (Ansible, Puppet, Salt stb.), root tulajdonosként, mindenki számára olvashatóan, de csak root írhatóan:

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

A nem érvényes JSON fájlok figyelmen kívül hagyásra kerülnek, az alkalmazás naplófájljában pedig figyelmeztetés jelenik meg. A Flatpak verzió nem látja a gazdagép /etc könyvtárát: adjon neki olvasási hozzáférést, és a fájlt a(z) /run/host/etc/antimatter-desktop/policies.json útvonalról olvassa be:

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

A Mattermost asztali alkalmazásnak beállított szabályok

A Windows alatt az alkalmazás a Mattermost asztali alkalmazás beállított házirendjeit is beolvassa a SOFTWARE\Policies\Mattermost alatt, mint tartalékot. Hely szerint olvassa be őket: a házirendkulcs közvetlen értékei, a DefaultServerList alkulcs és a TrustedEmbeddedMediaOrigins alkulcs. Mindegyik e három helyen a Mattermost kulcsot csak akkor olvassa be, ha az Antimatter kulcsnak nincs értéke ott, egyik méhben sem. Így, ha egyetlen értéket is beállítanak közvetlenül az Antimatter kulcs alatt, például az MSI AUTOUPDATE tulajdonságával, a Mattermost kulcs közvetlen értékei közül egyet sem olvas be. Egyszerre, egyben vigyék át a házirendjeiket az Antimatter kulcs alá.

A macOS alatt a Mattermost asztali alkalmazás kezelt beállításait (com.mattermost.desktop) nem olvassa be: állítsák be a chat.antimatter.desktop számára.

Aláíratlan buildek

Az asztali alkalmazás buildjeit még nem aláírják kiadói tanúsítvánnyal.

• Windows. Amikor valaki megnyit egy letöltött .exe vagy .msi fájlt, a Microsoft Defender SmartScreen azt jelenti, hogy a Windows megvédte a számítógépet, és egy ismeretlen kiadót nevez meg. Ők a További információ gombot, majd a Ugye is futtatás lehetőséget választják. A SmartScreen azokat a fájlokat ellenőrzi, amelyeket a letöltés után nyitnak meg, ezért nem látják ezt a figyelmeztetést, ha az alkalmazást SCCM, Intune vagy csoportos házirend révén telepítik. Ha a számítógépek csak jóváhagyott kiadók szoftverét futtathatják (AppLocker vagy App Control for Business szabályok), akkor az alkalmazást telepítési útvonala vagy fájl-környezetkódja alapján engedélyezzék.
• macOS. Az alkalmazás ad hoc aláírással rendelkezik, de Apple nem hitelesítette. Amikor valaki először megnyit egy letöltött példányt, a macOS azt jelenti, hogy nem tudja ellenőrizni, hogy az alkalmazás mentes-e kártevőktől, és nem nyitja meg. A macOS 15 és újabb verziókon a Rendszerbeállítások › Adatvédelem és biztonság menüben a Ugye is megnyitás lehetőséget kell választani. Korábbi verziókon az alkalmazást kell Control-kattintással megnyitni, és a Megnyitás lehetőséget választani. A Gatekeeper csak azokat a fájlokat ellenőrzi, amelyeken a letöltés jelzője (a quarantine-attribútum) van: ha saját eszközeikkel telepítik az alkalmazást, a telepítési szkriptjükben távolítsák el a jelzőt a xattr -dr com.apple.quarantine /Applications/Antimatter.app paranccsal.