ubuntu/LinuxMintでkeycloakを利用してDocker環境でSSOを試しました

1.概要

SAML(認証)とOauth(認可)はどちらも難しい。今回、SAMLにチャレンジしました。ネットで調べて、keycloakを利用することでlocal環境でSSO(シングルサインオン)が実現できるので試してみました。keycloakサイトにdockerを利用した簡単なSAML環境構築事例があり、仕組みを経験できます。これを実際に試してみたので、その内容を記述します。

2.詳細

keycloakサイトのGetStartedからGetting startedのDockerを選択します。Docker環境で試すことができるので、Dockerを導入して確認をします。以前、この資料を利用して、Ubuntu 20.04で確認をしました。今回はLinuxMint 22.3を利用します。
利用する機器は以下のとおりです。

HW: i3-7100, Memory 16GB, SSD 256GB
SW: LinuxMint 22.3

参考資料（Get started with Keycloak on Docker）に沿って作業します。

(1) Before you start

Docker環境を導入します。

$ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu noble stable"
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg
$ sudo apt update
$ sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
$ sudo gpasswd -a $USER docker
$ docker --version
$ docker compose version

(2) Start Keycloak

コンテナ起動は１行だけです。

$ docker run -p 127.0.0.1:8080:8080 -e KC_BOOTSTRAP_ADMIN_USERNAME=admin -e KC_BOOTSTRAP_ADMIN_PASSWORD=admin quay.io/keycloak/keycloak:26.6.4 start-dev

Listening on: http://0.0.0.0:8080
が表示されると起動完了です。

これ以降はブラウザ(Firefox)で複数タブを利用します。その内容を記載ます。
参考資料内にURLのリンクがあります。

(a) Sign in to Keycloak
　http://localhost:8080/realms/master/protocol/openid-connect/auth
(b) Account Console 
　http://localhost:8080/realms/myrealm/protocol/openid-connect/auth
(c) Test Application 
　https://www.keycloak.org/app/

(3) Log in to the Admin Console

「(a) Sign in to Keycloak」からログインします。

Username=admin, Password=admin です

(4) Create a realm

「(a) Sign in to Keycloak」にログイン後、表示されたmaster realmで作業します。

左側上方のMagage realmsをクリックします
青色のCreate realmボタンをクリックします
Realm nameにmyrealmを入力後、青色のCreateをクリックします
登録されました

(5) Create a user

「(a) Sign in to Keycloak」で作業します。

左側中断のUsersをクリックします。
青色のCreate new userをクリックします
Username=myuser
Emailは入力しません
First name=foo
Last name=bar
を入力して、青色のCreateをクリックします

上方のCredentialsタブを選択します
青色のSet passwordをクリックします
Password=mypassword
Password confirmation=mypassword
TemporaryをOffに設定して、
Saveをクリックします。
更に、赤色のSave passowrdをクリックします
登録されました

(6) Log in to the Account Console

「(b) Account Console」からログインします

Username=myuser, Password=mypassword です
Email欄がエラーになるので、myuser@localhostを入力して、submitします
ログインできました

(7) Secure the first application

「(a) Sign in to Keycloak」から作業します

左側上方のClientsをクリックします
青色のCleate clientをクリックします
Client ID=myclientを入力して、Next
次の画面もNext
Valid redirect URIs = https://www.keycloak.org/app/*
Web origins         = https://www.keycloak.org
を入力後、save

「(c) Test Application」を開きます

Keycloak URL = http://localhost:8080
Realm = myrealm
Client = myclient

を確認後、Saveをクリックします

これで試験ができる環境ができました

(8) 試験１

「(b) Account Console」でログインすると、「(c) Test Application」もログインできる検証

「(b) Account Console」と「(c) Test Application」のSign outを確認します
「(b) Account Console」で myuser/mypasswordでログイン
「(c) Test Application」でSign inボタンを押すとすぐにログインできます

(9) 試験２

「(c) Test Application」でログインすると、「(b) Account Console」もログインできる検証

「(b) Account Console」と「(c) Test Application」のSign outを確認します
「(c) Test Application」でSign inボタンを押して、myuser/mypasswordでログイン
「(b) Account Console」はログインされています

3.所見

この説明資料に従って確認をすると、SSOを実際に体験できます。簡単に動作確認でき、keycloakを理解するにはとても良い資料です。しかし、実務上の設定の場合、セキュリティ面を考慮する必要があり、とても難しく簡単ではありません。

参考

[外部サイト参照]

コメント

コメントを投稿

過去30日間に良く読まれた記事

miniPCのBMAXでWindows11のsecure boot設定漏れでトラブル発生

0.推奨 Windows11をプリインストールモデルの状態で利用されている場合は問題になることはありません。Windows11のUSB bootメディアを作成して自分で新規導入したり、Windows10からWindows11へupgradeをした場合。Windows11への移行条件確認が十分でない状態があったのではないかと思います。Windows11で必須要件を満たさずに移行されたWindows11環境がありました。 今回のトラブルでBitLockerの48桁の回復キーがないことが痛手でした。Windows11を利用する上でBitLockerの回復キーは大切に保管が必要です。secure bootを設定するとディスクは暗号化されてしまいます。障害復旧に回復キーは必須です。６月の証明書期限切れで問題が発生して、思わぬ事態にならぬように早めにチェックすること、回復キーを保管することを推奨します。 1.概要 始まりは、参考資料の「6月からパソコンが動かなくなる？」です。miniPCのsecure boot設定をmsinfo32で確認すると「無効」でした。そこで、BIOSの設定でsecure bootをenableに設定して、msinfo32は「有効」になりました。これが暗号化設定と認識不足でした。Windows Updateを実行して証明書の更新を実行すると、Windows Updateのボタンが赤色に変わりました。ここからトラブルです。理解不足で複数のミスが重なり、データを消失。復旧も時間を必要としました。その内容を記述します。 2.詳細 (1) トラブルの始まり ネット記事で、secure boot設定が必要で、６月にPCが動かなくなると思って、BIOS設定を変更したことが始まりです。この変更は、BIOSでSecurityのsecure bootをdisableからenableに変更だけです。Windows11を起動してmsinfo32で有効をチェックして完了。追加としてWindows Updateで証明書の導入をしてからハマりました。 障害の状況は、Windows11自体は普通に使えるのですが、Windows Updateのボタンが赤色。文字も赤字に変わりました。今後、発生するupdate適用ができなくなると認識しました。 (2) GoogleAI(Gemini)に...
続きを読む

Windows95/98のPCゲームをUbuntu/LinuxMintの最新PCで楽しむ方法 ( KVM / Wine / dosbox-x / midi )

1.概要 Ubuntults 24.04のリポジトリを利用するLinuxMint 22.3で、32bitのアプリケーションを楽しむことができるのか整理をしました。今回、仮想環境のKVMでの試験を実施して、KVM,Wine,Dosbox-xの３種類を実施した範囲で、遜色なく利用できるのはDosbox-xだけでした。KVMやWineではサウンド処理関連の互換性がなくなったような気がします。この内容に関して記述します。 注意事項 Windowsの利用にあたっては、Microsoftが定める使用許諾契約（EULA）を遵守する必要があります。ライセンス違反（不正なプロダクトキーの利用、規約外の商用利用など）は違法行為となるため、必ず正規のライセンスを取得・確認した上で操作を行ってください。 2.詳細 (1)KVM環境 KVM環境はRegacyBIOS互換のCSMで試しました。KVM上でWindows98SEは起動します。デバイスマネージャを参照した範囲ではエラーはありませんが、サウンドが想定通りに再生されない点、ディスプレイ表示設定が思うようにならない点がありました。どちらもドライバの問題と思います。構築した環境はUbuntu 22.04まで試験をしていた環境です。仮想ソフト（KVM, VMware, Virtualboxなど）は新しい環境への対応を進める中で古い環境の互換性は保たれなくなっていると感じています。 (a) KVMにWindows98seを導入 Windows98の仮想マシンを作成（サポート期間が切れたOSを選択） Memory=128MB、CPU=1、Disk=0.5GBを選択 インストールの前に設定をカスタマイズするを選択 ブートオプション：IDE CD-ROMにチェック CD-ROM bootのため、IDE ディスクとIDE CR-ROMの順番を入替える サウンド ich6：sb16を上書設定 ビデオ QXL：cirrusを上書設定 CD-ROM boot後、CD-ROMサポート付きmsdosを利用して、fdiskでCドライブを作成 再度、上記構成で再起動をして、d:\win98にてformat c:を実行してfat16で初期化 d:\win98のsetupを実行して導入 (2)Wine環境 Wine 11.8で試験をしました。 ディスプレイ表示は普通に使...
続きを読む

LinuxMint/ubuntuにWine 11導入を試しました ( LinuxMint 21.3 / 22.3 ubuntu 22.04 / 26.04 Wine 11.0 / 11.6 / 11.8 / 11.13 )

1.概要 Wine 11.0がリリースされました。メジャーアップデートで「Wine 11.0 6300以上の変更と600件以上の不具合修正を反映」と記載されています。早速、試してみることにしました。少し前にWinBoatを導入したことと比較すると、とても簡単でミスをすることはありません。しかし、Windowsのアプリを動かす意味を考え直すことになりました。 ubuntu desktop 26.04をKVM環境で評価しているので、Wine 11.13(最新版)導入を試しました。手順はWikiに記載されている手順で問題なく実施できます。詳細手順は、4.追加に記載します。 2.詳細 環境は、intel i3, Memory 16GBのPCにLinuxMint-21.3を新規導入しました。 Wine 11.0の導入手順を見つけるのに少し手間取りましたが、Wiki/Debian-Ubuntuに詳しく記載されています。 その手順に沿って作業を実施しました。 $ cat /etc/os-release $ sudo mkdir -pm755 /etc/apt/keyrings $ wget -O - https://dl.winehq.org/wine-builds/winehq.key | sudo gpg --dearmor -o /etc/apt/keyrings/winehq-archive.key - $ sudo dpkg --add-architecture i386 $ sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/jammy/winehq-jammy.sources $ sudo apt update $ sudo apt install --install-recommends winehq-stable $ wine --version $ sudo apt install winetricks $ winetricks cjkfonts $ winetricks --version 上記手順でWine 11.0の導入が終わります。３分間程度なので負担はありません。日本語環境も導入しました。 何をしようかと考えて、動かしたいWindo...
続きを読む