Infisical CLI 시크릿은(는) 무엇을 하나요?
Infisical CLI를 시크릿 관리의 진실 공급원(Source of Truth) 경계로 사용하세요. 안전하게 인증하고, infisical run으로 프로세스에 시크릿을 주입하며, 값을 채팅, 로그, 추적 파일에 복사하지 마십시오. 수동 .env 파일보다 프로세스 시간 주입 및 프로젝트 네이티브 시크릿 표면을 선호하세요.
변수
- INFISICAL_DOMAIN: 자체 호스팅 또는 클라우드 도메인, 예:
https://infisical.example.internal. - INFISICAL_PROJECT_ID: Infisical 프로젝트 UUID.
- INFISICAL_ENV: 환경 슬러그, 일반적으로
dev,staging또는prod. - INFISICAL_MACHINE_ENV_FILE:
INFISICAL_CLIENT_ID,INFISICAL_CLIENT_SECRET,INFISICAL_DOMAIN,INFISICAL_PROJECT_ID를 포함하는 선택적 로컬 환경 파일. - PAWRRTAL_REPO: Pawrrtal 쿡북을 적용할 때 사용하는 선택적 Pawrrtal 체크아웃 경로.
작동 방식
먼저 시크릿 표면을 분류합니다: 로컬 개발 프로세스, 서비스 프로세스, CI, 또는 애플리케이션 소유 워크스페이스/사용자 시크릿. 그런 다음 사용자 로그인 또는 머신 아이덴티티로 인증하고, 가장 작고 안전한 스모크 테스트를 실행하며, 대상 애플리케이션에 자체 암호화된 시크릿 저장소가 없는 한 infisical run을 사용하여 프로세스 경계에서 시크릿을 주입합니다.
명령어
| 명령어 | 목적 |
|---|---|
/infisical-cli-secrets recon | 저장소를 검사하고 시크릿 흐름 방식을 결정합니다. |
/infisical-cli-secrets auth | 사용자 로그인 또는 머신 아이덴티티로 안전하게 인증합니다. |
/infisical-cli-secrets run | 명령어를 Infisical 시크릿 주입으로 감쌉니다. |
/infisical-cli-secrets sync | 값을 노출하지 않고 시크릿 키를 추가, 업데이트 또는 감사합니다. |
/infisical-cli-secrets pawrrtal | Pawrrtal 게이트웨이 및 워크스페이스 시크릿에 클린 패턴을 적용합니다. |
쿡북
각 명령어에는 상세한 단계별 가이드가 있습니다. 명령어를 실행하기 전에 해당 쿡북 파일을 읽으십시오.
| 명령어 | 쿡북 | 사용 시기 |
|---|---|---|
| recon | cookbook/recon.md | 저장소의 env 파일, 구성 및 시크릿 평면을 이해해야 할 때 |
| auth | cookbook/auth.md | 안전한 CLI 세션 또는 머신 토큰이 필요할 때 |
| run | cookbook/run.md | 시크릿이 주입된 상태로 명령어를 시작해야 할 때 |
| sync | cookbook/sync.md | 시크릿 키를 설정, 가져오기, 비교 또는 확인해야 할 때 |
| pawrrtal | cookbook/pawrrtal.md | 저장소가 Pawrrtal이거나 paw/워크스페이스-env 규칙을 사용할 때 |
사용자가 /infisical-cli-secrets를 호출하면, 먼저 일치하는 쿡북 파일을 읽은 다음 단계를 실행하십시오.
안전 규칙
- 시크릿 값을 절대 출력하지 마십시오. 출력이 보호된 파일로 리디렉션되고 사용자가 명시적으로 요청한 경우가 아니라면
infisical secrets --plain,infisical export또는printenv를 피하십시오. .env파일을 작성하는 것보다infisical run -- <명령어>를 선호하십시오. 대상 도구가 프로세스 env를 받아들일 수 없을 때만 파일을 사용하고, 권한을0600으로 설정하십시오.- 자체 호스팅 인스턴스의 경우 모든 명령어에
--domain을 전달하거나INFISICAL_API_URL/INFISICAL_DOMAIN을 내보내십시오. - 머신 아이덴티티의 경우 토큰을
INFISICAL_TOKEN으로 캡처하십시오. 명령어 문자열에 직접 토큰을 전달하거나 추적 파일에 저장하지 마십시오. - 삭제는 고위험으로 취급하십시오. 의도를 확인하고, 키 이름과 환경을 검증하며, 설치된 CLI 삭제 경로가 손상된 것으로 알려진 경우 UI/API 삭제를 선호하십시오.
관련 스킬
함께 사용: /tailscale, /dev-box, /deploy-checklist