スタートガイド

手順

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

4. unzip、tar、Expand-Archive などの適切な unzip ユーティリティーを使用して ZIP ファイルを展開します。

   Linux/Unix

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

   Copy to Clipboard Toggle word wrap

   Windows

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

   Copy to Clipboard Toggle word wrap

手順

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

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

   Linux/Unix

   $ cd bin
   $ ./standalone.sh

   Copy to Clipboard Toggle word wrap

   Windows

   > ...\bin\standalone.bat

   Copy to Clipboard Toggle word wrap

手順

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

   Copy to Clipboard Toggle word wrap
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

   Copy to Clipboard Toggle word wrap

   Windows

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

   Copy to Clipboard Toggle word wrap

   Windows Powershell

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   $ cd bin

   Copy to Clipboard Toggle word wrap

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

   注記

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

   Linux/Unix

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

   Copy to Clipboard Toggle word wrap

   Windows

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

   Copy to Clipboard Toggle word wrap

   注記

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

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

   Linux/Unix

   $ ./standalone.sh

   Copy to Clipboard Toggle word wrap

   Windows

   > ...\standalone.bat

   Copy to Clipboard Toggle word wrap

手順

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

3. 左側のメニューで 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"/>

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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>

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap
6. アプリケーションサーバーを再起動します。

手順

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

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

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

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

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

   $ mvn clean wildfly:deploy

   Copy to Clipboard Toggle word wrap

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

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

   

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

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

   

   Red Hat Single Sign-On の使用が成功したことを示すメッセージが表示され、サンプル JBoss EAP アプリケーションを保護します。おめでとうございます。

   完全な成功