Ruby の ASM を有効にする

Docs > Datadog Security > Application Security Management > ASM の有効化 > Ruby の ASM を有効にする

Docker、Kubernetes、Amazon ECS、および AWS Fargate で実行されている Ruby アプリケーションのセキュリティを監視することができます。

In general, setting up Application Security Management (ASM) involves:

Identifying services that are vulnerable or are under attack, which would most benefit from ASM. Find them on the Security tab of your Service Catalog.
Updating to the latest Datadog library (the most recent APM tracing library).
Enabling the library to collect the application security data from the services and send it to Datadog.
Triggering security signals in your application and seeing how Datadog displays the resulting information.

Prerequisites

The Datadog Agent is installed and configured for your application’s operating system or container, cloud, or virtual environment.
Datadog APM is configured for your application or service, and traces are being received by Datadog.
If your service is running with an Agent with Remote Configuration enabled and a tracing library version that supports it, you can block attackers from the Datadog UI without additional configuration of the Agent or tracing libraries.

脅威検出を有効にする

はじめに

Gemfile を更新して Datadog ライブラリを含めます:
```
gem 'ddtrace', '~> 1.1'
```
サービスの言語やフレームワークのバージョンが ASM 機能に対応しているかどうかは、互換性をご参照ください。
dd-trace 0.x バージョンからのアップグレードの詳細については、Ruby トレーサーアップグレードガイドを参照してください。

APMトレーサーを有効にすることで、ASM を有効にします。以下のオプションは、最も一般的なケースをカバーするクイックセットアップを説明します。詳細については、Ruby トレーサーのドキュメントをお読みください。

コード内で ASM を有効にすることができます。

アプリケーションコードにイニシャライザーを追加して、APM トレーサーを有効にします。

# config/initializers/datadog.rb

require 'datadog/appsec'

Datadog.configure do |c|
  # APM トレーサーを有効にする
  c.tracing.instrument :rails

  # ASM を有効にする
  c.appsec.enabled = true
  c.appsec.instrument :rails
end

または、自動インスツルメントするために Gemfile を更新して、自動インスツルメンテーションを通じて APM トレーサーを有効にします。

gem 'ddtrace', '~> 1.1', require: 'ddtrace/auto_instrument'

また、appsec を有効にします。

# config/initializers/datadog.rb

require 'datadog/appsec'

Datadog.configure do |c|
  # APM トレーサーは自動インスツルメンテーションで有効になっている

  # ASM を有効にする
  c.appsec.enabled = true
  c.appsec.instrument :rails
end

アプリケーションのスタートアップに以下を追加して、APM トレーサーを有効にします。

require 'sinatra'
require 'ddtrace'
require 'datadog/appsec'

Datadog.configure do |c|
  # APM トレーサーを有効にする
  c.tracing.instrument :sinatra

  # ASM for Sinatra を有効にする
  c.appsec.enabled = true
  c.appsec.instrument :sinatra
end

または自動インスツルメンテーションで APM トレーサーを有効にします。

require 'sinatra'
require 'ddtrace/auto_instrument'

Datadog.configure do |c|
  # APM トレーサーは自動インスツルメンテーションで有効になっている

  # ASM for Sinatra を有効にする
  c.appsec.enabled = true
  c.appsec.instrument :sinatra
end

config.ru ファイルに以下を追加して、APM トレーサーを有効にします。

require 'ddtrace'
require 'datadog/appsec'

Datadog.configure do |c|
  # APM トレーサーを有効にする
  c.tracing.instrument :rack

  # ASM for Rack を有効にする
  c.appsec.enabled = true
  c.appsec.instrument :rack
end

use Datadog::Tracing::Contrib::Rack::TraceMiddleware
use Datadog::AppSec::Contrib::Rack::RequestMiddleware

または、アプリケーションの実行場所に応じて、以下の方法のいずれかを使用します。

APM 用の構成コンテナを更新するには、docker run コマンドに以下の引数を追加します。

docker run [...] -e DD_APPSEC_ENABLED=true [...]

コンテナの Dockerfile に以下の環境変数の値を追加します。

ENV DD_APPSEC_ENABLED=true

APM 用の構成 yaml ファイルコンテナを更新し、AppSec の環境変数を追加します。

spec:
  template:
    spec:
      containers:
        - name: <CONTAINER_NAME>
          image: <CONTAINER_IMAGE>/<TAG>
          env:
            - name: DD_APPSEC_ENABLED
              value: "true"

以下を環境セクションに追加して、ECS タスク定義 JSON ファイルを更新します。

"environment": [
  ...,
  {
    "name": "DD_APPSEC_ENABLED",
    "value": "true"
  }
]

コード内で ASM を初期化するか、サービスの呼び出し時に環境変数 DD_APPSEC_ENABLED を true に設定します。

env DD_APPSEC_ENABLED=true rails server

The library collects security data from your application and sends it to the Agent, which sends it to Datadog, where out-of-the-box detection rules flag attacker techniques and potential misconfigurations so you can take steps to remediate.

To see Application Security Management threat detection in action, send known attack patterns to your application. For example, trigger the Security Scanner Detected rule by running a file that contains the following curl script:
```
for ((i=1;i<=250;i++)); 
do
# Target existing service’s routes
curl https://your-application-url/existing-route -A dd-test-scanner-log;
# Target non existing service’s routes
curl https://your-application-url/non-existing-route -A dd-test-scanner-log;
done
```
Note: The dd-test-scanner-log value is supported in the most recent releases.
A few minutes after you enable your application and exercise it, threat information appears in the Application Trace and Signals Explorer in Datadog.