From 43e14b6f417d8415c1a4b2d733fcfd72d4b4123e Mon Sep 17 00:00:00 2001 From: Maddy <130055405+Maddy-Cloudflare@users.noreply.github.com> Date: Wed, 15 Jan 2025 14:17:44 +0000 Subject: [PATCH 1/2] [Security Center] Update Brand Protection docs --- .../docs/security-center/brand-protection.mdx | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/src/content/docs/security-center/brand-protection.mdx b/src/content/docs/security-center/brand-protection.mdx index 6dc359852adc067..7f4dacae2ac0aeb 100644 --- a/src/content/docs/security-center/brand-protection.mdx +++ b/src/content/docs/security-center/brand-protection.mdx @@ -25,30 +25,26 @@ To start searching for new domains that might be trying to impersonate your bran 2. Go to **Security Center** > **Brand Protection**. -3. Provide a name for your query. +3. In **String query**, provide a name for your query. You can add multiple brand phrases on the same query, and the results will generate matches for all of those. Once you entered the string queries, select **Search matches**. -4. In **Match against**, write the name of the domain that you want the query to match. You have the ability to add multiple brand phrases on the same query, and the results will generate matches for all of those. - -5. In the **Character distance** dropdown, select from `0-3` the number of characters the results can differ from your domain. +4. In the **Character distance**, select from `0-3`. The number of characters the results can differ from your domain. :::note If a brand phrase or search term has less than five characters, you can only choose a max distance of `0` (zero). ::: -6. Select **Apply**. This will create a preview of the most recent results matching your query. - -7. You can select **Save query** to monitor it in the future and perform other actions, such as delete, clone and set up alerts, according to your paid plan limits. +5. You can select **Save query** to monitor it in the future and perform other actions, such as delete, clone and set up alerts, according to your Paid plan limits. -8. To export all matches from a saved query, select your **Query name** > select the three dots > **Export matches**. +6. To export all matches from a saved query, select your **Query name** > select the three dots > **Export matches**. -In the section **Monitored queries**, you can check all the queries that you selected to monitor. You can delete, clone, or create notifications for a query. Refer to [Brand Protection Alerts](#brand-protection-alerts) to set up notifications. +In the section **Monitor Strings**, you can check all the string queries that you selected to monitor. You can delete, clone, or create notifications for a string query. Refer to [Brand Protection Alerts](#brand-protection-alerts) to set up notifications. ## Logo queries To set up a new logo query: -1. Go to **Security Center** > **Monitor Images** and select **Add logo**. +1. Go to **Security Center** > **Monitor Logos** and select **Add logo**. 2. Add a name for your query and upload your logo. Only the `.png`, `.jpeg`, and `.jpg` file extensions are supported. 3. Select **Save logo**. @@ -56,12 +52,18 @@ The browser will return to the **Monitor Images** overview page, where you can a ## Investigate a query -To investigate a query: +In this section, the dashboard displays: + +- **Domain overview**. +- **WHOIS** that provides details about the date the domain was created, registrant and nameservers. +- **Domain history** that provides information on the domain category and when it was last changed. Refer to [Investigate threats](/security-center/investigate/investigate-threats/) for more details. +- **URL Reports** that provides information on any reported URL. -1. Go to the **Monitored strings** or **Monitor Logos** section to view all your queries. +To investigate a string query: + +1. Go to the **Monitor Strings** or **Monitor Logos** section to view all your queries. 2. Select a monitored query to inspect all the domains that matched your query. 3. Next to the domain, select **Domain** or **URL**. This will trigger a search on the [**Investigate**](/security-center/investigate/) section in a separate tab. URL scanner will also be triggered from **Brand Protection** through **Security Center** > **Investigate**. You will also have access to a report which will be generated automatically. The report will display screenshots of the matched domain, and the registrar of your domain. -4. In this section, you have the **Domain overview**, the **WHOIS** section that provides details about the date the domain was created, registrant and nameservers, and the **Domain history** that provides information on the domain category and when it was last changed. Refer to [Investigate threats](/security-center/investigate/investigate-threats/) for more details. ## Brand Protection Alerts @@ -69,20 +71,18 @@ To investigate a query: -To set a Brand Protection Alert: - -1. Go to the **Monitored queries** section and select the three dots in front of the query for which you would like to create notifications. +To set up a Brand Protection Alert: -2. From the dropdown, select *Create notification* to receive an immediate notification once Cloudflare detects that a newly registered domain matches your query, or *Create digest notification* to run your query every 24 hours. +1. Go to **Monitor Strings** and locate the query for which you would like to create notifications. -3. You will be taken to the **Notifications** section in the sidebar, to configure your Brand Protection Alert. +2. Select **alerts**. This should redirect you to the **Add Notification** page, where you can configure what you want to be notified about and how. :::note You can also set up the alerts from your [Notifications](/notifications/) menu. ::: -4. Create a notification name, add a description (optional), add a Webhook, and enter a notification email. You can add multiple email addresses. +4. Create a notification name, add a description (optional), and select the monitored queries. You can also add a Webhook, and a notification email. You can add multiple email addresses. 5. Select **Save**. From 1378c53d4376eac8d03226d6fbcf8998eea6fef9 Mon Sep 17 00:00:00 2001 From: Maddy <130055405+Maddy-Cloudflare@users.noreply.github.com> Date: Wed, 15 Jan 2025 15:18:13 +0000 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Jun Lee --- src/content/docs/security-center/brand-protection.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/docs/security-center/brand-protection.mdx b/src/content/docs/security-center/brand-protection.mdx index 7f4dacae2ac0aeb..ce08a09209bc5d9 100644 --- a/src/content/docs/security-center/brand-protection.mdx +++ b/src/content/docs/security-center/brand-protection.mdx @@ -75,16 +75,16 @@ To set up a Brand Protection Alert: 1. Go to **Monitor Strings** and locate the query for which you would like to create notifications. -2. Select **alerts**. This should redirect you to the **Add Notification** page, where you can configure what you want to be notified about and how. +2. Select **alerts**. This should redirect you to the **Add Notification** page, where you can configure what you want to be notified about, and how. :::note You can also set up the alerts from your [Notifications](/notifications/) menu. ::: -4. Create a notification name, add a description (optional), and select the monitored queries. You can also add a Webhook, and a notification email. You can add multiple email addresses. +3. Create a notification name, add a description (optional), and select the monitored queries. You can also add a Webhook, and a notification email. You can add multiple email addresses. -5. Select **Save**. +4. Select **Save**. Manage your notifications in the **All notifications** tab. You can disable, edit, delete, or test them.