Внешние оценки

Внешняя оценка — это механизм для вызова оценки из любой другой оценки. Внешняя оценка не является самой оценкой. Вместо этого он действует как источник данных, который позволяет отправлять данные и получать ответ от целевой оценки. Оценивание может иметь одну из двух возможных настроек общего доступа.

• Частный: доступ имеется только в основной среде оценки.
• Общий доступ: доступен во всех средах арендатора.

Внешние оценки могут указывать на любую частную оценку, доступную в той же корневой среде, или любую общую оценку, доступную в любой корневой среде клиента.

После настройки внешней оценки его можно вызвать с помощью правила из любой оценки в этой среде.

Для частной оценки: среда Y = среда X

Для общей оценки: среда Y = любая корневая среда в одном клиенте

Вызывающая оценка относится к любой оценке, которая вызывает частную или общую оценку через внешнюю оценку. Обязательная оценка должна иметь установленное правило внешней оценки. При выполнении условия правила правило вызовет внешнюю оценку и выполнит настроенные действия. Подобно внешним вызовам, внешние оценки не наследуются потомками. Чтобы использовать внешнюю оценку в правиле, необходимо настроить внешнюю оценку в среде, из которой вы хотите вызвать ее.

Создание внешней оценки

Чтобы создать внешнюю оценку, сначала убедитесь, что у вас есть право на выполнение этой операции. Дополнительные сведения о ролях и разрешениях пользователей см. в разделе "Роли пользователей" и "Доступ"

1. На портале защиты от мошенничества в области навигации слева выберите внешние оценки и нажмите кнопку +Создать внешнюю оценку.
2. На странице "Новая внешняя оценка " задайте следующие поля:

• Целевая оценка для вызова . В раскрывающемся списке можно просмотреть все частные оценки, настроенные в одной корневой среде, а также любые доступные общие оценки, настроенные в любой корневой среде одного клиента. Выберите оценку, на которую хотите направить внимание.

• Имя — введите имя, которое будет использоваться для ссылки на внешнюю оценку из правил. Имя может содержать только цифры, буквы и подчеркивания. Он не может начинаться с числа.

• Описание . Добавьте описание, чтобы помочь вашей команде быстро определить внешнюю оценку.
• API для предварительной версии — выберите API, для которого нужно просмотреть пример кода. Пример кода — это FQL, который можно использовать в правиле для вызова этой общей оценки.

• Пример ответа . Этот раздел содержит пример ответа, ожидаемый от целевой оценки. Отображаемые сведения отображаются вручную администратором целевой оценки и используются для включения описаний (подсказок) и предложений автозавершения при ссылке на оценку в правиле.

3. После настройки обязательных полей нажмите кнопку "Создать".

Вызов внешней оценки

Чтобы использовать внешние оценки, ссылаться на них в ваших правилах. Например, чтобы ссылаться на внешнюю оценку с именем myAssessment, в правиле используйте следующий синтаксис:

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

В приведенном выше примере $baseInput = @@ будет сопоставлять все поля, необходимые для общей или внешней оценки, используя информацию из полезной нагрузки оценки вызова. Можно сопоставить только определенные поля. Вы также можете определить, какие действия вы хотите, чтобы правило предприняло на основе информации, которую он будет получать обратно от вызова внешней оценки.

Например

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

Вы можете настроить правило для вызова внешней оценки с помощью шаблона правила использовать внешнюю оценку или копирования и вставки примера FQL со страницы внешней оценки. Обязательно используйте пример кода для API (оценка, наблюдение, ярлык), который вы хотите вызвать. В примере кода будут показаны все поля, которые можно отправить в общую оценку. Обязательные поля помечены как такие в коде.

Ниже приведен еще один пример FQL для вызова API оценки внешней оценки с именем ExtAssessment1:

LET $customUser = {
    id: "userId123456",
    username: "johnsmith2",
    firstName: "John",
    lastName: "Smith",
    email: "[email protected]",
    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)

Вы также можете получить доступ к объекту диагностики в правилах, что позволяет обнаруживать важные диагностические и отладочные сведения из ответа внешней оценки. Объект диагностики содержит полезные данные запроса , код HttpStatus , сообщение об ошибке и задержку. Сначала необходимо создать объект диагностики с помощью соответствующего метода расширения. GetDiagnostics()", прежде чем поля объекта можно использовать в правилах.

Ниже приведен пример правила с использованием объекта диагностики в ответе на внешнюю оценку ExtAssessment2.

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

Для внешних вызовов и внешних оценок может потребоваться сложные структурированные объекты в рамках схемы запроса. Дополнительные сведения об использовании массивов и объектов JSON см. в руководстве по языку.

Мониторинг внешних оценок на портале защиты от мошенничества

Защита от мошенничества показывает плитку, содержащую три метрики для каждой внешней оценки, которую вы определяете:

• запросов в секунду — общее количество запросов, разделенных на общее количество минут в выбранном интервале времени.
• Средняя задержка — общее количество запросов, разделенных на общее количество минут в выбранном интервале времени.
• Частота успешного выполнения — общее количество успешных запросов, разделенных на общее количество выполненных запросов.

Числа и диаграммы, отображаемые на этой плитке, включают только данные для интервала времени, выбранного в раскрывающемся списке в правом верхнем углу страницы.

• Чтобы глубже ознакомиться с данными о внешней оценке, выберите "Производительность" в правом углу плитки. Защита от мошенничества показывает новую страницу с более подробным представлением метрик.
• Чтобы просмотреть метрики для любого интервала времени за последние три месяца, настройте параметр диапазона дат в верхней части страницы.

Помимо трех описанных ранее метрик отображается диаграмма ошибок . На этой диаграмме показано количество ошибок по типу и коду. Чтобы просмотреть количество ошибок с течением времени или просмотреть распределение ошибок, выберите круговую диаграмму.

Помимо ошибок клиента HTTP (400, 401 и 403), могут появиться следующие ошибки:

• Недопустимый идентификатор приложения — указанный идентификатор приложения не существует в вашем клиенте или недействителен.
• Сбой Microsoft Entra — не удалось получить маркер Microsoft Entra.
• Определение не найдено — внешний вызов был удален, но он по-прежнему ссылается в правиле.
• Время ожидания — запрос к целевому объекту занял больше времени ожидания, чем указанное время ожидания.
• сбой связи . Подключение к целевому объекту невозможно сделать из-за проблемы с сетью или из-за недоступности целевого объекта.
• Автоматический выключатель — если внешний вызов неоднократно терпел неудачу и превысил определенный порог, все дальнейшие вызовы приостанавливаются на короткий промежуток времени.
• Неизвестный сбой — произошла внутренняя ошибка Dynamics 365.