Goエージェントを手動でインストール

重要

この機能はベータ版です。そのため、機能に変更が生じる場合や、予期せぬ動作をする場合があります。このエージェントをインストールすると、Contrastベータプログラムの利用規約に同意したことになります。

Goエージェントをインストールするには:

  1. https://pkg.contrastsecurity.comから両方の実行ファイルをダウンロードします。

    contrast-gocontrast-serviceの実行ファイルは、MacおよびLinux OS用に直接ダウンロードすることができます。以下の例では、<#.#.#>をサービスとリライタの適切なバージョンに置き換えてください。利用可能なバージョンは、 contrast-service-releasego-agent-release で確認できます。

    • Macの場合:

      wget https://pkg.contrastsecurity.com/contrast-service-release/latest/darwin-amd64/contrast-service
      wget https://pkg.contrastsecurity.com/go-agent-release/latest/darwin-amd64/contrast-go

      または

      curl -L https://pkg.contrastsecurity.com/contrast-service-release/latest/darwin-amd64/contrast-service > contrast-service
      curl -L https://pkg.contrastsecurity.com/go-agent-release/latest/darwin-amd64/contrast-go > contrast-go
    • Linuxの場合:

      wget https://pkg.contrastsecurity.com/contrast-service-release/latest/linux-amd64/contrast-service
      wget https://pkg.contrastsecurity.com/go-agent-release/latest/linux-amd64/contrast-go

      または

      curl -L https://pkg.contrastsecurity.com/contrast-service-release/latest/linux-amd64/contrast-service > contrast-service
      curl -L https://pkg.contrastsecurity.com/go-agent-release/latest/linux-amd64/contrast-go > contrast-go
  2. ダウンロードしたら、エージェントとサービスが実行可能であることを確認します。例:

    chmod u+x contrast-service
    chmod u+x contrast-go
  3. 計測するアプリケーションの準備をします。アプリケーションには、必要な依存関係を示すgo.modファイルが必要です。アプリケーションのソースディレクトリで、以下のコマンドを実行します。

    go mod init
  4. アプリケーションをビルドします。

    contrast-go build -o output-name-of-application
  5. 計測対象のアプリケーションを、ビルド元と同じサーバで実行する必要はありません。アプリケーションを実行するには、Contrast serviceを起動し、サービスと通信するようにアプリケーションを設定して、アプリケーションを起動します。

    設定を容易にするため、アプリケーションとサービスで同じcontrast_security.yaml設定ファイルを共有できます。そのためには、設定ファイルを/etc/contrast/contrast_security.yamlに配置しエージェントキーを確認して以下の値を設定します。

    api:
      url:
      api_key:
      secret_key:
      user_name:
    agent:
      service:
        host: 127.0.0.1
        port: 30555
        socket: /tmp/contrast.sock # optional: only `socket` OR `host` and `port` should be set
        grpc: true

    Contrast serviceの実行の詳細については、Contrast serviceのインストールを参照してください。

    ランタイム設定オプションの詳細については、Go固有の設定を参照してください。

  6. アプリケーションを疎通してテストします。

  7. Contrastを表示して、エージェントがインストールされ、依存関係の情報と検出結果が報告されていることを確認します。