외부 평가

외부 평가는 다른 평가에서 평가를 호출하는 메커니즘입니다. 외부 평가는 평가 자체가 아닙니다. 대신 데이터를 보내고 대상 평가에서 응답을 받을 수 있는 데이터 원본처럼 작동합니다. 평가에는 다음 두 가지 가능한 공유 설정 중 하나가 있을 수 있습니다.

• 프라이빗: 평가의 루트 환경에서만 액세스할 수 있습니다.
• 공유: 테넌트 내의 모든 환경에서 액세스할 수 있습니다.

외부 평가는 동일한 루트 환경에서 사용할 수 있는 프라이빗 평가 또는 테넌트의 루트 환경에서 사용할 수 있는 공유 평가를 가리킬 수 있습니다.

참고 항목

평가의 공유 설정을 비공개에서 공유 또는 공유에서 비공개로 변경하는 방법에 대한 자세한 내용은 평가 구성 개요를 참조하세요.

외부 평가를 설정한 후 해당 환경의 모든 평가에서 규칙을 통해 호출할 수 있습니다.

프라이빗 평가의 경우: 환경 Y = 환경 X

공유 평가의 경우: 환경 Y = 동일한 테넌트 내의 모든 루트 환경

호출 평가는 외부 평가를 통해 비공개 또는 공유 평가를 호출하는 모든 평가를 나타냅니다. 호출 평가에는 외부 평가 규칙이 설정되어 있어야 합니다. 규칙 조건이 충족되면 규칙은 외부 평가를 호출하고 구성된 작업을 수행합니다. 외부 호출과 마찬가지로 외부 평가는 자식에 의해 상속되지 않습니다. 규칙에서 외부 평가를 사용하려면 외부 평가를 호출하려는 환경에서 설정해야 합니다.

외부 평가 만들기

외부 평가를 만들려면 먼저 이 작업을 수행할 수 있는 권한이 있는지 확인합니다. 사용자 역할 및 권한에 대한 자세한 내용은 사용자 역할 및 액세스를 참조 하세요.

1. 사기 방지 포털의 왼쪽 탐색 영역에서 외부 평가를 선택한 다음 + 새 외부 평가를 선택합니다.
2. 새 외부 평가 페이지에서 다음 필드를 설정합니다.

• 호출 할 대상 평가 – 드롭다운에서 동일한 루트 환경에서 설정된 모든 프라이빗 평가와 사용 가능한 공유 평가를 동일한 테넌트 루트 환경에서 설정할 수 있습니다. 대상으로 지정할 평가를 선택합니다.

참고 항목

외부 평가를 가리키려는 공유 평가가 드롭다운에 표시되지 않는 경우 평가의 공유 설정을 확인하고 공유로 설정되었는지 확인합니다. 공유 설정을 구성하는 방법에 대한 자세한 내용은 평가 구성 개요를 참조하세요.

• 이름 – 규칙에서 외부 평가를 참조하는 데 사용할 이름을 입력합니다. 이름에는 숫자, 문자 및 밑줄만 포함될 수 있습니다. 숫자로 시작할 수 없습니다.

참고 항목

규칙에서 사용한 후에는 외부 평가의 이름을 변경할 수 없습니다.

• 설명 – 팀이 외부 평가를 신속하게 식별하는 데 도움이 되는 설명을 추가합니다.
• 미리 볼 API – 샘플 코드를 미리 볼 API를 선택합니다. 샘플 코드는 규칙에서 이 공유 평가를 호출하는 데 사용할 수 있는 FQL입니다.

참고 항목

외부 평가를 사용하여 가리키는 공유 또는 개인 평가의 평가, 관찰 또는 레이블 API를 호출할 수 있습니다.

• 샘플 응답 – 이 섹션에는 대상 평가에서 예상되는 샘플 응답이 포함되어 있습니다. 표시되는 정보는 대상 평가 관리자가 수동으로 제공하며, 평가가 규칙에서 참조될 때 자동 완성에 대한 설명(도구 설명) 및 제안을 사용하도록 설정하는 데 사용됩니다.

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(평가, 관찰, 레이블)에 샘플 코드를 사용해야 합니다. 샘플 코드는 공유 평가로 보낼 수 있는 모든 필드를 표시합니다. 필수 필드는 코드에 다음과 같이 표시됩니다.

다음은 ExtAssessment1이라는 외부 평가의 평가 API를 호출하기 위한 또 다른 샘플 FQL입니다.

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 배열 및 개체를 사용하는 방법에 대한 자세한 내용은 언어 참조 가이드를 참조하세요.

참고 항목

외부 평가는 함수 내에서도 참조할 수 있습니다. 자세한 내용은 함수를 참조하세요.

사기 방지 포털에서 외부 평가 모니터링

Fraud Protection은 정의한 각 외부 평가에 대한 세 가지 메트릭을 포함하는 타일을 보여 줍니다.

• 초당 요청 수 - 총 요청 수를 선택한 시간 프레임의 총 시간(분)으로 나눈 값입니다.
• 평균 대기 시간 – 총 요청 수를 선택한 시간 프레임의 총 시간(분)으로 나눈 값입니다.
• 성공률 – 성공한 총 요청 수를 총 요청 수로 나눈 값입니다.

이 타일에 표시되는 숫자와 차트에는 페이지의 오른쪽 위 모서리에 있는 드롭다운 목록에서 선택한 시간 프레임에 대한 데이터만 포함됩니다.

참고 항목

메트릭은 외부 평가가 활성 규칙에서 사용되는 경우에만 표시됩니다.

• 외부 평가에 대한 데이터를 자세히 알아보려면 타일의 오른쪽 모서리에서 성능을 선택합니다. Fraud Protection은 메트릭에 대한 자세한 보기를 포함하는 새 페이지를 표시합니다.
• 지난 3개월 동안의 모든 시간 프레임에 대한 메트릭을 보려면 페이지 맨 위에 있는 날짜 범위 설정을 조정합니다.

앞에서 설명한 세 가지 메트릭 외에도 오류 차트도 표시됩니다. 이 차트에는 오류 유형 및 코드별 오류 수가 표시됩니다. 시간에 따른 오류 수를 보거나 오류 분포를 보려면 원형 차트를 선택합니다.

HTTP 클라이언트 오류(400, 401 및 403) 외에도 다음과 같은 오류가 표시될 수 있습니다.

• 잘못된 애플리케이션 ID – 제공된 애플리케이션 ID가 테넌트에 없거나 유효하지 않습니다.
• Microsoft Entra 실패 – Microsoft Entra 토큰을 검색할 수 없습니다.
• 정의를 찾을 수 없음 – 외부 호출이 삭제되었지만 여전히 규칙에서 참조됩니다.
• 시간 제한 – 대상에 대한 요청이 지정된 제한 시간보다 오래 걸렸습니다.
• 통신 실패 - 네트워크 문제 또는 대상을 사용할 수 없기 때문에 대상에 연결할 수 없습니다.
• 회로 차단기 – 외부 호출이 지속적으로 실패하고 특정 임계값을 초과하면 모든 추가 호출이 짧은 간격으로 일시 중단됩니다.
• 알 수 없는 오류 – 내부 Dynamics 365 오류가 발생했습니다.