This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Broadcom ProxySG

    SamurAI [Local] CollectorSamurAI [Cloud] Collector
    Picture1.svg

    This guide describes the steps required to configure Broadcom (formely Blue Coat) ProxySG to send both event logs and access logs to a Samurai Local Collector deployed on your network. Event logs are forwarded via syslog on UDP port 514. Access logs use a custom ELFF format delivered via TCP port 514.

    To complete this Integration you will need to:

    1) From your Broadcom ProxySG:

    Configure event log syslog

    Perform the following steps to configure event log syslog forwarding:

    1. Log in to the Broadcom ProxySG

    2. From the command line specify the following commands to enable event log syslog:

    enable
    config t
    event-log
    syslog add udp [Local Collector IP Address] 514
    syslog enable
    

    where:

    [Local Collector IP Address] is the IP address of the Samurai Local Collector deployed on your network.

    1. Optionally, set the event logging level to ensure the appropriate verbosity of events are forwarded. From the CLI:
    event-log
    level informational
    

    Configure access log syslog

    Access logs must be forwarded using a mandatory custom ELFF format. The field order and number of fields must match the specification exactly — logs that do not conform to this format cannot be analysed by the SamurAI platform.

    Access log delivery uses TCP port 514 via the Management Console Custom Client upload method.

    Step 1 - Create the log format

    1. Log in to the Broadcom ProxySG Management Console (https://[ProxySG IP]:8082)

    2. Navigate to Configuration > Access Logging > Formats

    3. Click New and complete the following fields:

      3.1 Enter a Format Name — for example NTT_format

      3.2 Select W3C Extended Log File Format (ELFF) and enter the following string in the ELFF text box:

      date time time-taken c-ip cs-username cs-auth-group x-exception-id sc-filter-result cs-categories cs(Referer) sc-status s-action cs-method rs(Content-Type) cs-uri-scheme cs-host cs-uri-port cs-uri-path cs-uri-query cs-uri-extension cs(User-Agent) s-ip sc-bytes cs-bytes x-virus-id x-bluecoat-application-name x-bluecoat-application-operation c-port r-ip r-port cs-protocol s-computername c-uri cs(X-Forwarded-For) s-session-id x-http-connect-host
      

    3.3 Click Test Format to validate — a Format Syntax correct message confirms the format is valid

    3.4 Click OK and then Apply

    The table below describes each field in the format:

    #FieldDescription
    1dateDate of the URL connection
    2timeTime of the URL connection
    3time-takenTime taken to process the transaction (ms)
    4c-ipClient IP address
    5cs-usernameClient username
    6cs-auth-groupGroup name the user belongs to
    7x-exception-idIdentifier for failed transaction processing
    8sc-filter-resultContent filtering result
    9cs-categoriesContent category of the accessed URL
    10cs(Referer)Referrer URL (URL viewed immediately before)
    11sc-statusHTTP status code
    12s-actionProxySG traffic control action result
    13cs-methodHTTP method
    14rs(Content-Type)Content type of retrieved data
    15cs-uri-schemeURL connection scheme
    16cs-hostHostname
    17cs-uri-portDestination port specified by the client
    18cs-uri-pathURL path
    19cs-uri-queryURL query string
    20cs-uri-extensionFile extension of retrieved data
    21cs(User-Agent)Browser/user agent information
    22s-ipProxySG IP address
    23sc-bytesBytes transferred by ProxySG
    24cs-bytesBytes received by ProxySG
    25x-virus-idVirus identifier (if detected)
    26x-bluecoat-application-nameApplication name used for the connection
    27x-bluecoat-application-operationOperation performed by the application
    28c-portSource port used by the client
    29r-ipIP address of the remote server
    30r-portPort of the remote server
    31cs-protocolProtocol used in the client request
    32s-computernameConfigured appliance name
    33c-uriRequest source URL
    34cs(X-Forwarded-For)X-Forwarded-For header value
    35s-session-idStreaming session ID
    36x-http-connect-hostHostname from the original HTTP CONNECT request

    Step 2 — Create the access log

    1. Navigate to Configuration > Access Logging > Logs and select the Logs tab

    2. Click New and complete the following:

      2.1 Enter a Log Name — for example NTT_access_log

      2.2 Select the log format created in Step 1 (e.g. NTT_format) as the Log Format

      2.3 Click OK and then Apply

    Step 3 — Configure the upload client

    1. Select the Upload Client tab, choose your log from the drop-down list at the top, and complete the following:

      1.1 Set Client Type to Custom Client

      1.2 Set Save the log file as to text file

      1.3 Click Settings next to Primary Custom Server and enter:

      FieldValue
      HostIP address of the Samurai Local Collector
      Port514

      1.4 Click OK and then Apply

    Step 4 — Configure the upload schedule

    1. Select the Upload Schedule tab

    2. Choose your log from the drop-down list

    3. Under Upload the access log, select continuously

    4. Click Apply

    Step 5 — Apply policy via Visual Policy Manager

    1. Navigate to Configuration > Policy > Visual Policy Manager and click Launch

    2. From the menu, select Policy > Add Web Access Layer to open the Web Access Layer

    3. Right-click the Action cell on the target row and select Set

    4. In the Set Action Object window, click New and select Modify Access Logging

    5. In the Add Access Logging Object window, complete the following:

      5.1 Enter a Name — for example NTT_logging

      5.2 Under Enable logging to, select the log created in Step 2 (e.g. NTT_access_log)

      5.3 Click OK on both the Add Access Logging Object and Set Action Object windows

    6. Confirm that the Action column in the Web Access Layer reflects the new logging action

    7. Click Install Policy to apply — a Policy installation was successful message confirms the policy has been applied

    Step 6 — Verify logging

    1. Navigate to Statistics > Access Logging

    2. Select your configured log (e.g. NTT_access_log) and review the log tail to confirm events are being recorded and forwarded

    For integrations that utilize a Local Collector where we ingest syslog only, you do not need to follow specific steps in the SamurAI MDR portal as we auto detect the vendor and product. The only reason you need to use the SamurAI MDR portal is if you need to determine the Local Collector IP address. Of course you will still need to ensure the integration is functioning! See Integrations for more information on checking status.

    Our Integration guide was accurate at the time of writing but vendors change things frequently! If you find errors or anything is outdated, let us know by raising a request in the SamurAI MDR Portal and we shall get it updated.