環境
コントラクト別ホスト
| コントラクト | サンドボックスホスト | 本番ホスト |
|---|---|---|
| OAuth2 / Token | https://identityhomolog.acesso.io | https://identity.acesso.io |
| Web & SDK | https://api.idcloud.uat.unico.app | https://api.idcloud.unico.app |
| API | https://api.id.uat.unico.app | https://api.id.unico.app |
| Magic Link (Mexico) | https://sandbox.trully.ai | https://api.trully.ai |
サンドボックスを使用する場面
- 本番稼働前の開発および統合テスト。
- テナントが有効化される新しいフローまたは機能の検証。
- 実際のデータに影響を与えずに顧客向け問題を再現する場合。
認証情報は環境固有です
サンドボ ックスと本番環境は異なる認証情報(クライアント ID、秘密鍵、API キー)を使用します。環境間で認証情報を混在させることは、401 エラーの最も一般的な原因の一つです。認証 > 一般的なエラーを参照してください。
動作の違い
両環境は同じ API コントラクトを共有しています — 同じエンドポイント、同じペイロードです。異なる点は以下のとおりです:
| 側面 | サンドボックス | 本番 |
|---|---|---|
| 認証情報 | サンドボックス専用 | 本番専用 |
| 実際の生体認証データ | なし(テストデータのみ) | あり |
| Webhook 配信 | 実際(サンドボックスエンドポイントへ) | 実際 |
| レート制限 | 低め | レート制限を参照 |
| 永続性 | 定期的にリセット | 永続的 |
Webhook の送信元(Magic Link のみ)
Magic Link(Mexico)を使用する場合は、Webhook サーバーの CORS で以下の送信元を許可してください:
- サンドボックス:
https://verification.uat.unico.app - 本番:
https://verification.unico.app
本番稼働に向けて許可リストに追加するホスト
貴社(または貴社のクライアント)のネットワークで、本番環境への移行前に明示的なファイアウォール/プロキシの許可リストが必要な場合は、以下のホストの許可を依頼してください:
cadastro.unico.appid.unico.ioretry.unico.ioultimatum.unico.iobackend-sdk.prod.private.unico.run
ファイアウォールがドメインレベル(ワイルドカード)のルールに対応しており、登録するエントリを少なくしたい場合は、上記の個別ホストの代わりに以下のドメインを許可することもできます:
*.unico.app*.unico.io*.unico.run
Unico 自身のドメインに加えて、以下のサードパーティホストも本製品の動作(フィーチャーフラグの評価、エラートラッキング、パフォーマンスモニタリング)に必須であり、同様に許可リストに追加する必要があります:
app.launchdarkly.comclientstream.launchdarkly.comevents.launchdarkly.como939397.ingest.sentry.iojs-agent.newrelic.combam.nr-data.net
ファイアウォールがドメインレベル(ワイルドカード)のルールに対応している場合は、代わりに以下のドメインを許可することもできます:
*.launchdarkly.com*.sentry.io*.newrelic.com*.nr-data.net