세션 요청하기

서버에서 작업하려면 필요한 내용을 담아 세션을 요청합니다. 제출하면 접근이 허용되기 전에 Superuser 역할을 가진 사용자가 요청을 검토합니다.

요청 시작하기#

두 가지 방법으로 요청을 시작할 수 있습니다.

• 서버에서: 서버 카드나 서버 상세 페이지에서 연결을 클릭합니다. 해당 서버가 요청 폼에 미리 선택됩니다.
• Sessions 페이지에서: 사이드바의 Access에서 Sessions를 열고 새 세션을 클릭합니다.

어느 방법이든 요청 폼으로 이동합니다.

요청 작성하기#

폼은 다음 단계로 진행됩니다.

1. 담당자 (슈퍼유저 전용)#

기본적으로 세션은 본인을 위해 요청됩니다. 슈퍼유저는 다른 사용자에게 세션을 지정할 수 있습니다.

2. 세션에서 접근할 서버#

작업할 서버를 선택합니다. 커미션되고 온라인 상태인 서버만 추가할 수 있습니다. 서버 선택에서 검색해 필요에 따라 추가하거나 제거하세요. 최소 한 대 이상이 필요합니다.

3. 세션 사용 목적#

접근이 필요한 이유를 작성합니다. 목적은 필수이며 Markdown을 지원하고, 최대 2,048자까지 입력할 수 있습니다.

서버를 선택한 경우 생성을 클릭하면 Alpacon이 목적 초안을 작성하고 서버에 맞는 기능을 추천해 줍니다. 결과를 수정하거나 원래대로를 클릭해 되돌릴 수 있습니다.

4. 세션에서 사용할 기능#

웹 터미널, 파일 전송, 명령 실행, 포트 포워딩, 코드 에디터, 권한 상승 등 필요한 기능을 선택합니다. 최소 하나 이상 선택하세요. 웹 터미널, 파일 전송, 명령 실행, 권한 상승은 기본으로 선택되어 있으며, 작업에 맞게 조정하면 됩니다.

각 기능에는 사용 방식 배지가 표시됩니다.

• 사용자용 (웹 인터페이스 · 사용자에 적합): 브라우저에서 실행됩니다.
• 에이전트용 (CLI · 에이전트에 적합): 세션에 진입한 뒤 Alpacon CLI에서 사용합니다.

5. 세션 사용 시간#

세션을 사용할 수 있는 시간을 설정합니다.

• 프리셋: 1시간, 2시간, 4시간. 세션이 언제 종료되는지 미리보기가 표시됩니다.
• 직접 설정: 직접 설정으로 전환해 시작 시점(지금 또는 예약)과 시간·분 단위 길이를 설정합니다.

워크스페이스는 허용 최대 시간(기본 4시간)을 정하며, 이는 사용 시간 입력란 아래에 표시됩니다. 그보다 긴 세션은 요청할 수 없습니다.

요청한 시간은 받을 수 있는 최대치이며, 승인자가 더 짧은 시간을 부여할 수도 있습니다. 승인 전 시간 창 단축을 참고하세요.

제출하기#

세션 요청을 클릭합니다. 세션이 승인 대기 상태로 생성되고 상세 페이지로 이동합니다.

이후 진행#

• 요청은 Superuser의 승인을 기다립니다. 대기 중에는 기능과 서버가 사용 요청된 상태로 표시되며 아직 사용할 수 없습니다.
• 대기 중에는 요청을 취소할 수 있습니다.
• 승인되면 세션은 시작 시각에 활성 상태가 되며, 그전까지는 승인됨 상태로 표시됩니다. 활성 상태가 되면 기능을 실행할 수 있습니다. 세션 사용하기를 참고하세요.

요청이 거부되는 경우#

제출하는 즉시 거부되는 요청이 있으며, 이유는 메시지로 안내됩니다.

• 허용되지 않은 AI 에이전트: 보고한 에이전트 이름이 워크스페이스의 접근 규칙에서 허용되지 않는다는 메시지가 표시됩니다. 세션은 만들어지지 않습니다.
• 다른 승인자가 없는 경우: 규칙상 다른 승인자가 필요하지만 요청을 승인할 수 있는 다른 사람이 없다는 메시지가 표시됩니다. Advisory 워크스페이스에서는 세션이 검토 없이 통과하므로 이 거부가 나타나지 않습니다. 두 거부는 워크스페이스의 접근 규칙에 따른 것입니다.

CLI에서 요청하기#

Alpacon CLI의 alpacon work-session create로도 세션을 요청할 수 있습니다. 스크립트나 AI 에이전트에 유용합니다.

$ alpacon work-session create --purpose "nginx fix" --scope command,websh --server web-01 --expires-in 2h

주요 플래그:

• --purpose: 접근이 필요한 이유(필수).
• --scope: 요청할 기능: command, editor, sudo, tunnel, webftp, websh(쉼표로 구분).
• --server: 대상 서버 이름(쉼표로 구분).
• --expires-in / --expires-at: 사용 시간(1h, 2h, 4h) 또는 절대 시각.
• --wait: 요청이 승인될 때까지 대기.
• --use: 생성한 세션을 활성 세션으로 지정해 이후 exec, websh, cp, tunnel 명령이 자동으로 이 세션에 연결되게 함. 승인이 필요한 경우 --wait와 함께 사용.
• --sudo: 비대화형 호출자가 MFA 프롬프트 없이 실행할 sudo 명령 패턴을 사전 선언(sudo 기능이 추가됨).

수명 주기는 동일합니다. 세션은 승인 대기 상태로 시작해 승인되면 사용할 수 있습니다. 나중에 승인된 세션에 진입하려면 alpacon work-session use를 사용하세요. 자세한 내용은 세션 사용하기를 참고하세요. 전체 명령과 플래그 설명은 alpacon work-session CLI 레퍼런스에서 확인할 수 있습니다.

관련 문서#

• 세션 기능
• 세션 사용하기
• 승인
• alpacon work-session CLI 레퍼런스