Edmund AI Dokumentacja
/DOKUMENTACJA IT

Wymagania sieciowe

Pełne działanie Edmunda wymaga dopuszczenia połączeń wychodzących przez firewall lokalny lub brzegowy. Wymagany jest HTTPS na TCP 443. Nie są potrzebne niezamówione połączenia przychodzące z internetu.

Wymagane usługi docelowe

Wszystkie poniższe usługi korzystają z HTTPS na TCP 443.

UsługaCel
AWS ECR w IrlandiiPobieranie podpisanych obrazów kontenerów platformy
SentryWysyłanie zdarzeń błędów i śladów wydajności
Grafana PrometheusPrzekazywanie metryk aplikacji i infrastruktury
Azure OpenAI ServiceFunkcje generatywnej AI
Milvus Zilliz, endpoint właściwy dla klientaOdczyt i zapis indeksu dokumentów
LangSmith, telemetria LangChainRejestrowanie wykonań łańcuchów do obserwacji i diagnostyki

Dokładne FQDN właściwe dla wdrożenia przekazuje zespół Edmunda podczas konfiguracji. Publiczna dokumentacja nie zawiera identyfikatorów kont ani wewnętrznych nazw infrastruktury.

Zalecenia dla firewalla

  • Lista FQDN zamiast IP: adresy IP endpointów są dynamiczne i mogą się zmieniać. Zalecane są reguły DNS lub proxy HTTP/S zamiast stałych reguł IP.
  • Aktualny TLS: inspekcja HTTPS i proxy SSL/TLS muszą obsługiwać TLS 1.2 lub nowszy oraz wymagane główne urzędy certyfikacji.
  • Bez dodatkowych reguł przychodzących: komunikację inicjuje infrastruktura wewnętrzna. Platforma nie wymaga niezamówionego ruchu przychodzącego.
  • Filtrowanie treści i DPI: inspekcja wychodzącego HTTPS powinna przepuszczać uzgodnione FQDN bez modyfikacji powodujących błędy połączenia.
  • Typ treści: należy dopuścić text/event-stream, potrzebny do strumieniowania odpowiedzi. Niektóre firewalle blokują go domyślnie.
  • Zarządzanie zmianą: lista obowiązuje dla danej wersji. Wyznaczony kontakt klienta jest uprzedzany o nowych celach wymagających zmian firewalla.

Test łączności

Dla AWS ECR, Sentry, Grafana Prometheus, Azure OpenAI i LangSmith administrator może wykonać żądanie nagłówków do przekazanego FQDN:

curl -I https://<uzgodniony-fqdn>/<uzgodniona-sciezka>

Dowolny status HTTP potwierdza osiągalność sieciową, ale nie poprawność autoryzacji ani działania usługi. Ścieżki testowe zależą od usługi; Prometheus wykorzystuje między innymi /api/prom, a Azure OpenAI /openai/deployments.