From commits-return-3066-archive-asf-public=cust-asf.ponee.io@metron.apache.org Fri Jun 8 14:19:32 2018 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx-eu-01.ponee.io (Postfix) with SMTP id 5A49218067B for ; Fri, 8 Jun 2018 14:19:30 +0200 (CEST) Received: (qmail 85651 invoked by uid 500); 8 Jun 2018 12:19:29 -0000 Mailing-List: contact commits-help@metron.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@metron.apache.org Delivered-To: mailing list commits@metron.apache.org Received: (qmail 85605 invoked by uid 99); 8 Jun 2018 12:19:29 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 08 Jun 2018 12:19:29 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id CBFD8E10B7; Fri, 8 Jun 2018 12:19:28 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: leet@apache.org To: commits@metron.apache.org Date: Fri, 08 Jun 2018 12:19:31 -0000 Message-Id: <71962891168b4f69aeebfe8e5853e4db@git.apache.org> In-Reply-To: References: X-Mailer: ASF-Git Admin Mailer Subject: [04/39] metron git commit: METRON-1607 update public web site to point at 0.5.0 new release (justinleet) closes apache/metron#1053 http://git-wip-us.apache.org/repos/asf/metron/blob/ae1d3eb9/site/current-book/metron-sensors/pycapa/index.html ---------------------------------------------------------------------- diff --git a/site/current-book/metron-sensors/pycapa/index.html b/site/current-book/metron-sensors/pycapa/index.html index 8c46464..f81aee9 100644 --- a/site/current-book/metron-sensors/pycapa/index.html +++ b/site/current-book/metron-sensors/pycapa/index.html @@ -1,313 +1,199 @@ - + Metron – Pycapa - + - - - - - - - - - - - - - - -
-

Example 5

Consume 10 packets from the Kafka topic pcap running on localhost:9092, then pipe those into Wireshark for DPI.

-
-
-
$ pycapa --consumer \
+
+
+
$ pycapa --consumer \
     --kafka-broker localhost:9092 \
     --kafka-topic pcap \
     --max-packets 10 \
@@ -446,59 +337,58 @@ Capturing on 'Standard input'
     9   2.083872 192.30.253.125 → 192.168.0.3  TCP 66 443 → 54671 [ACK] Seq=32 Ack=36 Win=31 Len=0 TSval=2658503087 TSecr=961120495
    10   3.173189 fe80::1286:8cff:fe0e:65df → ff02::1      ICMPv6 134 Router Advertisement from 10:86:8c:0e:65:df
 10 packets captured
-
+
+

Kerberos

-

The probe can be used in a Kerberized environment. Follow these additional steps to use Pycapa with Kerberos. The following assumptions have been made. These may need altered to fit your environment.

- +

The probe can be used in a Kerberized environment. Follow these additional steps to use Pycapa with Kerberos. The following assumptions have been made. These may need altered to fit your environment.

    - +
  • The Kafka broker is at kafka1:6667
  • -
  • Zookeeper is at zookeeper1:2181
  • -
  • The Kafka security protocol is SASL_PLAINTEXT
  • -
  • The keytab used is located at /etc/security/keytabs/metron.headless.keytab
  • -
  • The service principal is metron@EXAMPLE.COM
-
    - +
  1. +

    Build Librdkafka with SASL support (--enable-sasl) and install at your chosen $PREFIX.

    - -
    -
    -
    wget https://github.com/edenhill/librdkafka/archive/v0.9.4.tar.gz  -O - | tar -xz
    +
    +
    +
    +
    wget https://github.com/edenhill/librdkafka/archive/v0.9.4.tar.gz  -O - | tar -xz
     cd librdkafka-0.9.4/
     ./configure --prefix=$PREFIX --enable-sasl
     make
     make install
    -
  2. - +
+
  • -

    Validate Librdkafka does indeed support SASL. Run the following command and ensure that sasl is returned as a built-in feature.

    - -
    -
    -
    $ examples/rdkafka_example -X builtin.features
    +
    +

    Validate Librdkafka does indeed support SASL. Run the following command and ensure that sasl is returned as a built-in feature.

    + +
    +
    +
    $ examples/rdkafka_example -X builtin.features
     builtin.features = gzip,snappy,ssl,sasl,regex
     
    -

    If it is not, ensure that you have libsasl or libsasl2 installed. On CentOS, this can be installed with the following command.

    - -
    -
    -
    yum install -y cyrus-sasl cyrus-sasl-devel cyrus-sasl-gssapi
    -
  • - + +

    If it is not, ensure that you have libsasl or libsasl2 installed. On CentOS, this can be installed with the following command.

    + +
    +
    +
    yum install -y cyrus-sasl cyrus-sasl-devel cyrus-sasl-gssapi
    +
    +
  • -

    Grant access to your Kafka topic. In this example the topic is simply named pcap.

    - -
    -
    -
    ${KAFKA_HOME}/bin/kafka-acls.sh \
    +
    +

    Grant access to your Kafka topic. In this example the topic is simply named pcap.

    + +
    +
    +
    ${KAFKA_HOME}/bin/kafka-acls.sh \
       --authorizer kafka.security.auth.SimpleAclAuthorizer \
       --authorizer-properties zookeeper.connect=zookeeper1:2181 \
       --add \
    @@ -510,65 +400,60 @@ ${KAFKA_HOME}/bin/kafka-acls.sh \
       --add \
       --allow-principal User:metron \
       --group pycapa
    -
  • - + +
  • +

    Use Pycapa as you normally would, but append the following three additional parameters

    -
      - +
    • security.protocol
    • -
    • sasl.kerberos.keytab
    • - -
    • sasl.kerberos.principal
    • -
    - -
    -
    -
      $ pycapa --producer \
    -  --interface eth0 \
    -  --kafka-broker kafka1:6667 \
    -  --kafka-topic pcap --max-packets 10 \
    -  -X security.protocol=SASL_PLAINTEXT \
    -  -X sasl.kerberos.keytab=/etc/security/keytabs/metron.headless.keytab \
    -  -X sasl.kerberos.principal=metron-metron@METRONEXAMPLE.COM
    -  INFO:root:Connecting to Kafka; {'sasl.kerberos.principal': 'metron-metron@METRONEXAMPLE.COM', 'group.id': 'ORNLVWJZZUAA', 'security.protocol': 'SASL_PLAINTEXT', 'sasl.kerberos.keytab': '/etc/security/keytabs/metron.headless.keytab', 'bootstrap.servers': 'kafka1:6667'}
    -  INFO:root:Starting packet capture
    -  INFO:root:Waiting for '1' message(s) to flush
    -  INFO:root:'10' packet(s) in, '10' packet(s) out
    -
  • +
  • sasl.kerberos.principal + +
    +
    +
    $ pycapa --producer \
    +    --interface eth0 \
    +    --kafka-broker kafka1:6667 \
    +    --kafka-topic pcap --max-packets 10 \
    +    -X security.protocol=SASL_PLAINTEXT \
    +    -X sasl.kerberos.keytab=/etc/security/keytabs/metron.headless  .keytab \
    +    -X sasl.kerberos.principal=metron-metron@METRONEXAMPLE.COM
    +INFO:root:Connecting to Kafka; {'sasl.kerberos.principal':   'metron-metron@METRONEXAMPLE.COM', 'group.id': 'ORNLVWJZZUAA',   'security.protocol': 'SASL_PLAINTEXT', 'sasl.kerberos.keytab':   '/etc/security/keytabs/metron.headless.keytab', 'bootstrap.servers': 'kafka1:6667'}
    +INFO:root:Starting packet capture
    +INFO:root:Waiting for '1' message(s) to flush
    +INFO:root:'10' packet(s) in, '10' packet(s) out
    +
    +
  • + +

    FAQs

    -

    How do I get more logs?

    +

    How do I get more logs?

    Use the following two command-line arguments to get detailed logging.

    -
    -
    -
    -X debug=all --log-level DEBUG
    -
    +
    +
    +
    -X debug=all --log-level DEBUG
    +
    +
    -

    When I run Pycapa against a Kafka broker with Kerberos enabled, why do I get an error like “No such configuration property: ‘sasl.kerberos.principal’”?

    -

    This can be a confusing error message because sasl.kerberos.principal is indeed a valid property for librdkafka as defined here. This is most likely because Pycapa is running against a version of Librdkafka without SASL support enabled. This might happen if you have accidentally installed multiple versions of Librdkafka and Pycapa is unexpectedly using the version without SASL support enabled.

    +

    When I run Pycapa against a Kafka broker with Kerberos enabled, why do I get an error like “No such configuration property: ‘sasl.kerberos.principal’”?

    +

    This can be a confusing error message because sasl.kerberos.principal is indeed a valid property for librdkafka as defined here. This is most likely because Pycapa is running against a version of Librdkafka without SASL support enabled. This might happen if you have accidentally installed multiple versions of Librdkafka and Pycapa is unexpectedly using the version without SASL support enabled.

    Bottom Line: Make sure that Pycapa is running against a version of Librdkafka with SASL support enabled.

    - - - - + + +
    -
    -
    -
    Copyright © 2018 - The Apache Software Foundation. - All Rights Reserved. - +
    +
    +© 2015-2016 The Apache Software Foundation. Apache Metron, Metron, Apache, the Apache feather logo, + and the Apache Metron project logo are trademarks of The Apache Software Foundation. +
    - - - -
    http://git-wip-us.apache.org/repos/asf/metron/blob/ae1d3eb9/site/current-book/metron-stellar/stellar-3rd-party-example/index.html ---------------------------------------------------------------------- diff --git a/site/current-book/metron-stellar/stellar-3rd-party-example/index.html b/site/current-book/metron-stellar/stellar-3rd-party-example/index.html index d60a128..4e19e16 100644 --- a/site/current-book/metron-stellar/stellar-3rd-party-example/index.html +++ b/site/current-book/metron-stellar/stellar-3rd-party-example/index.html @@ -1,211 +1,108 @@ - + Metron – Introduction - + - - - - - - - - - - - - - - -
    - +
    -
    -
    Copyright © 2018 - The Apache Software Foundation. - All Rights Reserved. - +
    +
    +© 2015-2016 The Apache Software Foundation. Apache Metron, Metron, Apache, the Apache feather logo, + and the Apache Metron project logo are trademarks of The Apache Software Foundation. +
    - - - -
    http://git-wip-us.apache.org/repos/asf/metron/blob/ae1d3eb9/site/current-book/metron-stellar/stellar-common/3rdPartyStellar.html ---------------------------------------------------------------------- diff --git a/site/current-book/metron-stellar/stellar-common/3rdPartyStellar.html b/site/current-book/metron-stellar/stellar-common/3rdPartyStellar.html index eb9e054..88d7ac6 100644 --- a/site/current-book/metron-stellar/stellar-common/3rdPartyStellar.html +++ b/site/current-book/metron-stellar/stellar-common/3rdPartyStellar.html @@ -1,216 +1,114 @@ - + Metron – Custom Stellar Functions - + - - - - - - - - - - - - - - -
    -