콘텐츠로 이동

현재 세션에 개인 자격 증명을 제공합니다.

프라이빗 자격증 항목을 사용하여 데이터베이스 비밀번호, 리포지터리 토큰 또는 SSH 프라이빗 키를 제공합니다. 현재 세션에서 일반적인 셸 명령어를 사용할 때 이러한 정보를 사용할 수 있으며, 이 정보는 채팅 메시지로 전송되지 않습니다.

obscli

채팅에 /credentials를 입력합니다. 메뉴에는 Write와 Delete만 표시되며 세션의 단일 Agent에 자동으로 연결됩니다. Write를 선택하고 같은 비공개 양식에 Key와 Value를 입력합니다. Tab으로 필드를 전환하고 Enter로 제출합니다. 기본 유형은 텍스트이며 Value는 항상 숨겨집니다. 기존 이름에 쓰려면 덮어쓰기를 확인해야 합니다.

서비스 응답을 기다리는 동안, Ctrl+C 또는 Esc를 두 번 클릭하여 대기 중단된 작업을 취소할 수 있습니다. 대기 중에 입력된 텍스트는 삭제되며, 채팅 기록, 로그, 캐시에는 저장되지 않습니다. 이미 전송된 메시지를 취소해도 서버의 작업은 복구되지 않습니다. 다시 시도하기 전에 결과를 반드시 확인하십시오.

파일에도 같은 양식을 사용합니다. Ctrl+T를 누르면 file로 전환되고 Value가 지워집니다. Value에 @로 시작하는 경로를 입력합니다. 절대 경로, ~/, 상대 경로를 지원합니다. 방향키로 선택하고 Tab으로 자동 완성하며 Shift+Tab으로 Key에 돌아갑니다. 자동 완성은 현재 디렉터리 접두사에 해당하는 숨김 파일도 포함하며 재귀 검색을 하지 않습니다. 업로드 전에 선택한 경로와 크기를 확인하세요. obscli는 붙여 넣은 텍스트를 파일로 변환하지 않습니다.

양식에는 자격 증명 목록이나 새로 고침 기능이 없습니다. 일반 채팅에서 Agent에 자격 증명의 이름과 유형 목록을 요청하세요. 값은 반환하지 않습니다. Delete에는 정확한 이름과 확인이 필요합니다. 실패하면 입력이 양식에 남으며 수동으로 재시도하거나 Edit key and value를 사용할 수 있습니다. 취소하거나 닫거나 성공하면 입력이 지워집니다. 기본 TUI 메뉴, 프롬프트, 오류는 영어로 표시됩니다. 사용자 콘텐츠와 모델 출력은 변경하지 않습니다.

git-rg 토큰을 추가하세요.

git-rg은 다음 자격 증명만 필요합니다:

이름 목적
GITRG_TOKEN 검색하고 리포지토리를 읽습니다.
GITRG_WRITE_TOKEN 리포지토리를 읽고, 변경 사항을 미리 보며, 새로운 브랜치, 커밋을 생성할 수 있으며, 드래프트 PR이나 MR을 생성할 수도 있습니다.

대상 플랫폼에서 작업에 필요한 최소 권한으로 토큰을 생성합니다.

플랫폼 읽기 접근 권한 쓰기 접근
GitHub 대상 리포지토: Contents: Read-only 대상 리포지토: Contents: Read and write, Pull requests: Read and write
GitLab Reporter, read_api Developer, api
Gitee projects projects, pull_requests, 그리고 대상 리포지토에 대한 쓰기 접근 권한

세션에 토큰을 제출합니다:

  1. /credentials를 입력하고 Write를 선택하세요.
  2. 읽기 전용 작업의 경우, Key를 GITRG_TOKEN로 설정합니다. 편집 작업의 경우, GITRG_WRITE_TOKEN를 사용합니다.
  3. 플랫폼 토큰을 Value에 붙여넣고 Enter 버튼을 누르세요.

두 Token을 모두 준비할 필요는 없습니다. Token을 채팅에 입력하지 마세요. 세션 종료, Agent 재시작 또는 연결 종료 시 자격 증명이 만료됩니다.

이러한 독립적인 명령어들은 자동화 및 호환성 목적으로 계속 사용할 수 있습니다. ID와 이름은 예시일 뿐이며, 절대 명령줄에 비밀스러운 값을 입력해서는 안 됩니다. 텍스트 형태의 값은 숨겨진 입력 방식을 통해 입력됩니다. 파일 내용은 Agent에 비밀스럽게 저장되며, 해당 변수는 해당 파일의 로컬 경로를 포함합니다. list는 오직 이름과 유형만을 반환합니다.

obscli session credential put --workspace-uuid WS --session-uuid SESSION --agent-uuid AGENT
obscli session credential put --workspace-uuid WS --session-uuid SESSION --agent-uuid AGENT --name GITRG_TOKEN
obscli session credential put --workspace-uuid WS --session-uuid SESSION --agent-uuid AGENT --name GITRG_WRITE_TOKEN
obscli session credential put --workspace-uuid WS --session-uuid SESSION --agent-uuid AGENT --name SSH_KEY_FILE --file ./id_ed25519
obscli session credential list --workspace-uuid WS --session-uuid SESSION --agent-uuid AGENT
obscli session credential delete --workspace-uuid WS --session-uuid SESSION --agent-uuid AGENT --name GITRG_TOKEN

--stdin을 사용하여 안전한 입력 소스에서 텍스트를 읽습니다. 마지막의 새줄을 포함한 모든 바이트들이 보존됩니다. 명령어나 인수에 비밀한 문자를 사용하지 마세요. 그렇게 하면 셸의 역사에 그 문자들이 남아날 수 있습니다.

일회성 작업 임포트

obscli run --import-credential /secure/credentials.json은 작업을 전송하기 전에 자격 증명을 가져옵니다. JSON 및 호출 예시:

{
  "kv": {"DB_PASSWORD": "your-password", "GITRG_TOKEN": "your-read-token", "GITRG_WRITE_TOKEN": "your-write-token"},
  "files": {"SSH_KEY_FILE": "./id_ed25519"}
}
obscli run --agent-uuid "$AGENT" \
  --import-credential /secure/credentials.json \
  --prompt '使用 DB_PASSWORD 和 SSH_KEY_FILE 执行任务'

JSON만 지원합니다. kv 또는 files를 생략할 수 있습니다. 상대 파일 경로는 JSON 파일의 디렉터리를 기준으로 해석합니다. $VARIABLE과 ~는 확장하지 않으며 셸 코드도 실행하지 않습니다. 이름은 두 섹션 전체에서 고유해야 하고, 값은 비어 있지 않은 문자열이어야 하며, 파일은 읽을 수 있는 일반 파일이어야 합니다. JSON 파일은 최대 8 MiB, 이름은 최대 64개, 항목당 최대 256 KiB, 디코딩된 자격 증명 전체는 최대 8 MiB입니다.

클라이언트는 모든 입력을 확인하고, 빈 세션을 생성하며, 자격 증명을 업로드하고, 모든 확인 절차를 마친 후에 프롬프트를 전송합니다. 업로드 실패이나 확인되지 않은 결과는 작업이 시작되지 못하게 하며, 자동으로 재시도되지 않습니다. 클라이언트는 세션을 종료하려고 시도하며, 정리 작업의 실패를 보고합니다. 원본 JSON 및 로컬 파일은 유지되며, 0600 권한을 가진 사용자가 관리하는 것이 좋습니다. 명령줄에는 오직 임포트 경로만 표시되며, 자격 증명 내용은 채팅, 모델 또는 애플리케이션 로그에 기록되지 않습니다.

업로드 작업은 자동으로 시작되지 않습니다. 확인 후, 원하는 용도를 일반 채팅으로 설명하고 계속 진행해달라고 요청해야 합니다. 다음의 일반 모델 호출은 이름과 유형만을 받으며, 일반적인 셸 구문을 사용합니다:

PGPASSWORD="$DB_PASSWORD" psql -h db.example.com -U readonly
git-rg --auth env -F 'timeout' github:OWNER/REPO
ssh -i "$SSH_KEY_FILE" deploy@host

기간 및 권한

  • 동일한 이름을 작성하면, 그 값은 이후의 명령어들에게도 그대로 적용됩니다. 이미 실행 중인 명령어들은 기존의 값을 그대로 유지할 수 있습니다.
  • 세션 내에서 메시지를 전송할 수 있는 사용자는 자격 증명을 관리할 수 있습니다. 이 세션은 Agent과 연결되며, 다른 세션들은 자격 증명을 상속받지 않습니다.
  • 텍스트는 Agent 메모리에 저장됩니다. 파일 디렉터리는 0700, 파일은 0600 모드를 사용하며 모두 Agent 계정이 소유합니다. 파일 자격 증명에는 Unix 권한 방식이 필요합니다. Windows Agents는 이를 거부하지만 Windows 클라이언트는 Unix Agents에 업로드할 수 있습니다.
  • 세션을 종료하거나 Agent을 재시작하면 자격 증명이 취소됩니다. 비정상적인 종료로 남아 있는 파일들은 다음 시작 시 정리되며, 이전의 값들은 복원되지 않습니다.
  • Agent를 Beak에서 분리하면 자격 증명도 함께 취소됩니다. 다시 연결한 후에 다시 제출해야 합니다. 세션을 다시 열어도 자격 증명을 복원할 수 없습니다.
  • 각 세션은 이름을 최대 64개, 항목당 최대 256 KiB까지 허용합니다. 누적 제출량은 8 MiB로 제한됩니다. 삭제해도 카운터는 초기화되지 않습니다. 마스킹용 조각은 더 이상 생성하지 않습니다.
  • Agents가 오프라인이면 대기열에 넣지 않고 즉시 실패합니다. 확인 시간이 초과되면 결과를 알 수 없습니다. 아무것도 저장되지 않았다고 가정하지 말고 이름 목록을 확인하거나 같은 이름으로 다시 제출하세요.
  • 자격 증명을 포함한 명령이 반환될 때, 해당 프로세스 그룹 내의 백그라운드 자식 프로세스들은 정리됩니다. 장시간 실행되는 서비스를 시작하기 위해서는 이 메커니즘을 사용하지 마세요.

일반 명령어는 세션 변수와 파일 경로를 받습니다. 기존의 셸 승인 규칙은 여전히 적용됩니다. 도구에서 출력된 자격 증명은 원래 내용 그대로 기록, 로그, 추적 및 모델에 포함됩니다. 파일 삭제는 디스크 증거 조사, 스냅샷 또는 백업으로부터 보호하지 않습니다. 동일한 OS 계정 및 관리자들은 파일 사용 권한 격리 구역 외부에 있습니다.

자격 증명은 해당 세션의 명령 프로세스에만 삽입되며, Agent의 전역 환경에는 영향을 주지 않습니다. 다른 세션들은 자동으로 자격 증명을 상속받지 못하지만, 동일한 Agent에 있는 세션들은 일반적으로 동일한 OS 계정을 공유합니다. 다른 세션의 제한 없는 셸은 해당 계정이 소유한 파일을 읽을 수 있으며, 프로세스-환경 접근은 OS 권한에 따라 결정됩니다. 세션의 범위는 별도의 계정, 컨테이너 또는 OS 샌드박스를 대체하지 않습니다.

웹에 접속하기

웹 입력 기능에는 호환되는 프런트엔드 버전과 배포 후 인수 검증이 필요합니다. Beak과 Agent만 업데이트해도 자동으로 제공되지는 않습니다.

현재 세션에서 자격 증명 항목을 선택하세요. 대화상자는 쓰기, 교체, 삭제 기능을 제공하며, 목록, 새로고침, 또는 Agent 선택기능은 제공되지 않습니다. 새로운 작업은 모델을 호출하지 않고 빈 세션을 생성하며, 이후 메시지들은 이 세션을 재사용합니다.

텍스트 입력은 숨겨져 있습니다. 파일은 붙여넣은 멀티라인 콘텐츠를 통해 업로드하거나 생성할 수 있으며, 공백과 새줄을 유지합니다. 덮어쓰기 및 삭제는 확인이 필요합니다. 입력이 실패할 경우, 해당 정보는 현재 폼의 메모리에만 남아 수동으로 재시도할 수 있습니다. 세션을 종료하거나 전환하거나 성공적으로 처리하면 해당 정보가 삭제됩니다. 사용자는 구조화된 데이터를 작성할 필요가 없습니다.

Beak은 메모리에서 자격 증명을 잠시 전달합니다. 배포 시 리버스 프록시, APM 또는 Redis 명령 디버깅에서 이 요청 본문을 수집하지 않도록 설정해야 합니다. 운영 환경에서는 HTTPS/WSS를 사용하세요.

문서 평가

이 페이지가 도움이 되었나요?