접근 규칙 참조
아래 표는 세션 승인, 계정 선택, sudo 위험도, 명령어 실행을 구별합니다. 별도 설명이 없으면 enforce에서 일치하는 워크스페이스 규칙이 없을 때의 기본값입니다. 적용되는 검사는 콘솔 각 영역의 안내와 미리보기로 확인하세요. 한 검사에서 허용하더라도 인증, 범위, 계정 권한, 필요한 MFA를 건너뛰지는 않습니다.
기본 개념은 접근 결정 방식을, 규칙 작성과 미리보기 절차는 접근 규칙을 참고하세요.
작업 주체와 자격 증명
| 작업 주체 또는 자격 증명 | 판단 기준 |
|---|---|
| 사람 | 역할과 서버 접근 권한을 가진 워크스페이스 사용자. 개인 API 토큰에는 명령어 실행이나 파일 전송 범위를 넣어 발급할 수 없으므로, 해당 작업에는 서비스 토큰 사용 |
| AI 에이전트 | 사용자나 애플리케이션의 신원으로 선언한 에이전트 모드. 스스로 신고한 이름으로 규칙을 좁힐 수 있지만, 이름만으로 권한을 인정하지 않음 |
| 서비스 토큰 | 애플리케이션 신원과 토큰의 범위, 서버 접근, 명령어·파일 사전 승인. 세션 없는 실행과 작업 세션에 연결한 실행을 구별 |
| Alpamon | 관리 대상 서버의 소프트웨어로, AI 에이전트 요청자 모드와 구별. 등록 자격 증명으로 AI 에이전트에 실행 권한을 부여하지 않음 |
개인 API 토큰이나 MCP로 요청한 세션, 에이전트임을 선언한 CLI 또는 식별되지 않은 클라이언트가 요청한 세션은 에이전트 모드로 처리합니다.
세션 승인 기본 규칙
세션 승인에는 AI 명령어 위험도가 없습니다. 요청자의 역할과 세션을 사용할 사람의 역할은 별도 조건입니다.
| 요청 | 기본 승인 결정 | 추가 조건 |
|---|---|---|
| 슈퍼유저 역할을 가진 사람 | 허용 | 계정 사용 자격과 요청한 권한은 별도로 확인 |
| 그 밖의 사람 | 승인자 한 명 | 대상에 따라 승인할 수 있는 사람을 결정 |
| AI 에이전트 | 사람의 승인 필요 | 에이전트 요청자를 허용하는 명시적 규칙이 요건을 충족하면 목적을 적은 세션을 승인 없이 시작할 수 있음. 목적이 없거나 sudo 정책을 연결하면 여전히 사람의 승인 필요 |
| 서비스 토큰이 직접 세션 생성 시도 | 거부 | 애플리케이션이 지원하는 자동화 경로 사용. 토큰이 사람의 세션을 생성하지 않음 |
세션 대상이 여러 서버 그룹에 걸치면 더 엄격한 대상의 결정도 반영합니다. 계정 규칙 때문에 허용될 요청에 더 엄격한 조건이 붙을 수 있습니다. 스스로 신고한 에이전트 이름만을 기준으로 한 규칙은 사람의 승인 요건을 없앨 수 없습니다.
계정별 기본 규칙
아래는 계정 분류에 따른 기본값입니다. 실제 적용 결과는 배포 환경의 계정 정책 적용 여부와 해당 계정의 접근 가능 범위에도 영향을 받습니다. 선택할 수 있는 계정은 서버 계정 선택을 참고하세요. 표에 있다고 모든 계정을 선택할 수 있는 것은 아닙니다.
| 계정과 사용자의 관계 | 기본값 |
|---|---|
| 프로비저닝을 기다리는 본인 계정 | 계정 검사에서 허용 |
| 본인에게 연결된 개인 계정 | 계정 검사에서 허용 |
| 본인에게 연결됐지만 시스템 계정인 경우 | 거부 |
| 다른 사람에게 연결된 계정 | 거부 |
| 애플리케이션에 연결된 서비스 계정 | 거부 |
| 시스템 계정 | 거부 |
| 공유 계정 | 승인자 한 명 |
| 미분류 계정 | 승인자 한 명. 검토할 때 계정 분류도 결정 |
다른 사람의 개인 계정은 모든 모드에서 항상 거부하며, 규칙이나 advisory로 완화하기 전에 확인합니다. sudo, su, runuser로 그 계정에 전환할 때도 적용합니다. 전환할 계정을 알아낼 수 없는 명령어도 거부합니다. 다른 계정도 접근 범위, 직접 root 접속 설정, 세션에서 승인받은 계정인지 여부를 계속 확인합니다.
사람과 에이전트의 sudo 기본 규칙
아래는 세션 안에서 sudo를 쓸 때의 위험도 판단입니다. 세션 승인 규칙이나 최종 권한 부여를 뜻하지 않습니다. 작업 세션에 sudo가 있어야 하고 호출자에게 계정 권한이 있어야 합니다. 사람이 실행한다면 필요한 최근 MFA 확인도 마쳐야 합니다.
| AI 위험도 | 사람 | AI 에이전트 |
|---|---|---|
| 정보 | 위험도 검사에서 허용 | 위험도 검사에서 허용 |
| 낮음 | 위험도 검사에서 허용 | 위험도 검사에서 허용 |
| 중간 | 위험도 검사에서 허용 | 승인자 한 명 |
| 높음 | 승인자 한 명 | 승인자 한 명 |
| 심각 | 기본 거부 | 기본 거부 |
| 미평가 | 기본 거부 | 기본 거부 |
워크스페이스 규칙으로 위험도 판단 결과를 바꿀 수 있지만, 심각 위험도의 sudo를 자동 승인할 수는 없습니다. 심각 위험도를 명시적으로 검토하도록 정한 규칙은 승인을 요청할 수 있습니다. 사람이 보류된 명령어를 승인하면 명령줄에 명시적으로 보이는 sudo도 심각 위험도까지 포함해 허용할 수 있습니다. 다만 범위·계정 검사나 워크스페이스의 거부·복수 승인 요건은 무시하지 않습니다. 스크립트나 래퍼 안에 숨은 sudo는 그 승인에 포함되지 않습니다.
터미널 sudo에는 추가 권한 검사가 있습니다. 세션 승인이 MFA를 대신하는 정책이 일치하면 일회성 승인이나 일반 위험도·MFA 검사보다 먼저 적용합니다. 그렇지 않으면 배포 환경에서 추가 MFA 인증을 지원해야 합니다. 위험도 검사를 통과한 뒤에는 워크스페이스 관리자, 대상 서버에 연결된 그룹의 소유자와 관리자, 일치하는 상시 sudo 정책이 있는 사람이 MFA 후 진행할 수 있습니다. 그 밖의 사람은 승인과 MFA가 필요합니다.
콘솔은 웹 터미널과 CLI·API를 구분합니다. 선택한 영역의 안내와 Try it를 확인하세요. 웹 터미널에 여기서 실행하는 sudo도 명령어 규칙으로 판정해요.가 표시되면 CLI·API의 sudo 규칙이 웹 터미널 sudo도 결정합니다. 상시 권한과 MFA 검사는 계속 적용됩니다.
서비스 토큰 실행 기본 규칙
서비스 토큰의 sudo에는 별도의 위험도 정책을 적용합니다. AI가 작업 세션 없는 토큰 명령어를 거부했을 때도 이 정책으로 처리 방식을 결정합니다. 토큰의 범위, 계정, 서버 접근, 명령어·파일 사전 승인은 계속 필요합니다.
Enforce에서는 다음 토큰 위험도 기본 규칙을 적용합니다.
| 토큰 위험도 정책에 전달된 AI 위험도 | 기본값 |
|---|---|
| INFO, LOW, MEDIUM, HIGH | 이 정책 검사에서 허용 |
| 미평가 | 이 정책 검사에서 허용 |
| CRITICAL | 자동 실행 거부. 어떤 규칙도 자동 승인할 수 없음 |
Enforce에서는 위험도가 없어도 AI가 명시적으로 거부한 명령어를 실행하지 않습니다. 이는 장애로 위험도를 평가하지 못한 경우와 다릅니다. Enforce에서는 어떤 위험도 규칙도 CRITICAL 토큰 실행을 자동 승인할 수 없습니다. Alpacon Cloud에서 enforce를 사용하면 사전 승인된 원장 항목과 일치해도 심각 위험도 차단 기준에 해당하는 명령어는 거부합니다.
Enforce에서는 토큰 sudo 정책이 한 명 이상의 승인을 요구하면 거부로 처리합니다. 작업 세션 없는 토큰 명령어는 승인을 기다리지 않으며, enforce에서 CRITICAL이면 거부합니다. Advisory에서는 심각 위험도 차단 기준에 해당하는 토큰 실행도 위험도 검사에서 자동 승인합니다.
Alpacon Cloud에서는 두 모드 모두 사전 승인된 원장 항목과 일치하지 않거나 원장 조회에 실패한 명령어를 거부합니다. 이 표에서 허용이라고 해도 검증이나 사전 승인을 확인할 수 없는 상황에서 실행을 보장하지는 않습니다.
작업 세션에 연결한 명령어는 그 세션의 명령어 승인 절차를 따를 수 있습니다. 사람이 화면에 보이는 명령줄의 sudo까지 승인하면 나머지 제한을 지키는 범위에서 실행할 수 있습니다. AI 에이전트라는 표시만으로 토큰의 처리 방식을 판단하지 마세요.
워크스페이스에서 sudo를 허용해야 합니다. 기본 자체 호스팅 배포에서는 서비스 토큰 sudo를 거부하므로, 위험도 표만으로 sudo가 활성화되지는 않습니다. 자격 증명 설정과 배포 환경별 요건은 서비스 토큰을 참고하세요.
애플리케이션·토큰 조건은 그룹 조건을 함께 지정하지 않는 한 그룹 소속 여부와 관계없이 적용됩니다. 그룹 조건만으로 만든 제한은 그룹이 없는 서버와 일치하지 않습니다. 제한을 검토할 때는 구체적인 토큰과 그룹이 없는 대상을 함께 확인하세요.
명령어와 파일 실행 기본 규칙
검증을 통과한 명령어에는 다음 순서로 기본 명령어 규칙을 적용합니다.
| 일치하는 경우 | 기본값 |
|---|---|
| 승인자가 이미 검토한 것과 정확히 같은 파일 실행 | 명령어 정책 검사에서 허용 |
agent-approval-required 서버 그룹을 대상으로 하는 에이전트 명령어 | 승인자 한 명 |
| AI 판단 신뢰도가 낮은 에이전트 명령어 | 승인자 한 명 |
| 그 밖의 검증된 명령어 | 명령어 정책 검사에서 허용 |
승인된 파일과 일치하려면 검토한 파일 내용, 서버, 계정, 인수가 같아야 합니다. 파일이 바뀌면 기존 승인을 적용하지 않습니다. 일치하는 워크스페이스 규칙이 있거나 세션의 목적을 벗어나면 여전히 검토가 필요할 수 있습니다. 승인된 파일과 일치한다는 이유만으로 모든 검사를 생략하지는 않습니다.
일반 허용 규칙으로 AI가 거부한 명령어를 검증된 명령어로 바꿀 수는 없습니다. AI가 거부한 명령어를 사람이 검토할 수 있는 환경이라면, 그 사람이 실행을 승인할지 결정해야 합니다. Advisory와 서비스 토큰에는 이 문서의 해당 조건이 적용됩니다.
웹 터미널에 입력하는 명령어는 이 제출형 명령어 정책을 사용하지 않습니다. sudo는 따로 검사합니다. 명령어 승인 결과만 기록하는 배포에서는 이 규칙으로 명령어를 보류하지 않는다는 안내가 표시됩니다. 파일 작업 절차는 검증된 파일 실행을 참고하세요.
일치 조건, 순서와 만료
승인 규칙은 작업 종류별로 평가합니다. 켜져 있고 만료되지 않은 워크스페이스 규칙 중 처음 일치한 규칙을 기본값보다 우선 적용합니다. 그 규칙의 모든 조건이 일치해야 합니다. 조건에 필요한 값이 없으면 일치하지 않습니다. 일치하는 워크스페이스 규칙이 없으면 기본 규칙으로 결정합니다.
순서는 콘솔 목록에서 설정합니다. 새 규칙은 같은 작업의 기존 워크스페이스 규칙 뒤에 추가됩니다. 종료일을 지정한다면 저장 시점보다 미래여야 합니다. 종료일이 없는 규칙은 끄거나 삭제할 때까지 계속 적용됩니다. 만료되거나 꺼진 규칙은 결과를 결정하지 않으며, 규칙을 삭제하면 나머지 규칙과 기본값이 적용됩니다.
모든 접근 검사를 하나의 목록 순서로 처리하는 것은 아닙니다. 항상 거부하는 계정 조건, 세션 제한, 상시 sudo 권한, 최근 MFA 확인은 각각 계속 적용됩니다. 신고한 에이전트 이름을 지정하는 세션 규칙은 따로 평가하며, 그 밖의 조건으로 정해진 결과를 더 엄격하게만 바꿀 수 있습니다. 미리보기에서 선택한 경로와 결과를 결정한 규칙을 확인할 수 있습니다.
작업별 조건
콘솔에서는 지원하는 조건 중 일부를 설정할 수 있습니다. 편집 항목이 없는 기존 조건은 수정 시 유지합니다. 저장된 규칙에 조건이 있다고 해서 편집기에서 그 조건을 새로 만들 수 있는 것은 아닙니다.
| 작업 | 지원하는 일치 조건 | 콘솔에서 설정할 수 있는 항목 |
|---|---|---|
| 세션 시작 | 요청자 종류, 요청자의 전역 역할, 담당자의 전역 역할, 서버 그룹, 신고한 에이전트 이름, 대상 계정 종류 | 요청자 종류·역할, 에이전트 이름, 세션을 사용할 사람의 역할, 서버 그룹, 화면에서 제공하는 계정 종류 |
| 세션 안의 sudo 위험도 | 위험도, 요청자 종류, 세션을 사용할 사람의 전역 역할, 서버 그룹 | CLI/API 경로의 요청자 종류·역할, 그룹, 위험도 |
| 서비스 토큰 실행 위험도 | 위험도, 애플리케이션 ID, 서비스 토큰 ID, 서버 그룹 | 새 규칙용 애플리케이션·토큰 선택 항목은 없음. 저장된 조건은 유지 |
| 제출형 명령어 | 요청자 종류, AI 판단 신뢰도, 위험도, 승인된 파일 일치 여부, 서버 그룹 | 요청자 종류, 그룹, 위험도. 저장된 신뢰도·승인 파일 조건은 유지 |
| 계정 분류 | 계정 성격, 사용자와의 관계 | 계정 분류 기본값은 세션의 계정 종류 선택 항목과 별개 |
| 상시 터미널 sudo 정책 | 지정한 사람, 개별 서버, 명령어 패턴 | 사람, 서버, 패턴, 선택적 종료일. 결과는 MFA 후 허용 |
요청자와 담당자의 역할은 전역 역할이며 사용자 그룹 소속을 뜻하지 않습니다. 서버 그룹은 대상을 선택하는 조건입니다. 신고한 에이전트 이름은 버전 없이 비교합니다. 작업 주체는 에이전트 요청자 종류로 지정하고, 필요하면 이름으로 범위를 좁히세요.
세션에서 선택할 수 있는 계정 종류는 본인 계정, 공유·시스템 계정, root입니다. 기존의 다른 사람 계정 조건은 저장된 상태로 표시하지만, 다른 사람의 계정을 항상 거부하는 제한을 해제하지는 못합니다. 상시 정책의 일치 기준은 sudo 명령 패턴을, 토큰 사전 승인은 토큰 명령어 패턴을 참고하세요.
결과와 승인자
| 결과 | 의미 |
|---|---|
| 허용 | 이 규칙에 따른 승인 대기 없음. 다른 검사는 계속 적용 |
| MFA 후 허용 | 상시 터미널 sudo 권한. 최근 MFA 확인 필요 |
| 승인 요청 | 승인 자격이 있는 사람이 필요한 인원만큼 승인. 서버 승인자나 특정 역할을 가진 사람에게 요청 가능 |
| 차단 | Enforce에서 이 판단에 따라 작업 거부 |
요청자에게 승인 자격이 있다면 기본적으로 자신의 요청도 승인할 수 있습니다. 규칙으로 자기 승인을 금지할 수 있습니다. 그때 다른 승인자가 아무도 없으면 무기한 기다리는 대신 요청을 거부합니다. 미리보기에는 승인 가능한 사람이 표시되며, 요구한 인원보다 적을 때도 알 수 있습니다. 승인자는 지정한 역할, 그룹별 승인자 지정, 워크스페이스 전체 승인자 지정, 워크스페이스의 활성 슈퍼유저 순서로 확인합니다. 그룹별 승인자와 워크스페이스 전체 승인자는 모두 승인 자격에 포함됩니다. 역할을 지정했지만 그 역할을 가진 활성 사용자가 없으면 활성 슈퍼유저로 바로 대체합니다.
저장된 다단계 규칙은 첫 단계의 승인자 그룹 하나로 처리하며, 순차 승인 절차로 실행하지 않습니다. 세션 승인으로 MFA를 대신하는 방식과 일회성 sudo 승인은 상시 터미널 정책의 MFA 후 허용과 구별됩니다.
위험도와 신호
위험도는 INFO, LOW, MEDIUM, HIGH, CRITICAL이며, 미평가는 위험도가 없다는 뜻입니다. 이는 범주이며 공개된 숫자 점수 구간이 아닙니다. AI 판단 신뢰도가 낮다는 조건은 LOW 위험도와 별개입니다.
| 신호 또는 제한 | 효과와 설정 가능 여부 |
|---|---|
embedded_script | 명령어 평가에서 보내며 결과와 함께 기록하는 신호 |
목적 불일치(intent_misaligned) | 별도 검사에서 sudo가 세션 목적을 벗어나면 검토 요구. 워크스페이스 허용 규칙이 일치해도 적용 |
평가한 명령줄 밖의 실행(wrapper_mismatch) | 별도 검사에서 권한을 높여 실행할 명령어가 평가한 명령줄에 포함되지 않으면 검토 요구. 워크스페이스 허용 규칙이 일치해도 적용 |
| 세션 sudo 위험도 상한과 수동 sudo 승인 요건 | 세션 안에서 자동 허용될 sudo를 검토 대기로 바꿀 수 있음. 거부나 더 많은 승인을 요구하는 조건은 완화하지 않음 |
Enforce에서는 워크스페이스 허용 규칙을 포함한 모든 sudo 규칙에 목적 검사와 평가 범위를 벗어난 실행 검사를 적용합니다. 사용자 정의 허용 규칙으로 이 검사를 없앨 수 없습니다. 자동으로 허용될 작업에 검토를 요구할 수는 있지만, 거부나 더 많은 승인을 요구하는 조건은 완화하지 않습니다. 콘솔에서는 신호 목록을 수정할 수 없습니다. 화면에서 제공하는 조건과 결과를 설정하세요.
미리보기는 입력한 위험도를 사용하며 AI를 호출하거나 명령어를 실행하거나 요청·권한을 만들지 않습니다. 콘솔 기능이며 공개 CLI나 MCP 평가 API가 아닙니다.
Advisory와 enforce
Enforce는 실행 제어 결과를 적용합니다. Advisory는 심각 위험도와 세션의 수동 sudo 승인 요건을 포함한 위험도 판단을 기록하되 적용하지 않습니다. Advisory에서는 세션 시작, sudo, 명령어 실행에 대한 승인 요청을 만들지 않습니다. 아직 보유하지 않은 권한을 요청하는 경우에는 상시 sudo 정책, 서비스 토큰 발급·변경, 사용자명·계정 승인 등을 평소처럼 승인자에게 보냅니다. 새 세션은 실행 제어 승인을 기다리지 않지만, 계정 거부는 계속 적용됩니다.
인증, 자격 증명 권한, 세션 범위, 계정 거부, 토큰 접근 규칙, 명령어 안의 자격 증명 검사는 그대로 유지됩니다. 이 검사에서 허용하지 않는 작업은 계속 거부합니다. 상시 권한이나 일치하는 정책이 없는 터미널 sudo는 sudo_no_authority로 거부합니다. Advisory가 모든 sudo를 허용하는 것은 아닙니다.
모드를 바꿔도 대기 중인 요청이 자동 승인되지는 않습니다. 기존 만료 규칙을 계속 따르며, 새 요청에 현재 모드가 적용됩니다. 워크스페이스 설정은 서버 접근을 참고하세요.
플랜과 권한 요건
| 기능 | 요건 |
|---|---|
| 규칙 목록 보기 | approval_policy:read 권한이 있는 워크스페이스 관리자 또는 슈퍼유저. 모든 배포 환경의 콘솔에서 접근 가능 |
| 승인 규칙 생성·수정·삭제 | 해당 approval_policy 권한. 콘솔에서만 가능 |
| 상시 sudo 정책 생성·수정·삭제 | 해당 sudo_policy 권한과 대상에 대한 권한 |
| 일치 조건 없는 승인 규칙 | Free에서 사용 가능 |
| 조건, 자기 승인 금지, 역할별 승인자 지정 | Essentials 또는 Enterprise. 저장된 규칙을 끄는 작업은 Free에서도 가능 |
| 편집기에서 승인자 두 명 이상 선택 | Enterprise |
| 다른 구체적인 사람이나 서비스 토큰 미리보기 | 유료 플랜. 주체 종류별 미리보기는 Free에서도 가능 |
| 상시 sudo 정책 | 유료 플랜. 세션에 연결한 정책 생성은 별도 취급 |
| 콘솔에서 sudo 정책을 관리할 때 승인의 MFA 대체 허용 활성화 | Enterprise와 유효한 작업 세션 연결. 세션 요청 작성에는 별도 요건 적용 |
MFA 설정은 배포 환경의 신원 공급자와 지원하는 설정에도 영향을 받습니다. 항목이 비활성화됐다고 요건을 우회할 수 있는 것은 아닙니다. 현재 배포 환경의 안내와 미리보기에서 실제 적용되는 규칙 경로를 확인하세요.
관련 오류 코드
응답에 직렬화된 소문자 코드와, 제공되는 경우 gate, missing, 승인 참조를 함께 확인하세요. 영어 hint는 사람이 읽는 안내입니다. 프로그램에서는 구조화된 필드를 사용하세요. 코드만 보고 승인 요청이 대기 중이라고 판단하지 마세요.
| 코드 | 원인과 해결 방법 |
|---|---|
work_session_scope_not_allowed | 세션에 요청한 기능이 없습니다. sudo 등 필요한 범위를 세션에 추가로 요청하세요. |
work_session_account_not_approved | 에이전트 세션에서 승인하지 않은 계정입니다. 승인된 계정을 쓰거나 필요한 계정으로 세션을 요청하세요. |
work_session_agent_not_allowed | 워크스페이스 정책에서 허용하지 않은 에이전트입니다. 허용된 에이전트를 사용하세요. |
work_session_sudo_bypass_console_only | MFA를 생략하는 sudo 정책은 콘솔에서만 세션에 추가할 수 있습니다. 콘솔에서 변경하세요. |
sudo_risk_denied | 위험도 검사에서 명령어를 거부했습니다. 명령어를 바꾸거나 적용된 접근 규칙을 확인한 뒤 다시 시도하세요. |
sudo_presence_required | sudo에 최근 MFA 확인이 필요합니다. 지원되는 방식으로 인증한 뒤 다시 시도하세요. |
sudo_step_up_unavailable | 필요한 MFA 확인을 이 환경에서 지원하지 않습니다. 해당 확인이 필요 없는 sudo만 진행할 수 있습니다. |
sudo_approval_required | sudo에 승인이 필요합니다. 응답의 gate와 요청 상태를 확인하고 권한을 받은 뒤 다시 시도하세요. |
sudo_intent_deviation | 명령어가 세션 목적을 벗어났습니다. 승인 요청이 있으면 상태를 확인하거나 변경된 작업에 맞는 세션을 요청하세요. |
sudo_approval_pending | 승인 대기 시간이 끝날 때까지 승인과 신원 확인을 모두 마치지 못했습니다. 응답에서 안내한 요청의 상태를 확인한 뒤 다시 시도하세요. |
sudo_approval_already_waiting | 같은 명령어가 다른 터미널에서 승인 대기 중입니다. 그곳에서 기다리거나 대기를 중단한 뒤 다시 시도하세요. |
sudo_approval_rejected | 승인이 거절, 철회 또는 만료되었습니다. 요청 상태를 확인한 뒤 다시 시도하세요. |
sudo_no_authority | 명령어를 허용하는 상시 권한이 없습니다. gate와 승인 요청 상태를 확인하세요. sudo gate가 표시되면 advisory에서도 이 시도는 승인 대기 중이 아닙니다. |
sudo_command_not_authorized | sudo 실행에 책임을 질 사람을 확인할 수 없습니다. 사람이 명령어 실행을 요청해야 합니다. |
sudo_policy_mfa_required | 정책에 필요한 MFA를 비대화형 명령어로 확인할 수 없습니다. 대화형 터미널을 사용하세요. |
sudo_no_worksession_policy | 명령어에 맞는 sudo 정책이 세션에 없습니다. 명령어에 맞는 sudo 패턴이 있는 세션을 사용하세요. 세션 변경에 승인이 필요하면 요청하세요. |
sudo_target_other_person | 다른 사람의 계정으로 전환하는 명령어는 항상 거부합니다. 본인 계정이나 공유 계정을 사용하세요. |
sudo_target_unparsed | 전환할 계정을 확인할 수 없습니다. 대상 계정을 명확히 지정한 뒤 다시 시도하세요. |
sudo_no_accountable_actor | sudo 실행에 책임을 질 활성 사용자가 없습니다. 계정이 활성 상태인 사람의 세션을 사용하세요. |
sudo_account_bound_to_application | 애플리케이션에 연결된 계정은 터미널에서 권한을 높일 수 없습니다. 명령어 실행 기능을 사용하세요. |
sudo_system_user_not_found | Alpacon에서 확인할 수 없는 서버 계정입니다. 관리되는 계정으로 접속한 뒤 다시 시도하세요. |
sudo_session_missing | Alpacon 세션이 열려 있지 않아 sudo를 실행할 수 없습니다. 승인된 작업 세션이나 대화형 Websh 세션 안에서 실행하세요. |
sudo_command_too_long | 기록할 수 있는 길이를 넘긴 명령어입니다. 짧게 줄인 뒤 다시 시도하세요. |
sudo_policy_bypass_agent_session_needs_approval | 에이전트 세션에 승인의 MFA 대체 허용 설정이 켜진 sudo 정책을 추가하려면 사람의 승인이 필요합니다. 세션 변경을 요청할 때 이 정책을 포함하세요. |
sudo_policy_bypass_agent_session_needs_presence | 에이전트 세션에서 승인의 MFA 대체 허용 설정이 켜진 sudo 정책을 변경하려면 최근 MFA 확인이 필요합니다. 인증한 뒤 다시 시도하세요. |
sudo_verify_credential_cannot_prove_mfa | 이 자격 증명으로 MFA를 확인할 수 없습니다. 콘솔이나 CLI에 로그인해 인증하세요. |
sudo_policy_console_only | sudo 정책을 만들거나 권한을 넓히려면 콘솔이 필요합니다. 콘솔에서 변경하세요. |
workspace_sudo_with_mfa_disabled | 워크스페이스의 sudo가 꺼져 있습니다. 실행하려면 워크스페이스 설정에서 허용해야 합니다. |
workspace_block_local_sudo_step_up_unavailable | sudo MFA를 지원하지 않는 워크스페이스입니다. 이 환경에서는 로컬 sudo를 차단할 수 없습니다. |
workspace_sudo_with_mfa_step_up_unavailable | sudo MFA를 지원하지 않는 워크스페이스입니다. 이 환경에서는 해당 설정을 변경할 수 없습니다. |
approval_no_other_approver | 자기 승인이 금지됐고 다른 승인자가 없습니다. 승인자 지정을 확인한 뒤 다시 요청하세요. |
approval_requester_may_not_approve | 요청자는 본인의 요청을 결정할 수 없습니다. 승인 자격이 있는 다른 사람이 결정해야 합니다. |
approval_request_not_approver | 이 계정에 해당 요청의 승인 자격이 없습니다. 승인 자격이 있는 계정을 사용하세요. |
approval_request_not_requester | 이 계정이 올린 요청이 아니므로 취소할 수 없습니다. 요청자가 취소해야 합니다. |
agent_credential_not_accepted | 관리 대상 서버의 에이전트 자격 증명으로 처리할 수 없는 작업입니다. 필요한 권한이 있는 사용자나 API 토큰을 사용하세요. |
auth_mfa_required | 최근 MFA 확인이 필요한 작업입니다. MFA를 마친 뒤 다시 시도하세요. |
auth_mfa_requires_human_principal | 필요한 MFA는 사람만 확인할 수 있습니다. 사용자로 로그인한 뒤 다시 시도하세요. |
auth_interactive_channel_requires_presence | 이 자격 증명으로 대화형 세션을 열 수 없습니다. 콘솔이나 CLI에 로그인하세요. |
api_token_scope_action_unresolved | 이 작업에 사용할 토큰 범위를 확인할 수 없습니다. 콘솔에 로그인해 진행하세요. |
api_token_scope_missing | 토큰에 필요한 범위가 없습니다. 해당 범위를 가진 토큰을 사용하세요. |
api_token_acl_not_allowed | server_reach, command_acl, file_acl에서 부족한 서버·명령어·파일 전송 권한을 확인하세요. 허용된 대상에서 허용된 작업을 실행하세요. |
command_acl_moved | 명령어 사전 승인을 AI 명령어 원장에서 관리하는 환경입니다. 해당 콘솔 설정을 사용하세요. |
local_access_principal_not_supported | 콘솔에 로그인한 사람이 처리해야 하는 작업입니다. 토큰으로는 처리할 수 없습니다. |
local_access_claim_not_maintainer | 해당 계정의 애플리케이션 관리자가 아닙니다. 이 로그인이 자동화 작업에 쓰인다는 확인은 관리자만 할 수 있습니다. |
rbac_permission_required | 역할에 해당 작업 권한이 없습니다. 부여된 역할의 권한을 확인하세요. |
rbac_object_permission_required | 부여된 역할로는 해당 대상에 접근할 수 없습니다. 대상에 대한 역할 권한을 확인하세요. |
rbac_application_update_required | 선택한 애플리케이션 중 수정 권한이 없는 대상이 있습니다. 각 애플리케이션의 권한을 확인하세요. |
permission_denied | 계정이나 자격 증명에 권한이 없습니다. 접근 권한을 확인한 뒤 다시 시도하세요. |
user_no_permission | 계정에 해당 작업 권한이 없습니다. 부여된 역할을 확인하세요. |
api_not_for_alpacon | 관리 대상 서버의 에이전트 자격 증명으로 보낼 수 없는 요청입니다. 지원되는 사용자 자격 증명을 사용하세요. |
api_rate_limited | 짧은 시간에 요청이 너무 많습니다. 잠시 기다린 뒤 다시 시도하세요. |
service_token_application_forbidden | 해당 애플리케이션의 토큰 발급·변경 권한이 없습니다. 애플리케이션 권한을 확인하세요. |
service_token_break_glass_unauthorized | 슈퍼유저만 break-glass를 활성화할 수 있습니다. 작업 계정의 역할을 확인하세요. |
workspace_security_settings_console_only | 워크스페이스 MFA 설정 완화는 콘솔에서만 가능합니다. 콘솔에서 변경하세요. |
workspace_execution_control_console_only | 실행 제어 완화는 콘솔에서만 가능합니다. 콘솔에서 변경하세요. |
workspace_execution_control_mode_presence_required | 실행 제어 변경에 최근 MFA 확인이 필요합니다. 인증한 뒤 다시 시도하세요. |
workspace_execution_control_mode_superuser_required | 실행 제어 변경에 슈퍼유저 권한이 필요합니다. 작업 계정의 역할을 확인하세요. |
workspace_plan_update_required | 현재 플랜에 없는 기능입니다. 포함된 기능을 사용하거나 플랜을 변경하세요. |
workspace_enterprise_plan_required | Enterprise가 필요한 기능입니다. 현재 플랜의 기능을 사용하거나 플랜을 변경하세요. |
access_rules_admin_only | 규칙 조회나 해당 대상의 미리보기 권한이 없습니다. 권한이 있는 워크스페이스 관리자 계정을 사용하세요. |
access_rules_console_only | 접근 규칙과 미리보기는 콘솔에서만 사용할 수 있습니다. 웹 콘솔을 사용하세요. |
approval_policy_console_only | 승인 규칙 조회·변경은 콘솔에서만 가능합니다. 콘솔에서 관리하세요. |
group_agent_approval_console_only | 그룹의 에이전트 승인 요건 변경은 콘솔에서만 가능합니다. 콘솔에서 변경하세요. |
group_agent_approval_policy_authority_required | 그룹의 에이전트 승인 요건 변경에 승인 정책 권한이 필요합니다. 작업 계정의 권한을 확인하세요. |
access_rules_subject_unknown | 미리보기 대상이 없거나 접근할 수 없습니다. 접근 가능한 대상을 선택하세요. |
approval_policy_valid_until_past | 규칙 종료일은 현재보다 이후여야 합니다. 미래 날짜를 선택하세요. |
approval_policy_critical_auto_forbidden | CRITICAL 실행을 자동 승인하는 규칙입니다. 거부를 선택하거나, 검토를 지원하는 작업이라면 검토를 거치도록 설정하세요. |
approval_policy_other_person_account_locked | 다른 사람의 계정 제한을 완화하는 규칙입니다. 해당 계정으로의 접근은 계속 거부해야 합니다. |
approval_policy_agent_auto_forbidden | 에이전트 이름만으로 세션을 자동 승인할 수 없습니다. 사람의 승인을 유지하거나 자동 허용이 목적이라면 에이전트 요청자 종류를 명시적으로 선택하세요. |
approval_policy_requester_type_required | 역할 조건에 요청자 종류가 없습니다. 의도한 요청자 종류도 선택하세요. |
approval_policy_request_type_unknown | 지원하지 않는 작업 종류입니다. 편집기에서 지원하는 작업을 선택하세요. |
approval_policy_condition_key_unsupported | 해당 작업에 적용할 수 없는 조건입니다. 작업에서 제공하는 조건을 사용하세요. |
approval_policy_requester_may_approve_unsupported | 자기 승인 제한을 지원하지 않는 작업입니다. 해당 작업에서 이 제한을 제거하세요. |
approval_policy_stages_shape_invalid | 승인자 설정 형식이 잘못되었습니다. 편집기에서 유효한 승인자 수와 지정 방식을 설정하세요. |
approval_policy_stages_lane_mismatch | 승인자 설정이 결과와 맞지 않습니다. 결과와 승인자 설정을 맞춰 수정하세요. |
approval_policy_stage_role_unknown | 승인자 역할이 없습니다. 현재 존재하는 역할을 선택하세요. |
approval_policy_reorder_mismatch | 순서가 현재 규칙 목록과 맞지 않습니다. 목록을 새로 불러온 뒤 다시 정렬하세요. |
approval_missing_metadata | 승인 요청에 필요한 정보가 빠져 있습니다. 필요한 내용을 모두 담아 새로 요청하세요. |
approval_request_already_decided | 이미 이 요청에 결정을 내렸습니다. 다시 결정하지 말고 현재 요청 상태를 확인하세요. |
approval_request_already_reviewed_or_cancelled | 이미 검토되었거나 취소된 요청입니다. 새로 요청하기 전에 처리 결과를 확인하세요. |
approval_request_expired | 승인 요청이 만료되었습니다. 권한이 여전히 필요하면 새로 요청하세요. |
approval_request_not_allowed | 허용되지 않는 승인 요청입니다. 요청한 작업이 승인을 지원하는지 확인하세요. |
approval_request_status_invalid | 현재 요청 상태에서는 이 작업을 할 수 없습니다. 요청을 새로고침하고 상태를 확인하세요. |
approval_request_type_invalid | 승인 요청 유형이 올바르지 않습니다. 필요한 권한에 맞는 요청 절차를 사용하세요. |
approval_superuser_approve_required | 사용자명에 슈퍼유저 승인이 필요해 요청을 보냈습니다. 승인 결과를 기다리세요. |
sudo_grant_not_pending | 이 sudo 요청은 더 이상 MFA를 기다리는 상태가 아닙니다. 다시 시도하기 전에 현재 상태를 확인하세요. |
sudo_iam_user_not_found | 서버 계정에 연결된 Alpacon 사용자가 없습니다. sudo를 사용하려면 관리자에게 계정 연결을 요청하세요. |
sudo_mfa_failed | sudo MFA 인증에 실패했습니다. 등록한 인증 수단으로 확인한 뒤 명령어를 다시 실행하세요. |
sudo_policy_bypass_requires_worksession | 승인이 sudo MFA를 대신하려면 활성 작업 세션이 필요합니다. 정책을 활성 작업 세션에 연결하세요. |
sudo_policy_bypass_worksession_unusable | 정책이 연결된 세션이 끝나서 승인이 MFA를 대신할 수 없습니다. 사용할 수 있는 세션에 연결된 정책을 요청하세요. |
sudo_policy_changed_since_request | 요청 후 sudo 정책이 바뀌어 승인할 수 없습니다. 요청자에게 다시 요청해 달라고 안내하세요. |
sudo_policy_command_not_allowed | 이 명령어를 허용하는 sudo 정책이 없습니다. 필요한 명령어를 포함한 정책을 요청하세요. |
sudo_policy_expired | sudo 정책의 유효 기간이 끝났습니다. 다시 실행하기 전에 새 정책을 요청하세요. |
sudo_policy_rebound | 편집하는 동안 정책에 연결된 작업 세션이 바뀌었습니다. 페이지를 새로고침한 뒤 다시 시도하세요. |
sudo_policy_request_bypass_mfa_not_allowed | 단독 sudo 요청에서는 승인이 MFA를 대신할 수 없습니다. 작업 세션에 포함해 정책을 요청하세요. |
sudo_policy_request_metadata_corrupted | sudo 요청의 승인 정보가 올바르지 않아 승인할 수 없습니다. 새로 요청하세요. |
sudo_policy_request_user_not_self | 다른 사람의 sudo 정책을 요청할 권한이 없습니다. 본인의 권한을 요청하세요. |
sudo_policy_required | 이 요청에 맞는 sudo 정책이 없습니다. 필요한 서버와 계정을 포함한 정책을 요청하세요. |
sudo_response_timeout | 결정이 오기 전에 sudo 요청의 대기 시간이 끝났습니다. 명령어를 다시 실행해 새로 요청하세요. |
sudo_system_error | sudo 승인을 처리하지 못했습니다. 잠시 후 다시 시도하세요. |
sudo_websocket_unavailable | 실시간 연결이 끊겨 sudo 요청을 전달하지 못했습니다. 다시 연결한 뒤 시도하세요. |
target_account_other_person | 대상 서버 중 하나 이상에서 다른 사람에게 연결된 계정이므로 모든 모드에서 거부합니다. 본인 계정이나 공유 계정을 선택하세요. |
work_session_admission_denied | 워크스페이스 정책이 이 서버들에 대한 세션 시작을 거부합니다. 관리자에게 적용 규칙을 확인해 달라고 요청하세요. |
work_session_agent_session_required | 에이전트는 사람의 세션을 사용할 수 없습니다. 에이전트 세션을 여세요. |
work_session_assignee_mismatch | 세션 담당자가 아니므로 이 세션의 권한을 사용할 수 없습니다. 본인의 세션을 시작하거나 담당자 변경을 요청하세요. |
work_session_assignee_not_allowed | 이 사람을 세션 담당자로 지정하거나 기존 담당자를 바꿀 권한이 없습니다. 허용된 담당자를 선택하거나 관리자에게 요청하세요. |
work_session_cluster_not_allowed | 이 세션에 포함되지 않은 클러스터입니다. 승인된 클러스터를 사용하거나 필요한 클러스터의 세션을 요청하세요. |
work_session_expired | 세션이 만료되어 더 이상 권한을 사용할 수 없습니다. 새 세션을 시작하세요. |
work_session_expires_exceeds_max_ttl | 요청한 세션 기간이 허용 한도를 넘습니다. 허용 범위 안으로 기간을 줄이세요. |
work_session_extension_already_pending | 연장 요청이 검토를 기다리고 있습니다. 결과를 기다리거나 기존 요청을 취소한 뒤 다시 연장 요청을 하세요. |
work_session_mod_already_pending | 세션 변경 요청이 이미 검토를 기다리고 있습니다. 결과를 기다리거나 기존 요청을 취소한 뒤 새 변경을 요청하세요. |
work_session_not_active | 활성 세션이 필요한 작업입니다. 승인된 세션을 시작한 뒤 다시 시도하세요. |
work_session_not_approved | 승인되지 않았거나 거절·취소된 세션입니다. 시작하기 전에 세션 상태를 확인하세요. |
work_session_not_assignee | 세션 담당자만 할 수 있는 작업입니다. 담당자 본인이 로그인한 계정으로 진행하세요. |
work_session_not_found | 작업 세션을 찾을 수 없습니다. 선택한 세션을 확인하고 사용할 수 있는 세션을 선택하세요. |
work_session_not_modifiable | 현재 세션 상태에서는 변경할 수 없습니다. 다른 권한이 필요하면 새 세션을 요청하세요. |
work_session_not_pending | 이 작업에 필요한 승인 대기 상태가 아닙니다. 세션을 수정하거나 요청을 처리하기 전에 현재 상태를 확인하세요. |
work_session_not_started | 세션 시작 시각 전에는 연장할 수 없습니다. 시작 시각까지 기다리세요. |
work_session_not_usable | 현재 상태에서는 세션을 사용할 수 없습니다. 상태를 확인하고 승인되어 사용 가능한 세션을 선택하세요. |
work_session_principal_not_supported | 서비스 토큰으로는 작업 세션을 만들 수 없습니다. 애플리케이션의 토큰 실행 경로를 사용하거나 사람이 로그인해 세션을 요청하세요. |
work_session_required | 작업 세션이 필요한 작업입니다. 승인된 세션을 시작하고 해당 세션에서 작업하세요. |
work_session_server_not_allowed | 대상 서버가 세션 범위 밖에 있습니다. 승인된 서버를 선택하거나 해당 서버를 포함하도록 세션 변경을 요청하세요. |
work_session_sudo_loosen_forbidden | 승인자는 요청된 sudo 제한을 완화할 수 없습니다. 기존 제한을 유지하거나 더 엄격하게 정하세요. |
work_session_sudo_policy_id_not_bound | 선택한 sudo 정책이 이 세션에 속하지 않습니다. 새로고침한 뒤 이 세션에 연결된 정책을 선택하세요. |
work_session_sudo_policy_user_not_assigned | 세션 담당자가 아닌 사람의 sudo 정책을 추가할 권한이 없습니다. 세션 담당자를 선택하세요. |
work_session_sudo_policy_without_scope | sudo 정책을 추가하려면 세션에 sudo 범위가 필요합니다. 먼저 해당 범위를 요청하세요. |
work_session_target_account_absent | 선택한 서버에 계정이 없고 새로 생성되지도 않습니다. 해당 서버를 제외하거나 다른 계정을 선택하세요. |
work_session_target_account_clear_forbidden | 지정한 계정을 비울 수 없습니다. 기존 계정을 유지하거나 허용되는 계정 변경을 요청하세요. |
work_session_target_account_denied | 요청을 승인하거나 변경할 때 선택한 서버 중 일부에서 해당 계정이 허용되지 않습니다. 다른 계정을 선택하거나 관리자에게 확인을 요청하세요. |
work_session_target_account_not_applicable | 이 세션에서는 접속 계정을 지정하거나 조정할 수 없습니다. 사용하는 자격 증명과 세션에 맞는 계정 설정을 확인하세요. |
work_session_target_account_not_narrower | 승인자가 선택한 계정으로 바꾸면 요청한 범위보다 접근 권한이 넓어집니다. 기존 계정을 유지하거나 권한이 더 좁은 계정을 선택하세요. |
work_session_target_account_not_reachable | 세션 사용자의 역할로는 선택한 서버의 계정에 접근할 수 없습니다. 해당 서버의 계정 접근 권한을 확인하거나 접근 가능한 계정을 선택하세요. |
work_session_target_account_unavailable | 선택한 서버에 계정이 있지만 사용할 수 없습니다. 사용 가능한 계정을 선택하거나 계정 연결과 로그인 가능 여부를 확인해 달라고 요청하세요. |
work_session_window_not_narrower | 승인자는 요청된 세션 시간을 늘릴 수 없습니다. 유지하거나 줄이고, 시간이 더 필요하면 연장을 요청하세요. |
workspace_execution_control_mode_step_up_unavailable | 이 배포에서는 필요한 본인 확인을 할 수 없어 실행 제어 모드를 바꿀 수 없습니다. 현재 모드를 유지하세요. |
workspace_sudo_mfa_recheck_source_mismatch | 수정한 설정이 더 이상 이 환경의 sudo MFA에 적용되지 않습니다. 페이지를 새로고침하고 현재 설정을 수정하세요. |
workspace_sudo_with_mfa_required_for_block_local | 로컬 sudo를 차단하려면 MFA 기반 sudo가 필요합니다. MFA 기반 sudo를 먼저 켠 뒤 로컬 sudo를 차단하세요. |
해결 절차는 PAM과 sudo 문제 또는 명령어 문제 해결을 참고하세요. 오류 문구는 자동 생성된 목록에서 관리하며, 이 표는 어떤 판단을 확인해야 하는지 설명합니다.