세션 기능

세션 요청하기 사용할 기능을 선택합니다. 각 기능은 세션에 포함된 서버에서 작업할 수 있는 방법을 제공합니다. 요청하고 승인된 기능만 사용할 수 있습니다.

기능은 다음 두 가지 방식으로 사용합니다.

  • 웹 인터페이스: 세션 상세 페이지에서 브라우저로 바로 실행함
  • CLI: 세션에 연결한 뒤 CLI 레퍼런스에서 사용함

사용 가능한 기능

웹 터미널 (Websh)

브라우저 터미널에서 서버 명령을 실행합니다. 실행을 누르면 브라우저에서 열리며, CLI에서도 사용할 수 있습니다.

$ alpacon websh SERVER

터미널 접근 개요와 alpacon websh CLI 문서를 참고하세요.

파일 전송 (WebFTP)

서버와 파일을 주고받을 수 있으며, 브라우저에서는 드래그 앤 드롭도 지원합니다. 실행을 누르면 브라우저에서 열리며, CLI에서도 사용할 수 있습니다.

$ alpacon cp SERVER:/path/to/remote ./local/

파일 관리 개요와 alpacon cp, alpacon edit CLI 문서를 참고하세요.

명령 실행 (Command)

CLI에서 하나 이상의 서버에 명령을 실행합니다.

$ alpacon exec SERVER -- COMMAND

사용법과 플래그는 alpacon exec CLI 문서를 참고하세요.

포트 포워딩 (Tunnel)

서버 포트를 로컬 컴퓨터로 안전하게 전달합니다. CLI에서 사용합니다.

$ alpacon tunnel SERVER -l LOCAL -r REMOTE

사용법과 플래그는 alpacon tunnel CLI 문서를 참고하세요.

참고

서버 소유자가 포트 포워딩을 활성화해야 합니다. 서버 관리하기를 참고하세요.

코드 에디터 (Editor)

브라우저의 코드 편집기에서 서버 파일을 직접 수정합니다. 실행을 누르면 브라우저에서 열립니다.

참고

서버 소유자가 편집기를 활성화해야 합니다. 서버 관리하기를 참고하세요. 세션에 포함된 서버 중 편집기가 활성화된 서버가 없으면 이 기능을 실행할 수 없습니다.

코드 에디터 개요를 참고하세요.

권한 상승 (Sudo)

세션의 다른 기능에서 상승된 권한(sudo)으로 작업할 수 있습니다. 이 기능은 단독으로 실행하지 않습니다. 터미널, 파일 전송 등 사용하는 기능에 상승된 권한을 부여합니다. 세션에 포함하는 것만으로는 충분하지 않습니다. 다른 기능과 마찬가지로 요청하고 승인받아야 합니다.

이후 sudo를 사용할 때마다 해당 작업을 다시 확인합니다. 워크스페이스의 승인 정책에 따라 위험도가 낮은 작업은 자동으로 승인되거나 담당자의 승인을 기다리며, MFA를 요청할 수도 있습니다. 승인은 제한된 시간 동안만 유효하고 모든 sudo 작업은 감사 기록에 남습니다.

사람이 승인한 명령에는 그 명령의 sudo 승인도 포함됩니다. 승인 대기 중인 명령을 사람이 승인하면, 승인한 명령줄에 적힌 sudo도 함께 승인됩니다. 이때 권한 상승은 별도의 sudo 승인 없이 실행되며, 위험도가 심각 수준이어도 이를 이유로 거부되지 않습니다. 승인 범위는 승인자가 확인한 내용과 그 명령이 실행되는 동안으로 한정됩니다. 다만 공백이 포함된 스크립트를 실행하는 sudo sh -c '…', root가 아닌 계정을 지정하는 sudo -u, 스크립트나 xargs 등을 통해 간접적으로 실행되는 sudo는 별도로 확인하며, 추가 승인을 요청하거나 거부할 수 있습니다. 워크스페이스에서 명령을 거부하거나 승인자를 둘 이상 요구하도록 정한 정책도 그대로 적용됩니다.

사람이 승인하지 않은 명령은 명령 전체의 위험도와 AI 검증에서 거부된 위험도 중 더 높은 수준으로 판단합니다. 명령 전체의 위험도가 낮게 표시되더라도 AI 검증에서 심각 수준으로 거부된 명령은 실행되지 않고, 높음 수준으로 거부된 명령은 승인을 기다립니다.

실행 제어가 Advisory로 설정된 워크스페이스에서는 위험도가 높아도 sudo 작업이 보류되지 않습니다. 대신 Sudo에 Advisory (not gated)로 기록됩니다. 그 밖의 sudo 동작은 그대로입니다. 명령을 실행할 권한이 있어야 하며 MFA를 요청받을 수 있습니다.

참고

여기서는 작업 세션에서 사용하는 sudo를 설명합니다. 서비스 토큰으로 실행하는 파이프라인에는 다른 기준이 적용됩니다. 이 경우 사람의 승인을 기다리느라 보류되지 않으며 MFA도 요청하지 않습니다. 자세한 내용은 명령 패턴과 sudo를 참고하세요.

sudo with MFA를 참고하세요.

기능 요약

기능사용 방법CLI 명령
웹 터미널브라우저 및 CLIalpacon websh SERVER
파일 전송브라우저 및 CLIalpacon cp SERVER:/remote ./local/
명령 실행CLIalpacon exec SERVER -- COMMAND
포트 포워딩CLIalpacon tunnel SERVER -l LOCAL -r REMOTE
코드 편집기브라우저—
권한 상승수식 기능(별도 실행 없음)—

승인 후 기능 변경

세션 소유자 또는 Superuser는 승인된 세션이나 활성 세션의 기능을 변경할 수 있습니다. 변경 사항을 적용하려면 다시 승인이 필요할 수 있습니다. 자세한 내용은 세션 사용하기를 참고하세요.

관련 문서

최종 수정: