altrive / gitbucket Goto Github PK

概要

HttpPlatformHandlerを使用してGitBucketをホスティングする場合
IIS側に認証処理を任せることが可能。
HTTPヘッダ X-IIS-WindowsAuthToken に認証トークンが渡ってくるので
これを処理するプラグインを書けばSSOに対応可能と思われる。

実装方針

1. GitBucketプラグインを作成し /windows_auth/signin で認証トークンを処理
2. /windows_auth/ フォルダに対し、IIS側でWindows認証を要求するよう設定する。
3. デフォルトの認証リダイレクト先を /signinから/auth/signin_ssoに変更する。
   認証トークンがない場合は既定のサインインページにリダイレクト。

TODO

GitBucketプラグインを作成し、問題なく動作しそうなことまでは確認済み。
HttpPlatformHandlerの将来性が不明確のため、対応保留中。
今後、HttpPlatformHandler v1.3がリリースされるようなら、対応を検討。

GitBucketのWikiには Helicontech Zoo を使用する手順しか記載されていない。
Windows上でのホスティング方法について手順をWikiに追加する。

• Windowsサービス上でのホスティング手順
  → おそらくこれが一番無難な方式。

• HttpPlatformHandlerを使用したホスティング手順
  → 認証/ロギング等にIIS側機能が利用できる利点がある。
  → ただ、ASP.NET Coreがこのモジュールを使用しなくなって以降、保守がされてるのか怪しい。

Microsoft JDBC Driver 6.0 for SQL Serverに含まれるsqljdbc_auth.dll を追加で配置することで
Windows統合認証が利用可能であることを確認済み。
https://www.microsoft.com/en-us/download/details.aspx?id=11774

Windows統合認証を利用する場合(integratedSecurity=true)
GitBucketの起動アカウントが認証に使用される。
このため、ユーザー名/パスワードをdatabase.confに記載する必要がなくなる。

統合認証を利用する場合の設定例

db {
  url = "jdbc:sqlserver://localhost;instanceName=SQLEXPRESS;databaseName=GitBucket;integratedSecurity=true;applicationName=GitBucket"
  #url = "jdbc:sqlserver://localhost:1433/databaseName=${DatabaseHome};integratedSecurity=true;instance=SQLEXPRESS"
  user = "dummy"
  password = "dummy"
}

※バリデーションチェックの都合上、user/passwordにはダミー値を設定する必要がある。

TODO

• Wikiに設定手順を記載する(英語)

以下のOS/データベースの組合せで正常に動作することを確認する。

Windows

• SQL Server 2016 SP1 (Express Edition)

Linux

• SQL Server on Linux vNext
  → vNextが正式リリースされたら確認予定

その他

• Azure SQL Database
  → いまのところ動作確認予定なし。

AppVeyerを使用し、Windows向けのCIビルド環境を用意する。

TODO

• AppVeyer環境のセットアップ
• SQL Server利用時のDBマイグレーションテスト追加

その他

既存のTravis CI 上でも、SQL Server on　Linux のDockerイメージを利用したテストを行いたいが
現時点で試した方の記載をみる限り、実行タイムアウト等の問題があるらしいので対応は保留。