Utrulling av skrivebordsappen

Slik installerer du Antimatter-skrivebordsappen på datamaskinene i et selskap eller en skole, og setter servere, brukernavn og oppdateringskontroller sentralt på Windows, macOS og Linux.

Last ned appen

Utgavene av skrivebordsappen finnes på GitHub, på github.com/AntimatterChat/desktop-app/releases. Som serveren er appen i beta: en utgave med en suffiks etter en bindestrek i versjonsnummeret er merket Pre-release. Hver utgave har en SHA256SUMS-fil med sjekksummen for hver fil. Kontroller en nedlasting med sha256sum --check --ignore-missing SHA256SUMS på Linux, eller sammenlign utdataene fra Get-FileHash <file> -Algorithm SHA256 i PowerShell med linjen i SHA256SUMS.

• Windows (x64 og arm64): .exe-installatoren, .msi-pakken eller et .zip-arkiv. For eksempel antimatter-desktop-<version>-win-x64.exe og antimatter-desktop-<version>-win-x64.msi.
• macOS: en .dmg-diskbilde eller en .zip, for Apple silicon (arm64), Intel Macs (x64) eller begge (universal).
• Linux (x64 og arm64): en .deb- eller .rpm-pakke, en AppImage, en Flatpak-bundle eller et .tar.gz-arkiv.

Hvilken Windows-installerer du skal bruke

Appen sjekker etter nye versjoner på GitHub, hver time mens den kjører, og ser kun etter fullstendige utgaver, ikke forhåndsutgaver. Når den finner en, varsler den brukeren og tilbyr en lenke for å laste den ned. En kopi installert med MSI sjekker ikke automatisk, fordi brukerne vanligvis ikke har rettigheter til å installere programvare. Du kan slå på sjekkene for den med innstillingen EnableAutoUpdater: nedlastingen som da tilbys, er den nye .msi-filen, som krever administratorrettigheter.

Bruk MSI for styrt distribusjon med SCCM (Configuration Manager), Intune eller gruppepolicy for programvareinstallasjon. Når MSI installeres, fjernes .exe-kopien for kontoen som kjører installasjonen, hvis det finnes en.

Innstillinger du kan styre

De samme innstillingene finnes på alle systemer. På Windows er de registerverdier under SOFTWARE\Policies\Antimatter, i HKEY_LOCAL_MACHINE (for datamaskinen) eller HKEY_CURRENT_USER (for én bruker). På macOS og Linux er de nøkler i de styrede preferansene eller i policyfilen.

• Brukernavnet fylles bare inn på innloggsiden for servere som er satt ved hjelp av policy, aldri på en server en person har lagt til, og aldri over det noen har skrevet. Folk kan fortsatt endre det. Miljøvariabler mellom prosenttegn erstattes, så én verdi passer for alle: %USERNAME% på Windows eller %USER% på macOS og Linux gir kontonavnet, og %USERNAME%@example.com en e-postadresse som følger dette mønsteret. Hvis en variabel ikke er satt, fyller appen ingenting inn.
• Hvis du slår av serveradministrasjon, må du sette minst én server i DefaultServerList.
• På Windows vinner en datamaskinpolicy (HKEY_LOCAL_MACHINE) over en brukerpolicy (HKEY_CURRENT_USER). Serverlistene til begge kombineres.
• Appen leser innstillingene når den starter: etter en endring må folk lukke og åpne den på nytt.

Windows: stille installasjon med MSI

MSI-filen tar imot offentlige egenskaper som skriver innstillingene som datamaskinpolicyer, i HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Antimatter. Bruk dem i en SCCM-applikasjon, en Intune-app eller et skript. I PowerShell:

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

• En egenskap som ikke er gitt, skriver ingenting, og overstyrer derfor ikke en verdi satt av gruppepolicy. AUTOUPDATE og SERVERMANAGEMENT aksepterer bare 0 eller 1. MSI-filen setter én server: bruk gruppepolicy for flere.
• DEFAULTUSERNAME må nå installatøren som teksten %USERNAME%, slik at appen erstatter den for hver person. Ellers erstatter skallet som kjører installasjonen den med sitt eget kontonavn. I PowerShell, behold enkeltanførselstegn. I en .bat-fil, skriv %%USERNAME%%. Etter en testinstallasjon, sjekk i registeret at DefaultUsername inneholder %USERNAME%.
• Send egenskapene på nytt ved hver oppgradering. Når du installerer en ny versjon av MSI-filen, fjernes den gamle, med verdiene den skrev, og deretter skrives verdiene fra den nye kommandolinjen. SCCM og Intune beholder kommandolinjen for en applikasjon: gjenbruk den for hver ny versjon. Eller sett policyene med gruppepolicy eller Intune i stedet, noe oppgraderinger ikke rører.
• MSI og gruppepolicy skriver de samme registerverdiene. For hver innstilling skal du bruke enten den ene eller den andre: Hvis du avinstallerer MSI, slettes verdiene den skrev, selv om gruppepolicy også har satt dem.
• MSI registrerer også installasjonsmappen i HKEY_LOCAL_MACHINE\SOFTWARE\Antimatter\Desktop (InstallDir). Dette er hvordan appen vet at den ble installert med MSI.

For å avinstallere: msiexec /x antimatter-desktop-<version>-win-x64.msi /qn. I Intune tar typen «Windows app (Win32)» de samme kommandolinjene. For typen «Line-of-business app», legg egenskapene til kommandolinjeargumentene.

Windows: Gruppepolicy og Intune

Administrative maler, antimatter.admx og en-US\antimatter.adml, finnes i gpo-mappen i den installerte appen (C:\Program Files\Antimatter\gpo for MSI) og i resources/windows/gpo-mappen i appens repository. De viser disse policyene, under Administrative Templates › Antimatter:

Gruppepolicy i et domene

1. Kopier antimatter.admx til sentralt lager, \\<domain>\SYSVOL\<domain>\Policies\PolicyDefinitions, og antimatter.adml til en-US-mappen der.
2. I Gruppepolicyadministratoren, åpne Computer Configuration (eller User Configuration) › Policies › Administrative Templates › Antimatter.
3. Rediger en policy, velg Aktivert og fyll den ut. For Servers, klikk Vis og legg til én linje per server: verdinavnet er fane-navnet, verdien er server-URL-en, for eksempel https://chat.example.com.

Hvis du aktiverer La brukere legge til og fjerne servere eller Varsle om nye versjoner, skrives 1; hvis du deaktiverer, skrives 0.

Intune

I Enheter › Konfigurasjon, bruk Import ADMX for å importere antimatter.admx med en-US\antimatter.adml. Deretter lager du en profil fra Maler › Importerte administrative maler, og setter Antimatter-politikken i den.

En enkelt datamaskin, eller et skript

Kopier malene til C:\Windows\PolicyDefinitions for å bruke dem i gpedit.msc (Windows Pro og Enterprise). Eller skriv registerværdiene direkte, med en .reg-fil som importeres som administrator (reg import antimatter-policies.reg), som for eksempel denne. Filen example-policies.reg i samme mappe har disse verdiene, med kommentarer.

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: en konfigurasjonsprofil

På macOS leser appen innstillingene sine fra de administrerte preferansene til bunten sin identifikator, chat.antimatter.desktop, med nøklene fra innstillingstabellen. Lever dem med MDM-en din (Jamf, Intune, Kandji, Mosyle og andre) som en konfigurasjonsprofil.

• Mappen resources/mac/mdm i appens repository har en eksempelprofil, antimatter.mobileconfig. Rediger verdiene, gi den dine egne PayloadIdentifier- og PayloadUUID-verdier (uuidgen lager nye UUID-er), og last den opp som en tilpasset profil.
• De fleste MDM-er godtar også bare nøklene, som en «custom settings»- eller «preference domain»-last for chat.antimatter.desktop. Samme mappe har dem i example-managed-preferences.plist.

Innstillingene i profilens last:

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

Booleans kan også gis som heltallene 0 og 1.

Linux: policyfilen

På Linux leser appen /etc/antimatter-desktop/policies.json, et JSON-objekt med nøklene fra innstillingstabellen:

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

Lever den med verktøyet ditt for konfigurasjonsstyring (Ansible, Puppet, Salt og andre), eid av root, lesbar for alle og skrivbar bare for root:

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

En fil som ikke er gyldig JSON ignoreres, med en advarsel i appens logg. Flatpak-versjonen ser ikke vertens /etc: gi den leseaksess, og den leser filen fra /run/host/etc/antimatter-desktop/policies.json:

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

Policies satt for Mattermost-desktopappen

På Windows leser appen også policyene som er satt for Mattermost-skrivebordet, under SOFTWARE\Policies\Mattermost, som en reserve. Den leser dem etter plass: verdiene direkte under policy-nøkkelen, undernøkkelen DefaultServerList og undernøkkelen TrustedEmbeddedMediaOrigins. For hver av disse tre plassene leser den Mattermost-nøkkelen bare når Antimatter-nøkkelen ikke har verdier der, i noen av hiveene. Så når én verdi er satt direkte under Antimatter-nøkkelen, for eksempel av MSI-egenskapen AUTOUPDATE, leses ingen av verdiene direkte under Mattermost-nøkkelen. Flytt alle policyene dine til Antimatter-nøkkelen på én gang.

På macOS leses ikke de administrerte preferansene til Mattermost-skrivebordet (com.mattermost.desktop): Sett dem for chat.antimatter.desktop.

Uunderskrevne bygg

Skrivebordsappens bygg er ikke ennå signert med en utgiver-sertifikat.

• Windows. Når en person åpner en nedlastet .exe eller .msi, sier Microsoft Defender SmartScreen at Windows har beskyttet datamaskinen, og nevner en ukjent utgiver. De velger Mer info, deretter Kjør likevel. SmartScreen sjekker filer som personer åpner etter en nedlasting, så personer ser ikke denne advarselen når du distribuerer appen via SCCM, Intune eller gruppepolicy. Hvis datamaskinene dine bare kjører programvare fra godkjente utgivere (AppLocker- eller App Control for Business-regler), tillat appen ved installasjonsstien eller filhashen i stedet.
• macOS. Appen er signert ad hoc, men ikke notarert av Apple. Første gang en person åpner en nedlastet kopi, sier macOS at den ikke kan verifisere at appen er fri for skadeprogram, og åpner den ikke. På macOS 15 og nyere, åpner de Systeminnstillinger › Personvern og sikkerhet og velger Åpne likevel. På tidligere versjoner, holder de nede Control-tasten og klikker på appen, og velger Åpne. Gatekeeper sjekker bare filer som er merket som nedlastet (med karantene-attributtet): Når du installerer appen med dine egne verktøy, fjern merket i installasjonsskriptet ditt, med xattr -dr com.apple.quarantine /Applications/Antimatter.app.