Goエージェントのリリースノート

Goエージェントが、Protect機能をサポートするようになりました。

Go 1.19はサポートされなくなりました。

Assessの処理のパフォーマンスを改善しました。

サポート対象外の古いバージョンのフレームワークとのcontrast-goビルドの互換性を改善しました。以前は、サポート対象バージョンより古いパッケージでcontrast-goがビルドを中断する場合がありましたが、ビルドエラーや中断を回避し、サポートされていないバージョンが使用されていることをユーザに知らせる警告をログに書き込むようにしました。(GO-1891)

有効なエージェント設定がContrastに報告されるようになりました。アプリケーションのモードがContrast Webインターフェイスに表示されるようになりました。(GO-1636)

ジェネリックなbyte配列でスライス演算子を使用する場合のビルドエラーを修正しました。(GO-1955)

Assessのパフォーマンスを改善しました。(GO-1929、GO-1923、GO-1946)

Goエージェントは、Go Fiberフレームワークのバージョン2.40以降をサポートするようになりました。

複数のメインパッケージをコンパイルするGoコマンドでビルド失敗の原因となる競合状態を修正しました。(GO-1935)

マップキーを追跡する際のデータフローの精度を向上させました。(GO-1948)

contrast-goでビルドエラーが起こる可能性のある条件をいくつか修正しました。(GO-1907)

contrast-goの型チェックが失敗し、エージェントがいくつかのパッケージの組込みをスキップする問題を修正しました。(GO-1853)

アプリケーション作成時の応答において、シャットダウンを行う処理に関する問題を修正しました。(GO-1936)

net/httpからのリクエストに関する動きを改善し、エージェントが事前にリクエストボディを読み取らないようにしました。(GO-1925)

unicode/utf8パッケージから伝播する際のパフォーマンスを改善しました。 (GO-1924)

特定のプロパゲータにおいて、エージェントが必要もなくスタックトレースをキャプチャしていました。これは、パフォーマンスの問題を引き起こす可能性があったため修正しました。(GO-1917)

contrast-goで無効なコードが生成され、ビルドが失敗する不具合を修正しました。(GO-1904)

パストラバーサルのルールの精度を向上しました。(GO-1892)

JSONのマーシャル(marshal)による伝播がパフォーマンスの問題を引き起こしていた問題を修正しました。(GO-1912)

Goエージェントは、Go 1.21をサポートするようになりました。

net/http.Handlerインターフェイスで処理されるgRPCメッセージを追跡するポリシーを追加しました。(GO-1268)

github.com/gofiber/fiberのv2.48.0以降のサポートを追加しました。

github.com/valyala/fasthttpのv1.46.0以降のサポートを追加しました。

トレース表示の詳細を改善しました。

精度とパフォーマンスを向上させました。

Contrast CLIコマンド、contrast-go helpのサポートを追加しました。

gin.StingToBytesおよびgin.BytesToStringの伝播ポリシーを追加しました。

スタックに割り当てられたバイトスライスの追跡時にパニックを引き起こす可能性がある使用法を修正しました。

依存関係のバージョンを更新しました。

aarch64のビルドが失敗する問題を修正しました。

複数の依存関係のバージョンを更新しました。

診断の出力をContrastの仕様に合わせて更新しました。

SIGTERMとSIGINTでのエージェントのシャットダウンとフラッシュの発生方法を改善しました。

データ精度の向上とバグ修正。

Go 1.18のサポートを削除

Chiフレームワークのサポートを追加しました。

julienschmidt/httprouterルーティングライブラリのルート検出と観測を追加しました。

一部の条件下で意図せずにContrast Assessを無効にする設定オプションの問題を修正しました。(GO-1567)

ルートの重複を排除するアルゴリズムを更新しました。(GO-1528)

デフォルトのアプリケーション名としてメインパッケージのパスを使用するようにしました。

マイナーなバグ修正および改善を行いました。

Goエージェント4.0は、Contrast Webインターフェイスと直接通信を行うようになりました。Contrastサービスへの依存関係は、エージェントから削除され、通信するためにContrastサービスを使用するオプションはサポートされなくなりました。

gRPCのサポートはプレビューステータスが終了し、現在は正式にサポートとなりました。

Go1.19言語機能のサポートを追加しました。

gRPCのメッセージトラッキングの精度を向上させました。

swaggerのルート探索の失敗を修正しました。

計測のオーバーヘッドを削減し、エージェントのパフォーマンスを改善しました。

gRPCのメッセージトラッキングの精度を向上させました。

Added X-Powered-By-Set Assess response analysis

Agent failed to start in case of config option misconfiguration (GO-1497)

Fixed a race condition in concurrent map access that might result in a crash (GO-1467)

Log diagnostic data to JSON file at agent startup

Fixed logs inconsistency in cached build logs

Added process ID to the log entires

contrast-go build failed in 1.18 modules when any is redeclared. (GO-1464)

Fixed a crash condition that occurred when all required fields were missing from the configuration (GO-1446)

Improved code instrumentation when encountering shadowed type names (GO-1472)

Agent only reported routes for one service in gRPC apps with multiple services. (GO-1465)

Agent caused a memory leak in certain scenarios where an instrumented application spawns a long-running goroutine. (GO-1461)

The Go agent now supports log rotation.Log rotation can be configured using the following options:

agent:
  logger:
    rotate: 
      enable: true # defaults to false
      max_size_mb: 10 # defaults to 1. sets the maximum size of an individual log file
      backup_count: 3 # defaults 10. sets the number of backup files to retain
      compress: false # defaults to false. enables compression of rotated files

It can also be configured through environment variables.Backups are stored in agent.logger.path with a timestamp appended to the base of the filename.

Improvements to vulnerability rendering.

Log messages now use a user-friendly time format rather than Unix epochs.

Agent now correctly reports routes discovered for applications written with the go-swagger framework (GO-1377).

Agent now correctly reports library usage data for applications written with the Gin framework (GO-1292).

Support for Go 1.18.

Various minor fixes.

Update to include Go security fixes in Golang release 1.17.9.

Support for go-swagger APIs.

Route discovery and observation for gRPC APIs written with google.golang.org/grpc.

gRPC trace titles are now reported more uniquely for different inputs. (GO-1272)

The agent now supports vulnerability detection for gRPC APIs written with the google.golang.org/grpc module.The functionality is enabled via the following configuration settings:

agent:
  go:
    preview:
      grpc: true
  service:
    bypass: true

Alternately, the same feature can be enabled using environment variables:

CONTRAST__AGENT__GO__PREVIEW__GRPC=true
CONTRAST__AGENT__SERVICE__BYPASS=true

The agent now correctly reports server tags when bypassing the service. (GO-1256)

The agent now reports unvalidated redirects under the appropriate vulnerability category. (GO-1265)

contrast-go now correctly accepts build flags with double dashes. (GO-1258)

Go agent users can now configure the agent to report directly to Contrast, removing the need to install contrast-service, by using the bypass setting in their contrast_security.yaml file:

agent:
  service:
    bypass: true

Alternately, the same feature can be enabled using an environment variable:

CONTRAST__AGENT__SERVICE__BYPASS=true

When running the agent with contrast-go run main.go , the application name was reported as 'command-line-arguments'.It now reports the correct package name when possible. (GO-1188)

Exercised routes erroneously appeared as new routes due to a mismatch in how trailing slashes were interpreted by discovered vs exercised routes.Exercised routes now handle trailing slashes identically to discovered routes. (GO-1210)

Support for bufio buffered I/O.

Distributing bullseye package for Debian. (GO-1141)

Report path traversal vulnerability for os.Rename with user controlled new file name. (GO-1078)

Fix fmt handling of complex types. (GO-1146)

Tracking no longer fails when reading directly from a request body to a []byte. (GO-1147)

Fixed a false negative caused by merging multiple vulnerabilities discovered on the same route. (GO-1149)

Support for the Gin web framework.

The io/fs.Open function now correctly triggers the path traversal finding. (GO-1072)

contrast-go run now supports running programs that take arguments. (GO-1016)

When calling bufio/bytes methods on interfaces instead of concrete types, the agent won't propagate. (GO-1019)

When custom types are printed to a http.ResponseWriter, they aren't analyzed for XSS (False Negative). (GO-1053)

Golang major language version 1.17 support.

When converting from strings to named byte slices or byte slices to named strings, the agent loses data flow. (GO-1005)

When an application nests http.Handlers, the agent reports route observation and responses multiple times. (GO-999)

When triggering dataflow rules, sink events do not correctly set up parent history. (GO-1027)

When reporting route observation, the request pointer changes which breaks assess sources. (GO-1028)

Allow for custom go commands to be passed through our contrast-go executable.

When reporting sinks with multiple sources, the agent does not correctly attribute which fields/sources triggered the corresponding finding. (Go-950)

When rewriting a slice operation on a named byte slice type with methods, the build fails. (Go-991)

When appending data, the agent incorrectly detects if the data is tracked, resulting in no finding when reporting to TeamServer. (Go-993)

When dataflow events happen concurrently, the runtime panics and crashes the application. (Go-1023)

When the application starts, the agent spawns ticker routines which continuously leak more tickers. (GO-995)

When sending enhanced class usage, the agent never releases previous reports and spends unnecessary resources on de-duping. (GO-996)

When an application calls a pointer method with a value, the rewritten code copies by value not reference, changing the runtime behavior. (GO-989)

Improve performance of rewritten code.

When propagating through bytes Buffer/Reader.Read, no propagation event is shown in the finding trace. (GO-993)

When rewriting go function literals with returns, the rewriter omits the returns and breaks builds. (GO-937)

When an error occurs during initialization of the logger, the agent shuts itself off. (GO-952)

When a slice of a tainted byte slice reaches a sink, the sink is not triggered (false negative). (GO-983)

Enhanced data flow tracking, which improves agent accuracy.

When propagating through a circular buffer, the agent caused a stack overflow. (GO-982)

When an error occurs during agent initialization, more specific/detailed error messages are logged.

When using getTypeName, the rewriter failed to safely handle errors and did not inject correct packages. (GO-884)

When comparing types, the rewriter incorrectly compared by pointer rather than by type. (GO-885)

Update the rewriter to only emit on exported functions, reducing the performance overhead of the rewriter itself.

When replacing expressions with callexprs, the agent may break addressability, resulting in a failed build. (GO-873)

When creating caches for rewrite, the reported tool version is not included, resulting in caches that will not be rebuilt despite agent changes. (GO-875)

When rewriting string slices, shadowed type names do not prevent casts from being injected, resulting in code that will not build. (GO-883)

Updated the rewriter functionality of the agent to rely on Go’s toolexec to allow for the instrumentation of a larger set of Go applications.

Add custom SSRF sink for net/http Client.PostForm.

Added the ability to rewrite Go code including compiler directive comments, such as, //go:embed, //go:nosplit and //go:noescape and others.

OSS and Assess feature support for the Go standard library.

Update agent.logger.path and agent.logger.level config settings to those from remote settings. (GO-844)