ログインの問題
パスワードを忘れた場合
OpSee は認証を完全に Keycloak に委任しています。パスワードのリセットは Keycloak 経由で行う必要があります。
- ログインページに「パスワードをお忘れですか」リンクが表示されている場合、それをクリックしてメールでのリセットフローに従ってください。これには Keycloak でメールサーバーが設定されている必要があります。
- リセットリンクが表示されない場合、Keycloak 管理者がパスワードを手動でリセットする必要があります。Keycloak Admin Console → Users → 自分のアカウントを選択 → Credentials → Reset Password を使用してください。
セッションが期限切れになった
OAuth2 トークンには有効期限があります。セッションが期限切れになると、API リクエストは 401 を返し、UI は警告なしにログインページにリダイレクトされる場合があります。
対処法: アバターメニュー（右上）から明示的にログアウトし、その後再度ログインしてください。先にログアウトせずにブラウザのタブを閉じて再度開くことでも、古いセッションを解決できる場合があります。
ログイン後にすべてのページで 401 が返る
ログインページにリダイレクトされ、認証に成功した直後に再び 401 エラーが表示される場合、ブラウザに保存されたトークンが破損している可能性があります。
対処法:
- ブラウザの開発者ツールを開く → Application → Cookies を選択し、OpSee ドメインのすべての Cookie を削除します。
- Local Storage を開き、OpSee ドメインのすべてのエントリを削除します。
- タブを閉じ、再度開いて、もう一度ログインします。
ログイン後に 403 になる（ログインできるが何も表示できない）
Keycloak のログインに成功した直後に 403 エラーが発生する場合、アカウントは存在し正しく認証されているものの、OpSee でロールが割り当てられていないことを意味します。
対処法: Keycloak 管理者がアカウントにロールを割り当てる必要があります。
- Keycloak Admin Console を開きます。
- Users → 自分のアカウントを選択 → Role Mappings に移動します。
- OpSee クライアント配下で、適切なロール（例：
menu:production、menu:oee、menu:admin）を割り当てます。 - 新しいロールを反映させるため、ユーザーにログアウトして再ログインしてもらってください。
Keycloak にアクセスできない
ログインページ自体が読み込まれない場合、または Keycloak に到達しようとしてブラウザが接続エラーを表示する場合、Keycloak の Docker コンテナが停止している可能性があります。
対処法:
- SSH でサーバーに接続し、
docker psを実行してどのコンテナが稼働しているか確認します。 - Keycloak コンテナが一覧にない、または
Exitedステータスを示している場合は、再起動します:docker compose up -d keycloak。 - Keycloak コンテナのログで起動エラーを確認します:
docker compose -f infra/docker-compose.yml logs keycloak。 - 再度ログインを試みる前に、Keycloak が完全に起動するまで待機します（30〜60 秒かかることがあります）。
リダイレクトループ
ブラウザが OpSee アプリと Keycloak のログインページの間を行き来し続けて落ち着かない場合、OAuth2 Proxy または Keycloak クライアント設定に誤りがある可能性が高いです。
考えられる原因:
- Keycloak クライアントに登録されたリダイレクト URI が、実際のアプリケーション URL と一致していない。
- OAuth2 Proxy の Cookie シークレットが変更されている、または欠落している。
- 環境変数
SERVER_DOMAINが、ブラウザが使用しているドメインと一致していない。
対処法: インフラ管理者に連絡してください。この種の問題は、クライアント設定を修正するために Docker Compose の構成および Keycloak 管理コンソールへのアクセスを必要とします。