{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"disc"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"5529262b-4366-4d44-b676-6ea15a4c01e9"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"0d35200f-0b20-4dc1-9fac-37d78a9036b7"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"About the Device","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Squid is a caching proxy for the Web supporting HTTP, HTTPS, FTP, and more. It reduces bandwidth and improves response times by caching and reusing frequently-requested web pages. Squid has extensive access controls and makes a great server accelerator.","type":"text"}]},{"type":"paragraph","content":[{"text":"Squid provides the best possible web access by optimizing the data flow between client and server to improve performance and by caching frequently-used content to save bandwidth. Squid can also route content requests to servers in a wide variety of ways to build cache server hierarchies which optimizes network throughput. Squid helps in building content clusters to route and load balance requests via a variety of web servers.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Device Information","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"1369afa3-beee-4792-9117-7e46c85afb16"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[230.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"Entity","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[530.0]},"content":[{"type":"paragraph","content":[{"text":"Particulars","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[230.0]},"content":[{"type":"paragraph","content":[{"text":"Vendor Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[530.0]},"content":[{"type":"paragraph","content":[{"text":"Squid","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[230.0]},"content":[{"type":"paragraph","content":[{"text":"Product Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[530.0]},"content":[{"type":"paragraph","content":[{"text":"Web Proxy","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[230.0]},"content":[{"type":"paragraph","content":[{"text":"Type of Device","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[530.0]},"content":[{"type":"paragraph","content":[{"text":"Hosted","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Collection Method","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"28a69db5-c078-4328-9392-223badf5ff91"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[152.0]},"content":[{"type":"paragraph","content":[{"text":"Log Type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":" Ingestion label","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":"Preferred Logging Protocol - Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[274.0]},"content":[{"type":"paragraph","content":[{"text":"Log collection method","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[152.0]},"content":[{"type":"paragraph","content":[{"text":"Squid Web Proxy","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"SQUID_WEBPROXY","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[177.0]},"content":[{"type":"paragraph","content":[{"text":"Syslog","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[274.0]},"content":[{"type":"paragraph","content":[{"text":"CyberHub","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Port Requirements","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"149963da-b0c5-4cae-bfd2-84f13f6919dd"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"Source","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[252.0]},"content":[{"type":"paragraph","content":[{"text":"Destination","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[252.0]},"content":[{"type":"paragraph","content":[{"text":"Port","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"Squid Web Proxy","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[252.0]},"content":[{"type":"paragraph","content":[{"text":"CyberHub","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[252.0]},"content":[{"type":"paragraph","content":[{"text":"601 (TCP)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"To facilitate secure communication and align with our best practice, we strongly encourage the use of Transport Layer Security (TLS) between your security devices and our Adaptive MxDR platform for event forwarding.","type":"text"}]},{"type":"paragraph","content":[{"text":"While we understand that TLS support may not be available on all devices, if your devices do support TLS communication, we recommend utilizing port 6514 for seamless integration.","type":"text"}]},{"type":"paragraph","content":[{"text":"In some cases, the upgraded version of the device might incorporate TLS support without prior notice. If you come across such a scenario or for further assistance in configuring TLS, we kindly ask you to reach out to your dedicated Adaptive MxDR Service Delivery Lead.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Device Configuration","type":"text","marks":[{"type":"strong"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The procedures in this document have been tested on - Squid Proxy v5.7 installed on Ubuntu 22.04.4 LTS. As a prerequisite, we assume that Squid Server has been deployed and running properly on the host machine.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Follow the below steps to configure Squid Proxy Server and RSyslog service to forward Squid Access Logs to CyberHub.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access Host machine with root or Similar Privileges.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure taking","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"backup of your existing squid configuration file (","type":"text"},{"text":"squid.conf","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"Squid configuration file ","type":"text"},{"text":"/etc/squid/squid.conf","type":"text","marks":[{"type":"code"}]},{"text":" by carefully adding following lines under Log File options to specify Log Format along with Syslog settings for Access Log and save the edits.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Adaptive MxDR support two formats: The Default Format (","type":"text"},{"text":"squid","type":"text","marks":[{"type":"strong"}]},{"text":") and a Custom Format (","type":"text"},{"text":"AMxDRSquid","type":"text","marks":[{"type":"strong"}]},{"text":"). For more detailed logging data, we recommend using the Custom Format.","type":"text"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"a. To use ","type":"text"},{"text":"Custom format","type":"text","marks":[{"type":"strong"}]},{"text":", add following","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"lines in the squid configuration file.","type":"text"}]},{"type":"codeBlock","content":[{"text":"logformat AMxDRSquid %ts.%03tu %6tr %>a %Ss/%03>Hs %p %

h\" \"%{User-Agent}>h\" %>st %. AMxDRSquid","type":"text"}]},{"type":"paragraph","content":[{"text":"Specify any chosen Linux ","type":"text"},{"text":"Syslog_Facility ","type":"text","marks":[{"type":"code"}]},{"text":"and ","type":"text"},{"text":"Syslog_Severity","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Here we have used ","type":"text"},{"text":"Syslog_Facility","type":"text","marks":[{"type":"code"}]},{"text":" as ","type":"text"},{"text":"local6","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Syslog_Severity","type":"text","marks":[{"type":"code"}]},{"text":" as ","type":"text"},{"text":"info","type":"text","marks":[{"type":"strong"}]},{"text":". Kindly follow the below snapshot.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":977,"alt":"image-20240715-074456.png","id":"31f9df80-886e-4440-be93-d8b129a40786","collection":"contentId-590577704","type":"file","height":73}}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"b. To use ","type":"text"},{"text":"Default Squid","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"format","type":"text","marks":[{"type":"strong"}]},{"text":", add the following","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"line in the squid configuration file.","type":"text"}]},{"type":"codeBlock","content":[{"text":"access_log syslog:. squid","type":"text"}]},{"type":"paragraph","content":[{"text":" Specify any chosen Linux ","type":"text"},{"text":"Syslog_Facility","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"Syslog_Severity","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Here we have used ","type":"text"},{"text":"Syslog_Facility","type":"text","marks":[{"type":"code"}]},{"text":" as ","type":"text"},{"text":"local6","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Syslog_Severity","type":"text","marks":[{"type":"code"}]},{"text":" as ","type":"text"},{"text":"info","type":"text","marks":[{"type":"strong"}]},{"text":". Kindly follow the below snapshot.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1057,"alt":"image-20240715-074703.png","id":"e79fd361-f8e3-4027-a4b7-38a691f56797","collection":"contentId-590577704","type":"file","height":94}}]},{"type":"orderedList","attrs":{"order":4},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify or create the ","type":"text"},{"text":"/etc/rsyslog.d/50-default.conf","type":"text","marks":[{"type":"code"}]},{"text":" file and add the following line at the end of the file and save the edits.","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"$template AMxDRSquidPattern,\"<%pri%>%timegenerated% %HOSTNAME% squid-access%msg%\\n\"\nlocal6.info @@:601;AMxDRSquidPattern","type":"text"}]},{"type":"paragraph","content":[{"text":" Specify ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]},{"text":"in the IP placeholder.","type":"text"}]},{"type":"paragraph","content":[{"text":" Ensure specifying correct ","type":"text"},{"text":"Syslog_Facility","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Syslog_Severity","type":"text","marks":[{"type":"strong"}]},{"text":" here as we have used ","type":"text"},{"text":"local6.info","type":"text","marks":[{"type":"underline"},{"type":"em"},{"type":"link","attrs":{"href":"http://local6.info"}}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"in an example.","type":"text"}]},{"type":"orderedList","attrs":{"order":5},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Restart ","type":"text"},{"text":"Squid","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"and ","type":"text"},{"text":"rsyslog","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"services.","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"systemctl restart rsyslog\nsystemctl restart squid","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Integration Parameters","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Parameters required from customer for Integration.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"32c8d25f-6aa9-45f5-a070-e253b0f5b318"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Property","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Default Value","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"IP Address","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Squid Web Proxy interface IP address","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Hostname or IP address of the device which forwards logs to the CyberHub","type":"text"}]}]}]}]}],"version":1}

Browser not supported