Työpöytäsovelluksen asennus

Näin asennat Antimatterin työpöytäsovelluksen yrityksen tai koulun tietokoneille ja määrität sen palvelimet, käyttäjätunnuksen ja päivitystarkistukset keskitetysti Windowsissa, macOSissa ja Linuxissa.

Lataa sovellus

Työpöytäsovelluksen julkaisut löytyvät GitHubista osoitteesta github.com/AntimatterChat/desktop-app/releases. Kuten palvelin, myös sovellus on beetaversiona: julkaisun, jonka versiotunnuksessa on viivun jälkeinen liite, merkintä on Pre-release. Jokaisessa julkaisussa on SHA256SUMS-tiedosto, joka sisältää kaikkien tiedojen tarkistussummat. Tarkista lataus Linuxissa komennolla sha256sum --check --ignore-missing SHA256SUMS tai vertaa PowerShellin komennon Get-FileHash <file> -Algorithm SHA256 tulosta SHA256SUMS-tiedoston riviin.

• Windows (x64 ja arm64): .exe-asennusohjelma, .msi-paketti tai .zip-arkisto. Esimerkiksi antimatter-desktop-<version>-win-x64.exe ja antimatter-desktop-<version>-win-x64.msi.
• macOS: .dmg-levykuva tai .zip, Apple-silikonille (arm64), Intel-Macille (x64) tai molemmille (universal).
• Linux (x64 ja arm64): .deb- tai .rpm-paketti, AppImage, Flatpak-paketti tai .tar.gz-arkisto.

Mikä Windowsin asennusohjelma kannattaa käyttää

Sovellus tarkistaa GitHubista uusia versioita tunneittain ajon aikana ja näkee vain täydet julkaisut, ei esijulkaisuja. Jos se löytää uuden version, se ilmoittaa tästä käyttäjälle ja tarjoaa linkin ladata sen. MSI-tiedostolla asennettu kopio ei tarkista päivityksiä oletuksena, koska sen käyttäjät eivät yleensä voi asennella ohjelmistoja. Voit ottaa tarkistukset käyttöön EnableAutoUpdater-asetuksella: silloin tarjottava ladattava tiedosto on uusi .msi, joka vaatii ylläpitäjän oikeuksia.

Käytä MSI-tiedostoa hallittuun asennukseen SCCM:n (Configuration Manager), Intunen tai ryhmäasetusten ohjelmistoasennuksen kautta. MSI-tiedoston asennus poistaa .exe-kopion asennusta suorittavalta tililtä, jos sellainen on olemassa.

Hallittavat asetukset

Samat asetukset ovat olemassa kaikilla järjestelmillä. Windowsissa ne ovat rekisterin arvoja SOFTWARE\Policies\Antimatter-polun alla, joko HKEY_LOCAL_MACHINE (tietokoneelle) tai HKEY_CURRENT_USER (yksittäiselle käyttäjälle) -polussa. macOSissa ja Linuxissa ne ovat hallittujen asetusten tai asennustiedoston avaimia.

• Käyttäjätunnus täytetään vain palvelimilla, jotka on määritetty käytännön asetuksilla, eikä koskaan palvelimilla, jotka käyttäjä on lisännyt itse, eikä koskaan sen päälle, jonka joku on syöttänyt. Käyttäjät voivat silti muuttaa sitä. Prosenttimerkeissä olevat ympäristömuuttujat korvataan, joten yksi arvo sopii kaikille: %USERNAME% Windowsissa tai %USER% macOS:ssa ja Linuxissa antaa tilin nimen, ja %USERNAME%@example.com sähköpostiosoitteen, joka noudattaa tätä kaavaa. Jos muuttujaa ei ole määritetty, sovellus ei täytä mitään.
• Jos sammutat palvelimen hallinnan, aseta vähintään yksi palvelin DefaultServerList-asetukseen.
• Windowsissa tietokonekäytäntö (HKEY_LOCAL_MACHINE) voittaa käyttäjäkäytännön (HKEY_CURRENT_USER). Molempien palvelinlistat yhdistetään.
• Sovellus lukee asetukset käynnistyessään: muutoksen jälkeen käyttäjien on suljettava ja avattava se uudelleen.

Windows: hiljainen asennus MSI-pakettia käyttäen

MSI-paketti ottaa vastaan julkisia ominaisuuksia, jotka kirjoittavat asetukset tietokonekäytännöiksi hakemistoon HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Antimatter. Käytä niitä SCCM-sovelluksessa, Intune-sovelluksessa tai skriptissä. PowerShellissä:

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

• Ominaisuus, jota ei anneta, ei kirjoita mitään, joten se ei ylikirjoita ryhmäkäytännön asettamaa arvoa. AUTOUPDATE ja SERVERMANAGEMENT hyväksyvät vain arvot 0 tai 1. MSI-paketti asettaa yhden palvelimen: käytä ryhmäkäytäntöjä useampiin.
• DEFAULTUSERNAME on toimitettava asennusohjelmaan tekstinä %USERNAME%, jotta sovellus voi korvata sen jokaiselle käyttäjälle. Muuten asennusta suorittava kuori korvaa sen omalla tilinimellään. PowerShellissä käytä yksittäisiä lainausmerkkejä. .bat-tiedostossa kirjoita %%USERNAME%%. Testiasennuksen jälkeen tarkista rekisteristä, että DefaultUsername sisältää arvon %USERNAME%.
• Anna ominaisuudet uudelleen jokaisessa päivityksessä. Uuden MSI-paketin version asennus poistaa vanhan, sen kirjoittamien arvojen kanssa, ja kirjoittaa sitten uuden komentorivin arvot. SCCM ja Intune tallentavat sovelluksen komentorivin: toista sitä jokaiselle uudelle versiolle. Tai aseta käytännöt ryhmäkäytännön tai Intunen kautta, joita päivitykset eivät koske.
• MSI- ja ryhmäpoliikkatiedostot kirjoittavat samat rekisteriarvot. Käytä kunkin asetuksen osalta toista tai toista: MSI-paketin poistaminen poistaa sen kirjoittamat arvot, vaikka ryhmäpolitiikka olisi asettanut ne.
• MSI-paketti tallentaa myös asennuskansonsa polun HKEY_LOCAL_MACHINE\SOFTWARE\Antimatter\Desktop -rekisterin InstallDir-arvoon. Näin sovellus tietää, että se on asennettu MSI-paketilla.

Poistaminen: msiexec /x antimatter-desktop-<version>-win-x64.msi /qn. Intune-palvelussa tyyppi "Windows app (Win32)" käyttää samoja komentorivikomentoja. Tyyppiin "Line-of-business app" lisätään ominaisuudet komentorivin argumentteihin.

Windows: ryhmäpolitiikka ja Intune

Hallinnalliset mallit, antimatter.admx ja en-US\antimatter.adml, sijaitsevat asennetun sovelluksen gpo-kansassa (MSI-paketilla polku on C:\Program Files\Antimatter\gpo) sekä sovelluksen koodivaraston resources/windows/gpo-kansassa. Ne sisältävät nämä politikat kohdassa Administrative Templates › Antimatter:

Ryhmäpolitiikka verkkodomaanissa

1. Kopioi antimatter.admx keskitettyyn varastoon polkuun \\<domain>\SYSVOL\<domain>\Policies\PolicyDefinitions ja antimatter.adml sen en-US-kansaan.
2. Avaa Ryhmäpoliikan hallintakoneessa Computer Configuration (tai User Configuration) › Policies › Administrative Templates › Antimatter.
3. Muokkaa politiikkaa, valitse Käytössä ja täytä se. Servers-politiikan kohdalla napsauta Näytä ja lisää yksi rivi per palvelin: arvon nimi on välilehden nimi ja arvo on palvelimen osoite, esimerkiksi https://chat.example.com.

Kun Let people add and remove servers tai Notify about new versions -politiikka on käytössä, arvo on 1; poistettu käytöstä, arvo on 0.

Intune

Käytä Laitteet › Asetukset -osiossa toimintoa Tuota ADMX tuodaksesi tiedoston antimatter.admx yhdessä tiedoston en-US\antimatter.adml kanssa. Luo tämän jälkeen profiili kohdasta Mallit › Tuodut hallintamallit ja aseta Antimatterin käytännöt siinä.

Yksi tietokone tai skripti

Kopioi mallit hakemistoon C:\Windows\PolicyDefinitions, jotta voit käyttää niitä ohjelmassa gpedit.msc (Windows Pro ja Enterprise). Voit myös kirjoittaa rekisterin arvot suoraan, kun tuot .reg-tiedoston järjestelmänvalvojana (esim. reg import antimatter-policies.reg). Samassa kansiossa oleva example-policies.reg-tiedosto sisältää nämä arvot kommentteineen.

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: asetuksetprofiili

macOS:ssä sovellus lukee asetuksensa paketin tunnisteen chat.antimatter.desktop hallinnoituista preferensseistä, käyttäen asetustaulun avaimia. Levitä ne MDM-järjestelmälläsi (Jamf, Intune, Kandji, Mosyle jne.) asetuksetprofiilina.

• Sovelluksen varaston resources/mac/mdm-kansiossa on esimerkkiprofiili antimatter.mobileconfig. Muokkaa sen arvoja, anna sille omat PayloadIdentifier- ja PayloadUUID-arvot (uuidgen luo uusia UUID:itä) ja lataa se mukautettuna profiilina.
• Useimmat MDM-järjestelmät hyväksyvät myös pelkät avaimet "custom settings"- tai "preference domain"-kuormana sovellukselle chat.antimatter.desktop. Samassa kansiossa on ne tiedostossa example-managed-preferences.plist.

Profiilin kuorman sisällä olevat asetukset:

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

Poolsit voi myös antaa kokonaislukuna 0 tai 1.

Linux: käytäntötiedosto

Linuxissa sovellus lukee tiedoston /etc/antimatter-desktop/policies.json, joka on JSON-objekti, jossa on asetustaulun avaimet:

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

Levitä se asetushallinnantarkkaallesi (Ansible, Puppet, Salt jne.). Tiedoston omistajaksi tulee root, sen tulee olla luettavissa kaikille ja kirjoitettavissa vain root-käyttäjälle:

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

Virheellinen JSON-tiedosto ohitetaan, ja sovelluksen lokissa näkyy varoitus. Flatpak-versio ei näe isäntäjärjestelmän /etc-hakemistoa: anna sille lukuoikeus, jolloin se lukee tiedoston polusta /run/host/etc/antimatter-desktop/policies.json:

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

Mattermostin pöytäsovellukselle asetetut käytännöt

Windowsissa sovellus lukee myös Mattermost-työpöytäsovelluksen asetukset, jotka on määritetty SOFTWARE\Policies\Mattermost-politiikan alla, varalla. Se lukee ne sijainnin mukaan: arvot suoraan politiikan avainnimen alla, DefaultServerList-alikehys ja TrustedEmbeddedMediaOrigins-alikehys. Jokaisessa näistä kolmesta sijainnista se lukee Mattermostin avaimen vain, jos Antimatterin avaimessa ei ole arvoja kyseisessä sijainnissa kummassakaan hive:ssä. Kun yksi arvo on määritetty suoraan Antimatterin avaimen alla, esimerkiksi MSI:n AUTOUPDATE-ominaisuudella, Mattermostin avaimen suoraan alla olevia arvoja ei luetella. Siirrä kaikki politiikat Antimatterin avaimen kerralla.

macOS:lla Mattermost-työpöytäsovelluksen hallitut asetukset (com.mattermost.desktop) eivät luetella: määritä ne chat.antimatter.desktop -sovellukselle.

Allekirjoittamattomat julkaisut

Työpöytäsovelluksen julkaisuja ei ole vielä allekirjoitettu julkaisijan varmentimella.

• Windows. Kun käyttäjä avaa ladatun .exe- tai .msi-tiedoston, Microsoft Defender SmartScreen ilmoittaa, että Windows suojasi tietokoneen, ja mainitsee tuntemattoman julkaisijan. Käyttäjä valitsee Lisätietoja ja sen jälkeen Aja silti. SmartScreen tarkistaa tiedostot, joita käyttäjä avaa latauksen jälkeen, joten tämä varoitus ei näy, kun sovellus jaetaan SCCM:n, Intunen tai ryhmäpolitiikan kautta. Jos tietokoneet sallivat vain hyväksyttyjen julkaisijoiden ohjelmiston (AppLocker- tai App Control for Business -säännöt), salli sovellus asennuspolun tai tiedoston hashin perusteella.
• macOS. Sovellus on allekirjoitettu ad hoc -menetelmällä, mutta Apple ei ole notarisoitu. Ensimmäistä kertaa, kun käyttäjä avaa ladatun kopion, macOS ilmoittaa, ettei se voi varmentaa, että sovellus on haittaohjelmavapaa, eikä avaa sitä. macOS 15:ssä ja myöhemmissä versioissa käyttäjä avaa Järjestelmäasetukset › Tietoturva ja yksityisyys ja valitsee Aja silti. Aiemmissa versioissa käyttäjä napsauttaa sovellusta ohjausnäppäimen kanssa ja valitsee Ava. Gatekeeper tarkistaa vain ladattuina merkityt tiedostot (quarantine-attribuutin kanssa): kun asennat sovelluksen omilla työkaluillasi, poista merkki asennusskriptissä komennolla xattr -dr com.apple.quarantine /Applications/Antimatter.app.