Authorization Core の機能セットと Authorization Extension は、完全に別の機能です。グループ、ロール、または権限を管理するには、それらを最初に作成した機能を使用する必要があります。
前提条件
拡張機能を使用する前に、次の作業を行う必要があります。データの管理
JSONファイルを使用して、拡張機能にデータを簡単にインポートしたり、拡張機能からエクスポートしたりできます。詳しくは、Authorization Extension データのインポートとエクスポートをご覧ください。機能を追加する
拡張機能のセットアップが完了したら、さらに機能を追加できます。- 拡張機能へのAPIアクセスを有効にする: 拡張機能のAPIを使って、プロビジョニングを自動化し、ユーザーの認可コンテキストをリアルタイムで照会する方法を説明します。
- 拡張機能へのAPIアクセスを有効にする: Authorization Extension のAPIエンドポイントとその使い方について説明します。
- ルールでAuthorization Extensionのデータを使用する: ルールを使用して、ログインに追加のロジックを設定する方法を説明します。
旧バージョンからのアップグレード
バージョン 2.6 以降からのアップグレード
バージョン 2.6 以降からのアップグレードでは、互換性のない変更はなく、特別な対応も必要ありません。2.6 より前のバージョンからアップグレードする
Authorization Extension 2.6 には、API キーの保存および処理ロジックの変更に伴う互換性のない変更が含まれているため、以下のとおりアップグレード時に追加の手順を実行する必要があります。これらの手順を完了しないと、ルールの実行時にInvalidApiKey または You are not allowed to access this application エラーが発生します。詳細については、GitHub changelog を参照してください。
- Auth0 Dashboard > Extensions に移動し、Installed Extensions ビューを選択します。
- Auth0 Authorization を見つけて Upgrade を選択し、確認します。アップグレードが完了するまで待ちます。
拡張機能のAPIキーをローテーションします
- Auth0 Authorization を選択して、拡張機能を開きます。
- 拡張機能ダッシュボードの右上にあるドロップダウンメニューから、Configuration を選択します。
- API Key セクションで Rotate を選択します。
拡張機能のルールを再度公開する
Publish Rule を選択します。古い拡張機能ルールが存在する場合は削除する
- Auth0 Dashboard > Auth Pipeline > Rules に移動します。
-
auth0-authzルールを探します。見つからなければこれで完了です。見つかった場合は、次の手順に進みます。 -
auth0-authorization-extensionルールを探し、auth0-authzルールの下にドラッグします。 -
auth0-authzルールについて、次の点を確認します。- Authorization Extension によって作成されており、手動で変更されていない
- 削除しても、意図しないユーザーにアクセスや権限が付与されるような形で認可フローが変わらない
-
上記の条件を満たしている場合は、トグルを使って
auth0-authzルールを無効にします。すべてが正常に動作することを確認したら、このルールを無効のままにしておくか、完全に削除するかを判断できます。