6. Keycloakコンソール¶

6.1. はじめに¶

本書では、Exastro Suite におけるシステム管理の Keycloakコンソールについて説明します。

システム管理者が、新たなシステム管理者を追加やオーガナイゼーション毎のユーザーパスワード変更やパスワードポリシー、ログイン方法などを変更する際に利用します。

またユーザーの変更やロールの追加を行った際の監査ログも確認できます。

システム管理者の追加

システム管理者を追加する際に、上述のレルムで master を選択し、メニューからユーザーを選択後、ユーザーの追加ボタンを押下して、ユーザーを追加（情報入力）することができます。

システム管理者のユーザー情報入力

ユーザー情報入力に新しいユーザー情報を入力します。

表 6.1 項目説明¶
項目名	説明
必要なユーザー・アクション	次回ログインした際に、どのような情報を設定するか設定できます詳しい設定値は、Keycloakの公式ドキュメントをご参照ください
Eメールが確認済み	OFFを選択します ※ONを選択してもメール送信用サーバー設定が設定されていないと動作しません
Select a location	言語を選択します
ユーザー名	ログイン時に使用するユーザー名を入力します
Eメール	追加するユーザーのE-mailアドレスを入力します
名	追加するユーザーの名を入力します
性	追加するユーザーの姓を入力します
Join Groups	Exastro システムでは未対応のため、指定しないでください

追加したユーザーのパスワード設定

ユーザーの登録ではパスワードの設定ができていないため、登録後次の画面からパスワードを設定する必要があります。
ユーザー詳細の クレデンシャル を選択し、パスワードを設定してください。
パスワード設定 ボタンからパスワードを入力後、保存 ボタンを押下してパスワード設定します。

表 6.2 項目説明¶
項目名	説明
パスワード	ログイン時に使用するパスワードを入力します
新しいパスワード（確認）	入力したパスワードと同じ内容を入力します
一時的	オンに設定した際、次回ログイン時にパスワード変更画面が表示されます通常はオンのままご利用ください

大容量ファイルのアップロード・ダウンロードなど完了に時間が掛かる処理を行った際に、「認証に失敗しました。」とメッセージが表示されてしまう事象が多発する場合、

アクセストークン生存期間の変更を行うと事象を解消できることがあります。

クライアント（オーガナイゼーションIDと同じ値）選択

上述のレルム（オーガナイゼーション）選択で目的のレルムを選択し、メニューからクライアントを選択します。

クライアント一覧画面が表示されるので、クライアントID列からオーガナイゼーションIDと同じ値のクライアントを選択します。
Advanced settings（クライアント）の表示

クライアント詳細画面が表示されるので、 Advanced を選択し、

Advanced画面の右側 Jump to section から、Advanced settings を選択します。
アクセストークン生存期間の変更

アクセストークン生存期間項目の、「inherits from realm settings」を「有効期限」に変更、変更したい時間を入力します。

画面を下にスクロールし、保存ボタンを押下してトークン生存期間の変更を保存します。

注釈

アクセストークンは、SSOセッション・アイドル/SSOセッション最大に指定した時間を過ぎると、生存期間内であってもトークンが無効化されます。

SSOセッションのデフォルト設定、SSOセッション・アイドル(30分)/SSOセッション最大(10時間) を超える時間が、アクセストークン生存期間に必要な場合は、

あわせて SSOセッション・アイドル/SSOセッション最大の時間も変更を行ってください。

Session Settings画面の表示

上述のレルム（オーガナイゼーション）選択で目的のレルムを選択し、メニューからレルムの設定を選択します。

レルム設定画面が表示されるので、セッションを選択し、Session Settings 画面を表示します。
アクセストークン生存期間の変更

SSOセッション・アイドル/SSOセッション最大項目に変更したい時間を入力します。

画面を下にスクロールし、保存ボタンを押下してSSOセッションの変更を保存します。