프리뷰 보호

프리뷰 주소를 누가 열 수 있는지, 자동화에서 통과하는 법.

프리뷰 보호

프로덕션 브랜치가 아닌 push는 프리뷰 주소로 배포돼요. 이 주소를 누가 열 수 있는지 정해요.

get_preview_protection   지금 설정, 보호 범위, 우회 키, 공유 링크
set_preview_protection   off | members | password
set_protection_scope     보호할 주소(previews | generated | all), 들일 IP, 통과시킬 경로
create_bypass_secret     우회 키 만들기 (한 번만 보임)
revoke_bypass_secret     우회 키 폐기
create_share_link        배포 하나나 브랜치 하나를 여는 링크 (1~30일)
revoke_share_link        공유 링크 폐기

members: 콘솔에 로그인한 이 조직의 사람만. 새 프로젝트의 기본값이에요.
password: 비밀번호 하나로. 계정 없는 고객에게 보여 줄 때.
off: 주소를 아는 누구나.

프로덕션 주소와 연결한 도메인은 언제나 공개예요. 배포마다 붙는 dpl-… 주소는 프로덕션 빌드라도 보호돼요.

E2E 테스트처럼 로그인할 수 없는 곳에서는 create_bypass_secret으로 만든 우회 키를 x-blackwall-protection-bypass 헤더로 보내세요. AI가 자기가 배포한 프리뷰를 열어 확인할 때도 이 키를 써요. set_protection_scope의 scope를 generated로 하면 프로덕션의 기본 주소까지, all이면 연결한 도메인까지 보호해요.

환경

프로덕션과 브랜치 프리뷰 말고 스테이징 같은 환경을 직접 만들 수 있어요. 자기 주소, 도메인, 환경 변수를 따로 가져요.

list_environments        프로덕션과 직접 만든 환경, 따라가는 브랜치, 주소, 도메인
create_environment       환경 만들기 (name, branch, auto_assign)
update_environment       따라가는 브랜치와 자동으로 받는지 바꾸기
remove_environment       환경 지우기 (confirm에 이름)
set_domain_environment   확인된 도메인을 환경에 연결

환경 변수는 set_env_vars의 target에 환경 이름을 넣어요. auto_assign이 false인 환경은 promote_deployment로만 바뀌어요. 소유자·관리자만 바꿀 수 있어요.

브랜치 미리보기

get_branch_previews   지금 설정 (branch_previews: true | false)
set_branch_previews   enabled: true | false

조직 전체 설정이에요. false면 프로덕션 브랜치(보통 main)에 들어온 것만 빌드하고, 브랜치 푸시는 배포 기록에 건너뜀으로 남아요. redeploy·직접 올린 배포·배포 훅은 그대로 빌드해요. 소유자·관리자만 바꿀 수 있어요. REST는 GET·PUT /v1/projects/<ref>/branch-previews {enabled}, CLI는 oneend deployments branch-previews [on|off], 콘솔은 조직 → 배포 정책 → 브랜치 미리보기예요.