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
| Klient | ID lub adres URL | Sposó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. |
| Outlook | https://antibait.io/outlook-addin/manifest.xml | Prześ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.
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"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:
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:00000001W Edge ustaw te same wartości w kluczu Edge poniżej. W konsoli administracyjnej Google wpisz je jako JSON w polu zasad rozszerzenia.
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\3rdparty\extensions\<edge-extension-id>\policyFirefox
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": {
"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": {
"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.
- 01
Zaloguj się do centrum administracyjnego Microsoft 365 i otwórz Ustawienia, a potem Zintegrowane aplikacje.
- 02
Wybierz Przekaż aplikacje niestandardowe, zaznacz Dodatek pakietu Office i podaj poniższy link do pliku manifestu.
- 03
Wybierz użytkowników lub grupy, które mają dostać dodatek, i zakończ wdrożenie.
- 04
Poproś użytkowników, aby otworzyli AntiBait z paska wiadomości i raz się zalogowali.
https://antibait.io/outlook-addin/manifest.xmlWdroż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.
| Klucz | Wartości | Opis |
|---|---|---|
apiBase | https://… | Adres serwera AntiBait, na przykład własnej bramki. Gdy jest ustawiony, użytkownicy nie mogą go zmienić. |
autoScan | auto | off | auto automatycznie sprawdza każdy e-mail w planach, które to obejmują; off sprawdza tylko na żądanie. |
model | account | standard | enhanced | enterprise | Model detekcji. account używa domyślnego modelu zalogowanego konta. |
rawCapture | true | false | Analizuj pełne źródło wiadomości zamiast treści strony. |
showBanner | true | false | Pokazuj baner z werdyktem w wiadomości. |
linkWarnings | true | false | Oznaczaj 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.
curl -s https://antibait.io/downloads/index.json
sha256sum antibait-firefox-*.xpi(Invoke-RestMethod https://antibait.io/downloads/index.json).firefox.sha256
Get-FileHash -Algorithm SHA256 .\antibait-firefox-*.xpiPotrzebujesz pomocy z integracją API? Zespół wsparcia odpowiada w ciągu 24 godzin w dni robocze.