スタートガイド

手順

1. Red Hat カスタマーポータル に移動します。
2. Red Hat Single Sign-On サーバー (rh-sso-7.6.zip) をダウンロードします。
3. 選択したディレクトリーにファイルを配置します。

4. unzip、tar、Expand-Archive などの適切な unzip ユーティリティーを使用して ZIP ファイルをデプロイメントします。

   Linux/Unix

   $ unzip rhsso-7.6.zip
   
   or
   
   $ tar -xvzf rh-sso-7.6.tar.gz

   Windows

   > Expand-Archive -Path 'C:Downloads\rhsso-7.6.zip' -DestinationPath 'C:\Downloads'

5. Red Hat カスタマーポータル に戻ります。
6. Patches タブをクリックします。

7. Red Hat Single Sign-On 7.6.11 サーバーパッチをダウンロードします。

   選択したディレクトリーにダウンロードした ZIP ファイルを配置します。

8. Red Hat Single Sign-On サーバーのルートディレクトリーに移動します。

9. JBoss EAP コマンドラインインターフェイスを起動します。

   Linux/Unix

   $ ./bin/jboss-cli.sh

   Windows

   > .\bin\jboss-cli.bat

10. パッチを適用します。

    $ patch apply <path-to-zip>/rh-sso-7.6.11-patch.zip

手順

1. Red Hat Single Sign-On サーバーのルートディレクトリーに移動します。

2. enable-elytron-se17.cli スクリプトを渡して jboss-cli コマンドを実行します。

   Linux/Unix

   $ ./bin/jboss-cli.sh --file=docs/examples/enable-elytron-se17.cli

   Windows

   > .\bin\jboss-cli.bat --file=docs\examples\enable-elytron-se17.cli

手順

1. サーバーディストリビューションの bin ディレクトリーに移動します。

2. ブートスクリプト standalone を実行します。

   Linux/Unix

   $ cd bin
   $ ./standalone.sh

   Windows

   > ...\bin\standalone.bat

手順

1. Web ブラウザーで http://localhost:8080/auth を開きます。

   Welcome ページが開き、サーバーが実行していることを確認します。

   Welcome ページ

   

2. ユーザー名とパスワードを入力して、最初の管理ユーザーを作成します。

手順

1. Welcome ページの Administration Console リンクをクリックします。または、http://localhost:8080/auth/admin/ (コンソール URL) に直接アクセスします。

   注記

   管理コンソールは通常、Red Hat Single Sign-On ドキュメントの管理コンソールと呼ばれます。

2. Welcome ページで作成したユーザー名とパスワードを入力して、管理コンソール を開きます。

   管理コンソールのログイン画面

   

   管理コンソールの初期画面が表示されます。

   管理コンソール

   

手順

1. http://localhost:8080/auth/admin/ にアクセスし、管理者アカウントを使用して Red Hat Single Sign-On 管理コンソールにログインします。
2. マスターメニューから、Add Realm をクリックします。マスターレルムにログインすると、このメニューに他のすべてのレルムが一覧表示されます。

3. Name フィールドに demo と入力します。

   新しいレルム

   

   注記

   レルム名は大文字と小文字を区別するため、大文字小文字に注意してください。

4. Create をクリックします。

   レルムを demo に設定し、メインの管理コンソールページが開きます。

   demo レルム

   

5. Select realm ドロップダウンリストでエントリーをクリックして、master レルムと、作成したレルムの管理を切り替えます。

手順

1. メニューから Users をクリックしてユーザーリストページを開きます。
2. 空のユーザーリストの右側で、Add User をクリックして Add user ページを開きます。

3. Username フィールドに名前を入力します。

   これは唯一の必須フィールドです。

   Add user ページ

   

4. Email Verified スイッチを On に切り替え、Save をクリックします。

   新規ユーザーの管理ページが開きます。

5. Credentials タブをクリックして、新規ユーザーの一時パスワードを設定します。
6. 新規パスワードを入力して確認します。

7. Set Password をクリックして、指定した新しいパスワードにユーザーパスワードを設定します。

   認証情報ページの管理

   

   注記

   このパスワードは一時的なもので、ユーザーは初回ログイン時にパスワードを変更する必要があります。永続的なパスワードを作成する場合は、Temporary スイッチを Off に切り替え、Set Password をクリックします。

手順

1. ユーザーメニューを開き、Sign Out を選択して管理コンソールからログアウトします。
2. http://localhost:8080/auth/realms/demo/account にアクセスし、作成したユーザーで demo レルムにログインします。

3. 新しいパスワードを入力するように求められたら、記憶できるパスワードを入力します。

   パスワードの更新

   

   このユーザーのアカウントコンソールが開きます。

   アカウントコンソール

   

4. このページを使用してテストする値で必須フィールドに入力します。

手順

1. Red Hat カスタマーポータル から JBoss EAP 7.3 をダウンロードします。

2. ダウンロードした JBoss EAP をデプロイメントします。

   $ unzip <filename>.zip

3. Red Hat Single Sign-On の root ディレクトリーに移動します。

4. jboss.socket.binding.port-offset システムプロパティーの値を指定して、Red Hat Single Sign-On サーバーを起動します。この値は、Red Hat Single Sign-On サーバーにより開かれる全ポートのベース値に追加されます。この例では、100 が値です。

   Linux/Unix

   $ cd bin
   $ ./standalone.sh -Djboss.socket.binding.port-offset=100

   Windows

   > ...\bin\standalone.bat -Djboss.socket.binding.port-offset=100

   Windows Powershell

   > ...\bin\standalone.bat -D"jboss.socket.binding.port-offset=100"

5. Red Hat Single Sign-On サーバーが稼働していることを確認します。http://localhost:8180/auth/admin/ にアクセスします。

   管理コンソールを開くと、JBoss EAP が Red Hat Single Sign-On と動作できるようにするクライアントアダプターをインストールすることができます。

手順

1. Red Hat カスタマーポータル から、Client Adapter for EAP 7 をダウンロードします。
2. JBoss EAP のルートディレクトリーに移動します。

3. ダウンロードしたクライアントアダプターをこのディレクトリーにデプロイメントします。以下に例を示します。

   $ unzip <filename>.zip

4. bin ディレクトリーに移動します。

   $ cd bin

5. プラットフォームに適したスクリプトを実行します。

   注記

   file not found エラーが発生した場合は、前の手順で unzip を使用していたことを確認してください。この展開方法により、正しい場所にファイルがインストールされます。

   Linux/Unix

   $ ./jboss-cli.sh --file=adapter-elytron-install-offline.cli

   Windows

   > jboss-cli.bat --file=adapter-elytron-install-offline.cli

   注記

   このスクリプトを使用すると、…​/standalone/configuration/standalone.xml ファイルに必要な編集が行われます。

6. アプリケーションサーバーを起動します。

   Linux/Unix

   $ ./standalone.sh

   Windows

   > ...\standalone.bat

手順

1. 管理者アカウントで管理コンソール (http://localhost:8180/auth/admin/) にログインします。
2. 左上のドロップダウンリストで、Demo レルムを選択します。

3. 左側のメニューで Clients をクリックし、クライアントページを開きます。

   Clients

   

4. 右側の Create をクリックします。

5. クライアントの追加ダイアログで、以下のようにフィールドを埋めて、vanilla という名前のクライアントを作成します。

   クライアントの追加

   

6. Save をクリックします。
7. 表示される Vanilla クライアントページで、Installation タブをクリックします。

8. Keycloak OIDC JSON を選択して、後で必要なファイルを生成します。

   Keycloak.json ファイル

   

9. Download をクリックして、後で確認できる場所に Keycloak.json を保存します。

10. Keycloak OIDC JBoss Subsystem XML を選択して XML テンプレートを生成します。

    テンプレート XML

    

11. Download をクリックして、次の手順で使用するコピーを保存します。これには JBoss EAP の設定が含まれます。

手順

1. JBoss EAP ルートディレクトリーの standalone/configuration ディレクトリーに移動します。

2. standalone.xml ファイルを開き、以下のテキストを検索します。

   <subsystem xmlns="urn:jboss:domain:keycloak:1.1"/>

3. 次に示すように、XML エントリーを自己終了から開始タグと終了タグのペアを使用するように変更します。

   <subsystem xmlns="urn:jboss:domain:keycloak:1.1">
   </subsystem>

4. 以下の例のように、XML テンプレートの内容を <subsystem> 要素内に貼り付けます。

   <subsystem xmlns="urn:jboss:domain:keycloak:1.1">
     <secure-deployment name="WAR MODULE NAME.war">
       <realm>demo</realm>
       <auth-server-url>http://localhost:8180/auth</auth-server-url>
       <public-client>true</public-client>
       <ssl-required>EXTERNAL</ssl-required>
       <resource>vanilla</resource>
     </secure-deployment>
   </subsystem>

5. WAR MODULE NAME.war を vanilla.war に変更します。

   <subsystem xmlns="urn:jboss:domain:keycloak:1.1">
     <secure-deployment name="vanilla.war">
     ...
   </subsystem>

6. アプリケーションサーバーを再起動します。

手順

1. JBoss EAP アプリケーションサーバーが起動していることを確認します。

2. 以下のコマンドを使用して、コードをダウンロードし、ディレクトリーを変更します。

   $ git clone https://github.com/redhat-developer/redhat-sso-quickstarts
   $ cd redhat-sso-quickstarts/app-profile-jee-vanilla/config

3. keycloak.json ファイルを現在のディレクトリーにコピーします。
4. app-profile-jee-vanilla ディレクトリーに移動します。

5. 以下のコマンドを使用してコードをインストールします。

   $ mvn clean wildfly:deploy

6. アプリケーションのインストールが正常に完了したことを確認します。ログインページが表示される http://localhost:8080/vanilla に移動します。

   成功を確認するログインページ

   

7. demo レルムで作成したアカウントを使用してログインします。

   demo レルムへのログインページ

   

   JBoss-EAPサンプルアプリケーションの保護にRed Hat Single Sign-Onを使用するのに成功したことを示すメッセージが表示されます。これですべての手順が終了しました。

   完全な成功