NVIDIA가 자율 AI 에이전트를 격리해 실행하는 OpenShell의 새 버전을 공개했다. 이번 업데이트는 외부 서비스에 보낼 인증 정보를 요청의 어디에 넣을지 명시하고, 실시간 양방향 통신을 지원하는 웹소켓 연결에는 별도 허용 규칙을 두도록 바꿨다. 에이전트를 서비스에 연결하는 개발자와 운영자는 기존 인증 설정과 통신 정책을 점검해야 한다.

1. 자격 증명은 요청 위치를 명시한다

배치 정보가 없는 정적 공급자 자격 증명은 이제 Authorization 헤더 또는 명시적으로 켠 본문·웹소켓 재작성 정책으로만 해석된다. 요청을 다시 쓰면서 인증 정보를 넣는 기능을 쓰려면 해당 정책을 켜야 한다.

x-api-key 같은 사용자 정의 헤더나 URL 요청에 붙는 쿼리 매개변수, 경로의 지정된 자리에 자격 증명을 넣으려면 배치 선언이 필요하다. 설정의 auth_style이 실제로 적용할 배치 방식을 고르며, 다른 방식의 필드는 무시된다. 인증 정보의 내용뿐 아니라 요청에 붙이는 위치까지 설정에서 선택하는 변화다.

2. 웹소켓에는 허용 규칙이 필요하다

HTTP 요청을 받는 REST 엔드포인트는 강제 모드와 감사 모드 모두에서 HTTP 업그레이드 요청에 403을 반환한다. 일반 HTTP 연결을 웹소켓으로 전환하는 요청을 기존 REST 규칙으로 처리하지 않고, 웹소켓용 정책으로 다루도록 한 것이다.

웹소켓을 쓰려면 프로토콜을 웹소켓으로 지정하고 연결 설정을 처음 협상하는 핸드셰이크와 이후 메시지에 적용할 규칙을 구성해야 한다. 웹소켓 자격 증명 재작성 기능도 웹소켓 엔드포인트가 설정된 경우에만 켤 수 있다. 연결을 여는 단계와 메시지를 처리하는 단계의 허용 범위를 명시하는 작업이 필요하다.

3. 파일·네트워크 경계와 감사 경로 변경

쓰기 가능한 작업 공간에서 다른 경로를 가리키는 심볼릭 링크를 거치는 파일 정책 경로가 있으면 샌드박스 시작이 실패한다. 가능한 범위에서 정책을 적용하는 최선 노력 모드, 적용 가능한 조치만 수행하는 방식에서도 같으며, 정책에는 링크가 가리키는 실제 경로를 넣어야 한다.

투명 TCP 연결, 원래 목적지를 유지해 중계하는 연결은 IPv4 주소를 담은 IPv6 목적지를 IPv4로 평가한다. 이 형식의 목적지를 쓰는 네트워크 규칙은 IPv4 주소로 바꿔야 한다. 같은 목적지라도 주소 표기 방식을 정책 평가 기준에 맞추는 작업이다.

감사 기록에서 어느 샌드박스의 활동인지 표시하는 위치도 달라졌다. 샌드박스 측 관리 구성요소인 슈퍼바이저는 장치의 컨테이너 항목에 식별 정보를 남긴다. 요청을 중계하는 게이트웨이는 이벤트 종류에 따라 자원 목록이나 별도 샌드박스 항목에 이를 기록한다. 기존 최상위 컨테이너 필드를 읽던 보안 로그 분석 파서는 매핑을 갱신해야 한다.

AWS SigV4, AWS 요청에 서명을 붙이는 인증 방식의 진단은 슈퍼바이저의 상세 추적 로그에 남지 않도록 바뀌었다. 임시 세션 토큰이 로그에 노출될 수 있던 경로를 줄인 수정이다.

4. 메모리와 장애 처리 개선

회사 발표 기준, 샌드박스를 삭제한 뒤 게이트웨이에 메모리가 남아 반복 생성·삭제가 메모리 고갈로 이어지던 문제가 수정됐다. 샌드박스마다 약 3.4 MiB의 스트림 버퍼, 데이터 흐름을 임시 저장하는 메모리 영역을 미리 할당하던 동작도 없어졌다. 샌드박스를 자주 만들고 지우는 운용에서 메모리 부담을 줄이는 변화다.

회사 발표 기준, PostgreSQL에 연결할 수 없을 때 게이트웨이 요청은 약 5초 안에 재시도 가능한 UNAVAILABLE 오류로 끝난다. 장애 중 시작한 게이트웨이도 데이터베이스가 돌아오면 반복 종료·재시작에 빠지는 대신 준비 상태가 된다.

Kubernetes에서 샌드박스를 삭제할 때는 팟, 컨테이너를 함께 실행하는 단위의 30초 종료 유예 시간을 기다리지 않게 됐다는 게 회사 발표다. 이 수치는 삭제에 걸리는 전체 시간이 아니라 기존에 기다리던 유예 시간을 가리킨다.

5. 운영자는 무엇을 점검해야 하나

릴리스 노트는 게이트웨이를 먼저 업그레이드한 뒤 슈퍼바이저를 올리도록 안내한다. 기존에 가져온 프로필도 필요에 따라 갱신해야 한다. 참고용 YAML만 편집해서는 게이트웨이 목록이 갱신되지 않기 때문이다.

빠른 설치 명령은 릴리스 노트에 다음과 같이 제시됐다.

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.1.8 sh

이번 릴리스의 이점은 자격 증명 배치와 네트워크 허용 경계를 분명히 하고 게이트웨이의 반복 운용 및 장애 회복을 개선한 데 있다. 그에 따른 작업은 구성 변경과 업그레이드 순서 확인, 기존 감사 파서 및 네트워크 정책의 갱신이다.

v0.1.8은 샌드박스 보안 경계와 운영 회복력을 함께 다듬었으며, 기존 구성을 쓰는 운영자는 정책과 배포 순서를 맞춰야 한다.