エージェントのインストール
- English
- 日本語
このガイドでは、パッケージリポジトリを追加し、エージェントパッケージをインストールして設定し、エージェントを起動することにより、 Next-Gen WAF エージェントをインストールする方法について説明します。
前提条件
エージェントをインストールする前に、次の操作を行う必要があります。
- Alpine Linux
- Amazon Linux
- Debian
- Red Hat/CentOS
- Ubuntu
- Windows
AlpineをDockerコンテナで実行している場合は、コンテナを起動する必要があります。
エージェントにアクセスさせたいサイトのエージェントキーをコピーします。エージェントキーは、Next-Gen WAF エージェントパッケージを設定する際に使用します。
パッケージリポジトリを追加してください
オペレーティングシステムに適切なパッケージリポジトリを追加して、エージェントのインストールプロセスを開始します。
ヒント : Windows にエージェントをインストールする場合、この手順をスキップしてエージェントパッケージのインストールを開始できます。
Alpine Linux
使用したいAlpineパッケージリポジトリのバージョンを追加してください。
注 :
これらの指示に従うと、パッケージマネージャーが
https://apk.security.fastly.comからプルするように設定できます。同じパッケージリポジトリはhttps://apk.signalsciences.netにもあります。パッケージマネージャーをhttps://apk.signalsciences.netからプルするように設定するには、関連するコードサンプル内のsecurity.fastly.comのすべてのインスタンスをsignalsciences.netに置き換えてください。
- Dockerコンテナ
- VMまたはベアメタルサーバー
Docker コンテナで Alpine を実行している場合は、次の手順を実行します。
Dockerfile に次の内容を追加します。
FROM alpine:3.20ENV ALPINE_VERSION=3.20RUN wget https://apk.security.fastly.com/sigsci_apk.pub && \apk add --repository https://apk.security.fastly.com/${ALPINE_VERSION}/main --no-cache && \apk update次のコマンドを実行して、ダウンロードしたキーに適切なキーが含まれていることを確認します。
$ openssl rsa -pubin -in /etc/apk/keys/sigsci_apk.pub -text -nooutダウンロードしたキーに適切なキーが含まれている場合、期待される出力は次のようになります。
Public-Key: (2048 bit)Modulus:00:bb:23:1a:ef:0d:61:8f:8d:55:aa:ad:01:84:43:6c:46:42:42:ab:5b:ec:4e:4b:e2:e6:b6:e7:3d:45:b7:96:70:fe:16:95:aa:09:f1:90:82:40:e4:30:2b:9e:2a:03:e9:74:63:55:66:f0:db:8c:b9:5b:f8:45:5f:ad:4e:7a:14:da:02:83:c2:36:a0:84:74:a0:bb:f9:3f:03:c8:fe:80:6a:95:0c:17:22:55:40:30:18:51:d9:30:db:7c:1b:d0:06:4e:a9:51:1a:31:0e:33:f0:6e:ad:53:98:31:a5:ac:a3:a1:44:83:72:a1:ca:78:e3:24:70:ab:7a:0e:66:32:3b:f6:c9:90:16:dc:89:d0:52:7a:50:a8:f8:59:0a:34:12:2e:85:11:f5:80:0d:d4:7d:a7:7b:3b:d7:d9:1e:28:ed:bb:f7:08:2e:9f:73:a5:23:d8:53:b4:7e:21:dd:ae:92:4a:d0:5b:86:21:9c:82:05:21:29:eb:c1:ab:91:cd:1a:7b:95:6d:43:d3:1a:a9:62:2b:b0:95:9e:cf:18:82:64:02:f9:38:7e:7f:47:9f:d9:f3:ac:fd:2c:30:ff:75:b1:11:27:1c:7a:d6:ca:04:19:f8:31:80:42:e9:4a:0d:ab:d5:b8:ad:f2:35:31:a5:3f:98:19:99:fc:29:e8:4fExponent: 65537 (0x10001)
Amazon Linux
使用したい Amazon Linux パッケージリポジトリのバージョンを追加してください。
注 :
これらの指示に従うと、パッケージマネージャーが
https://yum.security.fastly.comからプルするように設定できます。同じパッケージリポジトリはhttps://yum.signalsciences.netにもあります。パッケージマネージャーをhttps://yum.signalsciences.netからプルするように設定するには、関連するコードサンプル内のsecurity.fastly.comのすべてのインスタンスをsignalsciences.netに置き換えてください。
- Amazon Linux 2023
- Amazon Linux 2
Amazon Linux 2023 パッケージを追加するには、次のスクリプトを実行します。
$ sudo tee /etc/yum.repos.d/sigsci.repo <<-'EOF'[sigsci_release]name=sigsci_releasebaseurl=https://yum.security.fastly.com/release/amazon/2023/$basearchrepo_gpgcheck=1gpgcheck=1enabled=1gpgkey=https://yum.security.fastly.com/release/gpgkey https://dl.security.fastly.com/sigsci-agent/gpg.keysslverify=1sslcacert=/etc/pki/tls/certs/ca-bundle.crtEOFDebian
使用したいDebianパッケージリポジトリのバージョンを追加してください。
注 :
これらの指示に従うと、パッケージマネージャーが
https://apt.security.fastly.comからプルするように設定できます。同じパッケージリポジトリはhttps://apt.signalsciences.netにあります。パッケージマネージャーをhttps://apt.signalsciences.netからプルするように設定するには、関連するコードサンプル内のsecurity.fastly.comのすべてのインスタンスをsignalsciences.netに置き換えてください。
Debian 9 (Stretch) 以上のパッケージを追加するには、次のスクリプトを実行します。
$ sudo apt-get update$ sudo apt-get install -y apt-transport-https wget gnupg lsb-release$ sudo wget -qO - https://apt.security.fastly.com/release/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/sigsci.gpg$ sudo echo "deb [signed-by=/usr/share/keyrings/sigsci.gpg] https://apt.security.fastly.com/release/debian/ `lsb_release -cs` main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list$ sudo apt-get updateユーティリティのインストールに失敗した場合、一部の顧客は古いバージョンの Debian のアーカイブリポジトリを最初に追加する必要がある場合があります。例えば、Debian 10 (Buster) では、次のスクリプトを実行します。
$ sudo echo "deb http://archive.debian.org/debian/ buster main contrib non-free" >> /etc/apt/sources.list$ sudo apt-get updateRed Hat/CentOS
使用したいRed Hat/CentOSパッケージリポジトリのバージョンを追加してください。
注 :
これらの指示に従うと、パッケージマネージャーが
https://yum.security.fastly.comからプルするように設定できます。同じパッケージリポジトリはhttps://yum.signalsciences.netにもあります。パッケージマネージャーをhttps://yum.signalsciences.netからプルするように設定するには、関連するコードサンプル内のsecurity.fastly.comのすべてのインスタンスをsignalsciences.netに置き換えてください。
- Red Hat/CentOS 10
- Red Hat/CentOS 9
- Red Hat/CentOS 8
- Red Hat/CentOS 7
Red Hat/CentOS 10 パッケージを追加するには、次のスクリプトを実行します。
$ sudo tee /etc/yum.repos.d/sigsci.repo <<-'EOF'[sigsci_release]name=sigsci_releasebaseurl=https://yum.security.fastly.com/release/el/10/$basearchrepo_gpgcheck=1gpgcheck=1enabled=1gpgkey=https://yum.security.fastly.com/release/gpgkey https://dl.security.fastly.com/sigsci-agent/gpg.keysslverify=1sslcacert=/etc/pki/tls/certs/ca-bundle.crtEOFUbuntu
使用したいUbuntuパッケージリポジトリのバージョンを追加してください。
注 :
これらの指示に従うと、パッケージマネージャーが
https://apt.security.fastly.comからプルするように設定できます。同じパッケージリポジトリはhttps://apt.signalsciences.netにあります。パッケージマネージャーをhttps://apt.signalsciences.netからプルするように設定するには、関連するコードサンプル内のsecurity.fastly.comのすべてのインスタンスをsignalsciences.netに置き換えてください。
- V24.04
- V22.04
- V20.04
- V18.04
- V16.04
- V14.04
Ubuntu 24.04 - Noble パッケージを追加するには、次のスクリプトを実行します。
$ sudo apt-get update$ sudo apt-get install -y apt-transport-https wget gnupg$ wget -qO - https://apt.security.fastly.com/release/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/sigsci.gpg$ sudo echo "deb [signed-by=/usr/share/keyrings/sigsci.gpg] https://apt.security.fastly.com/release/ubuntu/ noble main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list$ sudo apt-get updateエージェントパッケージをインストールし、設定する
パッケージリポジトリを追加した後、Next-Gen WAF エージェントをインストールして設定します。
- Alpine Linux
- Amazon Linux
- Debian
- Red Hat/CentOS
- Ubuntu
- Windows
- 次のコマンドを実行して、Next-Gen WAF エージェントパッケージをインストールします。$ sudo apk add sigsci-agent
- 次のディレクトリに空のエージェント設定ファイルを作成します :
/etc/sigsci/agent.conf。 - サイト用のエージェントキーをエージェント設定ファイルに追加してください。accesskeyid = "AGENTACCESSKEYHERE"secretaccesskey = "AGENTSECRETACCESSKEYHERE"
- エージェントの設定ファイルを保存してください。
エージェントを起動してください
次に、インストールした Next-Gen WAF エージェントを起動します。
注意:エージェントをWindowsにインストールした場合は、この手順をスキップできます。インストールプロセスの最後のステップでエージェントが起動しました。
- Alpine Linux
- Amazon Linux
- Debian
- レッドハット/CentOS
- Ubuntu
Alpine を Docker コンテナで実行している場合は、次のコマンドを実行して Next-Gen WAF エージェントを起動します。
$ /usr/sbin/sigsci-agentAlpine を VM またはベアメタルサーバーで実行している場合、エージェントを再起動時に起動できるようにするために次のコマンドを実行してください。
$ sudo rc-update add sigsci-agent default次に、次のいずれかのコマンドを実行してエージェントを起動します。
$ sudo service sigsci-agent start$ sudo rc-service sigsci-agent start$ sudo /etc/init.d/sigsci-agent start次の手順
Next-Gen WAF モジュールをインストールするか、リバースプロキシとして実行するようエージェントを設定し、Next-Gen WAF のデプロイ設定を続行してください。
エージェントが Debian、Red Hat/CentOS、Ubuntu の場合、エージェントの自動更新サービスを有効にすることを検討してください。このサービスは、パッケージダウンロード Web サイトでエージェントの新しいバージョンを確認し、新しいバージョンが利用可能になるとエージェントを更新します。