Palo Alto Networks URL Filtering
The Palo Alto Networks URL Filtering connector enables automated querying of URL categories, aiding in the enforcement of web security policies.
Palo Alto Networks URL Filtering is a robust web security solution that classifies URLs to prevent access to malicious websites. This connector enables Swimlane Turbine users to automate the retrieval of URL categories, enhancing security workflows by quickly identifying potential threats. By integrating with Palo Alto Networks URL Filtering, users can leverage real-time data to enforce security policies and reduce manual categorization efforts. This streamlined process aids in the prevention of web-based threats, ensuring a secure and compliant network environment.
Prerequisites
To effectively utilize the Palo Alto Networks URL Filtering connector in Swimlane Turbine, ensure you have the following:
- Custom authentication with the necessary parameters:
- URL: The endpoint for the Palo Alto Networks URL Filtering API.
- API Key: A valid API key provided by Palo Alto Networks to authenticate requests.
Asset Setup
You need the following inputs:
- URL
- API Key
Capabilities
The Palo Alto URL Filtering integration provides the following capabilities:
- Get URL Category
Additional Information
The following table outlines the IDs for potential URL categories:
ID | Category | Description |
|---|---|---|
1 | Real Estate | Information on property rentals, sales and related tips or information. Includes sites for real estate agents, firms, rental services, listings (and aggregates), and property improvement. |
2 | Dynamic DNS | Sites that provide and/or utilize dynamic DNS services to associate domain names to dynamic IP addresses. Dynamic DNS is often used by attackers for command-and-control communication and other malicious purposes. |
3 | Financial Services | Websites pertaining to personal financial information or advice, such as online banking, loans, mortgages, debt management, credit card companies, and insurance companies. Does not include sites relating to stock markets, brokerages or trading services. |
4 | Business and Economy | Marketing, management, economics, and sites relating to entrepreneurship or running a business. |
5 | Computer and Internet Info | General information regarding computers and the internet. |
6 | Auctions | Sites that promote the sale of goods between individuals. |
7 | Shopping | Sites that facilitate the purchase of goods and services. Includes online merchants, websites for department stores, retail stores, catalogs, as well as sites that aggregate and monitor prices. |
9 | Travel | Information regarding travel tips, deals, pricing information, destination information, tourism, and related services. Includes websites for hotels, local attractions, casinos, airlines, cruise lines, travel agencies, vehicle rentals and sites that provide booking tools such as price monitors. |
10 | Abused Drugs | Sites that promote the abuse of both legal and illegal drugs, use and sale of drug related paraphernalia, manufacturing and/or selling of drugs. |
11 | Adult | Sexually explicit material, media (including language), art, and/or products, online groups or forums that are sexually explicit in nature. Sites that promote adult services such as video/telephone conferencing, escort services, strip clubs, etc. |
12 | Home and Garden | Information, products, and services regarding home repair and maintenance, architecture, design, construction, decor, and gardening. |
13 | Military | Information or commentary regarding military branches, recruitment, current or past operations, or any related paraphernalia. |
14 | Social Networking | User communities and sites where users interact with each other, post messages, pictures, or otherwise communicate with groups of people. Does not include blogs or personal sites. |
16 | Stock Advice and Tools | Information regarding the stock market, trading of stocks or options, portfolio management, investment strategies, quotes, or related news. |
17 | Training and Tools | Sites that provide online education and training and related materials. |
18 | Dating | Websites offering online dating services, advice, and other personal ads. |
19 | Sex Education | Information on reproduction, sexual development, safe sex practices, sexually transmitted diseases, birth control, tips for better sex, as well as any related products or related paraphernalia. Includes websites for related groups, forums or organizations. |
20 | Religion | Information regarding various religions, related activities or events. Includes websites for religious organizations, officials and places of worship. |
21 | Entertainment and Arts | Sites for movies, television, radio, videos, programming guides/tools, comics, performing arts, museums, art galleries, or libraries. Includes sites for entertainment, celebrity and industry news. |
22 | Personal Sites and Blogs | Personal websites and blogs by individuals or groups. |
23 | Legal | Information, analysis or advice regarding the law, legal services, legal firms, or other legal related issues. |
25 | Streaming Media | Sites that stream audio or video content for free and/or purchase. |
26 | Job Search | Sites that provide job listings and employer reviews, interview advice and tips, or related services for both employers and prospective candidates. |
27 | Gambling | Lottery or gambling websites that facilitate the exchange of real and/or virtual money. Related websites that provide information, tutorials or advice regarding gambling, including betting odds and pools. Corporate websites for hotels and casinos that do not enable gambling are categorized under Travel. |
28 | Translation | Sites that provide translation services, including both user input and URL translations. These sites can also allow users to circumvent filtering as the target page's content is presented within the context of the translator's URL. |
29 | Reference and Research | Personal, professional, or academic reference portals, materials, or services. Includes online dictionaries, maps, almanacs, census information, libraries, genealogy and scientific information. |
30 | Shareware and Freeware | Sites that provide access to software, screensavers, icons, wallpapers, utilities, ringtones, themes or widgets for free and/or donations. Also includes open source projects. |
31 | Peer-to-Peer | Sites that provide access to or clients for peer-to-peer sharing of torrents, download programs, media files, or other software applications. |
33 | Hacking | Sites relating to the illegal or questionable access to or the use of communications equipment/software. Development and distribution of programs, how-to-advice and/or tips that may result in the compromise of networks and systems. Also includes sites that facilitate the bypass of licensing and digital rights systems. |
34 | Games | Sites that provide online play or download of video and/or computer games, game reviews, tips, or cheats, as well as instructional sites for non-electronic games, sale/trade of board games, or related publications/media. Includes sites that support or host online sweepstakes and/or giveaways. |
35 | Philosophy and Political Advocacy | Sites containing information, viewpoints or campaigns regarding philosophical or political views. |
36 | Weapons | Sales, reviews, descriptions of or instructions regarding weapons and their use. |
38 | Hunting and Fishing | Hunting and fishing tips, instructions, sale of related equipment and paraphernalia. |
39 | Society | Topics relating to the general population, issues that impact a large variety of people, such as fashion, beauty, philanthropic groups, societies, or children. Also includes restaurant websites. |
40 | Educational Institutions | Official websites for schools, colleges, universities, school districts, online classes, and other academic institutions. |
42 | Sports | Information about sporting events, athletes, coaches, officials, teams or organizations, sports scores, schedules and related news, and any related paraphernalia. Includes websites regarding fantasy sports and other virtual sports leagues. |
43 | Swimsuits and Intimate Apparel | Sites that include information or images concerning swimsuits, intimate apparel or other suggestive clothing. |
44 | Questionable | Sites containing tasteless humor, offensive content targeting specific demographics of individuals or groups of people, criminal activity, illegal activity, and get rich quick sites. |
47 | Online Storage and Backup | Websites that provide online storage of files for free and as a service. |
50 | Search Engines | Sites that provide a search interface using keywords, phrases, or other parameters that may return information, websites, images or files as results. |
51 | Internet Portals | Sites that serve as a starting point for users, usually by aggregating a broad set of content and topics. |
52 | Web Advertisements | Advertisements, media, content, and banners. |
55 | Web-based Email | Any website that provides access to an email inbox and the ability to send and receive emails. |
56 | Malware (MALICIOUS) | Sites containing malicious content, executables, scripts, viruses, trojans, and code. |
57 | Phishing (MALICIOUS) | Seemingly reputable sites that harvest personal information from its users via phishing or pharming. |
58 | Proxy Avoidance and Anonymizers | Proxy servers and other methods that bypass URL filtering or monitoring. |
59 | Command and Control (MALICIOUS) | Domains and URLs used by malware to establish command and control, data exfiltration, and other actions over the network after a system is compromised. |
60 | Music | Music sales, distribution, or information. Includes websites for music artists, groups, labels, events, lyrics, and other information regarding the music business. |
61 | Government | Official websites for local, state, and national governments, as well as related agencies, services, or laws. |
62 | Nudity | Sites that contain nude or seminude depictions of the human body, regardless of context or intent, such as artwork. Includes nudist or naturist sites containing images of participants. |
63 | News | Online publications, newswire services, and other websites that aggregate current events, weather, or other contemporary issues. Includes newspapers, radio stations, magazines, and podcasts. |
65 | Content Delivery Networks | Sites whose primary focus is delivering content to 3rd parties such as advertisements, media, files, etc. |
66 | Internet Communications and Telephony | Sites that support or provide services for video chatting, instant messaging, or telephony capabilities. |
68 | Abortion | Sites that pertain to information or groups in favor of or against abortion, details regarding abortion procedures, help or support forums for or against abortion, or sites that provide information regarding the consequences/effects of pursuing (or not) an abortion. |
69 | Health and Medicine | Sites containing information regarding general health information, issues, and traditional and non-traditional tips, remedies, and treatments. Also includes sites for various medical specialties, practices and facilities (such as gyms and fitness clubs) as well as professionals. Sites relating to medical insurance and cosmetic surgery are also included. |
71 | Extremism | Websites promoting terrorism, racism, fascism or other extremist views discriminating people or groups of different ethnic backgrounds, religions or other beliefs. |
72 | Insufficient Content (DISABLED) | Websites and services that present test pages, no content, provide API access not intended for end-user display or require authentication without displaying any other content suggesting a different categorization. |
73 | Copyright Infringement | Web pages and services that are dedicated to illegally offer videos, movies or other media for download infringing copyrights of others. |
74 | Newly Registered Domains (DISABLED) | Domains that have been registered within the last 32 days. |
75 | Parked | URLs which host limited content or click-through ads which may generate revenue for the host entity but generally do not contain content that is useful to the end user. |
76 | Alcohol and Tobacco | Sites that pertain to the sale, manufacturing, or use of alcohol and/or tobacco products and related paraphernalia. Includes sites related to electronic cigarettes. |
80 | Recreation and Hobbies | Information, forums, associations, groups, and publications on recreations and hobbies. |
81 | Motor Vehicles | Information relating to reviews, sales and trading, modifications, parts, and other related discussions for automobiles, motorcycles, boats, trucks and RVs. |
82 | Web Hosting | Free or paid for hosting services for web pages, including information regarding web development, publication, promotion, and other methods to increase traffic. |
100 | High Risk (DISABLED) | Sites that were previously confirmed to be malicious but have displayed benign activity for at least 30 days. Bulletproof ISP-hosted sites and sites with an IP address from an ASN that is known to allow malicious content. Sites that are associated with confirmed malicious activity (for example, they share the same domain). Unknown sites are considered high risk until PAN-DB completes a site analysis and categorization of the site. |
101 | Medium Risk (DISABLED) | Sites confirmed to be malicious that have displayed only benign activity for at least 60 days. All sites categorized as online-storage-and-backup are medium risk by default. |
102 | Low Risk (DISABLED) | Sites that are not medium or high risk are considered low risk. These sites have displayed benign activity for a minimum of 90 days. The low risk category includes both sites that have a history of only benign activity, and sites found to be malicious in the past, but that have displayed benign activity for at least 90 days. |
251 | Private IP Addresses (DISABLED) | This category includes IP addresses defined in RFC 1918, 'Address Allocation for Private Intranets which are : 10.0.0.0 - 10.255.255.255 (10/8 prefix) 172.16.0.0 - 172.31.255.255 (172.16/12 prefix) 192.168.0.0 - 192.168.255.255 (192.168/16 prefix) 169.254.0.0 - 169.254.255.255 (169.254/16 prefix) It also includes domains not registered with the public DNS system (such a *.local). |
255 | Unknown (DISABLED) | Unknown The website has not yet been categorized, so it does not exist in the URL filtering database on the firewall or in the URL cloud database. When deciding on what action to take for traffic categorized as unknown, be aware that setting the action to block may be very disruptive to users because there could be a lot of valid sites that are not in the URL database yet. If you do want a very strict policy, you could block this category, so websites that do not exist in the URL database cannot be accessed. |
Configurations
Palo Alto URL Filtering Asset
Configuration Parameters
Parameter | Description | Type | Required |
|---|---|---|---|
url | A URL to the target host. | string | Required |
key | API Key for URL Filtering | string | Required |
verify_ssl | Verify SSL certificate | boolean | Optional |
http_proxy | A proxy to route requests through. | string | Optional |
Actions
Get URL Category
Retrieves the category of a specified URL from Palo Alto Networks URL Filtering service.
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
url | string | Required | URL endpoint for the request |
target | string | Optional | Parameter for Get URL Category |
Input Example
{"url":"string","target":"string"}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{},"reason":"OK","json_body":{}}
Response Headers
Header | Description | Example |
|---|---|---|
Content-Type | The media type of the resource | application/json |
Date | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |