Skip to main content
このガイドでは、Auth0 の主要な概念を理解できるよう、Auth0 の使い始めに必要な最初の手順を順を追って説明します。手順の一部を説明する際には、Example-Co という会社を例として使用します。

​
Auth0 アカウントを作成する

まだ Auth0 のアカウントにサインアップしていない場合は、ここで行ってください (無料です) 。ユーザー名、メールアドレス、または電話番号とパスワードを使うことも、ソーシャルプロバイダー (LinkedIn、Microsoft、GitHub、Google など) でログインすることもできます。

​
テナントとドメインを作成する

アカウントを作成すると、テナントを作成するよう求められます。すべては Auth0 テナントから始まります。ここで Auth0 の利用方法を設定し、アプリケーション、接続、ユーザープロファイル などの Auth0 のリソースを定義、管理、保存します。Auth0 テナントには Auth0 の Auth0 Dashboard からアクセスでき、ここで関連する追加のテナントを作成することもできます。複数の Auth0 テナントを作成すれば、異なるユーザードメインを分離できるようにテナントを構成でき、ソフトウェア開発ライフサイクル (SDLC) もサポートできます。 テナント名は、一度削除すると変更も再利用もできません。 そのため、Auth0 テナントを作成する前に、その名前で問題ないことをよく確認してください。 ユーザードメインについてどの程度の分離が必要かを判断することは重要なステップです。また、それにブランド要件をあわせて考慮することで、環境内で必要な Auth0 テナント数を見極めることができます。管理すべき Auth0 テナントの数はすぐに増える可能性があるため、本番用に複数の Auth0 テナントを作成する前に十分に検討してください。 テナントの特性:
  • テナント名は一意である必要があります。これは固有のドメインの作成に使用されます。
  • テナント名には小文字の英数字とハイフン (”-”) のみ使用できます。先頭または末尾にハイフンを付けることはできません。
  • テナント名は 3 文字以上 63 文字以下でなければなりません。
  • テナント名は作成後に変更できません。
  • 複数のテナントを作成できます。実際、開発、ステージング、本番などの環境ごとに作成することが推奨されます。詳しくは、Set Up Multiple Environments を参照してください。
テナント名は Auth0 ドメインの一部になります。これは を使用してカスタマイズできます。このドメインは、Auth0 API にアクセスするためのベース URL であり、ユーザーが認証を行う URL でもあります。

​
リージョン、ローカリティ、サブローカリティ

ドメイン名は、リージョン のローカリティ値によっても構成されます。パブリッククラウドのデプロイオプション では、以下のローカリティ値をサポートしています。 これらの各ローカリティは、ローカリティの後ろに数字を付けたサブローカリティ (または テナント環境) に分かれています。たとえば EU-2 のようになります。テナント環境は手動で選択できませんが、選択したリージョンに基づくローカリティは指定できます。これにより、割り当てられるテナントドメインと、データがホストされるリージョンが決まります。 この例では、Example-Co は名前として example-co を選び、リージョンとして AU を選択しました。そのため、ドメインは example-co.au.auth0.com になります。

​
カスタムドメイン

ユーザーに最も安全でシームレスな体験を提供するため、本番環境では example-co.com のようなカスタムドメインの使用を推奨します。 カスタムドメインの証明書は、Auth0 が管理することも、お客様自身で管理することも可能です。 詳しくは、Custom Domains をご覧ください。

​
次のステップ

  • アプリケーションを作成して登録する: アカウントとドメインを取得したら、サービスを利用する各アプリケーションを Auth0 Dashboard に登録する必要があります。詳しくは、Applications in Auth0 と Create Applications をご覧ください。
  • 接続を設定する: 次に、ログイン時にユーザーをどのように認証するかを設定する必要があります。Auth0 は、アプリと、ユーザーを認証する (Google や Facebook など) の間を仲介します。Auth0 とアイデンティティプロバイダーの関係は 接続 と呼ばれます。この接続レイヤーを利用することで、アイデンティティプロバイダーの実装に変更があっても、アプリはその影響を受けにくくなります。詳しくは、Authentication and Authorization と Connections をご覧ください。

​
Auth0 の機能を拡張する

Auth0 では、プラットフォームの機能を拡張するための方法がいくつか提供されています。
  • Actions: Actions は、Node.js で記述された、安全なテナント固有のバージョン管理された関数で、Auth0 プラットフォーム内の特定のポイントで実行されます。Actions を使用すると、カスタムログインなどによって Auth0 の機能をカスタマイズおよび拡張できます。
  • ルール: ルールは JavaScript または C# で記述された関数で、Auth0 で認証が正常に完了した直後、制御がアプリケーションに戻る前に実行されます。ルールは連結してモジュール化されたコードを構成でき、個別に有効化または無効化できます。ルールは次の用途に使用できます。
    • アクセス制御
    • ウェブフック
    • プロファイルの拡充
    • 多要素認証 (MFA)
  • フック: フックを使用すると、拡張ポイントに対して実行される Node.js コードによって Auth0 の動作をカスタマイズできます (これは、サーバーに組み込まれたウェブフックに相当します) 。フックは、Auth0 プラットフォームの特定の拡張ポイントに関連付けられた、安全で自己完結型の関数です。Auth0 は実行時にフックを呼び出して、カスタムロジックを実行します。
  • Extensions: Auth0 Extensions を使用すると、アプリケーションをインストールしたり、Auth0 の基本機能を拡張するコマンドやスクリプトを実行したりできます。Auth0 が提供する定義済みの Extensions を使用することも、独自に作成することもできます。Extensions で実行できる操作には、次のようなものがあります。
    • ユーザーの認可を管理する (グループ、ロール、権限を使用)
    • ユーザーのインポート/エクスポート
    • 他のサービスへのログのエクスポート
    • 外部リポジトリからスクリプトをデプロイする

​
詳しくはこちら