Oceny zewnętrzne

Ocena zewnętrzna to mechanizm wywoływania oceny z dowolnej innej oceny. Ocena zewnętrzna nie jest samą oceną. Zamiast tego działa jak źródło danych, które umożliwia wysyłanie danych i odbieranie odpowiedzi z oceny docelowej. Ocena może mieć jedno z dwóch możliwych ustawień udostępniania:

• Prywatne: dostępne tylko w środowisku głównym oceny.
• Udostępnione: dostępne we wszystkich środowiskach w dzierżawie.

Oceny zewnętrzne mogą wskazywać dowolną prywatną ocenę dostępną w tym samym środowisku głównym lub ocenę udostępnioną dostępną w dowolnym środowisku głównym dzierżawy.

Uwaga

Aby uzyskać więcej informacji na temat zmiany ustawienia Udostępnianie oceny z Prywatnej na Udostępnione lub Udostępnione na Prywatne, zapoznaj się z omówieniem konfiguracji oceny.

Po skonfigurowaniu oceny zewnętrznej można ją wywołać za pomocą reguły z dowolnej oceny w tym środowisku.

W przypadku oceny prywatnej: środowisko Y = środowisko X

W przypadku oceny udostępnionej: Środowisko Y = dowolne środowisko główne w ramach tej samej dzierżawy

Ocena wywołująca odnosi się do każdej oceny, która wywołuje prywatną lub udostępnioną ocenę za pośrednictwem oceny zewnętrznej. Ocena wywołująca musi mieć skonfigurowaną regułę oceny zewnętrznej. Po spełnieniu warunku reguły reguła wywoła ocenę zewnętrzną i wykona skonfigurowane akcje. Podobnie jak w przypadku wywołań zewnętrznych, oceny zewnętrzne nie są dziedziczone przez elementy podrzędne. Aby użyć oceny zewnętrznej w regule, należy skonfigurować ocenę zewnętrzną w środowisku, z którego chcesz go wywołać.

Tworzenie oceny zewnętrznej

Aby utworzyć ocenę zewnętrzną, najpierw upewnij się, że masz odpowiednie uprawnienia do wykonania tej operacji. Aby uzyskać więcej informacji na temat ról i uprawnień użytkownika, zobacz Role użytkowników i dostęp

1. W portalu ochrony przed oszustwami w obszarze nawigacji po lewej stronie wybierz pozycję Oceny zewnętrzne, a następnie wybierz pozycję + Nowa ocena zewnętrzna.
2. Na stronie Nowa ocena zewnętrzna ustaw następujące pola:

• Ocena docelowa do wywołania — na liście rozwijanej można wyświetlić wszystkie prywatne oceny, skonfigurować je w tym samym środowisku głównym, a także wszystkie dostępne oceny udostępnione, skonfigurowane w dowolnym środowisku głównym tej samej dzierżawy. Wybierz ocenę, która ma być docelowa.

Uwaga

Jeśli udostępniona ocena, do której chcesz wskazać ocenę zewnętrzną, nie jest wyświetlana na liście rozwijanej, sprawdź ustawienie Udostępnianie oceny i upewnij się, że jest ono ustawione na Udostępnione. Aby dowiedzieć się więcej na temat konfigurowania ustawienia Udostępnianie , zapoznaj się z omówieniem konfiguracji oceny.

• Nazwa — wprowadź nazwę, która będzie używana do odwoływania się do oceny zewnętrznej z reguł. Nazwa może zawierać tylko cyfry, litery i podkreślenia. Nie może zaczynać się od liczby.

Uwaga

Nie można zmienić nazwy oceny zewnętrznej po jej użyciu w regule.

• Opis — dodaj opis, aby ułatwić zespołowi szybkie zidentyfikowanie oceny zewnętrznej.
• Interfejs API do podglądu — wybierz interfejs API, dla którego chcesz wyświetlić podgląd przykładowego kodu. Przykładowy kod to język FQL, którego można użyć w regule w celu wywołania tej udostępnionej oceny

Uwaga

Możesz użyć oceny zewnętrznej, aby wywołać interfejs API oceny, obserwacji lub etykiety udostępnionej lub prywatnej oceny, do której wskazuje.

• Przykładowa odpowiedź — ta sekcja zawiera przykładową odpowiedź oczekiwaną z oceny docelowej. Wyświetlane informacje są ręcznie udostępniane przez administratora oceny docelowej i służą do włączania opisów (etykietek narzędzi) i sugestii dotyczących autouzupełniania podczas odwoływania się do oceny w regule.

3. Po zakończeniu ustawiania wymaganych pól wybierz pozycję Utwórz.

Wywoływanie oceny zewnętrznej

Aby korzystać z ocen zewnętrznych, należy odwołać się do nich z reguł. Aby na przykład odwołać się do oceny zewnętrznej o nazwie myAssessment, w regule użyj następującej składni:

Assessments.myAssessment.Evaluate($baseInput = @@)

W powyższym przykładzie $baseInput = @@zamapuje wszystkie pola wymagane przez udostępnioną/zewnętrzną ocenę z ładunku oceny wywołującej. Można również mapować tylko określone pola. Możesz również zdefiniować akcje, które mają być podejmowane przez regułę na podstawie informacji, które otrzymają z powrotem z wywołania oceny zewnętrznej.

Przykład:

LET $card = {
  number: 12345,
  expy: "2023-03-10".ToDateTime()
}
LET $response = Assessments.MicroTx.evaluate(card = $card, user = @@"user")
OBSERVE Output(decision = $response.decisionDetails.merchantRuleDecision)

Regułę można skonfigurować w celu wywołania oceny zewnętrznej przy użyciu szablonu Użyj zewnętrznej reguły oceny lub skopiować/wkleić przykładowy kod FQL ze strony zewnętrznej oceny. Pamiętaj, aby użyć przykładowego kodu dla interfejsu API (oceń, obserwuj, etykietę), który chcesz wywołać. Przykładowy kod pokaże wszystkie pola, które można wysłać do udostępnionej oceny. Wymagane pola są oznaczone jako takie w kodzie.

Oto kolejny przykładowy język FQL do wywoływania interfejsu API oceny zewnętrznej o nazwie ExtAssessment1:

LET $customUser = {
    id: "userId123456",
    username: "johnsmith2",
    firstName: "John",
    lastName: "Smith",
    email: "johnsmith2@gmail.com",
    address: {
        street1: "0123 Bechtelar Loop",
        city: "Kubtown",
        state: "SC",
        zipCode: "44329",
        countryRegion: "US"
    }
}

LET $result = Assessments.ExtAssessment1.Evaluate(
    user = $customUser,
    specialConsideration = true)
OBSERVE Output(Result = $result)

Możesz również uzyskać dostęp do obiektu diagnostyki w regułach, co umożliwia odnajdywanie ważnych informacji diagnostycznych i debugowania z odpowiedzi zewnętrznej oceny. Obiekt diagnostyczny zawiera ładunek żądania , kod HttpStatus , komunikat o błędzie i opóźnienie. Obiekt diagnostyczny musi zostać utworzony najpierw przy użyciu odpowiedniej metody rozszerzenia ". GetDiagnostics()", zanim pola obiektu będą mogły być używane w regułach.

Poniżej przedstawiono przykład reguły korzystającej z obiektu diagnostycznego w odpowiedzi zewnętrznej oceny o nazwie ExtAssessment2:

LET $result = Assessments.ExtAssessment2.evaluate($baseInput =@@)
LET $diagnostics = $result.GetDiagnostics()
RETURN Approve(), Output (Diagnostics = $diagnostics)
WHEN $diagnostics.httpStatusCode==200

Wywołania zewnętrzne i oceny zewnętrzne mogą wymagać złożonych obiektów strukturalnych w ramach schematu żądania. Aby uzyskać więcej informacji na temat używania tablic i obiektów JSON, zapoznaj się z przewodnikiem dokumentacja języka.

Uwaga

Do ocen zewnętrznych można również odwoływać się w usłudze Functions. Aby uzyskać więcej informacji, zobacz Funkcje.

Monitorowanie ocen zewnętrznych w portalu ochrony przed oszustwami

Ochrona przed oszustwami przedstawia kafelek zawierający trzy metryki dla każdej zdefiniowanej oceny zewnętrznej:

• Żądania na sekundę — łączna liczba żądań podzielona przez łączną liczbę minut w wybranym przedziale czasu.
• Średnie opóźnienie — łączna liczba żądań podzielona przez łączną liczbę minut w wybranym przedziale czasu.
• Współczynnik powodzenia — łączna liczba żądań zakończonych powodzeniem podzielona przez łączną liczbę wykonanych żądań.

Liczby i wykresy wyświetlane na tym kafelku obejmują tylko dane dla przedziału czasu wybranego na liście rozwijanej w prawym górnym rogu strony.

Uwaga

Metryki są wyświetlane tylko wtedy, gdy ocena zewnętrzna jest używana w aktywnej regule.

• Aby dowiedzieć się więcej na temat danych dotyczących oceny zewnętrznej, wybierz pozycję Wydajność w prawym rogu kafelka. Ochrona przed oszustwami przedstawia nową stronę, która ma bardziej szczegółowy widok metryk.
• Aby wyświetlić metryki dla dowolnego przedziału czasu w ciągu ostatnich trzech miesięcy, dostosuj ustawienie Zakres dat w górnej części strony.

Oprócz trzech opisanych wcześniej metryk pokazano również wykres Błędy . Ten wykres przedstawia liczbę błędów według typu błędu i kodu. Aby wyświetlić liczbę błędów w czasie lub wyświetlić rozkład błędów, wybierz pozycję Wykres kołowy.

Oprócz błędów klienta HTTP (400, 401 i 403) mogą wystąpić następujące błędy:

• Nieprawidłowy identyfikator aplikacji — podany identyfikator aplikacji nie istnieje w dzierżawie lub jest nieprawidłowy.
• Niepowodzenie firmy Microsoft Entra — nie można pobrać tokenu Entra firmy Microsoft.
• Nie można odnaleźć definicji — wywołanie zewnętrzne zostało usunięte, ale nadal występuje w regule.
• Limit czasu — żądanie do celu trwało dłużej niż określony limit czasu.
• Błąd komunikacji — nie można nawiązać połączenia z obiektem docelowym z powodu problemu z siecią lub z powodu niedostępności obiektu docelowego.
• Wyłącznik — jeśli wywołanie zewnętrzne nie powiodło się w sposób ciągły i przekroczyło określony próg, wszystkie kolejne wywołania są zawieszone przez krótki interwał.
• Nieznany błąd — wystąpił wewnętrzny błąd usługi Dynamics 365.