Pages, CDN 및 DNS를 위해 Cloudflare 계정을 연결하세요

연결 시 제공되는 혜택

Cloudflare 계정을 연결하면 당사에서 회원님의 계정에 있는 Cloudflare Pages로 정적 사이트를 배포하고, 해당 계정에서 사이트의 DNS 및 캐시를 제공할 수 있습니다. 모든 항목은 회원님의 고유한 Cloudflare 대시보드 및 Cloudflare 요금제 내에 유지됩니다.

시작하기 전에

사용하려는 도메인이 영역(zone)으로 추가된 Cloudflare 계정이 필요합니다. 연결에는 무료 요금제로도 충분하며, 각 영역에서 수행할 수 있는 작업은 회원님의 요금제에서 허용하는 바에 따릅니다.

1. Cloudflare에서 키 생성하기

Cloudflare 대시보드에서 My Profile → API Tokens를 열고 Create Token을 선택한 다음, Create Custom Token을 선택하십시오. 이름을 지정하고 아래의 권한을 추가한 후, Zone Resources에서 당사가 접근하기를 원하는 영역(모든 영역 또는 지정한 영역만)을 선택하십시오. 내용을 검토한 뒤 Create Token을 누르십시오. Cloudflare에서는 토큰이 한 번만 표시되므로, 이때 복사해 두십시오.

다음 권한들을 추가하십시오:

• Zone → Zone → Read
• Zone → DNS → Edit
• Zone → Cache Purge → Purge
• Zone → Zone Settings → Edit
• Account → Cloudflare Pages → Edit — Pages로 사이트를 배포하기를 원하시는 경우에만 해당합니다. 이 권한이 없는 토큰도 연결은 가능하며 DNS 및 캐시 기능은 정상 작동합니다.

이전 방식의 대안. 토큰 대신 Global API Key와 로그인 시 사용하는 이메일 주소(My Profile → API Tokens → API Keys → Global API Key → View)를 사용하여 연결할 수도 있습니다. 하지만 Cloudflare에서는 이 방식을 권장하지 않습니다. Global API Key는 모든 영역에 대해 로그인 계정이 가진 모든 권한을 동일하게 지니며, 권한 범위를 좁힐 수 없기 때문입니다. 가급적 토큰을 사용하십시오.

2. 여기에서 연결하기

대시보드에서 Integrations를 열고 Connect an account를 선택하십시오. 그룹으로 Cloudflare account (Pages, CDN & DNS)를, 계정으로 Cloudflare를 선택한 후, API token을 입력하거나 이전 방식 대안의 경우 API key와 Account email을 입력하고 Connect account를 누르십시오.

저장되기 전에 입력하신 내용을 먼저 테스트합니다. 작동하지 않는 키는 절대로 저장되지 않으며, 응답 메시지를 통해 문제 원인을 안내합니다. 작동하는 키는 비밀 보관함(secrets vault)에 암호화되어 보관되며(데이터베이스에는 절대 저장되지 않음), 본인을 포함하여 그 누구에게도 다시는 표시되지 않습니다.

이후 진행 과정

• 정적 사이트를 생성하거나 이전할 때 Cloudflare Pages가 배포 대상으로 표시되며, 빌드 결과물이 회원님 계정의 Pages 프로젝트로 배포됩니다.
• 회원님의 영역을 통해 이 계정에서 도메인의 DNS와 사이트의 캐시를 제공할 수 있습니다.
• 당사는 토큰이 영역을 읽고, DNS를 편집하며, 캐시를 삭제하고, 영역 설정을 변경할 수 있는지 확인합니다. 연결 상태 옆의 체크리스트에서 확인된 항목을 확인할 수 있습니다.

CDN과 DNS를 서로 다른 Cloudflare 계정에서 관리하고자 하시는 경우, 대신 Cloudflare CDN 및 Cloudflare DNS로 각각 따로 연결하십시오. 각 항목마다 별도의 안내서가 마련되어 있습니다.

연결되지 않는 경우

권한이 미확인 상태로 표시되는 경우. Cloudflare가 토큰 자체의 권한 목록 조회를 항상 허용하는 것은 아니므로, 일부 권한은 처음 사용될 때 확인됩니다. 나중에 권한 오류로 인해 작업이 실패하면 My Profile → API Tokens에서 토큰을 편집하여 누락된 권한을 추가하십시오. 토큰 값은 변경되지 않으므로 다시 연결할 필요는 없습니다.

영역이 누락된 경우. 토큰의 Zone Resources에 해당 영역이 포함되어 있지 않은 상태입니다. 해당 영역 또는 모든 영역이 포함되도록 토큰을 편집하십시오.

키가 거부되었다고 표시되는 경우. 대부분 다음 세 가지 중 하나에 해당합니다. 공백이나 줄 바꿈이 함께 복사되었거나, 만료된 키이거나, 복사한 후 취소되었거나 재생성된 키인 경우입니다. 새 키를 생성하여 다시 붙여넣으십시오.

연결은 되었으나 이후 작업이 실패하는 경우. 키 인증은 되었으나 해당 작업에 필요한 권한이 누락된 상태입니다. 위에 나열된 권한을 포함하여 새 키를 생성한 다음, 기존 연결을 해제하고 새 키로 연결하십시오.

연결 해제하기

Integrations를 열고 해당 계정을 찾은 뒤 Disconnect를 누르십시오. 그러면 저장되어 있던 키가 즉시 삭제됩니다. 해당 키를 사용하던 모든 작업은 다음 실행 시점에 중단되며, 해당 키에 의존하던 화면에는 오류 없이 조용히 실패하는 대신 관련 안내가 표시됩니다.

연결을 해제하더라도 이미 완료된 작업은 취소되지 않습니다. 회원님의 계정에서 당사가 변경한 레코드, 배포 또는 설정은 그대로 유지됩니다. 키 자체가 유출된 것으로 의심되는 경우에는 제공업체 측에서도 해당 키를 폐기하십시오. 연결 해제는 당사가 보유한 사본만 삭제하며, 제공업체의 사본까지 삭제하지는 않습니다.