You are viewing documentation for Falco version: v0.34.1

Falco v0.34.1 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.

Featured Image for Extend Falco outputs with falcosidekick
Thomas Labarussias

Extend Falco outputs with falcosidekick

    (2021-04-13) edit: update to integrate Falcosidekick-UI use last versions of Falco helm chart which embeds Falcosidekick as dependency

    默认情况下，Falco 的事件有 5 个输出：stdout、file、gRPC、shell 和 http。 如下图所示：

    falco extendend architecture

    即使它们很方便，我们也可以很快将 Falco 与其他组件集成。 Falcosidekick 来了，这是一个小守护进程，它扩展了可能的输出数量。

    当前可用的 Falcosidekick 输出列表（版本 v2.22.0）是：

    除此之外，它还提供有关事件数量的指标，并允许您在事件中添加自定义字段，例如环境、区域等

    在本文中，我们将了解如何在 Kubernetes 集群中一起部署 Falco、Falcosidekick 和 Falcosidekick-UI。

    我们将使用 Helm（版本 3）来安装所有组件，为了更好的用户体验，官方 Falco chart 能够为我们安装和设置所有配置：

    对于本教程，我们将在 Slack 频道中发送事件，因此请先获取您的 webhook URL。

    运行以下Helm

    kubectl create namespace falco
helm repo add falcosecurity https://falcosecurity.github.io/charts
helm install falco falcosecurity/falco \
--set falcosidekick.enabled=true \
--set falcosidekick.webui.enabled=true \
--set falcosidekick.config.slack.webhookurl="https://hooks.slack.com/services/XXXX" \
-n falco
    • --set falcosidekick.enabled=true enables deployment of Falcosidekick aside Falco and configures Falco for sending its events to Falcosidekick
    • --set falcosidekick.webui.enabled=true enables deployment of Falcosidekick-UI and configure Falcosidekick for using it as output
    • --set falcosidekick.config.slack.webhookurl="https://hooks.slack.com/services/XXXX" enables Slack as output for Falcosidekick

    所有可能的值都可以在相应的 Helm 图表中看到，请参阅存储库

    几秒钟后，您应该得到：

    kubectl -n falco get pods

NAME                                      READY   STATUS    RESTARTS   AGE
falco-falcosidekick-ui-7bdc54fb4c-h99b6   1/1     Running   0          26s
falco-falcosidekick-7779579477-pfspz      1/1     Running   0          26s
falco-falcosidekick-7779579477-bn8pv      1/1     Running   0          26s
falco-6ksbx                               1/1     Running   0          26s
falco-pxvbk                               1/1     Running   0          26s
falco-5cg5b                               1/1     Running   0          26s

    kubectl -n falco get svc

NAME                     TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
falco-falcosidekick      ClusterIP   10.43.212.119   <none>        2801/TCP   61s
falco-falcosidekick-ui   ClusterIP   10.43.35.87     <none>        2802/TCP   60s

    您可以使用典型的端口转发测试 Falcosidekick 的部署：

    kubectl -n falco port-forward svc/falco-falcosidekick 2801

    curl -s http://localhost:2801/ping

pong

    它还活着 ！

    我们可以向 Slack 发送一个测试事件来测试它是否有效。 Falcosidekick 为此提供了一个有用的端点：

    curl -sI -XPOST http://localhost:2801/test

HTTP/1.1 200 OK
Date: Tue, 13 Apr 2021 20:42:32 GMT
Content-Length: 0

    在日志中，您将获得：

    kubectl -n falco logs deployment/falcosidekick

kubectl logs deployment/falco-falcosidekick -n falco
Found 2 pods, using pod/falco-falcosidekick-7779579477-pfspz
2021/04/13 20:40:11 [INFO]  : Enabled Outputs : [Slack WebUI]
2021/04/13 20:40:11 [INFO]  : Falco Sidekick is up and listening on :2801
2021/04/13 20:41:35 [INFO]  : WebUI - Post OK (200)
2021/04/13 20:41:35 [INFO]  : WebUI - Publish OK
2021/04/13 20:41:35 [INFO]  : Slack - Post OK (200)
2021/04/13 20:41:35 [INFO]  : Slack - Publish OK

    我们可以注意到日志的第一行 [INFO] : Enabled Outputs : [Slack WebUI]，我们确实有 2 个启用的输出，Slack 和 WebUI (Falcosidekick-UI)

    在您的 Slack 频道中：

    falcosidekick slack test

    提示：对于 Slack 和其他一些输出，可以自定义消息格式，更多信息在 README(https://github.com/falcosecurity/falcosidekick/blob/master/README.md)*

    我们现在将添加一些自定义字段并测试更真实的事件。

    升级您的部署：

    helm upgrade falco falcosecurity/falco \
--set falcosidekick.enabled=true \
--set falcosidekick.webui.enabled=true \
--set falcosidekick.config.slack.webhookurl="https://hooks.slack.com/services/XXXX" \
--set falcosidekick.config.customfields="environment:production\,datacenter:paris"
-n falco

    向 Falcosidekick 发送更高级的测试事件（仍然保留端口转发）：

    curl "http://localhost:2801/" -d'{"output":"A more realistic test event","priority":"Error","rule":"Fake rule","time":"2021-04-13T20:58:00.746609046Z+2", "output_fields": {"evt.time":1618347519000000,"fd.name":"/bin/hack","proc.cmdline":"touch /bin/hack","user.name":"root"}}'

    falcosidekick slack test 2

    Falco 社区还提供了一个 Web UI，用于跟踪实时事件并获取有关上次的统计信息。 （提示：您可以通过单击任何标签来添加过滤器）

    默认情况下，您也可以通过端口转发访问它：

    kubectl port-forward svc/falco-falcosidekick-ui -n falco 2802

    您现在可以使用以下 URL 在浏览器中访问：http://localhost:2802/ui

    falcosidekick slack test 2

    falcosidekick slack test 2

    参与其中

    如果您想了解有关 Falco 的更多信息:

    就是这样！

    falco extendend architecture

    Enjoy