> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-actions-triggers-prototype.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 認可拡張機能をインストールする

> Auth0の認可拡張機能をインストールする方法について説明します。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Auth0では、ロールベースのアクセス制御（RBAC）を2つの方法で実装できます。これは、API独自の内部アクセス制御システムの代わりに使用することもできれば、両方を組み合わせて使用することもできます。

  * [認可コア](/docs/ja-jp/manage-users/access-control/rbac)
  * [認可拡張機能](/docs/ja-jp/customize/extensions/authorization-extension)

  認可コアの機能セットは、認可拡張機能と同じ機能性を備え、性能と拡張性を向上させると同時に、認可拡張機能より柔軟なRBACシステムを提供します。

  現時点では、どちらもRBACの主要な機能を実装し、APIに対して定義されるカスタムスコープをユーザーに権限として割り当てられたスコープに制限することが可能です。
</Callout>

## 前提条件

始める前に、認可拡張機能で使用できる既存のアプリケーションがあることを確認してください。以下の種類のアプリケーションを使用することができます。

* ネイティブアプリ
* 通常のWebアプリ
* シングルページアプリ

種類が割り当てられていないアプリケーションやマシンツーマシンアプリケーションには、この拡張機能を使用できません。

## 拡張機能をインストールする

1. [［Auth0 Dashboard］>［Extensions（拡張機能）］](https://manage.auth0.com/#/extensions)に移動します。
2. **［Auth0 Authorization（Auth0認可）］** を選択して、インストールのプロンプトを処理します。
3. データを保管したい場所を［Webtask Storage（Webtaskストレージ）］または［Amazon S3 bucket（Amazon S3バケット）］から選択します。

拡張機能がインストールされたら、 **［Installed Extensions（インストール済みの拡張機能）］** に一覧表示されます。

<Frame>
  <img src="https://mintcdn.com/docs-dev-actions-triggers-prototype/dadTd1GKGvbSPiSP/docs/images/ja-jp/cdy7uua7fh8z/5gJ26ZetkEXOur9Z7WFxzY/71e57c1e0f7e93c8f4492ba3f3c404bd/Installed_Extensions_-_Japanese.png?fit=max&auto=format&n=dadTd1GKGvbSPiSP&q=85&s=cd6f61185273133b807d17954f45e03b" alt="Dashboard - 拡張機能 - インストール済の拡張機能 - 認可拡張機能" width="1328" height="447" data-path="docs/images/ja-jp/cdy7uua7fh8z/5gJ26ZetkEXOur9Z7WFxzY/71e57c1e0f7e93c8f4492ba3f3c404bd/Installed_Extensions_-_Japanese.png" />
</Frame>

<Warning>
  この拡張機能をインストールすると、アカウントにauth0-authzアプリケーションが作成されます。 **このアプリケーションは絶対に編集・削除しないでください。** このアプリケーションは、拡張機能をアンインストールすると自動的に削除されます。
</Warning>

リンクをクリックして拡張機能を初めて開くと、拡張機能がAuth0アカウントにアクセスすることを許可するように促されます。許可すると、Authorization Dashboard（認可ダッシュボード）に移動します。

<Frame>
  <img src="https://mintcdn.com/docs-dev-actions-triggers-prototype/w3k2AH_K7Myvi2qD/docs/images/ja-jp/cdy7uua7fh8z/1ALaqm8mvtleQfm3XKvBtf/73fb69c35e2eed4dae74b1baa8e372a2/auth-dashboard-v2.png?fit=max&auto=format&n=w3k2AH_K7Myvi2qD&q=85&s=1aec29cdaef2f681cbe4da86d5851a13" alt="Dashboard - Extensions - Authorization Dashboard - Users" width="814" height="463" data-path="docs/images/ja-jp/cdy7uua7fh8z/1ALaqm8mvtleQfm3XKvBtf/73fb69c35e2eed4dae74b1baa8e372a2/auth-dashboard-v2.png" />
</Frame>

### Webtaskストレージ

拡張機能はデフォルトでWebtaskストレージを使用します。データの上限は500 KBです。これは以下に相当します。

* 1000のグループと3000人のユーザーで、それぞれのユーザーが3つのグループのメンバーである
* 20のグループと7000人のユーザーで、それぞれのユーザーが3つのグループのメンバーである

### Amazon S3

ストレージプロバイダーとしてAmazon S3を使用することもできます。Amazon S3はファイルベースのストレージプラットフォームで、並列書き込みを行います。これが問題となる場合もありますが、拡張機能のストレージロジックはこれを考慮しようとします。ただし、グループ、ロールや権限の作成を自動化する場合には、APIを順次に呼び出すことが推奨されます。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  この拡張機能は、性能面で制限があるため、大規模なデータセットでの使用には適していません。データストレージにAmazon S3を使用する前に、意図した運用での性能をテストし、確認することをお勧めします。S3に追加されるデータが増えるにしたがって性能が低下する可能性もあります。
</Callout>

Amazon S3を使用するには、以下を行います。

1. S3バケットを作成します。
2. IAMユーザーを作成し、そのユーザーのキーIDを取得します。
3. IAMユーザーのポリシーを作成して、IAMユーザーがバケットを変更できるようにします。

```json lines expandable theme={null}
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:DeleteObject",
                "s3:GetObject",
                "s3:ListBucket",
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::{nameOfYourBucket}/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::{nameOfYourBucket}"
            ],
            "Condition": {}
        }
    ]
}
```

## もっと詳しく

* [認可拡張機能の構成](/docs/ja-jp/customize/extensions/authorization-extension/configure-authorization-extension)
* [認可拡張機能ダッシュボードでユーザーをセットアップ](/docs/ja-jp/customize/extensions/authorization-extension/set-up-authorization-extension-users)
* [認可拡張機能へのAPIアクセスの有効化](/docs/ja-jp/customize/extensions/authorization-extension/enable-api-access-to-authorization-extension)
* [認可拡張機能のデータをインポートまたはエクスポートする](/docs/ja-jp/customize/extensions/authorization-extension/import-and-export-authorization-extension-data)
* [認可拡張機能のトラブルシューティング](/docs/ja-jp/troubleshoot/authentication-issues/troubleshoot-authorization-extension)