세션 사용하기
요청을 제출하면 각 세션마다 전용 상세 페이지가 생깁니다. 여기에서 기능을 실행하고, 상태를 추적하고, 세션을 관리합니다. Sessions 페이지나 세션 요청 후 표시되는 링크에서 세션을 열 수 있습니다.
세션 상세 탭
상세 페이지에는 세 개의 탭이 있습니다.
- 세션: 메인 화면: 상태와 타임라인, 목적, 대상 서버, 사용 가능한 기능, CLI 빠른 시작.
- 기록: 세션 중에 기록된 활동.
- 분석: 세션의 AI 위험 분석으로, 세션이 종료된 후 제공됩니다.
Alpacon이 확인한 것
세션 탭에는 요청이 어떤 사실을 근거로 처리됐는지 보여 주는 “Alpacon이 확인한 것” 블록이 있습니다. AI 에이전트가 알려 온 이름(있는 경우), 세션이 사용하는 계정(Windows 서버에서는 명령이 SYSTEM으로 실행되므로 감사용 표시이며, Windows의 권한 참고), 입력한 목적이 표시됩니다. “악성 코드 탐지가 아닌 정책 확인이에요.”에서 Alpacon이 확인하는 것과 확인하지 않는 것으로 이동할 수 있습니다. 승인자는 승인 카드에서 승인 규칙과 누가 승인해야 했는지까지 확인할 수 있습니다. 자세한 내용은 요청 검토하기를 참고하세요.
브라우저에서 기능 실행하기
세션 탭의 사용 가능한 기능 카드에 세션이 부여한 기능이 표시됩니다.
- 웹 터미널, 파일 전송, 코드 에디터처럼 브라우저에서 바로 실행되는 기능에는 실행 버튼이 표시됩니다. 클릭하면 작업을 시작합니다. 대상 서버가 필요한 기능은 서버를 선택하라는 안내가 나옵니다.
- 명령 실행, 포트 포워딩 같은 CLI 전용 기능에는 실행할 명령과 복사 버튼이 표시됩니다.
실행은 세션이 활성 상태일 때만 사용할 수 있으며, 코드 에디터와 포트 포워딩은 해당 기능이 활성화된 서버가 필요합니다.
기능을 처음 실행하기 전에 아직 설정하지 않았다면 사용자명을 먼저 설정하세요. 사용자명을 참고하세요.
CLI에서 진입하기
세션의 기능을 명령줄에서 사용하려면 먼저 세션에 진입합니다. CLI로 시작하기 카드에 명령이 표시됩니다.
$ alpacon work-session use SESSION_ID진입한 뒤 각 기능에 표시된 명령(예: alpacon websh, alpacon exec, alpacon tunnel)을 실행합니다. 전체 명령과 플래그는 alpacon work-session CLI 레퍼런스를 참고하세요.
세션 수명 주기
세션은 다음 상태를 거칩니다.
| 상태 | 의미 |
|---|---|
| 승인 대기 | 요청 제출됨, 관리자 승인 대기 중. 아직 사용 불가. |
| 승인됨 | 승인되어 시작 예정. 활성화되면 사용 가능. |
| 활성 | 현재 사용 가능. 기능 실행, CLI 진입, 연장, 종료 가능. |
| 완료됨 | 활성 상태에서 사용자가 일찍 종료함. |
| 만료됨 | 사용 시간이 끝남. |
| 반려됨 | 관리자가 요청을 반려함. |
| 취소됨 | 요청자가 승인 전에 취소함. |
| 철회됨 | 관리자가 승인된 세션을 활성화 전에 철회함. |
세션 탭의 타임라인에서 세션이 수명 주기 중 어디에 있는지 확인할 수 있습니다.
세션 관리하기
사용 가능한 작업은 세션 상태와 사용자 역할에 따라 달라집니다.
- 세션 연장: 활성 또는 승인 상태인 세션에서 프리셋(+1시간, +2시간, +4시간)이나 직접 설정한 시간으로 종료 시각을 연장하고 사유를 입력합니다. 새 종료 시각은 워크스페이스 최대 사용 시간을 초과할 수 없습니다. 아래 승인을 통한 연장을 참고하세요.
- 즉시 종료: 활성 세션을 즉시 종료합니다. 모든 활성 연결이 곧바로 닫힙니다. 되돌릴 수 없습니다. 세션 소유자와 관리자가 사용할 수 있습니다.
- 취소: 대기 중인 세션에서, 승인 전에 본인 요청을 취소합니다.
- 철회: 관리자는 승인된 세션이 활성화되기 전에 철회할 수 있습니다.
승인을 통한 연장
세션을 연장할 때는 사유가 필수입니다. 사유를 비워 두면 연장이 거부되므로 사유를 입력해 다시 제출해야 합니다. 연장에 Superuser의 승인이 필요한지는 새 세션 요청과 같은 기준으로 결정됩니다. 자동 승인을 참고하세요. 워크스페이스의 실행 제어가 Enforce로 설정되어 있으면 MFA를 우회하는 sudo 정책이 있는 AI 에이전트 세션을 연장하는 요청은 사람의 승인을 기다립니다.
- 자동 승인: 새 종료 시각이 즉시 적용되며, 세션에 연결된 sudo 권한도 새 종료 시각에 맞춰 연장됩니다.
- 승인 필요: 연장 요청이 승인 큐에 추가됩니다. Superuser가 결정할 때까지 세션의 기존 종료 시각은 유지됩니다. 세션 페이지에는 사유, 요청한 새 종료 시각, 요청 자체가 만료되기까지 남은 시간을 보여주는 배너가 표시됩니다.
세션에는 한 번에 하나의 연장 요청만 대기할 수 있습니다. 해당 요청이 처리되거나 만료될 때까지 세션 연장을 사용할 수 없습니다.
Superuser는 요청한 종료 시각 그대로 승인하거나 더 이른 시각으로 단축할 수 있습니다. 요청한 시각보다 늦출 수는 없습니다. 승인 시점에 선택한 종료 시각이 워크스페이스 최대 사용 시간을 초과하지 않는지 다시 확인합니다. 승인된 종료 시각이 적용되면 세션에 연결된 sudo 권한도 그 시각에 맞춰 연장됩니다.
세션은 여러 번 연장할 수 있습니다. 연장할 때마다 같은 제한을 확인하며, 매번 사유를 입력해야 하고 워크스페이스가 자동 승인하지 않는 한 승인을 받아야 합니다.
만료가 임박한 세션은 어떻게 연장하나요?
세션을 열어 세션 연장을 클릭하거나 CLI에서 alpacon work-session extend SESSION_ID --expires-in 2h --reason "..."를 실행하세요(alpacon work-session extend 참고). 세션이 만료되기 전에 요청해야 합니다. 승인이 필요한 워크스페이스에서는 검토를 기다리는 동안에도 기존 종료 시각까지 남은 시간이 줄어드므로, 검토자가 처리할 시간을 충분히 남겨 두세요.
연장 요청은 왜 반려되나요?
다음과 같은 경우 연장이 적용되지 않을 수 있습니다.
- Superuser가 요청을 반려했습니다. 세션 페이지에는 반려 사유가 표시되지 않으므로 검토자에게 직접 문의하세요.
- 결정되기 전에 요청이 만료되었습니다. 요청 자체나 세션이 먼저 만료되면 연장은 적용되지 않고 세션의 종료 시각도 그대로 유지됩니다. 시간이 더 필요하면 새 연장 요청을 제출하세요.
- 워크스페이스에서 요청을 즉시 거부했습니다. 일부 워크스페이스는 요청자 등의 조건에 따라 연장 요청이 승인 큐에 들어가기 전에 차단합니다. 이때는 대기 요청이 생성되지 않고 제출 즉시 오류가 표시됩니다.
연장 요청은 어떻게 승인하거나 단축하나요?
승인 큐에서 작업 세션 연장으로 표시된 요청을 여세요. 검토자는 사유, 기존 종료 시각, 요청한 새 종료 시각을 확인하고 요청한 시각을 그대로 두거나 더 이른 시각으로 단축할 수 있습니다. 요청한 시각보다 늦게 설정할 수는 없습니다. 승인을 누르면 선택한 종료 시각이 적용되고, 반려를 누르면 세션의 기존 종료 시각이 유지됩니다. 검토자가 확인하고 조정할 수 있는 내용은 요청 유형을 참고하세요.
기능 또는 서버 변경
관리자는 승인되었거나 활성 상태인 세션의 기능 또는 대상 서버를 편집할 수 있습니다. 변경 사항은 적용되기 전에 다시 승인이 필요할 수 있습니다. 변경이 승인 대기 중일 때는 일부 변경이 대기 중임을 알리는 배너가 표시되며, 대기 중인 변경을 취소할 수 있습니다. AI 에이전트 세션에 서버를 추가하는 변경은 사람의 승인을 기다리며, sudo 정책을 추가하거나 넓히는 변경도 워크스페이스의 실행 제어가 Enforce로 설정되어 있으면 사람의 승인을 기다립니다. sudo 정책을 제거하거나 좁히는 변경은 바로 적용됩니다.