Prioritized traffic

Prioritized traffic allows you to define which applications Magic WAN Connector should process first. Applications not in the list will be queued behind prioritized traffic.

Similarly to breakout traffic, prioritized traffic also works via DNS requests inspection.

Warning

Prioritized traffic will not work for applications that use DNS-over-HTTPS.

Add an application

You need to configure Prioritized traffic for each of your existing sites, as it is a per-site configuration.

Dashboard

1. Log in to the Cloudflare dashboard ↗, and select your account.
2. Select Magic WAN > Connector on-ramps (beta).
3. Select the Connector you want to configure > Edit.
4. Select Traffic Steering.
5. In Prioritized traffic, select Add.
6. Select one or more applications that should bypass Cloudflare filtering from the list. You can also use the search box.
7. Select Add applications.

The traffic for the application you chose is now processed first by Connector.

API

Note

You will need your account ID and API Key to use the API.

1. Send a GET request to list the applications associated with an account.

   Required API token permissions

   At least one of the following token permissions is required:

   • Magic WAN Write
   • Magic WAN Read
   • Magic Transit Prefix Read
   • Magic Transit Prefix Write

   List Apps

   curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/apps \
     --request GET \
     --header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
     --header "X-Auth-Key: $CLOUDFLARE_API_KEY"

     {
       "result": [
         {
           "managed_app_id": "<APP_ID>",
           "name": "<APP_NAME>",
           "type": "File Sharing",
           "hostnames": [
             "<app_name.com>",
             "<app-name.info>"
           ]
         }
       ]
     }

   Take note of the "managed_app_id" value for any application you want to add.

2. Send a POST request to add new apps to the breakout traffic policy.

   Required API token permissions

   At least one of the following token permissions is required:

   • Magic WAN Write
   • Magic Transit Prefix Write

   Create a new App

   curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/apps \
     --request POST \
     --header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
     --header "X-Auth-Key: $CLOUDFLARE_API_KEY" \
     --json '{
       "name": "<MANAGED_APP_ID>",
       "type": "<BREAKOUT_OR_PRIORITY>"
     }'

   {
     "result": {
       "account_app_id": "<APP_ID>",
       "name": "<APP_NAME>",
       "type": "<BREAKOUT_OR_PRIORITY>"
     },
     "success": true,
     "errors": [],
     "messages": []
   }

Delete an application

Dashboard

1. Log in to the Cloudflare dashboard ↗, and select your account.
2. Select Magic WAN > Connector on-ramps (beta).
3. Select the Connector you want to configure > Edit.
4. Select Traffic Steering.
5. In Prioritized traffic, find the application you want to delete, and select the three dots next to it.
6. Select Remove.
7. (Optional) If you have several pages of applications, you can use the search box to quickly find the application you are looking for.

API

Note

You will need your account ID and API Key to use the API.

1. Send a GET request to list the applications associated with a site.

   Required API token permissions

   At least one of the following token permissions is required:

   • Magic WAN Write
   • Magic WAN Read
   • Magic Transit Prefix Read
   • Magic Transit Prefix Write

   List Apps

   curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/apps \
     --request GET \
     --header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
     --header "X-Auth-Key: $CLOUDFLARE_API_KEY"

     {
       "result": [
         {
           "managed_app_id": "<APP_ID>",
           "name": "<APP_NAME>",
           "type": "File Sharing",
           "hostnames": [
             "<app_name.com>",
             "<app-name.info>"
           ]
         }
       ]
     }

   Take note of the "account_app_id" value for the application that want to delete.

2. Send a DELETE request to delete an application from the breakout traffic policy.

   Required API token permissions

   At least one of the following token permissions is required:

   • Magic WAN Write
   • Magic Transit Prefix Write

   Delete Account App

   curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/apps/$ACCOUNT_APP_ID \
     --request DELETE \
     --header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
     --header "X-Auth-Key: $CLOUDFLARE_API_KEY"

   {
     "result": {
       "account_app_id": "<APP_ID>",
       "name": "<APP_NAME>",
       "type": "<BREAKOUT_OR_PRIORITY>"
     },
     "success": true,
     "errors": [],
     "messages": []
   }