Exchange - Konfiguracja łącznika odbierania
Umieść zewnętrzną bramkę antyspamową przed platformą Exchange OVHcloud dzięki łącznikowi odbierania, tworzonemu i zarządzanemu za pomocą API OVHcloud
Wprowadzenie
Łącznik odbierania określa, które serwery mogą dostarczać e-maile do Twojej platformy Exchange i na jakich warunkach. Pozwala on umieścić przed platformą Exchange zewnętrzne rozwiązanie antyspamowe, nazywane również bramką filtrującą: rekordy MX Twojej domeny wskazują na tę bramkę, która filtruje przychodzące e-maile, a następnie przekazuje je do Exchange.
Łącznik odbierania jest dostępny dla usług Private Exchange i Trusted Exchange. Można go tworzyć i nim zarządzać wyłącznie za pomocą API OVHcloud.
Ten przewodnik wyjaśnia, jak utworzyć, zmodyfikować, wyłączyć i usunąć łącznik odbierania na platformie Exchange za pomocą API OVHcloud.
Aby kierować e-maile wychodzące z Twojej platformy przez serwer zewnętrzny, użyj zamiast tego łącznika wysyłania: zapoznaj się z naszym przewodnikiem "Exchange - Konfiguracja łącznika wysyłania".
Wymagania początkowe
- Platforma Private Exchange lub Trusted Exchange.
- Dane dostępowe API wygenerowane na , z co najmniej uprawnieniem
GETdo/email/exchangeoraz uprawnieniamiGET,POST,PUT,PATCHiDELETEdo/email/exchange/*. Skorzystaj z naszego przewodnika "Pierwsze kroki z API OVHcloud". - Adresy IP serwerów Twojego zewnętrznego rozwiązania antyspamowego, które będą dostarczać e-maile do Exchange. Poproś o nie dostawcę tego rozwiązania.
W praktyce
Informacje o domyślnym łączniku odbierania
Każda platforma Exchange posiada domyślny łącznik odbierania. Należy on do Exchange: nie możesz go zmodyfikować ani usunąć, możesz go jedynie włączyć lub wyłączyć. W API jego właściwość default ma wartość true.
Dopóki jest włączony, Twoja platforma przyjmuje wszystkie przychodzące e-maile, niezależnie od tego, który serwer je dostarcza: utworzony przez Ciebie łącznik odbierania nie ma wtedy żadnego efektu. Aby tylko Twoja bramka mogła dostarczać e-maile do Exchange, samodzielnie wyłącz domyślny łącznik. Nigdy nie jest on wyłączany automatycznie, aby uniknąć nagłego przerwania odbierania e-maili.
Wyłącz domyślny łącznik na końcu. Jeśli żaden inny włączony łącznik nie ma zastosowania, jego wyłączenie zatrzymuje odbieranie wszystkich e-maili na platformie. Przed jego wyłączeniem sprawdź, czy Twój łącznik odbierania jest włączony i czy rekordy MX Twojej domeny wskazują na Twoją bramkę.
Znajdowanie parametrów ścieżki
Wywołania dotyczące łącznika odbierania wymagają nazwy organizacji (organizationName) i nazwy usługi (exchangeService) Twojej platformy. Pobierz je po kolei: pierwsze z poniższych wywołań zwraca organizację, której potrzebuje drugie.
1. Organizacja (organizationName)
Wyświetl listę organizacji Exchange Twojego konta za pomocą poniższego wywołania API:
2. Usługa (exchangeService)
Wyświetl listę usług Exchange w organizacji za pomocą poniższego wywołania API:
Tworzenie łącznika odbierania
Utwórz łącznik za pomocą poniższego wywołania API:
Wypełnij następujące pola w treści żądania. Wymagane są tylko pola name, remoteIpRanges i requireTls.
Każdy wpis remoteIpRanges może być:
- pojedynczym adresem IP, na przykład
203.0.113.10; - siecią w notacji CIDR, na przykład
203.0.113.0/28; - zakresem adresów "początek-koniec", z uwzględnieniem granic, na przykład
203.0.113.10-203.0.113.20.
Akceptowane są zarówno adresy IPv4, jak i IPv6.
Ograniczenia remoteIpRanges
- Ten sam adres IP nie może należeć do dwóch łączników odbierania platformy.
- Cała lista, po połączeniu jej wpisów przecinkami, nie może przekraczać 255 znaków. Zamiast długiej listy pojedynczych adresów użyj sieci CIDR.
Wywołanie zwraca zadanie: łącznik zostanie utworzony po zakończeniu tego zadania.
Wyświetlanie listy i szczegółów łączników odbierania
Wyświetl listę łączników odbierania platformy, w tym łącznika domyślnego, za pomocą poniższego wywołania API:
Wywołanie zwraca listę identyfikatorów łączników (id). Wyświetl szczegóły łącznika za pomocą poniższego wywołania API:
Oprócz pól podawanych przy tworzeniu odpowiedź zawiera pole id, czyli identyfikator łącznika, oraz pole default, które ma wartość true w przypadku domyślnego łącznika odbierania.
Modyfikacja łącznika odbierania
Aby zmodyfikować jedno lub kilka pól bez zmiany pozostałych, użyj poniższego wywołania API:
Aby zastąpić całą konfigurację łącznika, wypełnij wszystkie pola w poniższym wywołaniu API:
Pole remoteIpRanges zastępuje zapisaną listę w całości. Aby dodać adres IP, wyślij pełną listę: istniejące adresy i nowy adres.
Aby włączyć lub wyłączyć łącznik, zmień jego pole enabled. W przypadku domyślnego łącznika odbierania jest to jedyne pole, które możesz zmienić: przed jego wyłączeniem zapoznaj się z sekcją "Informacje o domyślnym łączniku odbierania".
Każda zmiana zwraca zadanie: zostanie ona zastosowana po zakończeniu tego zadania.
Usuwanie łącznika odbierania
Usuń łącznik za pomocą poniższego wywołania API:
Wywołanie zwraca zadanie: łącznik zostanie usunięty po zakończeniu tego zadania. Nie możesz usunąć domyślnego łącznika odbierania.
Jeśli usuniesz ostatni łącznik inny niż domyślny, domyślny łącznik zostanie automatycznie ponownie włączony, aby nie blokować odbierania e-maili. To zachowanie zależy od parametru enableDefaultReceiveConnector wywołania (domyślnie true): przy wartości false wyłączony domyślny łącznik pozostaje wyłączony, a Twoja platforma przestaje odbierać e-maile.
Sprawdź również
Exchange - Konfiguracja łącznika wysyłania
Przewodniki Microsoft Exchange
W przypadku wyspecjalizowanych usług (pozycjonowanie, rozwój, etc.) skontaktuj się z partnerami OVHcloud.
Jeśli chcesz otrzymywać wsparcie w zakresie konfiguracji i użytkowania Twoich rozwiązań OVHcloud, zapoznaj się z naszymi ofertami pomocy.
Dołącz do grona naszych użytkowników.