Поделиться через

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

  • Статья

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

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

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

Примечание.

Дополнительные сведения о том, как изменить параметр общего доступа для оценки с приватного на общий или общий общий, см. в обзоре конфигурации оценки.

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

Внешний поток оценки

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

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

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

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

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

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

Примечание.

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

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

Примечание.

Вы не можете изменить имя внешней оценки после его использования в правиле.

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

Примечание.

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

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

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

Чтобы использовать внешние оценки, обратитесь к ним из правил. Например, чтобы ссылаться на внешнюю оценку с именем 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: "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)

Вы также можете получить доступ к объекту диагностика в правилах, что позволяет обнаруживать важные диагностические и отладочные сведения из ответа внешней оценки. Объект диагностика содержит полезные данные запроса, код 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.