Bezpieczeństwo i operacje

SDK Rozwiązywanie problemów z integracją

Zdiagnozuj Trading Widget, Agent SDK, problemy z podpisywaniem, webhookiem, timeoutem i środowiskiem przed eskalowaniem prośby o wsparcie.

Zobacz jako Markdown

Zacznij od środowiska, znacznika czasu i identyfikatora biznesowego dla nieudanej operacji. Kontrola strukturalna zazwyczaj oddziela problemy konfiguracyjne od uwierzytelniania, sieci i przetwarzania asynchronicznego.

Zalecana kolejność diagnostyki

  1. Potwierdź środowisko dotknięte i bazuj URL.
  2. Zapisz UTC przedział czasowy oraz pierwsze nieudane żądanie.
  3. Zidentyfikuj moduł: Trading Widget, Agent SDK, REST API, WebSocketlub webhook.
  4. Uchwyć identyfikator żądania, identyfikator użytkownika partnera, agentOrderNo, identyfikator zamówienia lub identyfikator zdarzenia webhooka.
  5. Sprawdź ostatni kod, dane uwierzytelniające, IP białą listę lub zmiany wdrożenia.
  6. Rozmnoś się z najmniejszym bezpiecznym przypadkiem testowym.

Trading Widget kwestie

ObjawyPrawdopodobna przyczynaFix
iframe żąda partnerskiej domeny lokalnejbaseUrl brakujePass baseUrl: ‘https://app.6mm.com’.
iframe jest niewidoczny lub bardzo krótkiKontener nadrzędny nie ma wysokościUstaw wysokość pojemnika lub wysokość przejścia.
token_provider_missingTryb token partnera nie ma dostawcyDodaj autoryzację.tokenProvider.
auth_exchange_failedNieprawidłowy, wygasły lub niedopasowany token osadzonySprawdź odpowiedź tokenów backendowych i channelId.

Agent SDK kwestie

ObjawyPrawdopodobna przyczynaFix
Podpis odrzuconyZły sekret, przesunięcie zegara lub ręczna zmiana znakowanych pólPozwól SDK generować pola podpisu i synchronizować czas na serwerze.
Ryzyko podwójnego ruchu środkówNowy numer zamówienia używany po przerwieNajpierw zapytanie przez oryginalnego agentOrderNo .
PROCESSING traktowana jako porażkaStan oczekujący na nieporozumieniePoczekaj na webhook lub zadzwoń do queryOrder.
Webhook przetwarzany wielokrotnieZachowanie powtórne bez idempotencjiDodaj klucz idempotencji i sprawdzenie stanu końcowego.

Dowody do przechwycenia

IntegracjaPrzydatne dowody
Trading WidgetStrona URL, SDK ścieżka wersji, konsola przeglądarki, nieudane żądania sieciowe, onError payload oraz wymiary kontenera.
Agent SDKSDK język/wersję, URL bazową, UTC znaczniki czasu, identyfikator żądania, agentOrderNo, kod odpowiedzi oraz oczyszczone logi.
WebhookCzas dostawy, klucz zdarzenia lub firmy, wynik weryfikacji podpisu, stan przetwarzania oraz oczyszczony hash surowego ciała.
REST APIMetoda, ścieżka, środowisko, identyfikator żądania, kod odpowiedzi oraz oczyszczone parametry.

Nigdy nie umieszczaj haseł, tokenów dostępu, API sekretów, pełnych podpisów, kluczy prywatnych ani nieocenzurowanych danych osobowych w diagnostyce.

Przed eskalacją

  • Próba ponowna tylko wtedy, gdy operacja zostanie udokumentowana jako bezpieczna do ponownej próby.
  • Po upływie czasu zapytania o oryginalny identyfikator firmy zamiast tworzenia nowego.
  • Potwierdzaj system zegara i środowiska uwierzytelniania pod kątem błędów sygnatury.
  • Zachowuj pierwsze niepowodzenie oraz ewentualne późniejsze wyniki powtórek.
  • Użyj Szablonu Żądania Wsparcia, aby wysłać kompletny, zredagowany raport.
Trading Widget Szybki Początek

Zweryfikować ładowanie skryptów, rozmiar kontenera, konfigurację i wywołania zwrotne.

Sekrety i podpisywanie

Sprawdź Agent SDK dane uwierzytelniające, zegary i pola podpisane.

Webhooki i Idempotencja

Przejrzyj weryfikację oddzwonienia i obsługę podwójnych zdarzeń.