セキュリティトークンを使用すると、商品ターゲティングストラテジーにプログラムからアクセスする際の API リクエストを認証できます。トークンの生成、表示、再生成は、Aftersell 管理画面で直接行えます。
最初のセキュリティトークンを生成するには:
- Aftersell 管理画面で Settings → Product Strategy に移動します
- ページ上部の Security Token カードを見つけます
- Generate Token をクリックします
- 新しいトークンが表示されます。Copy をクリックしてクリップボードにコピーします
⚠️ 重要: 生成後は必ずすぐにトークンをコピーしてください。ページを離れた後は、再び確認することはできません。
トークンを生成した後は、次の操作ができます:
- トークンの表示/非表示: 目のアイコンをクリックして表示を切り替えます
- トークンのコピー: Copy ボタンをクリックしてクリップボードにコピーします
セキュリティのため、トークンはデフォルトでマスクされています。ページから離れると、トークンは永久に非表示となり、再生成することしかできません(再生成すると以前のトークンは無効になります)。
新しいトークンを作成する必要がある場合(たとえば、現在のトークンが漏えいした場合):
- Aftersell 管理画面で Settings → Product Strategy に移動します
- Security Token カードで Regenerate をクリックします
- 新しいトークンが表示されます。Copy をクリックして保存します
⚠️ 警告: トークンを再生成すると、以前のトークンは即座に無効になります。古いトークンを使用する API リクエストはすべて失敗します。再生成する前に、古いトークンを使用しているすべてのシステムを必ず更新してください。
すべての Strategy API リクエストで、X-Strategy-Api-Key ヘッダーにセキュリティトークンを含めて送信してください。トークンはパスワードと同様に扱い、非公開かつ安全に保管してください。
ストアごとに一度にアクティブにできるトークンは 1 つだけです。新しいトークンを生成すると以前のトークンは即座に無効になるため、API を呼び出すすべての環境で 1 つのトークンを共有する必要があります。開発、ステージング、本番用に別々のトークンを発行することはできません。
- トークンを安全に保管する(バージョン管理には絶対にコミットしない)
- 漏えいの疑いがある場合はトークンを再生成する
- 古いトークンは即座に使えなくなるため、再生成する前にトークンを使用するすべてのシステムを更新する
- トークンの生成日時と使用場所を記録しておく
