Dokumentacja dla deweloperów

Dokumentacja

Instrukcje i dokumentacja API: jak uruchamiać analizy AntiBait w aplikacji webowej i z własnego kodu.

Wdrożenie w organizacji

Zainstaluj AntiBait na zarządzanych komputerach za pomocą zasad, które Twoje przeglądarki i programy pocztowe już obsługują, i zablokuj ustawienia, aby użytkownicy nie mogli ich zmienić.

W skrócie

KlientID lub adres URLSposób wdrożenia
Chrome<chrome-extension-id>Wymuszona instalacja po ID przez zasady Chrome, konsolę administracyjną Google lub Intune.
Edge<edge-extension-id>Wymuszona instalacja po ID przez zasady Edge lub Intune.
Firefox[email protected]Wymuszona instalacja podpisanego pliku z antibait.io przez policies.json lub zasady grupy.
Thunderbird[email protected]Wymuszona instalacja pliku z antibait.io przez policies.json.
Outlookhttps://antibait.io/outlook-addin/manifest.xmlPrześlij adres manifestu w centrum administracyjnym Microsoft 365.

Wdrożenie instaluje klienta, ale nikogo nie loguje. Każda osoba loguje się własnym kontem AntiBait, a jej analizy wliczają się do limitu planu tego konta.

Chrome i Edge

Dodaj AntiBait do listy wymuszonej instalacji. Przeglądarka sama zainstaluje go ze sklepu i będzie aktualizować, a użytkownicy nie będą mogli go usunąć. W Windows zastosuj poniższe klucze rejestru albo ustaw ExtensionInstallForcelist w zasadach grupy.

Chrome · .reg
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist]
"1"="<chrome-extension-id>;https://clients2.google.com/service/update2/crx"
Edge · .reg
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionInstallForcelist]
"1"="<edge-extension-id>;https://edge.microsoft.com/extensionwebstorebase/v1/crx"

W konsoli administracyjnej Google dodaj rozszerzenie po ID w sekcji Aplikacje i rozszerzenia i ustaw Wymuś instalację. W Intune użyj tego samego ustawienia ExtensionInstallForcelist z szablonów administracyjnych Chrome lub Edge.

Blokowanie ustawień

Ustawienie z zasad zastępuje wybór użytkownika i jest widoczne w rozszerzeniu jako zablokowane. Chrome odczytuje je z klucza zasad 3rdparty rozszerzenia:

Chrome · .reg
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\3rdparty\extensions\<chrome-extension-id>\policy]
"autoScan"="auto"
"showBanner"=dword:00000001
"linkWarnings"=dword:00000001

W Edge ustaw te same wartości w kluczu Edge poniżej. W konsoli administracyjnej Google wpisz je jako JSON w polu zasad rozszerzenia.

Edge
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\3rdparty\extensions\<edge-extension-id>\policy

Firefox

Firefox instaluje podpisany przez Mozillę plik AntiBait bezpośrednio z antibait.io i stamtąd go aktualizuje. Umieść ten policies.json w folderze distribution instalacji Firefoksa albo ustaw te same wartości w zasadach grupy lub profilu konfiguracji macOS.

policies.json
{
  "policies": {
    "ExtensionSettings": {
      "[email protected]": {
        "installation_mode": "force_installed",
        "install_url": "https://antibait.io/downloads/firefox/latest.xpi"
      }
    },
    "3rdparty": {
      "Extensions": {
        "[email protected]": {
          "autoScan": "auto",
          "showBanner": true,
          "linkWarnings": true
        }
      }
    }
  }
}

latest.xpi zawsze wskazuje bieżące wydanie. Blok 3rdparty blokuje ustawienia; pomiń go, jeśli użytkownicy mają wybierać sami.

Thunderbird

Thunderbird obsługuje tę samą zasadę ExtensionSettings. Umieść ten policies.json w folderze distribution instalacji Thunderbirda.

policies.json
{
  "policies": {
    "ExtensionSettings": {
      "[email protected]": {
        "installation_mode": "force_installed",
        "install_url": "https://antibait.io/downloads/thunderbird/latest.xpi"
      }
    }
  }
}

Zasady ustawień opisujemy tylko dla Chrome, Edge i Firefoksa. W Thunderbirdzie ustaw je w opcjach dodatku.

Outlook

Dodatek do Outlooka wdrażasz z centrum administracyjnego Microsoft 365. Działa w Outlooku w Windows, na Macu i w przeglądarce.

  1. 01

    Zaloguj się do centrum administracyjnego Microsoft 365 i otwórz Ustawienia, a potem Zintegrowane aplikacje.

  2. 02

    Wybierz Przekaż aplikacje niestandardowe, zaznacz Dodatek pakietu Office i podaj poniższy link do pliku manifestu.

  3. 03

    Wybierz użytkowników lub grupy, które mają dostać dodatek, i zakończ wdrożenie.

  4. 04

    Poproś użytkowników, aby otworzyli AntiBait z paska wiadomości i raz się zalogowali.

Adres manifestu
https://antibait.io/outlook-addin/manifest.xml

Wdrożony dodatek może pojawić się w Outlooku dopiero po kilku godzinach. Bez administratora można dodać go samodzielnie: Pobierz dodatki, Moje dodatki, Dodaj dodatek niestandardowy, Dodaj z adresu URL.

Ustawienia, które możesz zablokować

Te same klucze działają we wszystkich zasadach powyżej. Klucze, których nie ustawisz, pozostają pod kontrolą użytkownika.

KluczWartościOpis
apiBasehttps://…Adres serwera AntiBait, na przykład własnej bramki. Gdy jest ustawiony, użytkownicy nie mogą go zmienić.
autoScanauto | offauto automatycznie sprawdza każdy e-⁠mail w planach, które to obejmują; off sprawdza tylko na żądanie.
modelaccount | standard | enhanced | enterpriseModel detekcji. account używa domyślnego modelu zalogowanego konta.
rawCapturetrue | falseAnalizuj pełne źródło wiadomości zamiast treści strony.
showBannertrue | falsePokazuj baner z werdyktem w wiadomości.
linkWarningstrue | falseOznaczaj podejrzane linki w wiadomości.

Sprawdź pliki

antibait.io publikuje skróty SHA-256 wszystkich udostępnianych plików pod adresem /downloads/index.json. Porównaj skrót z pobranym plikiem, zanim przygotujesz go do wdrożenia.

Linux
curl -s https://antibait.io/downloads/index.json
sha256sum antibait-firefox-*.xpi
PowerShell
(Invoke-RestMethod https://antibait.io/downloads/index.json).firefox.sha256
Get-FileHash -Algorithm SHA256 .\antibait-firefox-*.xpi

Potrzebujesz pomocy z integracją API? Zespół wsparcia odpowiada w ciągu 24 godzin w dni robocze.