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

# サインインページのブランディングとカスタム認証ドメイン

> Didit のホスト型サインインページとメールを、ご自身のブランドに合わせて設定できます。ブランドロゴ、5言語のページ文言、利用規約・プライバシーポリシーのリンク、独自のサインイン用ドメインを指定可能です。

Didit Authenticationのホスト型サインインページとサインインメールには、本人確認フローと同じブランドが使われます。
Authenticationのページテキストと法的リンクを設定できるほか、サインインを`auth.example.com`のような独自ドメインに移行することもできます。

この設定はコンソールの**Authentication > Branding and emails**で管理できます。このページでは、ホスト型サインインページのライトモードとダークモードのプレビューをリアルタイムで確認できます。

![サンドボックスアプリケーション向けのDidit Business ConsoleのBranding and emailsページ。Customizationのブランド、ページテキスト、ホスト型ページのプレビューが表示されています。](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-branding.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=9653e0d5b5556cec809139cfa6eaf055)

Authentication > Branding and emails。ホスト型ページのプレビューを表示しています。

## あなたのブランド

ロゴ、ブランドカラー、背景、角の丸み、フォントは、コンソールのアプリケーションの**Customization**設定から取得され、ホスト型ページとメールはそれに従います。
変更するには**Edit in Customization**を選択します。1回の変更で、検証フローとサインインページの両方が同時に更新されます。

* ページは、利用者のデバイスのライトモードまたはダークモードに従い、ブランドカラーはダーク背景向けに調整されます。
* ページには、アプリケーションの名前が表示されます。
* Freeプランでは、ホスト型ページに**Secured by Didit**バッジが表示されます。

![サンドボックスアプリケーション向けのDiditのホスト型サインインページを、ライトモードとダークモードで表示したもの。パスキーのボタンと、メールアドレスおよびパスワードの入力欄があります。](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-light-dark.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=835219dfc253b7bfcb830255aff8ff93)

利用者のデバイスのライトモードまたはダークモードに従って、ホスト型サインインページが表示されます。

## ページのテキストと法的リンク

| 項目 | 上限 | 表示場所 |
| - | - | - |
| **サインインのタイトル** | 120文字 | サインインページの見出しです。 |
| **サブタイトル** | 160文字 | 見出しの下に表示される行です。 |
| **サインアップのタイトル** | 120文字 | サインアップページの見出しです。 |
| **利用規約のURL** | 500文字 | ページに表示されるリンクです。設定すると、サインアップフォームでユーザーに利用規約への同意を求めます。 |
| **プライバシーポリシーのURL** | 500文字 | ページ上で利用規約の隣に表示されるリンクです。 |

ホスト型のページは英語、スペイン語、フランス語、ドイツ語、日本語に翻訳されており、言語はユーザーのブラウザーの言語、またはサインインURLの`ui_locales`に基づいて選択されます。
言語ごとに独自のテキストを設定できます。テキストを設定していない言語では、Diditが翻訳したデフォルトテキストが使われます。

APIを使う場合は、[認証管理API](https://docs.didit.me/ja/authentication/set-up-by-api.md)の`PATCH branding/`で同じフィールドを設定します：

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}branding/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": {
      "en": {"sign_in_title": "Welcome back", "subtitle": "Sign in to manage your account.", "sign_up_title": "Open your account"},
      "es": {"sign_in_title": "Hola de nuevo"}
    },
    "terms_url": "https://example.com/legal/terms",
    "privacy_url": "https://example.com/legal/privacy"
  }'
```

テキストを空で送信すると、デフォルトに戻ります。

## サインインメール

**Branding and emails** のメールビューには、アプリケーションのサインインメールが一覧で表示されます。各メールのプレビューと **テストを送信** があります。

| メール | 送信されるタイミング |
| - | - |
| メールコード | 利用者がメールコードでサインインまたはサインアップしたとき。 |
| マジックリンク | 利用者がサインインリンクを要求したとき。 |
| パスワード再設定 | 利用者が[パスワードを忘れた場合](https://docs.didit.me/ja/authentication/sign-in-methods.md#パスワードの再設定)の手続きを開始したとき。 |
| 新しいデバイスからのサインイン | 利用者が新しいデバイスからサインインしたとき。 |
| 招待 | `invited`サインアップポリシーを使って利用者をサインアップに招待したとき。 |
| 組織への招待 | 利用者を[組織](https://docs.didit.me/ja/authentication/organizations.md#招待)に招待したとき。 |
| エージェントの承認、エージェントのアクセス終了 | 利用者の[AIエージェント](https://docs.didit.me/ja/authentication/agent-access.md)がアクセスを許可されたとき、またはアクセスを失ったとき。 |

各メールは、アプリケーションごとに **On** または **Off** に設定されています。
メールは、カスタマイズで検証済みのメールドメインを設定している場合はそのドメインから送信されます。設定していない場合は `Didit <no-reply@didit.me>` から送信されます。

## カスタムドメイン

デフォルトでは、アプリケーションは `https://<slug>.auth.didit.me` でユーザーをサインインさせます。
カスタムドメインを使うと、ホスト型ページ、ランタイムAPI、トークン発行者を、お客様のサブドメイン(`auth.example.com` など)に移行できます。
カスタムドメインは本番アプリケーション向けです。サンドボックスアプリケーションは、常にDiditのドメインでユーザーをサインインさせます。

> [!WARNING]
>
> パスキーは、ユーザーがサインインするドメインに紐づきます。
> カスタムドメインを有効にすると既存のパスキーを登録し直す必要があるため、ユーザーがパスキーを追加し始める前にドメインを追加してください。

### セットアップ

1. **Custom domain** の下の **Your domain** に `auth.example.com` のようなドメインを入力し、**Add domain** を選択します。サブドメインを使用してください。CNAMEはドメインのルートに設定できません。
2. コンソールに表示されるDNSレコードを作成します。ドメインからアプリケーションのDidit ホストへの `CNAME` です。
3. **Check DNS now** を選択します。新しいレコードが表示されるまで最大1時間かかる場合があります。Didit がレコードを確認すると、ドメインの証明書を発行します。証明書は自動で更新されます。
4. ドメインに **Verified** と表示されたら、**Use this domain** を選択して、アプリケーションのサインインオリジンに設定します。

| 状態 | 意味 |
| - | - |
| DNS待ち | Didit はまだ `CNAME` レコードを確認できていません。 |
| 証明書を発行中 | レコードは存在しており、証明書を発行しています。 |
| 確認済み | ドメインでホスト型ページを提供しています。有効化するまでサインインオリジンにはなりません。 |
| 有効 | ドメインがサインインオリジンおよび発行者になっています。 |
| 見つかりません | 確認に失敗しました。レコードを修正して、もう一度確認してください。 |

APIでは、`PUT domain/` に `{"domain": "auth.example.com"}` を送信してドメインを追加し、`POST domain/verify/` で確認、`POST domain/activate/` で有効化、`DELETE domain/` で削除します。

### 有効化すると変わること

* **発行者。** 新しいトークンの `iss` にはお客様のドメインが設定されます。ディスカバリーとJWKSもこのドメインに移ります。バックエンドで確認している発行者を更新するか、古いトークンが期限切れになるまで両方の発行者を受け入れてください。詳しくは [トークンとJWKS](https://docs.didit.me/ja/authentication/tokens-and-jwks.md) を参照してください。
* **公開可能キー。** 公開可能キーには発行者が含まれるため、キーも変わります。**Authentication > Developers** から新しいキーをコピーして、アプリに設定してください。
* **古いドメインのセッションとトークン。** 5分以内に終了します。
* **パスキー** は、新しいドメインで登録し直す必要があります。
* **リダイレクトURL、設定、サインアップ済みのユーザー** は変わりません。

公開可能キーはアプリの1つの設定にまとめて保存してください。そうすると、切り替えは1回の変更で済みます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.