Quarkus Security アーキテクチャー

Quarkus Securityは、 HttpAuthenticationMechanism を使用してHTTPリクエストから認証クレデンシャルを抽出し、 IdentityProvider に委任して、認証クレデンシャルを SecurityIdentity に変換します。たとえば、クレデンシャルは、 Authorization ヘッダー、クライアントの HTTPS 証明書、または Cookie から取得することができます。

Quarkus Securityが認証要求を拒否すると、 HttpAuthenticationMechanism はクライアントに認証チャレンジを返却します。 チャレンジのタイプは認証メカニズムによって異なります。 たとえば、OIDC OpenID Connect（OIDC）の認可コードフローメカニズムでは、リダイレクトURLが生成され、クライアントはOpenID Connectプロバイダに返されて認証されます。

IdentityProvider は、認証クレデンシャルを検証し、ユーザー名、ロール、元の認証クレデンシャル、およびその他の属性を持つ SecurityIdentity にマップします。

認証されたリソースごとに SecurityIdentity インスタンスを注入することで、認証された ID 情報を取得することができます。

他のコンテキストでは、同じ情報またはその一部を他の並列表現にすることが可能です。例えば、Jakarta RESTの SecurityContext 、JSON Web Tokens（JWT）の JsonWebToken など。

詳細については、Quarkus Identityプロバイダー ガイドを参照してください。

Quarkus Securityはカスタマイズ可能であるため、たとえば、認可ロールを SecurityIdentity に追加したり、1つまたは複数の SecurityAugmentor 実装を登録し、優先順位を付けることができます。

登録された SecurityIdentityAugmentor のインスタンスは、セキュリティ認証プロセスの最終段階で呼び出されます。詳細については、「セキュリティのヒントとコツ」ガイドの Security Identityのカスタマイズ セクションを参照してください。