API許可リスト用の静的IP: パートナーが信頼できる固定IPv4

なぜAPIやファイアウォールは静的IPを要求するのですか？

APIやファイアウォールが静的IPを要求するのは、既知の送信元アドレスがキーやパスワードに加えたシンプルな二重チェックになるからです。キーが漏洩しても、未知のアドレスからのリクエストは依然として拒否されます。

IP許可リストを使用する一般的な場面：

• パートナーAPIやサプライヤーAPI: 物流、在庫、卸売カタログ、データフィード。
• B2Bダッシュボード: 顧客の登録済みアドレスからのログインのみを受け入れます。
• クラウドファイアウォールやセキュリティグループ: SSH、データベースポート、管理パネルをリスト登録されたIPに開放します。
• ステージングサーバーやプレビューサーバー: 公開すべきでないもの。
• SaaS管理コンソール: オプションの「信頼できるIP」設定があるもの。

家庭やオフィスの接続はしばしばアドレスが変わり、クラウド関数やCIランナーは共有され変化する範囲を使用します。レンタルIPはそれらすべてに1つの安定した出口を提供します。

関与する2つの許可リストとは？

この設定では2つの異なる許可リストが関わり、それらを混同することが最もよくあるサポート質問です。

マシンのアドレスが変わる場合は、プロキシの許可リストをスキップしてユーザー名とパスワードを使用してください。ユーザー名とパスワード、またはIP許可リスト（最大10 IP）。

静的IP経由でAPI呼び出しをルーティングするにはどうすればよいですか？

API呼び出しを静的IP経由でルーティングするには、APIを呼び出すクライアントのHTTP(S)またはSOCKS5プロキシとしてそのIPを設定します。ほとんどのHTTPライブラリ、curl、多くのツールはプロキシ設定またはHTTPS_PROXY環境変数を読み取ります。まず公開エコーサービスで出口アドレスを確認し、その後パートナーAPIを呼び出してください。以下のアドレスはドキュメント用の例です。実際のIP、ポート、認証情報はアカウントにあります。

# 1. The address the partner will see
curl -x http://USERNAME:[email protected]:8000 https://api.ipify.org

# 2. Same proxy for every tool in this shell
export HTTPS_PROXY=http://USERNAME:[email protected]:8000
curl -H "Authorization: Bearer $PARTNER_TOKEN" https://example.com/api/v1/orders

レンタル終了時に許可リストはどうなりますか？

許可リストは同じIPを使い続ける限り機能するので、終了日より前に更新してください。各レンタルは引き渡しから30日間です。終了日前にアカウントから更新してください。レンタル終了後に同じIPを保持できることは保証されません。

許可リストを使ったアクセスの安全な手順：

1. IPを1つではなく2つレンタルする。 パートナーに両方のアドレスを伝えます。片方を交換する必要が出ても、もう片方で連携を維持できます。
2. 終了日をメモする（アカウントの各IPの横に表示されます）、数日前に更新してください。
3. パートナーの変更手順を手元に置く。 誰が許可リストを更新するのか、どれくらいかかるのかを把握しておきます。
4. 更新のたびにテストする（上記のエコー呼び出しで）。

IPが動作しない、または合法的な用途に使用できない場合はサポートまでご連絡ください。在庫の範囲で修正または同じ国のIPに交換します。交換用IPは新しいアドレスなので、新しい許可リストのエントリが必要です。

レンタルプロキシIPが不適切な選択となるのはどんな場合ですか？

レンタルプロキシIPが不適切な選択となるのは、接続したいサービスがブロックリストに載っている場合や、恒久的なアドレスが必要な場合です。銀行、政府、決済ポータルのサイトはすべてのIPでブロックされているため、銀行や決済APIの許可リストは当社がサポートする用途ではありません。

また、次の場合も他の選択肢を検討してください：

• クラウド上で自前のサーバーを運用している場合：クラウドプロバイダーの静的アドレスを自社のNATゲートウェイに紐づければ、トラフィックを自社インフラ内に保てます。
• IPv6が必要な場合：IPv4のみです。IPv6プロキシはまだ販売していません。
• 長年にわたり同じアドレスが必要な場合：30日レンタルは更新できますが、所有するアドレス割り当てではありません。