Защищённый доступ

SDK AgentBox обращается к контроллеру внутри каждой песочницы. Защищённый доступ требует токен для команд, операций с файлами и других API контроллера. В JavaScript и Python он включён по умолчанию. В Go задайте Secure: &secure, где secure := true. SDK добавляет полученный токен к запросам автоматически.

mjs

import { Sandbox } from "@abox-dev/sdk";

// Secure access is enabled by default.
const sandbox = await Sandbox.create();

try {
  const result = await sandbox.commands.run("printf secure");
  console.log(`Command result: ${result.stdout}`);
} finally {
  await sandbox.kill();
}

from agentbox import Sandbox


# Secure access is enabled by default.
sandbox = Sandbox.create()

try:
    result = sandbox.commands.run("printf secure")
    print(f"Command result: {result.stdout}")
finally:
    sandbox.kill()

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/abox-dev/sdk/packages/go-sdk"
)

func kill(sandbox *agentbox.Sandbox) {
	if _, err := sandbox.Kill(context.Background()); err != nil {
		log.Printf("cleanup sandbox: %v", err)
	}
}

func run() (err error) {
	ctx := context.Background()
	client, err := agentbox.NewClient()
	if err != nil {
		return err
	}
	secure := true
	sandbox, err := client.Sandboxes.Create(ctx, &agentbox.CreateSandboxOptions{Secure: &secure})
	if err != nil {
		return err
	}
	defer kill(sandbox)
	result, err := sandbox.Commands.Run(ctx, "printf", &agentbox.CommandOptions{Args: []string{"secure"}})
	if err != nil {
		return err
	}
	fmt.Printf("Command result: %s\n", result.Stdout)

	return nil
}

Обычно токен контроллера не нужно обрабатывать самостоятельно. При прямом обращении к API контроллера передавайте заголовок X-Access-Token со значением, которое вернул запрос создания песочницы.

Песочницу можно создать с secure: false в JavaScript или secure=False в Python, либо передать в Go Secure со значением false, но тогда любой владелец идентификатора песочницы сможет обратиться к её контроллеру. Не отключайте защищённый доступ в продакшене.

Защищённый доступ ​

Защищённый доступ