スタートガイド


Red Hat build of Keycloak 22.0

Red Hat Customer Content Services

概要

このガイドは、実稼働環境で使用する前に Red Hat build of Keycloak 22.0 を使用して評価するのに役立ちます。これには、Red Hat build of Keycloak をインストールして開発モードで実行する手順、ユーザーとアプリケーションを管理するためのレルムとアカウントを作成する手順、およびシングルページアプリケーション (SPA) のセキュリティーを保護する手順が含まれています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、用語の置き換えは、今後の複数のリリースにわたって段階的に実施されます。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。

第1章 スタートガイド

1.1. 作業を開始する前の注意事項

OpenJDK 17 がインストールされていることを確認してください。

1.2. Red Hat build of Keycloak のダウンロード

Red Hat build of Keycloak を Red Hat の Web サイト からダウンロードして展開します。

このファイルを展開すると、rhbk-26.0.10 という名前のディレクトリーが作成されます。

1.3. Red Hat build of Keycloak の起動

  1. ターミナルから rhbk-26.0.10 ディレクトリーを開きます。
  2. 以下のコマンドを実行します。

    • Linux では、次を実行します。

      bin/kc.sh start-dev
    • Windows では、次を実行します。

      bin\kc.bat start-dev

start-dev オプションを使用すると、開発モードで Red Hat build of Keycloak が起動します。このモードでは、Red Hat build of Keycloak を初めて試して、すぐに起動して実行することができます。このモードは、Red Hat build of Keycloak の開発など、開発者にとって便利なデフォルト設定を提供します。

1.4. 管理者ユーザーの作成

Red Hat build of Keycloak にはデフォルトの管理者ユーザーがありません。Keycloak を起動する前に、管理者ユーザーを作成する必要があります。

  1. http://localhost:8080/ を開きます。
  2. ユーザー名とパスワードをフォームに入力します。

1.5. 管理コンソールへのログイン

  1. Red Hat build of Keycloak 管理コンソール に移動します。
  2. 前の手順で作成したユーザー名とパスワードでログインします。

1.6. レルムを作成します。

Red Hat build of Keycloak のレルムはテナントに相当します。各レルムにより、管理者はアプリケーションとユーザーの分離グループを作成できます。Red Hat build of Keycloak には、最初は master と呼ばれる単一のレルムが含まれています。このレルムは、Red Hat build of Keycloak の管理にのみ使用し、アプリケーションの管理には使用しません。

次の手順を使用して、最初のレルムを作成します。

  1. Red Hat build of Keycloak 管理コンソール を開きます。
  2. 左上隅にある master という単語をクリックし、Create Realm をクリックします。
  3. Realm name フィールドに myrealm と入力します。
  4. Create をクリックします。
レルムの追加

1.7. ユーザーを作成します。

最初、レルムにはユーザーがいません。ユーザーを作成するには、以下を実行します。

  1. Red Hat build of Keycloak 管理コンソール を開きます。
  2. 左上隅にある master という単語をクリックし、myrealm をクリックします。
  3. 左側のメニューで Users をクリックします。
  4. Add user をクリックします。
  5. フォームに次の値を入力します。

    • Username: myuser
    • First name: 任意の名
    • Last name: 任意の姓
  6. Create をクリックします。
ユーザーの作成

このユーザーがログインするにはパスワードが必要です。初期パスワードを設定するには、以下を実行します。

  1. ページの上部にある Credentials をクリックします。
  2. Set password フォームにパスワードを入力します。
  3. ユーザーが最初のログイン時にこのパスワードを更新する必要がないように、TemporaryOff に切り替えます。
パスワードの設定

1.8. アカウントコンソールにログインします。

これで、アカウントコンソールにログインし、このユーザーが正しく設定されていることを確認できます。

  1. Red Hat build of Keycloak アカウントコンソール を開きます。
  2. 前の手順で作成した myuser とパスワードでログインします。

アカウントコンソールのユーザーとして、プロファイルの変更、2 要素認証の追加、ID プロバイダーアカウントの追加などを実行してアカウントを管理できます。

Red Hat build of Keycloak アカウントコンソール

1.9. 最初のアプリケーションのセキュリティー保護

最初のアプリケーションに対してセキュリティー保護を行うには、まずアプリケーションを Red Hat build of Keycloak インスタンスに登録します。

  1. Red Hat build of Keycloak 管理コンソール を開きます。
  2. 左上隅にある master という単語をクリックし、myrealm をクリックします。
  3. Clients をクリックします。
  4. Create client をクリックします
  5. フォームに次の値を入力します。

    • Client type: OpenID Connect
    • Client ID: myclient

      クライアントの追加
  6. Next をクリックします。
  7. Standard flow が有効になっていることを確認します。
  8. Next をクリックします。
  9. Login settings で以下の変更を行います。

    • Valid redirect URIshttps://www.keycloak.org/app/* に設定します。
    • Web originshttps://www.keycloak.org に設定します。
  10. Save をクリックします。
クライアントの更新

クライアントが正常に作成されたことを確認するために、Keycloak Web サイト の SPA テストアプリケーションを使用できます。

  1. https://www.keycloak.org/app/ を開きます。
  2. Save をクリックして、デフォルト設定を使用します。
  3. Sign in をクリックし、前に起動した Red Hat build of Keycloak サーバーを使用してこのアプリケーションを認証します。

1.10. 次のステップ

実稼働環境で Red Hat build of Keycloak を実行する前に、以下の操作を行うことを検討してください。

  • PostgreSQL などの実稼働対応データベースへの切り替え。
  • 独自の証明書を使用した SSL の設定。
  • よりセキュアな管理者パスワードへの切り替え。

詳細は、サーバーガイド を参照してください。

法律上の通知

Copyright © 2024 Red Hat, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions and limitations under the License.
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.