De desktopapp installeren

Hoe u de Antimatter-desktopapp installeert op de computers van een bedrijf of school en de servers, de gebruikersnaam en de controle op updates centraal instelt op Windows, macOS en Linux.

De app downloaden

De releases van de desktopapp staan op GitHub, op github.com/AntimatterChat/desktop-app/releases. Net als de server is de app in bèta: een release met een toenaanslag na een koppelteken in de versienummer wordt gemarkeerd als Pre-release. Elke release bevat een SHA256SUMS-bestand met de checksum van elk bestand. Controleer een download met sha256sum --check --ignore-missing SHA256SUMS op Linux, of vergelijk de uitvoer van Get-FileHash <file> -Algorithm SHA256 in PowerShell met de bijbehorende regel in SHA256SUMS.

• Windows (x64 en arm64): de .exe-installatieprogramma, het .msi-pakket of een .zip-archief. Bijvoorbeeld antimatter-desktop-<version>-win-x64.exe en antimatter-desktop-<version>-win-x64.msi.
• macOS: een .dmg-schijfbeeld of een .zip, voor Apple silicon (arm64), Intel Macs (x64) of beide (universal).
• Linux (x64 en arm64): een .deb- of .rpm-pakket, een AppImage, een Flatpak-bundle of een .tar.gz-archief.

Welk Windows-installatieprogramma u moet gebruiken

De app controleert op GitHub of er nieuwe versies beschikbaar zijn, elk uur terwijl deze actief is, en ziet alleen volledige releases, geen pre-releases. Als er een nieuwe versie wordt gevonden, wordt de gebruiker hierover geïnformeerd en wordt een link aangeboden om deze te downloaden. Een installatie via MSI controleert standaard niet op updates, omdat de gebruikers doorgaans geen software kunnen installeren. U kunt de controle voor deze installatie inschakelen met de instelling EnableAutoUpdater: de aangeboden download is dan de nieuwe .msi, wat beheerdersrechten vereist.

Gebruik de MSI voor een beheerde implementatie met SCCM (Configuration Manager), Intune of software-installatie via Group Policy. Bij het installeren van de MSI wordt het .exe-kopie van het account dat de installatie uitvoert, verwijderd, indien aanwezig.

De instellingen die u kunt beheren

Deze instellingen bestaan op elk systeem. Op Windows zijn dit registerwaarden onder SOFTWARE\Policies\Antimatter, in HKEY_LOCAL_MACHINE (voor de computer) of HKEY_CURRENT_USER (voor één gebruiker). Op macOS en Linux zijn dit sleutels van de beheerde voorkeuren of van het beleidsbestand.

• De gebruikersnaam wordt alleen ingevuld op de inlogpagina van de servers die via beleid zijn ingesteld, nooit op een server die een persoon heeft toegevoegd en nooit bovenop wat iemand heeft getypt. Mensen kunnen het nog steeds wijzigen. Omgevingsvariabelen tussen percenttekens worden vervangen, zodat één waarde voor iedereen werkt: %USERNAME% op Windows of %USER% op macOS en Linux geeft de accountnaam, en %USERNAME%@example.com een e-mailadres dat aan dit patroon voldoet. Als een variabele niet is ingesteld, vult de app niets in.
• Als u het beheren van servers uitschakelt, stelt u dan minstens één server in in DefaultServerList.
• Op Windows heeft een computerbeleid (HKEY_LOCAL_MACHINE) voorrang op een gebruikersbeleid (HKEY_CURRENT_USER). De serverlijsten van beide worden gecombineerd.
• De app leest de instellingen bij het starten: na een wijziging moeten gebruikers de app afsluiten en opnieuw openen.

Windows: stille installatie met de MSI

De MSI accepteert openbare eigenschappen die de instellingen schrijven als computerbeleid, in HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Antimatter. Gebruik ze in een SCCM-toepassing, een Intune-app of een script. In PowerShell:

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

• Een eigenschap die niet is opgegeven, schrijft niets en overschrijft dus geen waarde die is ingesteld via Group Policy. AUTOUPDATE en SERVERMANAGEMENT accepteren alleen 0 of 1. De MSI stelt één server in: gebruik Group Policy voor meer.
• DEFAULTUSERNAME moet de installateur bereiken als de tekst %USERNAME%, zodat de app het voor elke persoon vervangt. Anders vervangt de shell die de installatie uitvoert het door de eigen accountnaam. In PowerShell behoudt u de enkele aanhalingstekens. In een .bat-bestand schrijft u %%USERNAME%%. Controleer na een testinstallatie in het register of DefaultUsername %USERNAME% bevat.
• Geef de eigenschappen bij elke upgrade opnieuw door. Bij het installeren van een nieuwe versie van de MSI wordt de oude versie verwijderd, inclusief de waarden die deze schreef, en worden de waarden van de nieuwe opdrachtregel geschreven. SCCM en Intune bewaren de opdrachtregel van een toepassing: hergebruik deze voor elke nieuwe versie. Of stel de beleidsregels in via Group Policy of Intune, die upgrades niet raken.
• De MSI en Group Policy schrijven dezelfde registerwaarden. Gebruik voor elke instelling de ene of de andere: als u de MSI deinstalleert, worden de waarden die deze heeft geschreven verwijderd, ook als Group Policy ze heeft ingesteld.
• De MSI registreert ook de installatiemap in HKEY_LOCAL_MACHINE\SOFTWARE\Antimatter\Desktop (InstallDir). Zo weet de app dat deze met de MSI is geïnstalleerd.

Om te deïnstalleren: msiexec /x antimatter-desktop-<version>-win-x64.msi /qn. In Intune accepteert het type "Windows app (Win32)" dezelfde opdrachtregels. Voor het type "Line-of-business app" voegt u de eigenschappen toe aan de opdrachtregelargumenten.

Windows: Group Policy en Intune

De administratieve sjablonen, antimatter.admx en en-US\antimatter.adml, bevinden zich in de gpo-map van de geïnstalleerde app (C:\Program Files\Antimatter\gpo voor de MSI) en in de resources/windows/gpo-map van de repository van de app. Ze tonen deze beleidsregels, onder Administrative Templates › Antimatter:

Group Policy in een domein

1. Kopieer antimatter.admx naar de centrale opslag, \\<domain>\SYSVOL\<domain>\Policies\PolicyDefinitions, en antimatter.adml naar de en-US-map.
2. Open in de Group Policy Management Editor Computer Configuration (of User Configuration) › Policies › Administrative Templates › Antimatter.
3. Bewerk een beleidsregel, kies Ingeschakeld en vul de gegevens in. Voor Servers klikt u op Toon en voegt u per server één regel toe: de naam van de waarde is de tabnaam, de waarde is de server-URL, zoals https://chat.example.com.

Als u Serveren toevoegen en verwijderen toestaan of Melden bij nieuwe versies inschakelt, wordt 1 geschreven; bij uitschakeling wordt 0 geschreven.

Intune

Gebruik in Apparaten › Configuratie de optie ADMX importeren om antimatter.admx te importeren met en-US\antimatter.adml. Maak daarna een profiel aan vanuit Sjablonen › Geïmporteerde administratieve sjablonen en stel de Antimatter-beleidsregels daarin in.

Een enkel computer, of een script

Kopieer de sjablonen naar C:\Windows\PolicyDefinitions om ze te gebruiken in gpedit.msc (Windows Pro en Enterprise). Of schrijf de registerwaarden rechtstreeks in, met een .reg-bestand dat als beheerder wordt geïmporteerd (reg import antimatter-policies.reg), zoals dit. Het bestand example-policies.reg in dezelfde map bevat deze waarden, met commentaar.

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: een configuratieprofiel

Op macOS leest de app zijn instellingen uit de beheerde voorkeuren van de bundle-identificatiecode chat.antimatter.desktop, met de sleutels van de instellingentabel. Verspreid ze met uw MDM (Jamf, Intune, Kandji, Mosyle en anderen) als een configuratieprofiel.

• De map resources/mac/mdm in de repository van de app bevat een voorbeeldprofiel, antimatter.mobileconfig. Pas de waarden aan, geef het uw eigen PayloadIdentifier- en PayloadUUID-waarden (uuidgen maakt nieuwe UUID's) en upload het als een aangepast profiel.
• De meeste MDM's accepteren ook alleen de sleutels, als een "aangepaste instellingen"- of "voorkeusdomein"-payload voor chat.antimatter.desktop. Dezelfde map bevat ze in example-managed-preferences.plist.

De instellingen in de payload van het profiel:

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

Booleaanse waarden kunnen ook worden opgegeven als de gehele getallen 0 en 1.

Linux: het beleidsbestand

Op Linux leest de app /etc/antimatter-desktop/policies.json, een JSON-object met de sleutels van de instellingentabel:

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

Verspreid het met uw configuratiebeheerhulpmiddel (Ansible, Puppet, Salt en anderen), eigendom van root, leesbaar door iedereen en alleen schrijfbaar door root:

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

Een bestand dat geen geldige JSON is, wordt genegeerd, met een waarschuwing in het logboek van de app. De Flatpak-versie ziet het /etc van de host niet: geef het leesrecht, en het leest het bestand uit /run/host/etc/antimatter-desktop/policies.json:

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

Beleidsregels ingesteld voor de Mattermost-desktopapp

Op Windows leest de app ook de beleidsinstellingen die zijn ingesteld voor de Mattermost-desktopapp, onder SOFTWARE\Policies\Mattermost, als terugval. Deze worden gelezen op locatie: de waarden direct onder de beleidskey, de subkey DefaultServerList en de subkey TrustedEmbeddedMediaOrigins. Voor elk van deze drie locaties leest de app alleen de Mattermost-key wanneer de Antimatter-key daar geen waarden bevat, in beide hives. Zodra er één waarde direct onder de Antimatter-key is ingesteld, bijvoorbeeld via de AUTOUPDATE-eigenschap van de MSI, worden geen van de waarden direct onder de Mattermost-key meer gelezen. Verplaats al uw beleidsinstellingen tegelijk naar de Antimatter-key.

Op macOS worden de beheerde voorkeuren van de Mattermost-desktopapp (com.mattermost.desktop) niet gelezen: stel ze in voor chat.antimatter.desktop.

Ondertekende builds

De builds van de desktopapp zijn nog niet ondertekend met een uitgeverscertificaat.

• Windows. Wanneer iemand een gedownload .exe- of .msi-bestand opent, meldt Microsoft Defender SmartScreen dat Windows de computer heeft beschermd en noemt een onbekende uitgever. De gebruiker kiest Meer informatie en vervolgens Alsnog uitvoeren. SmartScreen controleert bestanden die mensen openen na een download, dus deze waarschuwing verschijnt niet wanneer u de app uitrolt via SCCM, Intune of Group Policy. Als uw computers alleen software van goedgekeurde uitgevers uitvoeren (AppLocker- of App Control for Business-regels), staat u de app dan toe via het installatiepad of de bestandshash.
• macOS. De app is ad hoc ondertekend, maar niet genotarieerd door Apple. De eerste keer dat iemand een gedownload exemplaar opent, meldt macOS dat het niet kan verifiëren dat de app vrij is van malware, en opent deze niet. Op macOS 15 en later opent de gebruiker Systeeminstellingen › Privacy & beveiliging en kiest Alsnog openen. Op eerdere versies klikt de gebruiker met de rechtermuisknop op de app en kiest Openen. Gatekeeper controleert alleen bestanden die als gedownload zijn gemarkeerd (met het quarantaine-attribuut): wanneer u de app installeert met uw eigen tools, verwijdert u het merkteken in uw installatiescript met xattr -dr com.apple.quarantine /Applications/Antimatter.app.