章 ▾ 第2版

4.6 サーバ上のGit - スマートHTTP

スマートHTTP

SSHによる認証済みアクセスとgit://による非認証アクセスが利用可能になりましたが、同時に両方を行うことができるプロトコルもあります。スマートHTTPの設定は、基本的に、Gitに付属しているgit-http-backendと呼ばれるCGIスクリプトをサーバー上で有効にするだけです。このCGIは、HTTP URLへのgit fetchまたはgit pushによって送信されるパスとヘッダーを読み取り、クライアントがHTTP経由で通信できるかどうかを判断します（これはバージョン1.6.6以降のすべてのクライアントに当てはまります）。CGIがクライアントがスマートであると判断した場合、スマートに通信します。そうでない場合は、ダムな動作に戻ります（そのため、古いクライアントからの読み取りと後方互換性があります）。

ごく基本的な設定を見ていきましょう。これをCGIサーバーとしてApacheで設定します。Apacheがセットアップされていない場合は、Linuxマシンで次のように設定できます

$ sudo apt-get install apache2 apache2-utils
$ a2enmod cgi alias env

これにより、この機能が適切に動作するために必要なmod_cgi、mod_alias、およびmod_envモジュールも有効になります。

ウェブサーバーがリポジトリへの読み取りおよび書き込みアクセスできるように、/srv/gitディレクトリのUnixユーザーグループをwww-dataに設定する必要もあります。これは、CGIスクリプトを実行するApacheインスタンスが（デフォルトで）そのユーザーとして実行されるためです。

$ chgrp -R www-data /srv/git

次に、ウェブサーバーの/gitパスへのすべてのアクセスに対してgit-http-backendをハンドラーとして実行するように、Apacheの設定にいくつか追加する必要があります。

SetEnv GIT_PROJECT_ROOT /srv/git
SetEnv GIT_HTTP_EXPORT_ALL
ScriptAlias /git/ /usr/lib/git-core/git-http-backend/

GIT_HTTP_EXPORT_ALL環境変数を省略すると、Gitデーモンと同様に、git-daemon-export-okファイルがあるリポジトリのみを認証されていないクライアントに提供します。

最後に、Apacheにgit-http-backendへのリクエストを許可し、何らかの方法で書き込みが認証されるように指示する必要があります。おそらく、次のようなAuthブロックを使用します。

<Files "git-http-backend">
    AuthType Basic
    AuthName "Git Access"
    AuthUserFile /srv/git/.htpasswd
    Require expr !(%{QUERY_STRING} -strmatch '*service=git-receive-pack*' || %{REQUEST_URI} =~ m#/git-receive-pack$#)
    Require valid-user
</Files>

そのためには、すべての有効なユーザーのパスワードを含む.htpasswdファイルを作成する必要があります。ファイルに「schacon」ユーザーを追加する例を次に示します。

$ htpasswd -c /srv/git/.htpasswd schacon

Apacheでユーザーを認証する方法は多数ありますので、その中から1つを選択して実装する必要があります。これは私たちが考えられる最もシンプルな例です。また、このデータをすべて暗号化するために、SSL経由で設定することをほぼ確実に希望するでしょう。

異なるサーバーを使用していたり、異なる認証ニーズがある可能性もあるため、Apacheの設定の詳細に深入りしたくはありません。Gitにはgit-http-backendと呼ばれるCGIが付属しており、それが呼び出されると、HTTP経由でデータを送受信するためのすべてのネゴシエーションを行います。それ自体は認証を実装していませんが、それを呼び出すウェブサーバーの層で簡単に制御できます。これはほとんどすべてのCGI対応ウェブサーバーで実行できるため、最もよく知っているものを使用してください。

注記

Apacheでの認証設定に関する詳細については、こちらでApacheのドキュメントを確認してください：https://httpd.apache.org/docs/current/howto/auth.html。
scroll-to-top