Skip to content

Secure, Fast, and Extensible Sandbox runtime for AI agents.

3.8 KB
Raw Blame
/*
 * Copyright 2026 The OpenSandbox Authors
 *
 * 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
 *
 *     http://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.
 */

/*
 * opensandbox-session-gate is the last fail-closed barrier before a session
 * workload executes. bubblewrap's --block-fd treats EOF as success, so it
 * cannot be the authorization boundary by itself.
 *
 * The helper announces that it is blocked over an inherited SOCK_SEQPACKET
 * socket. execd authenticates the sender with SCM_CREDENTIALS, validates its
 * host PID and network namespace, and then sends the exact READY frame.
 * EOF, a short/long frame, an invalid descriptor, or any socket error exits
 * without ever executing the workload.
 */

#include <errno.h>
#include <fcntl.h>
#include <limits.h>
#include <stddef.h>
#include <stdlib.h>
#include <string.h>
#include <sys/socket.h>
#include <unistd.h>

#define GATE_FAILURE 125
#define EXEC_FAILURE 126

static const char waiting_frame[] = "OPENSANDBOX_SESSION_WAITING_V1";
static const char ready_frame[] = "OPENSANDBOX_SESSION_READY_V1";

static int parse_fd(const char *value)
{
    char *end = NULL;
    long parsed;

    errno = 0;
    parsed = strtol(value, &end, 10);
    if (errno != 0 || end == value || *end != '\0' ||
        parsed < 3 || parsed > INT_MAX)
        return -1;
    return (int)parsed;
}

static void fail_closed(int control_fd, int exec_fd)
{
    if (control_fd >= 0)
        (void)close(control_fd);
    if (exec_fd >= 0 && exec_fd != control_fd)
        (void)close(exec_fd);
    _exit(GATE_FAILURE);
}

int main(int argc, char **argv)
{
    int control_fd;
    int exec_fd;
    int socket_type = 0;
    socklen_t socket_type_len = sizeof(socket_type);
    char incoming[sizeof(ready_frame)];
    ssize_t received;
    ssize_t sent;

    if (argc < 5 || strcmp(argv[3], "--") != 0)
        fail_closed(-1, -1);

    control_fd = parse_fd(argv[1]);
    exec_fd = parse_fd(argv[2]);
    if (control_fd < 0 || exec_fd < 0 || control_fd == exec_fd)
        fail_closed(control_fd, exec_fd);

    if (fcntl(control_fd, F_GETFD) < 0)
        fail_closed(control_fd, exec_fd);
    if (fcntl(exec_fd, F_GETFD) < 0)
        fail_closed(control_fd, exec_fd);
    /*
     * bubblewrap starts this helper through /proc/self/fd/<exec_fd>. Once
     * main is running the executable is already mapped, so close that
     * descriptor before the workload handshake to avoid leaking it onward.
     */
    if (close(exec_fd) != 0)
        fail_closed(control_fd, -1);
    if (getsockopt(control_fd, SOL_SOCKET, SO_TYPE,
                   &socket_type, &socket_type_len) < 0 ||
        socket_type != SOCK_SEQPACKET)
        fail_closed(control_fd, -1);

    sent = send(control_fd, waiting_frame, sizeof(waiting_frame) - 1,
                MSG_NOSIGNAL);
    if (sent != (ssize_t)(sizeof(waiting_frame) - 1))
        fail_closed(control_fd, -1);

    /*
     * The buffer has room for one byte beyond the expected payload. This
     * makes overlong seqpacket messages observably different from READY.
     */
    received = recv(control_fd, incoming, sizeof(incoming), 0);
    if (received != (ssize_t)(sizeof(ready_frame) - 1) ||
        memcmp(incoming, ready_frame, sizeof(ready_frame) - 1) != 0)
        fail_closed(control_fd, -1);

    if (close(control_fd) != 0)
        _exit(GATE_FAILURE);

    execvp(argv[4], &argv[4]);
    _exit(EXEC_FAILURE);
}