Gestisci regole

Importante

A partire dal 3 febbraio 2025, Dynamics 365 Fraud Protection non è più disponibile per l'acquisto. Il supporto per la protezione delle frodi terminerà il 3 febbraio 2026. Per altre informazioni, vedere l'articolo Fine del supporto per Dynamics 365 Fraud Protection.

Microsoft Dynamics 365 Fraud Protection offre la flessibilità necessaria per creare regole che usano il punteggio generato dal modello di intelligenza artificiale all'avanguardia di Fraud Protection insieme ai parametri aggiuntivi del payload della richiesta. In base a questi input, le regole possono convertire una valutazione in una decisione, ad esempio Approva, Rifiuta, Rivedi o Verifica.

Se l'istanza di Fraud Protection include più ambienti, è possibile gestire le regole in un ambiente specifico usando lo switcher dell'ambiente. Se l'ambiente ha ambienti padre, le regole nell'ambiente padre di primo livello vengono valutate per prime. Se le impostazioni delle regole per l'ambiente padre di primo livello sono impostate su Esegui tutte le regole di corrispondenza fino a quando non viene presa una decisione, le regole nell'ambiente padre di secondo livello vengono valutate successivamente. Questo processo continua a meno che le impostazioni delle regole per un ambiente non siano impostate su Esegui solo la prima regola corrispondente o fino a quando non vengono valutate tutte le regole per l'ambiente padre e l'ambiente corrente.

Definizione di una regola: Guida introduttiva

Le regole sono costituite da clausole e sono definite dalle parole chiave RETURN e WHEN . Hanno la struttura di base seguente.

RETURN <decision>
WHEN <condition>

L'istruzione RETURN viene eseguita solo se l'istruzione WHEN restituisce True. L'istruzione RETURN termina l'esecuzione della regola e deve specificare una funzione decisionale valida: Approve, Reject, Challenge o Review. Ogni funzione decisionale accetta anche un parametro facoltativo, consentendo di esprimere il motivo della decisione. Per altre informazioni, vedere Funzioni decisionali.

Oltre a una decisione, l'istruzione RETURN può essere usata anche per scrivere dati nella risposta api o nella traccia di eventi. Per altre informazioni, vedere Funzioni di osservazione.

L'istruzione WHEN specifica una condizione booleana che determina se l'istruzione RETURN viene eseguita.

L'istruzione WHEN può usare uno degli elementi seguenti:

• Tutti gli attributi inviati nella richiesta API per la valutazione, inclusi i dati personalizzati. È possibile accedere a questi attributi con l'operatore @ . Ad esempio: @"user.userId".
• I punteggi generati dai modelli di intelligenza artificiale di Fraud Protection. Ad esempio: @"riskscore".
• Elenchi che hai caricato su Protezione frodi. Per altre informazioni su come caricare gli elenchi, vedere Gestire elenchi. Per altre informazioni sul riferimento a questi elenchi nelle regole, vedere Uso degli elenchi nelle regole.
• Velocità definite in Protezione dalle frodi. Per altre informazioni, vedere Eseguire controlli della velocità.
• Le chiamate esterne che hai creato nella Protezione da Frodi. Per altre informazioni, vedere Chiamate esterne.
• Le funzioni che hai creato in Protezione frodi. Per ulteriori informazioni, vedere la sezione Funzioni.

Le espressioni possono essere confrontate usando operatori di confronto (ad esempio ==, !=, >, <), e possono essere combinati usando operatori logici come e (&&) e ( ||).

Per altre informazioni sulla sintassi delle regole, vedere la Guida di riferimento al linguaggio.

Visualizzazione visiva

Usare la modalità visiva per scrivere regole in modo rapido e semplice usando gli attributi del payload della richiesta.

1. Per creare regole visive, selezionare + Nuova clausola.
2. Selezionare Visualizzazione visiva accanto al nome della clausola.
3. È possibile aggiungere più filtri alla clausola e scegliere gli attributi dal menu a discesa.
4. Tornare alla Vista Codice per visualizzare e modificare le regole nel Linguaggio di Interrogazione per Frodi. Dopo aver modificato la regola nella visualizzazione codice, non è possibile tornare alla visualizzazione visiva.

L'immagine seguente mostra la visualizzazione visiva delle regole e il pulsante Visualizzazione codice che è possibile selezionare per modificare la visualizzazione.

L'immagine seguente mostra la visualizzazione codice delle regole e il pulsante Visualizzazione visiva che è possibile selezionare per modificare la visualizzazione.

Esempi di regole

RETURN Reject("high score")
WHEN @"riskScore" > 900

RETURN Review("medium score")
WHEN @"riskScore" <= 900 and @"riskScore" > 400

RETURN Approve(), Other(ip=@"device.ipAddress")
WHEN @"user.countryRegion" == "US"

RETURN Reject("user on block list")
WHEN ContainsKey("Email Block List", "Emails", @"user.email")

RETURN Review()
WHEN @"user.email".EndsWith(“@contoso.com”)

Scheda Regole

È possibile creare regole personalizzate e gestire le regole esistenti nella scheda Regole .

• Per creare e gestire regole correlate agli acquisti, selezionare Acquista e quindi selezionare la scheda Regole .
• Per creare e gestire regole correlate agli account, selezionare Creazione account o Account di accesso e quindi selezionare la scheda Regole .
• Per creare e gestire regole correlate a una valutazione personalizzata, selezionare Valutazioni personalizzate, selezionare una valutazione personalizzata e quindi selezionare la scheda Regole .

La scheda Regole mostra un elenco delle regole configurate per un tipo di valutazione. Queste regole sono suddivise in due sezioni: Regole pubblicate e Bozze. Per informazioni sulle bozze, vedere la sezione Bozze più avanti in questo articolo.

È possibile visualizzare le informazioni seguenti per ogni regola o bozza:

• Nome
• La condizione che hai creato
• Stato: Attivo o Inattivo

È anche possibile selezionare il riquadro per ogni regola per espanderlo e visualizzare informazioni aggiuntive. Ecco alcuni esempi:

• Descrizione
• Numero di clausole nella regola
• Chi ha aggiornato per ultimo la regola
• Data dell'ultimo aggiornamento della regola

Annotazioni

Nella scheda Regole le regole pubblicate sono elencate nell'ordine in cui vengono eseguite.

Impostazioni delle regole

È possibile accedere alle impostazioni della regola nella scheda Regole per una valutazione specifica. È possibile modificare il comportamento di valutazione delle regole e il payload di esempio. Queste modifiche si applicano alle regole solo per la valutazione che stai modificando.

Comportamento di valutazione delle regole

È possibile aggiornare la modalità di valutazione delle regole. Se si seleziona Esegui la prima regola corrispondente, viene valutata una sola regola per transazione. Se tale regola non restituisce una decisione, non vengono valutate altre regole e viene restituita una decisione predefinita approvazione . Se si seleziona Esegui tutte le regole di corrispondenza fino a quando non viene presa una decisione, è possibile valutare più regole per una singola transazione. Se la prima regola valutata non restituisce una decisione, ogni regola di corrispondenza successiva viene valutata fino a quando non viene restituita una decisione.

Payload di esempio

Nel riquadro Impostazioni payload è possibile definire il payload di esempio per il tipo di valutazione. Il payload di esempio è destinato a contenere un esempio dei campi inviati nell'API di richiesta per la valutazione e che possono essere usati nella regola.

Nella richiesta API è possibile scegliere di non inviare campi facoltativi dallo schema di valutazione. In alternativa, è possibile scegliere di inviare campi personalizzati aggiuntivi. In entrambi i casi assicurarsi di aggiornare l'esempio di payload visualizzato nel riquadro Impostazioni payload , in modo che rifletta i campi specifici inviati.

Questo esempio di payload viene mostrato ogni volta che viene creata una nuova regola per la valutazione (vedere la sezione Esempio di payload più avanti in questo articolo). Tutte le modifiche apportate si applicano solo alle regole create da quel momento in poi.

Per annullare tutte le modifiche apportate dall'utente o da altri utenti all'esempio di payload e restituirlo all'esempio di payload predefinito del sistema, selezionare Ripristina.

Componenti di una regola

Una regola è costituita dai componenti seguenti:

• Nome e descrizione che descrivono lo scopo della regola
• Stato corrente della regola: Attivo o Inattivo
• Esempio di campi che consentono di scrivere e valutare la regola
• Componenti che consentono di creare la logica che approva automaticamente, rifiuta, sfida o esamina gli eventi:
  • Una condizione
  • Uno o più dei tipi di clausole seguenti:
    • Prima di tutte le clausole di assegnazione dei punteggi
    • Clausole successive al bot-scoring
    • Clausole di assegnazione dei punteggi post-rischio

Una regola pubblicata può anche avere una versione bozza.

Nome e descrizione

Quando si crea una regola, è possibile aggiungere un nome e una descrizione per aiutare se stessi e il team a identificare facilmente la regola. I nomi delle regole devono essere univoci e non sono sensibili alle maiuscole e minuscole.

stato

Quando si crea una regola per la prima volta, lo stato viene impostato su Bozza solo prima della pubblicazione.

Quando si pubblica una regola, è possibile impostare lo stato su Attivo o Inattivo.

• Se una regola è attiva, influisce sul traffico di produzione in tempo reale e tutti gli eventi vengono valutati rispetto alla regola.
• Se una regola è inattiva, non influisce sul traffico di produzione.

Quando si modifica una regola pubblicata in precedenza, la regola viene salvata con lo stato Attivo (con bozza) o Inattivo (con bozza), a seconda dello stato della regola pubblicata.

Esempi

Quando si crea o si modifica una regola, il riquadro Esempio viene visualizzato sul lato destro della pagina. Questo riquadro include due sezioni: una per l'esempio di payload e una per l'esempio di punteggio.

Per visualizzare le variabili di esempio usate nella regola, selezionare Mostra variabili usate.

Esempio di payload

L'esempio di payload contiene un esempio dei campi che possono essere inviati nell'API di richiesta per la valutazione, come definito nel riquadro Impostazioni payload. Questi campi possono essere usati come variabili nella regola.

Esempio di punteggio

L'esempio di punteggio contiene punteggi generati dai modelli di intelligenza artificiale di Fraud Protection. È possibile fare riferimento alle variabili di punteggio nelle regole dopo aver eseguito il modello di intelligenza artificiale associato e generare il punteggio. Ad esempio, è possibile usare @"botScore" dopo l'esecuzione della valutazione del bot ed è possibile usare @"riskScore" dopo l'esecuzione della valutazione del rischio. Per ulteriori informazioni, vedere la sezione Clausole che si trova più avanti in questo articolo.

Modifica dell'esempio

Per verificare che la regola funzioni per vari eventi, è possibile modificare l'esempio in base alle esigenze e quindi valutare i dati di esempio rispetto alla regola. È possibile modificare tutti i valori nel campione di payload e nell'esempio di punteggio. Quando si modifica un esempio, le modifiche non influiscono sui dati inviati (o non inviati) a Protezione dalle frodi.

Quando si pubblica una regola, tutte le modifiche apportate all'esempio vengono salvate e rese persistenti come parte della regola.

Per annullare tutte le modifiche apportate dall'utente o da altri utenti all'esempio, selezionare Ripristina. L'esempio di punteggio viene ripristinato al campione di punteggio predefinito del sistema e l'esempio di payload viene ripristinato all'esempio di payload definito dall'utente nel riquadro Impostazioni payload.

Condizioni

Le condizioni iniziano con la parola chiave WHEN e sono seguite da un'espressione booleana che valuta un'istruzione su True o False. È possibile creare una condizione per determinare quale regola viene valutata e per raggruppare la logica di business correlata. Ad esempio, la condizione seguente è correlata alle transazioni digitali del prodotto.

WHEN @"productList.type" == "Digital"

È quindi possibile creare clausole che configurano una strategia di frode correlata alle transazioni digitali del prodotto.

L'aggiunta di una condizione a una regola è facoltativa. Se si vuole applicare una regola a tutti gli eventi, non aggiungere una condizione. Per informazioni su come usare le condizioni per ordinare le regole, vedere la sezione Ordinamento delle regole più avanti in questo articolo.

Clausole

Le clausole contengono la logica di frode e i criteri di business rilevanti per il segmento di traffico definito nella condizione. Le clausole usano valori nel payload dell'evento insieme ai punteggi di intelligenza artificiale di Fraud Protection per accettare, rifiutare, esaminare o verificare gli eventi. Ogni regola deve contenere almeno una clausola e ogni nome univoco viene assegnato a ogni clausola. È possibile selezionare il nome per personalizzarlo.

Le clausole hanno la struttura di base seguente.

RETURN <decision> 
WHEN <condition is true>

È possibile usare questa struttura per creare una clausola che restituisce una decisione di approvazione, rifiuto, richiesta di verifica o revisione. È quindi possibile aggiungere parametri facoltativi che inviano altre informazioni sulla decisione.

Tutti gli elementi dopo la parola chiave WHEN devono essere valutati su True o False. Questa espressione booleana può essere costituita da valori del payloaddell'evento, degli elenchi definiti dall'utente e del bot e dei punteggi di rischio basati sull'intelligenza artificiale.

Per informazioni sulla sintassi per le clausole, vedere la Guida di riferimento al linguaggio.

Quando viene attivata una clausola , ovvero quando l'istruzione WHEN restituisce True, viene restituita la decisione specificata nell'istruzione RETURN e non vengono eseguite clausole successive.

Se una condizione corrisponde alla decisione ma non attiva una clausola, la regola viene quindi eseguita.

RETURN Approve("NO_CLAUSE_HIT")

Le clausole vengono eseguite in sequenza nell'ordine in cui vengono visualizzate nella scheda Regole . È possibile usare i pulsanti freccia sul lato destro di una clausola per modificarne la posizione nell'elenco.

Le clausole sono organizzate in sezioni. I modelli di intelligenza artificiale vengono eseguiti in base a queste sezioni e generano un punteggio come parte della valutazione. Le sezioni differiscono per valutazione e indicano quando la clausola viene eseguita in relazione al modello di intelligenza artificiale.

• Per la protezione degli acquisti, viene eseguito un modello di rischio di intelligenza artificiale che genera un punteggio di rischio per la transazione. Di conseguenza, queste regole contengono clausole di assegnazione dei punteggi antecedenti a qualsiasi valutazione e clausole di assegnazione dei punteggi successive alla valutazione del rischio.
• Per la protezione degli account, viene eseguito un modello di bot oltre a un modello di rischio. Questi modelli generano rispettivamente un punteggio del bot e un punteggio di rischio. Di conseguenza, queste regole contengono clausole precedenti a qualsiasi punteggio, clausole successive alla valutazione del bot e clausole successive alla valutazione del rischio.
• Per le valutazioni personalizzate, non vengono eseguiti modelli di intelligenza artificiale e queste regole contengono solo clausole che precedono qualsiasi valutazione.
• Le valutazioni create tramite la procedura guidata di valutazione non prevedono clausole antecedenti alla valutazione e clausole successive alla valutazione. Tutte le clausole vengono invece eseguite in sequenza (dall'alto verso il basso) in base all'ordine in cui sono elencate nella regola.

Clausole prima di tutte le assegnazioni di punteggio

Le clausole che precedono tutte le assegnazioni di punteggio vengono eseguite prima che i modelli di intelligenza artificiale di Fraud Protection siano eseguiti. Di conseguenza, vengono eseguiti prima che siano stati generati i punteggi di valutazione del bot o dei rischi. Queste clausole possono usare qualsiasi combinazione di campi inviati come parte del payload dell'evento e contenuti negli elenchi. Possono essere configurati per implementare l'embargo, il geofencing o altri criteri aziendali.

L'esempio seguente consente di esaminare gli acquisti quando gli utenti acquistano un prodotto in un mercato al di fuori della loro posizione geografica.

RETURN Review("location inconsistency") 
WHEN Geo.MarketCode(@"device.ipAddress") != "@productList.market"

In questa sezione è anche possibile scrivere una clausola negli elenchi di riferimenti incrociati. Ad esempio, se si dispone di un elenco personalizzato denominato Messaggi di posta elettronica rischiosi, la clausola seguente rifiuta gli eventi se l'indirizzo di posta elettronica dell'utente viene visualizzato nell'elenco.

RETURN Reject ("risky email") 
WHEN ContainsKey ("Risky Emails", "Emails", @"user.email")

Per informazioni sulla sintassi usata per fare riferimento agli elenchi nelle regole, vedere la Guida di riferimento al linguaggio.

Clausole successive alla valutazione bot

Le clausole successive alla valutazione dei bot vengono eseguite dopo che i modelli di intelligenza artificiale di Fraud Protection generano un punteggio del bot per un evento. Questo punteggio rappresenta la probabilità che un bot ha avviato l'evento. È un numero compreso tra 0 e 999. Un punteggio più alto indica una probabilità del bot più elevata.

Nelle clausole di punteggio post-bot, puoi usare questo punteggio insieme ai campi del payload e alle liste per prendere decisioni. Per fare riferimento a questo punteggio, usare la variabile @botScore . Ad esempio, la clausola seguente rifiuta gli eventi di un dominio di posta elettronica specifico con un punteggio bot superiore a 700.

RETURN Reject()
WHEN @"user.email".EndsWith("@contoso.com") && @"botScore" > 700

Clausole post-valutazione del rischio

Le clausole post-valutazione del rischio vengono eseguite dopo che i modelli di intelligenza artificiale di Fraud Protection generano un punteggio di valutazione dei rischi per un evento. Questo punteggio è un numero compreso tra 0 e 999. Un punteggio più alto indica un rischio percepito più alto.

Nelle clausole di assegnazione dei punteggi post-rischio è possibile usare questo punteggio insieme ai campi del payload e degli elenchi per prendere decisioni. Per fare riferimento a questo punteggio, usare la variabile @riskScore . Ad esempio, la clausola seguente rifiuta transazioni costose con un punteggio di rischio maggiore di 700.

RETURN Reject("high price and risk score")
WHEN @purchasePrice >= 199.99 && @riskScore > 700

Bozze

Una regola può avere sia una versione pubblicata che una versione bozza . Entrambe le versioni possono essere visualizzate come schede affiancate nella scheda Regole .

La versione pubblicata è di sola lettura e può essere visualizzata da chiunque. La versione bozza è visibile solo al relativo autore. Le bozze possono essere modificate e tutte le modifiche vengono salvate automaticamente.

• Per eliminare la bozza, selezionare Elimina.
• Per pubblicare la bozza, selezionare Pubblica.

Quando si pubblica una bozza, Fraud Protection sovrascrive la versione pubblicata della regola con la versione bozza.

Ordinamento delle regole

Nella scheda Regole viene visualizzato un elenco delle regole pubblicate configurate per la valutazione. L'ordine in cui sono elencate le regole influisce sull'ordine in cui vengono valutate. Per riordinare le regole, trascinare una regola nella posizione desiderata e quindi selezionare Salva.

Un evento viene valutato in base a ogni condizione della regola, in ordine, fino a quando una condizione non restituisce True. Ogni clausola nella regola selezionata viene quindi valutata. Se una di queste clausole restituisce una decisione, non vengono valutate altre regole. Se nessuna di queste clausole restituisce una decisione, la transazione viene approvata per impostazione predefinita o la successiva regola pubblicata con una condizione di corrispondenza viene valutata. Il comportamento dipende dal comportamento di valutazione delle regole selezionato nelle impostazioni della regola.

Crea una nuova regola

È possibile creare regole che prendono decisioni relative agli eventi di acquisto, creazione di account e accesso all'account.

Importante

Per impostazione predefinita, quando viene pubblicata una nuova regola, viene visualizzata nella parte inferiore dell'elenco nella sezione Regole pubblicate della scheda Regole . Per informazioni su come riposizionare la regola, vedere la sezione Modificare l'ordine di una regola più avanti in questo articolo.

1. Nella scheda Regole selezionare Nuova regola.

   Viene creata una bozza di regola. Tutte le modifiche apportate alle bozze vengono salvate automaticamente.

2. Selezionare Rinomina e quindi immettere un nome e una descrizione.

3. Aggiungere una condizione alla regola.

4. Aggiungere clausole per esprimere i criteri aziendali e le strategie di frode.

   • Per creare una nuova clausola da zero, selezionare Nuova clausola nella sezione della clausola appropriata.
   • È anche possibile iniziare da un modello di clausola esistente selezionando la freccia a destra della clausola New. Per visualizzare un elenco completo dei modelli e il relativo contenuto, selezionare Visualizza tutto.

5. Per valutare la regola e assicurarsi che funzioni come previsto, selezionare Espandi in basso a destra nella scheda Regole per aprire il riquadro di valutazione delle regole.

6. Per pubblicare la regola, selezionare Pubblica. Nella finestra di dialogo di conferma modificare il nome, la descrizione e lo stato e quindi selezionare Pubblica.

7. Impostare lo stato su Attivo o Inattivo.

8. Per riposizionare la regola nell'elenco nella scheda Regole , selezionare la regola, trascinarla nella nuova posizione e quindi selezionare Salva ordine.

Regole definite dal sistema (impostazione predefinita)

La protezione delle frodi può creare regole per ogni ambiente. Ad esempio, è possibile creare la regola predefinita seguente.

• Regola di supporto predefinita

Alcune funzionalità di protezione da frodi si basano sulle regole predefinite. Dopo aver aggiunto un messaggio di posta elettronica, un indirizzo IP o un altro contenuto dell'elenco noto a un elenco di supporto (sicuro, monitoraggio o rifiuto), questa regola predefinita garantisce che gli elenchi vengano controllati durante la valutazione.

È possibile modificare, eliminare e disattivare regole definite dal sistema. Come procedura consigliata, provare a creare o modificare una regola diversa, a meno che non si voglia modificare il comportamento predefinito.

Regole di valutazione (impostazione predefinita)

Ogni modello di valutazione indicato nel passaggio Seleziona modello della procedura guidata Valutazione è predefinito con una o entrambe le regole predefinite seguenti:

• Regola modello di esempio: questa regola contiene una serie di clausole di esempio che fungono da blocchi predefiniti per definire la propria logica per prendere decisioni in base a valori come il punteggio di rischio, il punteggio del bot e gli attributi del dispositivo, se applicabile. Nessuna di queste clausole prende decisioni per impostazione predefinita, tuttavia possono essere modificate rapidamente per farlo usando gli esempi forniti.
• Regola di elenco di supporto: questa regola è costituita da una serie di clausole che usano elenchi di supporto di Fraud Protection (safe, block, watch) per prendere decisioni informate (accettare, rifiutare, esaminare) in base alle entità in tali elenchi.

Se applicabile, queste regole predefinite vengono visualizzate come attive in Regole pubblicate immediatamente dopo la creazione di una valutazione. La tabella seguente è un riepilogo delle regole predefinite supportate dal modello di valutazione:

Modello	Regola modello	Regola della lista di supporto
Pagamento con carta	Sostenuto	Sostenuto
Creazione impronta digitale dispositivo	Sostenuto	Non disponibile
Programma fedeltà	Sostenuto	Sostenuto
Trasferimento di denaro	Sostenuto	Sostenuto
Pirateria informatica	Sostenuto	Sostenuto
Personalizzato	Non disponibile	Sostenuto

È possibile aggiungere manualmente regole e clausole aggiuntive a una valutazione negli ambienti radice e figlio.

Per richiamare i punteggi di rischio e bot di Fraud Protection dall'interno di una regola per una valutazione creata usando uno dei modelli, è necessario usare le funzioni del modello seguenti:

• Punteggio di rischio: Model.Risk().Score
• Punteggio bot: Model.Bot(@"deviceFingerprinting.id"). Punteggio

Filiali

I rami consentono di modificare in modo sicuro le regole senza influire su ciò che accade nell'ambiente di produzione. È possibile creare rami nella scheda Regole , in cui ogni ramo rappresenta una raccolta di regole. Il ramo predefinito è il ramo Production , ovvero il ramo delle regole che viene eseguito ogni volta che il traffico viene inviato a una valutazione.

Creare un ramo

Per creare un nuovo ramo, passare all'azione > Ramo Creare un nuovo ramo. È possibile assegnare un nome al ramo, specificare un nome API e selezionare le regole da copiare dal ramo di origine. Il ramo di origine è qualsiasi ramo in cui ci si trovava quando è stato selezionato Crea un nuovo ramo, produzione o altro. Nessuna bozza viene preservata nella fase di creazione di un branch.

Modificare le regole all'interno dei rami

Tutte le modifiche alle regole nei rami non di produzione non influiscono sullo stack di regole di produzione. È possibile modificare le regole normalmente e pubblicarle nel ramo, dove possono essere visualizzate da tutti gli utenti che hanno accesso alla pagina delle regole.

Test e esperimenti

Esistono due modi per testare il comportamento delle regole del branch: inviare direttamente il traffico a un branch e tracciare il traffico di produzione.

Inviare il traffico direttamente a un ramo

È possibile inviare traffico di test direttamente a un ramo specifico in una valutazione utilizzando l'endpoint dell'API del ramo disponibile in Azioni sul ramo > Informazioni sul ramo. Questo endpoint API usa la stessa struttura di payload della valutazione ed esegue lo stack di regole del branch.

Annotazioni

L'invio diretto del traffico a un ramo non ha alcun impatto sull'ambiente di produzione, quindi le velocità non vengono aggiornate e le transazioni di ramo non sono visibili nella ricerca.

Traffico di produzione ombra

È anche possibile testare il comportamento delle regole del ramo monitorando il traffico di produzione. Per nascondere il traffico di produzione, configurare e avviare un esperimento per un ramo selezionando Esegui esperimento. Quando un esperimento è in corso, è possibile visualizzarne le prestazioni nella scheda Monitoraggio passando al ramo in cui è in esecuzione l'esperimento. Quando un esperimento è in corso, i relativi parametri non possono essere modificati, ma è sempre possibile arrestare un esperimento per apportare modifiche e riavviarlo. Nella visualizzazione di navigazione del provider di servizi di pagamento (PSP), il menu a tendina Azioni ramo è visibile solo nella pagina delle regole e non in quella di monitoraggio.

Annotazioni

Il traffico ombreggiato eseguito nello stack di regole del ramo non ha alcun impatto sull'ambiente di produzione, quindi le velocità non verranno aggiornate due volte in seguito all'ombreggiatura, ma aggiornate una sola volta a seguito dell'esecuzione di produzione.

Promuovere i rami alla produzione

Se si vuole creare un ramo di produzione, è possibile farlo promuovendo un ramo in produzione. L'azione di promozione è disponibile in Azioni di ramo > Promuovi a produzione. Questa azione trasforma il ramo corrente in fase di promozione nel nuovo ramo di produzione. È possibile clonare le regole di produzione esistenti in un nuovo ramo per salvarle per riferimento. Le bozze vengono mantenute se è selezionata l'opzione di clonazione. Al termine dell'innalzamento di livello, il ramo di produzione viene aggiornato in modo da contenere le regole del ramo alzato di livello.

Annotazioni

La prima volta che si promuove un branch alla produzione per un'analisi, non è possibile clonare le regole di produzione esistenti in un nuovo branch. Se si desidera salvare le regole di produzione esistenti la prima volta che si promuove, creare un nuovo branch dalla produzione con tali regole per preservare le regole di produzione esistenti.

Gestire le regole esistenti

Nella scheda Regole è possibile eseguire le operazioni seguenti su una regola esistente:

• Rinominare
• Attivare o disattivare
• Elimina
• Modifica

Aggiornare il nome e la descrizione di una regola

Per aggiornare il nome e la descrizione di una regola, selezionare la regola, selezionare Rinomina e quindi immettere un nome e una descrizione univoci.

Modificare lo stato di una regola

Per modificare lo stato di una regola, selezionare la regola e quindi selezionare Attiva o Disattiva.

Eliminare una regola

Per eliminare una regola, selezionarla e quindi selezionare Elimina. Questa operazione non può essere annullata.

Modificare una regola esistente

Quando si modifica una regola pubblicata, Protezione frodi salva le modifiche come bozza finché non vengono pubblicate. Sia la versione pubblicata della regola selezionata che la versione bozza possono essere visualizzate come schede affiancate. Finché non viene pubblicata una bozza, è visibile solo alla persona che la crea. Per altre informazioni, vedere la sezione Bozze in precedenza in questo articolo.

1. Selezionare la regola e quindi selezionare Modifica.

   Viene visualizzata la scheda Bozza e la scheda Pubblicato .

2. Selezionare la scheda Bozza e quindi apportare le modifiche alla regola.

   La protezione dalle frodi salva automaticamente tutte le modifiche apportate alla regola.

   Per annullare le modifiche, selezionare Ignora. La protezione dalle frodi elimina la bozza ma mantiene la regola pubblicata originale.

3. Per pubblicare le modifiche, selezionare Pubblica.

   Quando si pubblica una bozza, Fraud Protection sovrascrive la versione originale pubblicata della regola con le modifiche apportate nella versione bozza.

   Se un compagno di squadra aggiorna e pubblica una regola mentre stai ancora modificandola, le tue modifiche potrebbero diventare obsolete. In questo caso, viene visualizzato un messaggio di avviso che chiede se si desidera comunque pubblicare le modifiche.

   • Se si seleziona Pubblica, le modifiche sovrascrivono tutte le modifiche apportate in precedenza.
   • Se si seleziona Annulla, è possibile esaminare le modifiche apportate da altre persone prima di pubblicare la versione.

Cercare una regola

Quando si cerca una regola, vengono cercati tutti i nomi e le descrizioni delle regole e i risultati vengono filtrati di conseguenza.

Per cercare una regola, immettere una parola chiave nel campo Cerca .

Per rimuovere un filtro, eliminare la parola chiave dal campo Cerca oppure selezionare la X sul lato destro del campo.

Modificare l'ordine di una regola

Poiché le regole pubblicate vengono visualizzate nella scheda Regole nell'ordine in cui vengono eseguite, la posizione di una regola pubblicata influisce in modo significativo sulla modalità di valutazione degli eventi.

Riordinare una regola pubblicata

1. Selezionare la regola pubblicata da spostare e trascinarla in una nuova posizione.
2. Ripetere il passaggio 1 per ogni regola da spostare e quindi selezionare Salva.
3. Per annullare le modifiche, selezionare Annulla.

Annotazioni

Non è possibile riordinare le regole nella sezione Bozze .

Valutare una regola

Prima di pubblicare la nuova regola, è possibile usare il riquadro di valutazione delle regole per assicurarsi che restituisca i risultati previsti.

• Per aprire il riquadro di valutazione delle regole, selezionare Espandi in basso a destra nella scheda Regole .
• Per chiudere il riquadro, seleziona Riduci.

Quando il riquadro di valutazione è aperto, è possibile controllare che la regola venga valutata rispetto all'esempio di payload corrente e al campione di punteggio. Quando si apportano modifiche all'esempio o alla regola stessa, il contenuto nel riquadro di valutazione viene aggiornato.

Il riquadro di valutazione mostra la decisione che Fraud Protection restituisce per l'evento di esempio. Vengono inoltre visualizzati tutti i valori associati alla risposta, ad esempio un motivo o un messaggio di supporto. La clausola che attiva la decisione è descritta in verde all'esterno del riquadro.

Se l'esempio di payload non corrisponde alla condizione, la regola non viene valutata. Se la condizione corrisponde, ma nessuna delle clausole attiva una restituzione, la decisione predefinita è Approva e il motivo è NO_CLAUSE_HIT.

Esempio di valutazione

Creare una regola con le tre clausole seguenti.

`// Approves when email from contoso domain has been validated`
`RETURN Approve()`
`WHEN @"email.isEmailValidated" == true && @"email.emailValue".EndsWith("@contoso.com")`

`// Rejects when email has not been validated and high risk score`
`RETURN Reject()`
`WHEN @"email.isEmailValidated" == false && @"riskscore" > 700`

`// Reviews when email has not been validated and medium risk score`
`RETURN Review()`
`WHEN @"email.isEmailValidated" == false && @"riskscore" > 400`

L'esempio di payload contiene l'oggetto seguente.

"email": {
    "email": "Primary",
    "emailValue": "kayla@contoso.com",
    "isEmailValidated": true,
    "emailValidatedDate": "2020-02-25T15:12:26.9733817-08:00",
    "isEmailUsername": true
},

L'esempio di punteggio contiene il valore seguente.

"riskScore": 500,

Quando il riquadro di valutazione viene espanso, viene attivata la clausola 1 e viene restituita una decisione di Approvazione .

Nel payload di esempio si modifica il valore del campo isEmailValidated nel payload da true a false.

"isEmailValidated": false,

In questo caso, viene attivata la clausola 2 e viene restituita una decisione di revisione .

Nel punteggio di esempio, se si modifica il valore di "riskScore" da 500 a 700, viene attivata la clausola 3 e la decisione viene aggiornata a Reject.In the sample score, if you change the value of "riskScore" from 500 to 700, clause 3 is triggered, and the decision is updated to Reject.