Évaluations externes

L’évaluation externe est un mécanisme permettant d’appeler une évaluation à partir de n’importe quelle autre évaluation. Une évaluation externe n’est pas une évaluation en soi. Au lieu de cela, elle agit comme une source de données qui vous permet d’envoyer des données et de recevoir une réponse d’une évaluation cible. Une évaluation peut avoir l’un des deux paramètres de partage possibles :

• Privé : accessible uniquement dans l’environnement racine de l’évaluation.
• Partagé : accessible dans tous les environnements du locataire.

Les évaluations externes peuvent pointer vers n’importe quelle évaluation privée disponible dans le même environnement racine, ou toute évaluation partagée disponible dans n’importe quel environnement racine du locataire.

Remarque

Pour plus d’informations sur la façon de modifier le paramètre de partage d’une évaluation de Private to Shared ou Shared to Private, reportez-vous à la vue d’ensemble de la configuration de l’évaluation.

Après avoir configuré une évaluation externe, elle peut être appelée par le biais d’une règle à partir de n’importe quelle évaluation dans cet environnement.

Pour l’évaluation privée : Environnement Y = Environnement X

Pour l’évaluation partagée : Environnement Y = Tout environnement racine au sein du même locataire

Une évaluation d’appel fait référence à toute évaluation qui appelle une évaluation privée ou partagée par le biais d’une évaluation externe. L’évaluation des appels doit avoir une règle d’évaluation externe configurée. Lorsque la condition de règle est remplie, la règle appelle l’évaluation externe et effectue les actions configurées. Comme pour les appels externes, les évaluations externes ne sont pas héritées par les enfants. Pour utiliser une évaluation externe dans une règle, vous devez configurer l’évaluation externe dans l’environnement à partir duquel vous souhaitez l’appeler.

Créer une évaluation externe

Pour créer une évaluation externe, vérifiez d’abord que vous disposez de l’autorisation appropriée pour effectuer cette opération. Pour plus d’informations sur les rôles d’utilisateur et les autorisations, consultez Rôles d’utilisateur et accès

1. Dans le portail Fraud Protection, puis dans la navigation gauche, sélectionnez Évaluations externes, puis + Nouvelle évaluation externe.
2. Sur la page Nouvelle évaluation externe, définissez les champs suivants :

• Évaluation cible à appeler : dans la liste déroulante, vous pouvez voir toutes les évaluations privées, configurées dans le même environnement racine, ainsi que toutes les évaluations partagées disponibles, configurées dans n’importe quel environnement racine du même locataire. Sélectionnez l’évaluation que vous souhaitez cibler.

Remarque

Si l’évaluation partagée à laquelle vous souhaitez pointer votre évaluation externe n’apparaît pas dans la liste déroulante, vérifiez le paramètre de partage de l’évaluation et vérifiez qu’il est défini sur Partagé. Pour en savoir plus sur la configuration du paramètre de partage, reportez-vous à la vue d’ensemble de la configuration de l’évaluation.

• Nom : saisissez le nom que vous utiliserez pour faire référence à l’évaluation externe à partir de vos règles. Le nom ne peut contenir que des chiffres, des lettres et des traits de soulignement. Il ne peut pas commencer par un chiffre.

Remarque

Vous ne pouvez pas modifier le nom d’une évaluation externe après l’avoir utilisé dans une règle.

• Description : ajoutez une description pour aider votre équipe à identifier rapidement l’évaluation externe.
• API à prévisualiser : sélectionnez l’API pour laquelle vous souhaitez prévisualiser l’exemple de code. L’exemple de code est le FQL que vous pouvez utiliser dans une règle pour appeler cette évaluation partagée

Remarque

Vous pouvez utiliser l’évaluation externe pour appeler l’API d’évaluation, d’observation ou d’étiquette de l’évaluation partagée ou privée vers laquelle il pointe.

• Exemple de réponse : cette section contient l’exemple de réponse attendu de l’évaluation cible. Les informations affichées sont fournies manuellement par l’administrateur d’évaluation cible et sont utilisées pour activer les descriptions (info-bulles) et les suggestions de saisie semi-automatique lorsque l’évaluation est référencée dans une règle.

3. Lorsque vous avez terminé de définir les champs requis, sélectionnez Créer.

Appeler une évaluation externe

Pour utiliser vos évaluations externes, référencez-les à partir de vos règles. Par exemple, pour référencer une évaluation externe nommée myAssessment dans votre règle, utilisez la syntaxe suivante :

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

Dans l’exemple ci-dessus, $baseInput = @@ mappera tous les champs nécessaires à l’évaluation partagée/externe à partir de la charge utile de l’évaluation d’appel. Vous pouvez également mapper des champs spécifiques uniquement. Vous pouvez également définir les actions que vous souhaitez que la règle entreprenne en fonction des informations qu’elle recevra en retour de l’appel d’évaluation externe.

Par exemple,

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

Vous pouvez configurer une règle pour appeler l’évaluation externe soit en utilisant le modèle de règle Utiliser une évaluation externe, soit en copiant/collant l’exemple FQL depuis la page d’évaluation externe. Veillez à utiliser l’exemple de code de l’API (évaluer, observer, étiquette) que vous souhaitez appeler. L’exemple de code affichera tous les champs qui peuvent être envoyés à l’évaluation partagée. Les champs obligatoires sont marqués comme tels dans le code.

Voici un autre exemple de FQL pour appeler l’API d’évaluation d’une évaluation externe nommée 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)

Vous pouvez également accéder à l’objet de diagnostic dans les règles, ce qui vous permet de découvrir des informations de diagnostic et de débogage importantes à partir de la réponse d’une évaluation externe. L’objet diagnostics contient la charge utile de requête, le code HttpStatus, le message d’erreur et la latence. L’objet diagnostics doit d’abord être créé à l’aide de sa méthode d’extension correspondante, ». GetDiagnostics()", avant que les champs de l’objet ne puissent être utilisés dans les règles.

Voici un exemple de règle utilisant l’objet diagnostics sur la réponse d’une évaluation externe nommée ExtAssessment2 :

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

Les appels externes et les évaluations externes peuvent nécessiter des objets structurés complexes dans le cadre de leur schéma de requête. Pour plus d’informations sur l’utilisation de tableaux et d’objets JSON, reportez-vous au guide de référence du langage.

Remarque

Les évaluations externes peuvent également être référencées dans Functions. Pour plus d’informations, consultez Fonctions.

Surveiller les évaluations externes dans le portail De protection contre les fraudes

Fraud Protection présente une vignette contenant trois éléments de mesure pour chaque évaluation externe que vous définissez :

• Requêtes par seconde : le nombre total de requêtes divisé par le nombre total de minutes dans le délai d’exécution sélectionné.
• Latence moyenne : le nombre total de requêtes divisé par le nombre total de minutes dans le délai d’exécution sélectionné.
• Taux de réussite : nombre total de demandes réussies divisées par le nombre total de demandes effectuées.

Les chiffres et les graphiques affichés sur cette vignette incluent uniquement les données du délai d’exécution que vous sélectionnez dans la liste déroulante dans le coin supérieur droit de la page.

Remarque

Les métriques s’affichent uniquement lorsque votre évaluation externe est utilisée dans une règle active.

• Pour approfondir l’étude des données relatives à votre évaluation externe, sélectionnez Performances dans le coin droit de la tuile. Fraud Protection affiche une nouvelle page offrant une vue plus détaillée des métriques.
• Pour afficher les métriques pour n’importe quelle délai d’exécution au cours des trois derniers mois, ajustez le paramètre Plage de dates en haut de la page.

En plus des trois métriques décrites précédemment, un graphique Erreur est également affiché. Ce graphique affiche le nombre d’erreurs, par type d’erreur et par code. Pour afficher le nombre d’erreurs au fil du temps ou pour afficher la distribution des erreurs, sélectionnez Diagramme circulaire.

En plus des erreurs du client HTTP (400, 401 et 403), vous pouvez voir les erreurs suivantes :

• ID d’application non valide : l’ID d’application qui a été fourni n’existe pas dans votre client ou il n’est pas valide.
• Échec de Microsoft Entra : le jeton Microsoft Entra n’a pas pu être récupéré.
• Définition introuvable : l’appel externe a été supprimé, mais il est toujours référencé dans une règle.
• Délai d’exécution : la requête adressée à la cible a pris plus de temps que le délai d’expiration spécifié.
• Échec de la communication : aucune connexion n’a pu être établie avec la cible en raison d’un problème réseau ou parce que la cible n’est pas disponible.
• Disjoncteur : si l’appel externe a échoué en continu et dépassé un certain seuil, tous les appels supplémentaires sont suspendus pendant un court intervalle.
• Échec inconnu : une défaillance interne de Dynamics 365 s’est produite.