> ## Documentation Index
> Fetch the complete documentation index at: https://docs-staging.auth0-mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Universal Portals Quickstart

> Auth0 CLI または Auth0 Agent Skills を使用して、初めてのポータルを設定する方法を説明します。

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Beta",
    "ea": "早期アクセス"
  };
  const stageText = stageTextMap[stage] || "製品リリース段階";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>この機能は{linkify(`${plans}プラン`, "https://auth0.com/pricing")}でご利用いただけます。 </>}
            {contact && "参加をご希望の場合は、" + contact + "までお問い合わせください。 "}
            {terms && <>この機能を使用することにより、Oktaの該当する無料トライアル規約および{linkify("Master Subscription Agreement", "https://www.okta.com/legal")}に同意したものとみなされます。</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>{feature}機能は現在、{linkify(stageText, prsLink)}です。</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Auth0 Universal Portals" stage="beta" terms="true" contact="Auth0 Support" />

ポータルは、以下の方法で作成できます。

* [Auth0 CLI](/docs/ja-jp/deploy-monitor/auth0-cli#auth0-cli) を使用して、1 つのコマンドでアプリケーションとポータルをプロビジョニングおよび設定する。
* [Auth0 Agent Skills](https://github.com/auth0/agent-skills) を使用して、お好みの AI アシスタントにアプリケーションとポータルのプロビジョニングおよび設定を依頼する。

<h2 id="prerequisites">
  前提条件
</h2>

* Universal Portals ベータ版へのアクセスがプロビジョニングされている [Development](/docs/ja-jp/get-started/tenant-settings#environment-tag) Auth0 テナント。

<Tabs>
  <Tab title="Auth0 CLI">
    <h2 id="step-1-install-the-auth0-cli-beta">
      ステップ1: Auth0 CLI Beta をインストールする
    </h2>

    お使いのプラットフォーム用の[インストール手順](https://github.com/auth0/auth0-cli/#linux-and-macos-1)に従ってインストールし、tenantで認証します。

    <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
      安定版の `auth0` CLI をすでにインストールしている Homebrew ユーザーの場合、既存のインストールによってベータバイナリが上書きされています。このガイドのコマンドを記載どおりに実行できるよう、以下のエイリアスを shell 設定に追加してください。

      ```bash theme={null}
      alias auth0-beta="$(brew --prefix auth0-beta)/bin/auth0"
      ```
    </Callout>

    ```bash theme={null}
    auth0-beta login
    ```

    <h2 id="step-2-run-the-setup-command">
      ステップ2：設定コマンドを実行する
    </h2>

    ```bash theme={null}
    auth0-beta universal-portals setup
    ```

    別名 `auth0-beta up setup` も使用できます。Auth0 CLI コマンドにより、次の項目が作成されます。

    * **My Account API**: ユーザーアカウント操作用のリソースサーバー
    * **My Organization API**: 組織管理操作用のリソースサーバー
    * **A Regular Web App**: ポータルにリンクされたアプリケーション
    * **3 つのクライアントグラント**: My Account、My Organization、Management API 操作へのスコープが設定されたアクセス
    * **ポータル**: デフォルトのテンプレートで事前設定され、すぐにテストを開始できます

    コマンドが完了すると、ポータルの URL が出力されます。ブラウザーで開いてポータルをテストしてください。
  </Tab>

  <Tab title="Auth0 Agent Skills">
    <h2 id="step-1-install-auth0-agent-skills">
      ステップ 1: Auth0 Agent Skills をインストールする
    </h2>

    ```bash theme={null}
    npx skills add auth0/agent-skills
    ```

    <h2 id="step-2-ask-your-ai-agent-to-configure-universal-portals">
      ステップ2：AI agent に Universal Portals の設定を依頼する
    </h2>

    ```bash theme={null}
    Auth0 テナントで Universal Portals を設定する
    ```

    AI agent により、以下が作成されます。

    * **My Account API**: ユーザーアカウント操作用のリソースサーバー
    * **My Organization API**: organization 管理操作用のリソースサーバー
    * **通常の Web アプリ**: ポータルにリンクされたアプリケーション
    * **3 つのクライアントグラント**: My Account、My Organization、Management API 操作へのスコープが設定されたアクセス
    * **ポータル**: すぐにテストを開始できるよう、デフォルトのテンプレートが事前設定されています

    コマンドが完了すると、ポータルの URL が出力されます。ブラウザーで URL を開いて、ポータルをテストしてください。

    詳細については、[Auth0 Agent Skills](https://github.com/auth0/agent-skills) を参照してください。
  </Tab>
</Tabs>

<h2 id="learn-more">
  詳細情報
</h2>

<Card title="Universal Portals の概要" icon="key" href="/docs/ja-jp/customize/portals/overview" horizontal>
  Universal Portals のユースケース、仕組み、主な機能について説明します。
</Card>

<Card title="Universal Components" icon="key" href="/docs/ja-jp/get-started/universal-components/universal-components-overview" horizontal>
  ポータルで使用する Universal Components ライブラリについて説明します。
</Card>

<Card title="Auth0 フォーム" icon="key" href="/docs/ja-jp/customize/forms" horizontal>
  ポータルでプロファイルの更新、ポリシーへの同意、マーケティングコミュニケーションの設定など、エンドユーザーから情報を収集するためのフォームについて説明します。
</Card>
