Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

[インデックス 12425] ファイルの概要

このコミットは、Go言語の標準ライブラリである src/pkg/crypto/tls/tls.go ファイルに対する変更です。このファイルは、Goの crypto/tls パッケージの主要なエントリポイントであり、TLS (Transport Layer Security) プロトコルの実装に関連する機能を提供します。具体的には、パッケージのドキュメンテーションコメントを更新し、その説明をより正確なものにしています。

コミット

このコミットは、crypto/tls パッケージのドキュメンテーションコメントを修正し、パッケージが部分的に実装しているTLSプロトコルのバージョンに関する記述をより正確なものにしています。以前はTLS 1.1 (RFC 4346) を部分的に実装していると記述されていましたが、このコミットによりTLS 1.0 (RFC 2246) を部分的に実装しているという記述に修正されました。これは、GoのTLS実装の実際の能力と、ドキュメンテーションとの間の乖離を修正するためのものです。

GitHub上でのコミットページへのリンク

https://github.com/golang/go/commit/4f25e4be028ea975fa93fcfe97759dae3b85f256

元コミット内容

commit 4f25e4be028ea975fa93fcfe97759dae3b85f256
Author: Adam Langley <agl@golang.org>
Date:   Tue Mar 6 12:49:29 2012 -0500

    crypto/tls: make the package description more accurate and less aspirational.
    
    Fixes #3216.
    
    R=golang-dev, bradfitz
    CC=golang-dev
    https://golang.org/cl/5755056

変更の背景

この変更の背景には、Go言語の crypto/tls パッケージが実際にサポートしているTLSプロトコルのバージョンと、そのパッケージのドキュメンテーションに記載されている内容との間に不一致があったという問題があります。コミットメッセージにある Fixes #3216 が示すように、これはIssue 3216を修正するためのものです。

当時のGoの crypto/tls パッケージは、TLS 1.1のすべての機能を完全に実装しているわけではありませんでした。しかし、パッケージのコメントには「TLS 1.1プロトコルを部分的に実装している」と記載されていました。これは、ユーザーに対して誤解を与える可能性がありました。

このコミットは、パッケージのドキュメンテーションを現実のGoのTLS実装の能力に合わせて修正することを目的としています。つまり、「部分的に実装している」という記述は維持しつつも、その対象プロトコルをより古いTLS 1.0に限定することで、より正確な情報を提供するように変更されました。これは、ドキュメンテーションがコードの現状を正確に反映すべきであるという原則に基づいています。

前提知識の解説

TLS (Transport Layer Security)

TLSは、インターネット上でデータを安全にやり取りするための暗号化プロトコルです。以前はSSL (Secure Sockets Layer) と呼ばれていましたが、現在はTLSがその標準となっています。TLSは、クライアントとサーバー間の通信を暗号化し、データの完全性を保証し、通信相手の認証を行うことで、盗聴、改ざん、なりすましを防ぎます。

TLSのバージョン

TLSプロトコルには複数のバージョンが存在し、それぞれが異なるRFC (Request for Comments) で定義されています。新しいバージョンほどセキュリティが強化され、古いバージョンの脆弱性が修正されています。

  • TLS 1.0 (RFC 2246): 1999年に定義されたTLSの最初のバージョンです。SSL 3.0の後継として登場しました。
  • TLS 1.1 (RFC 4346): 2006年に定義されたバージョンで、TLS 1.0のいくつかの脆弱性（特にCBCモードの攻撃に対する耐性）を改善しました。
  • TLS 1.2 (RFC 5246): 2008年に定義されたバージョンで、より強力なハッシュアルゴリズム（SHA-256など）と暗号スイートのサポートが追加されました。現在でも広く利用されています。
  • TLS 1.3 (RFC 8446): 2018年に定義された最新のバージョンで、ハンドシェイクの高速化、セキュリティの強化、古い脆弱な機能の削除など、大幅な改善が施されています。

Go言語の crypto/tls パッケージ

Go言語の標準ライブラリには、TLSプロトコルを扱うための crypto/tls パッケージが含まれています。このパッケージは、TLSクライアントおよびサーバーの実装を提供し、安全なネットワーク通信を可能にします。GoのTLS実装は、セキュリティとパフォーマンスを重視して設計されており、多くのGoアプリケーションでHTTPS通信などに利用されています。

技術的詳細

このコミットの技術的な詳細は、Go言語の crypto/tls パッケージのドキュメンテーションコメントの変更に集約されます。

変更前は、src/pkg/crypto/tls/tls.go ファイルの冒頭にあるパッケージコメントが以下のようになっていました。

// Package tls partially implements the TLS 1.1 protocol, as specified in RFC
// 4346.

この記述は、「TLS 1.1プロトコルを部分的に実装している」と明記しており、参照しているRFCはTLS 1.1を定義するRFC 4346でした。

しかし、当時のGoの crypto/tls パッケージの実際の機能は、TLS 1.1のすべての仕様を完全に満たしているわけではありませんでした。特に、TLS 1.1で導入された特定のセキュリティ強化や機能が完全にサポートされていなかった可能性があります。そのため、この記述はGoのTLS実装の現状を正確に反映していませんでした。

このコミットでは、この記述を以下のように変更しました。

// Package tls partially implements TLS 1.0, as specified in RFC 2246.

この変更により、以下の点が明確になりました。

  1. 対象プロトコルの変更: TLS 1.1からTLS 1.0に変更されました。これは、当時のGoのTLS実装が、TLS 1.0の仕様に対してはより完全な「部分的な実装」を提供していたことを示唆しています。
  2. 参照RFCの変更: RFC 4346 (TLS 1.1) からRFC 2246 (TLS 1.0) に変更されました。これにより、ドキュメンテーションが参照する標準が、実装の能力と一致するようになりました。
  3. 「部分的に実装」の維持: 「partially implements（部分的に実装している）」という表現は維持されています。これは、TLS 1.0のすべての側面を完全に実装しているわけではないことを示しており、GoのTLS実装が進化途上であったことを示唆しています。

この変更は、コードの機能そのものを変更するものではなく、あくまでドキュメンテーションの正確性を向上させるためのものです。しかし、ライブラリの利用者がその機能範囲を正しく理解するためには非常に重要な修正です。特にセキュリティ関連のライブラリにおいては、ドキュメンテーションの正確性が信頼性に直結します。

コアとなるコードの変更箇所

--- a/src/pkg/crypto/tls/tls.go
+++ b/src/pkg/crypto/tls/tls.go
@@ -2,8 +2,7 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
-// Package tls partially implements the TLS 1.1 protocol, as specified in RFC
-// 4346.
+// Package tls partially implements TLS 1.0, as specified in RFC 2246.
 package tls
 
 import (

コアとなるコードの解説

上記の diff は、src/pkg/crypto/tls/tls.go ファイルの変更を示しています。

  • - // Package tls partially implements the TLS 1.1 protocol, as specified in RFC
  • - // 4346.

これら2行は削除された行です。以前のパッケージコメントが、TLS 1.1プロトコルとRFC 4346を参照していることを示しています。

  • + // Package tls partially implements TLS 1.0, as specified in RFC 2246.

この1行は追加された行です。新しいパッケージコメントが、TLS 1.0プロトコルとRFC 2246を参照していることを示しています。

この変更は、Goの crypto/tls パッケージのドキュメンテーションコメントを、その時点での実際のTLS実装の能力に合わせて修正したものです。コードの動作自体には影響を与えませんが、パッケージの機能に関する公式な説明を正確にすることで、開発者がGoのTLSライブラリをより適切に利用できるようになります。

関連リンク

参考にした情報源リンク