
このプロジェクトは、Spring Security を OAuth (1a) および OAuth2 と共に使用するためのサポートを提供します。標準的な Spring および Spring Security のプログラミングモデルと設定慣行を使用して、これらのプロトコルのコンシューマとプロバイダの両方を実装するための機能を提供します。
このプロジェクトは Contributor Covenant 行動規範 に準拠しています。参加することで、この規範を遵守することが期待されます。不快な行為は [email protected] まで報告してください。
ダウンロード するか、GIT からクローンして、Maven (3.0.*) と Java (1.6 以降) を使用します:
$ git clone ...
$ mvn install -P bootstrap
bootstrap プロファイルは最初の一度だけ使用してください - このプロファイルは、デフォルトでは poms に公開できないいくつかのリポジトリを有効にします。このプロファイルをローカルの settings.xml に追加すると便利な場合があります。
ビルドを成功させるには Redis を実行する必要があります。homebrew を使用してインストールできます。Redis を実行していないと、ビルド中に Jedis の接続例外が多数発生します。
SpringSource ToolSuite ユーザー (または最新の m2eclipse プラグインを使用する Eclipse ユーザー) は、プロジェクトを既存の Maven プロジェクトとしてインポートできます。
Spring Security OAuth は Apache Software License Version 2.0 (license.txt を参照) の条件の下でリリースされています。
サンプルと統合テストは サブディレクトリ にあります。案内と情報のための独立した README があります。上記の「はじめに」の手順に従ってアーティファクトをローカルにインストールしたら、次のコマンドを実行できるはずです:
$ cd samples/oauth2/tonr
$ mvn tomcat7:run
そして、ブラウザで http://localhost:8080/tonr2/ のアプリにアクセスして、動作を確認してください。(これは OAuth 2.0 サンプル用です。OAuth 1.0a サンプルの場合は、ディレクトリパスから "2" を削除してください。) 統合テストには Tomcat の設定が少し異なる必要があるため、プロファイルを追加する必要があります:
$ cd samples/oauth2/tonr
$ mvn integration-test -P integration
リリースごとに対処された問題の一覧は github にあります (古いリリースは JIRA にあります)。
コミュニティに参加する方法はいくつかあります:
私たちが重要なパッチやプルリクエストを受け入れる前に、貢献者契約 に署名していただく必要があります。貢献者契約への署名は、メインリポジトリへのコミット権を誰かに与えるものではありませんが、あなたの貢献を受け入れることができることを意味し、受け入れた場合は著者としてのクレジットが得られます。積極的な貢献者はコアチームに参加するよう求められ、プルリクエストをマージする権限が与えられる可能性があります。
これらはプルリクエストに必須ではありませんが、すべて役立ちます。元のプルリクエストの後でも、マージ前に追加できます。
eclipse-code-formatter.xml をインポートしてください。IntelliJ を使用している場合は、spring-intellij-code-style.xml を ~/.IntelliJIdea*/config/codestyles にコピーし、Settings -> Code Styles から spring-intellij-code-style を選択してください。一部の Javadoc と、名前空間を変更する場合は XSD ドキュメント要素を追加してください。 単体テストもいくつかあると非常に役立ちます - 誰かがやらなければなりません。 あなたのブランチを他に誰も使用していない場合は、現在の master (またはメインプロジェクトの他のターゲットブランチ) に対してリベースしてください。