--- title: "Configuring a new risk rule" slug: "ztp-configure-risk-rule" updated: 2026-09-09T17:22:27Z published: 2026-09-09T17:22:27Z canonical: "support.appgate.com/ztp-configure-risk-rule" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.appgate.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuring a new risk rule 1. In the ZTP Cloud Console, go to **Services** > **Risk Engine** and click **+ Add New**. ![](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ztp_user-guide_word-image-y96mhhye.jpg?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A45Z&se=2026-11-21T22%3A49%3A45Z&sr=b&sp=r&sig=9gqlPhdfNlbn6JYEh5bRQMHnloyc9ap1G0gPbXbYuvg%3D) 1. Enter a name and description for the new risk rule, select an adapter, and provide the required connection information. ![](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ztp_user-guide_word-image-xcn7c8qe.jpg?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A45Z&se=2026-11-21T22%3A49%3A45Z&sr=b&sp=r&sig=%2FukEmD5o41vaV5i9lnIJzBvShiz4rjhCbAh0Avh9FF4%3D) > [!NOTE] > NOTE > > Most adapters require a client ID and client secret from the third-party service provider to allow the Risk Engine to access that service. 1. **If you are configuring a rule for a CrowdStrike ZTA adapter**, you can optionally set the ***Score Retention*** fields: - Select the *Expire stale scores* checkbox. - Enter the number of days to retain scores in the ***Score Retention (Days)*** field. Maximum is 60. ![Form for adding a risk engine rule with highlighted score retention settings.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ztp_score_retention.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A45Z&se=2026-11-21T22%3A49%3A45Z&sr=b&sp=r&sig=VXVwgr7eHDGjjQucTQNunYPXRkerC%2Bi86CYQjElLDvU%3D) > [!NOTE] > NOTE > > Score retention applies only to devices no longer in CrowdStrike. For example, if a device is registered in CrowdStrike for 90 days and its score is unchanged, it will not be purged. 1. Click **Save**. 2. ZTP displays a default risk mapping—a conversion table that translates incoming data into AppGate risk levels. The following image shows the risk mapping for the OS Checker adapter. To modify the risk mapping, go to the ***Risk Mapping*** tab of the risk rule and click ***Edit Risk Mapping***. ![](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ztp_user-guide_word-image-19owwwle.jpg?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A45Z&se=2026-11-21T22%3A49%3A45Z&sr=b&sp=r&sig=nCAk%2Fu4EyFaiNoCQ%2FeV4%2FxwkvqXqLjjhdy0VK5kRc%2Bw%3D) 1. Before saving changes, you can preview the percentage of users that will fall under each risk range based on the current risk mapping values. Click **Test** in the upper right corner of the screen and review the Risk Rule Mapping Prediction. ![](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ztp_user-guide_word-image-26tene1u.jpg?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A45Z&se=2026-11-21T22%3A49%3A45Z&sr=b&sp=r&sig=xmXcf%2FJKRsoKrxfKDeDsYM1uC9MZTl6PfRz%2BVpGRgDI%3D) 1. To view detailed mapping prediction information for each protected device, click **Download Details** in the lower left corner of the **Risk Rule Mapping Prediction** window. The download includes the following fields: - Device ID - Username - IdP - Timestamp - Result - Current risk score - Client type - Client version - OS - Agent IDs - Hostname - MAC addresses - Test risk score 2. Click **Save**. To edit the main properties or delete a risk rule, click **Actions** in the upper right corner. ![](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ztp_user-guide_word-image-zrtz90cl.jpg?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A45Z&se=2026-11-21T22%3A49%3A45Z&sr=b&sp=r&sig=X34UAjs37BOUxHi6kvshkOPz9To3ZvWIEestVVoMqlA%3D)