Apache アプリケーションにログイン機能を追加

このチュートリアルでは、Apache を設定して、Web アプリに認証と認可を追加する方法を説明します。

AI を使って Auth0 を統合する

Claude Code、Cursor、GitHub Copilot などの AI コーディングアシスタントを使えば、agent skills を利用して、数分で Auth0 認証を自動的に追加できます。

インストール:

npx skills add auth0/agent-skills --skill auth0

続いて、AI アシスタントに次のように依頼します:

Add Auth0 authentication to my Apache server

AI アシスタントが Auth0 アプリケーションを自動的に作成し、資格情報を取得して、mod_auth_openidc を設定します。agent skills の完全なドキュメント →

システム要件

このチュートリアルとサンプルプロジェクトは、以下の環境でテストされています。

• Apache 2.4

​

はじめに

このチュートリアルでは、Apache を設定して Web アプリに認証と認可を追加する方法を説明します。ご自身のアカウント用に設定された例を使ってこのクイックスタートを進められるよう、事前にログインしておくことをおすすめします。

1. mod_auth_openidc モジュールをインストールして有効にする

   まず、Apache 用の mod_auth_openidc モジュールをインストールします。

   GitHub からバイナリを入手して、お使いの OS にインストールできます。お使いの OS がいずれのバイナリにも対応していない場合でも、ソースからビルド できます。

   モジュールをインストールしたら、a2enmod コマンドで Apache で有効にします。詳しくは、Ubuntu の a2enmod マニュアルページ を参照してください。

   a2enmod auth_openidc
   

   Windows の場合は、この PowerShell スクリプト を使うと、システム上で a2enmod を動作させることができます。

2. Auth0 アカウント情報でモジュールを設定する

   /etc/apache2/mods-available フォルダーにある新しい設定ファイル (auth_openidc.conf) を更新します。

   Windows の場合は、/apache/conf/httpd.conf ファイルを使用する必要があります。

3. Auth0 を設定する

   Auth0 Dashboard で次の操作を行います。

   1. アプリケーション > アプリケーション に移動し、一覧から対象のアプリケーションを選択します。
   2. 設定 ビューに切り替え、Application URIs セクションを見つけます。
   3. OIDCRedirectURI の値を Allowed Callback URLs に追加します。
   4. ページ下部にある Advanced Settings を見つけます。
   5. OAuth ビューに切り替えます。
   6. JSON Web Token (JWT) Signature Algorithm を RS256 に設定します。
4. 認可

   auth_openidc.conf ファイルに Location ブロックを追加することで、ユーザーの ID トークン内のクレームの値に基づいて、特定の場所を保護するよう Apache を設定できます。

   たとえば、ユーザーのロールを読み取り、保護された場所へのアクセスを許可するクレームを追加する Action を作成できます。

   exports.onExecutePostLogin = async (event, api) => {
     const roles = event.authorization.roles; // ['user', 'admin']
     if (roles.includes('admin')) {
       api.idToken.setCustomClaim('folder', 'admin');
     }
   };
   

チェックポイント

素晴らしいです！ここまで進められたなら、アプリケーションで login、logout、ユーザープロファイル情報が利用できるようになっているはずです。

---

​

次のステップ

これで クイックスタート チュートリアルは終了です。ただし、まだまだ活用できる機能があります。Auth0 でできることについてさらに詳しく知りたい場合は、以下をご覧ください。

• Auth0 Dashboard - Auth0 テナントとアプリケーションを設定・管理する方法を確認できます
• Auth0 Marketplace - Auth0 の機能を拡張するために有効化できる連携を確認できます