ブランド設定オプション
ブランド設定は Hosted Auth ページ、同意画面、メールテンプレートの外観を制御します。各組織はインスタンスレベルのデフォルトを上書きできます。
| オプション | 説明 |
|---|---|
| プライマリカラー | ボタン、リンク、フォーカスリングに使用されるメインアクションカラー。CSS の hex または oklch 値を受け付けます。 |
| 背景色 | Hosted Auth 画面のページ背景。 |
| アクセントカラー | ラベルや装飾要素に使用されるセカンダリハイライトカラー。 |
| 角丸 | カード、入力フィールド、ボタンに適用する角丸。none、small、medium、large、full から選択できます。 |
| フォントファミリー | Google Fonts 名またはカスタム CDN フォント URL。システムの sans-serif スタックにフォールバックします。 |
| ロゴ（ライト） | ライトテーマページに表示される PNG または SVG。R2 に保存されます。 |
| ロゴ（ダーク） | ダークテーマページに表示される PNG または SVG。未設定の場合はライトロゴにフォールバックします。 |
組織ごとのブランド設定
各組織は独自のロゴ、色、背景でインスタンスレベルのブランド設定を上書きできます。Login Worker は組織ごとにブランド設定を解決し、組織の上書きがない場合はインスタンスのデフォルトにフォールバックします。ブランドキャッシュの読み取りは P50 で 2 ミリ秒以内に完了します。
Management API エンドポイント
PATCH リクエストで組織のブランド設定を更新します。リクエストボディに含まれるフィールドのみが変更されます。フィールドをクリアして親のデフォルトに戻すには null を渡してください。
curl -X PATCH https://xid.dev/v1/organizations/org_xxx/branding \
-H 'Authorization: Bearer sk_live_xxx' \
-H 'Content-Type: application/json' \
-d '{
"primary_color": "#6366f1",
"border_radius": "medium",
"font_family": "Inter",
"hide_xid_branding": true
}'カスタム CSS の制約
- 組織ごとの最大サイズは 50 KB です。
- CSP フィルターは許可リスト外を参照する
@importルールとurl()参照を除去します。純粋な CSS プロパティ宣言のみが残ります。 - カスタム CSS 内からの外部スクリプト実行はブロックされます。カスタム CSS は動作ロジックではなく、視覚的なオーバーライドにのみ使用してください。
- 変更は公開前に iframe サンドボックスでプレビューされます。プレビュー状態と本番状態は分離されます。
メールテンプレートのブランド設定
トランザクションメールテンプレート（確認、メールリンク、OTP、パスワードリセット、招待）は組織のロゴとプライマリカラーを自動的に取得します。コンソールから組織ごとにカスタム HTML メールテンプレートをアップロードできます。