Keycloak 連携
OpenID Connect プロトコルを通じてオープンソースの ID 認証プラットフォーム Keycloak と統合します
最終更新
役に立ちましたか?
OpenID Connect プロトコルを通じてオープンソースの ID 認証プラットフォーム Keycloak と統合します
Keycloak は広く利用されているオープンソースの ID 認証およびアクセス管理プラットフォームです。MaiAgent は OpenID Connect プロトコルを通じた Keycloak との統合に対応しています。
対象ユーザー:Keycloak で統一的な ID 管理を行っている企業、または Realm 単位でユーザーを管理する必要がある組織
主なメリット:
Keycloak Realm の分離に対応
Email を持たないアカウント向けに、仮想 Email ID を自動生成
サーバーサイドでの Token 失効(ログアウト)に対応
Keycloak エコシステムの各種機能との統合
Keycloak Admin Console にログインします
対象の Realm を選択します
Clients で Client を新規追加します
Client Protocol を openid-connect に設定します
Access Type を public に設定します(またはセキュリティ要件に応じて confidential を選択します)
Valid Redirect URIs を MaiAgent のフロントエンドドメインに設定します
Client ID を控えておきます

Keycloak 認証タイプを選択した後、以下の項目を入力する必要があります:
認証ソース名
はい
Realm 名との対応に使用します。Keycloak の Realm 名を使用することを推奨します
Email Domain
はい
仮想 Email を生成するためのドメインです。例:company.com
Server URL
はい
Keycloak サーバーの URL です。例:https://keycloak.company.com/
入力が完了すると、システムが自動的に Login URL を生成します。形式は以下のとおりです:
MaiAgent 管理画面で 保存 をクリックし、生成された Login URL を使用してログインフローをテストします。
Keycloak のユーザーは必ずしも Email アドレスを持っているとは限らないため、MaiAgent は一意の識別子として仮想 Email を自動的に生成します:
例:Email Domain が company.com に設定されている場合、ユーザー john.doe には MaiAgent のユーザー Email として john.doe@company.com が生成されます。
この仮想 Email はシステム内部での識別のみを目的としており、実際の Email 送信には使用されません。
MaiAgent の Keycloak 統合はサーバーサイドでのログアウトに対応しています。ユーザーが MaiAgent からログアウトすると、システムは同時に Keycloak サーバーへ Token 失効リクエストを送信し、Token が Keycloak 側でも無効になることを保証します。
認証ソース名
はい
小文字英数字 + ハイフン、最大 31 文字
company-kc
Email Domain
はい
ドメイン形式
company.com
Server URL
はい
HTTPS URL
https://keycloak.company.com/
最終更新
役に立ちましたか?
役に立ちましたか?
https://{フロントエンドドメイン}/auth/keycloak?url={Server URL}&clientId={Client ID}&realm={Realm}仮想 Email = {preferred_username}@{email_domain}