Skip to main content
セキュアアクセスは、SDK とサンドボックスコントローラー間の通信に認証を提供します。 サンドボックスコントローラーは各サンドボックス内で実行され、ファイルシステム操作、コマンド実行、その他のサンドボックス制御機能を含む、SDK が使用する管理インターフェイスを公開します。セキュアアクセスが無効になっている場合、サンドボックス ID を保持しているだけでこれらのインターフェイスを呼び出せるため、環境内からサンドボックスを不正に制御できる可能性があります。
SDK バージョン v2.0.0 以降では、サンドボックスが作成されるたびにセキュアアクセスが自動的に有効になります。古いカスタムテンプレートではこれがサポートされていない場合があり、その場合は再ビルドが必要になることがあります。

移行パス

v0.2.0 より前の envd で作成されたカスタムテンプレートでは、テンプレートを再ビルドした後にのみセキュアアクセスを利用できます。 サンドボックス作成時に一時的にセキュアアクセスを無効にするには、securefalse に設定できますが、セキュリティリスクがあるため、本番環境でセキュアアクセスを無効にすることは推奨されません。 テンプレート Envd version を確認するには、novita-sandbox-cli template list を使用してください。ダッシュボードでテンプレートを確認することもできます。

サポートされているバージョン

envd v0.2.0 以降のテンプレートから作成されたサンドボックスは、追加設定なしでセキュアアクセスをサポートします。 JavaScript および Python SDK では、v1.5.0 以降、セキュアアクセスをオプション設定として利用できました。 SDK v2.0.0 以降では、サンドボックスはデフォルトでセキュアアクセスが有効な状態でプロビジョニングされます。

サンドボックス API に直接アクセスする

SDK のいずれかを使用せずにサンドボックスとやり取りする場合、サンドボックスコントローラー URL に直接リクエストを送信できます。 セキュアアクセスで実行されているサンドボックスでは、直接 API リクエストは、作成時に生成されたアクセストークンが含まれている場合にのみ受け付けられます。SDK を使用する場合、セキュアアクセスは自動的に処理されます。X-Access-Token は、SDK を使用せずにサンドボックスコントローラー API を直接呼び出す場合にのみ必要です。 すべての直接サンドボックスコントローラーリクエストでは、このトークンを X-Access-Token ヘッダーに含めてください。 URL による Upload および download 操作には、pre-signed URLs が必要です。これらの生成には SDK の使用を推奨します。

セキュアアクセスを無効にする

セキュアアクセスを無効にすることは、サンドボックスをセキュリティリスクにさらす可能性があるため推奨されません。
最終更新日 2026年8月10日