sandboxed-api/sandboxed_api/sandbox2/examples/custom_fork/custom_fork_sandbox.cc

135 lines
4.5 KiB
C++

// Copyright 2019 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// A demo sandbox for the custom_fork_bin binary.
// Use: custom_fork_sandbox --logtostderr
#include <syscall.h>
#include <cstdint>
#include <cstdlib>
#include <memory>
#include <string>
#include <utility>
#include <vector>
#include "absl/log/check.h"
#include "absl/flags/parse.h"
#include "absl/log/globals.h"
#include "absl/log/initialize.h"
#include "absl/log/log.h"
#include "absl/base/log_severity.h"
#include "absl/time/time.h"
#include "sandboxed_api/config.h"
#include "sandboxed_api/sandbox2/comms.h"
#include "sandboxed_api/sandbox2/executor.h"
#include "sandboxed_api/sandbox2/fork_client.h"
#include "sandboxed_api/sandbox2/limits.h"
#include "sandboxed_api/sandbox2/policy.h"
#include "sandboxed_api/sandbox2/policybuilder.h"
#include "sandboxed_api/sandbox2/result.h"
#include "sandboxed_api/sandbox2/sandbox2.h"
#include "sandboxed_api/util/runfiles.h"
std::unique_ptr<sandbox2::Policy> GetPolicy() {
return sandbox2::PolicyBuilder()
.AllowRead()
.AllowWrite()
.AllowExit()
.AllowTime()
.AllowSyscalls({
__NR_close, __NR_getpid,
#if defined(__NR_arch_prctl)
// Not defined with every CPU architecture in prod.
__NR_arch_prctl,
#endif
})
.AllowLlvmSanitizers() // Will be a no-op when not using sanitizers.
.BuildOrDie();
}
static int SandboxIteration(sandbox2::ForkClient* fork_client, int32_t i) {
// Now, start the sandboxee as usual, just use a different Executor
// constructor, which takes pointer to the ForkClient.
auto executor = std::make_unique<sandbox2::Executor>(fork_client);
// Set limits as usual.
executor
->limits()
// Kill sandboxed processes with a signal (SIGXFSZ) if it writes more than
// these many bytes to the file-system (including logs in prod, which
// write to files STDOUT and STDERR).
->set_rlimit_fsize(1024 /* bytes */)
// The CPU time limit.
.set_rlimit_cpu(10 /* CPU-seconds */)
.set_walltime_limit(absl::Seconds(5));
sandbox2::Sandbox2 s2(std::move(executor), GetPolicy());
// Let the sandboxee run (asynchronously).
CHECK(s2.RunAsync());
// Send integer, which will be returned as the sandboxee's exit code.
CHECK(s2.comms()->SendInt32(i));
sandbox2::Result result = s2.AwaitResult();
LOG(INFO) << "Final execution status of PID " << s2.pid() << ": "
<< result.ToString();
if (result.final_status() != sandbox2::Result::OK) {
return -1;
}
return result.reason_code();
}
int main(int argc, char* argv[]) {
absl::SetStderrThreshold(absl::LogSeverityAtLeast::kInfo);
absl::ParseCommandLine(argc, argv);
absl::InitializeLog();
// This test is incompatible with sanitizers.
// The `SKIP_SANITIZERS_AND_COVERAGE` macro won't work for us here since we
// need to return something.
if constexpr (sapi::sanitizers::IsAny()) {
return EXIT_SUCCESS;
}
// Start a custom fork-server (via sandbox2::Executor).
// Note: In your own code, use sapi::GetDataDependencyFilePath() instead.
const std::string path = sapi::internal::GetSapiDataDependencyFilePath(
"sandbox2/examples/custom_fork/custom_fork_bin");
std::vector<std::string> args = {path};
std::vector<std::string> envs = {};
auto fork_executor = std::make_unique<sandbox2::Executor>(path, args, envs);
// Start the fork-server (which is here: the custom_fork_bin process calling
// sandbox2::Client::WaitAndFork() in a loop).
//
// This function returns immediately, returning std::unique_ptr<ForkClient>.
//
// If it's holding the nullptr, then this call had failed.
auto fork_client = fork_executor->StartForkServer();
if (!fork_client) {
LOG(ERROR) << "Starting custom ForkServer failed";
return EXIT_FAILURE;
}
LOG(INFO) << "Custom Fork-Server started";
// Test new sandboxees: send them integers over Comms, and expect they will
// exit with these specific exit codes.
for (int i = 0; i < 10; ++i) {
CHECK_EQ(SandboxIteration(fork_client.get(), i), i);
}
return EXIT_SUCCESS;
}