Pages, CDN 및 DNS를 위해 Cloudflare 계정 연결하기

연결 시 제공되는 기능

Cloudflare 계정을 연결하면 귀하의 계정에 있는 Cloudflare Pages에 정적 사이트를 게시하고, 해당 계정에서 사이트의 DNS와 캐시를 제공할 수 있습니다. 모든 항목은 귀하의 Cloudflare 대시보드와 귀하의 Cloudflare 요금제 내에서 관리됩니다.

시작하기 전 준비 사항

사용하려는 도메인이 영역으로 추가되어 있는 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를 누릅니다.

저장하기 전에 입력하신 내용을 테스트합니다. 작동하지 않는 키는 절대 저장되지 않으며, 무엇이 잘못되었는지 오류 메시지로 안내됩니다. 작동하는 키는 데이터베이스가 아닌 보안 볼트에 암호화되어 보관되며, 귀하를 포함하여 다시는 표시되지 않습니다.

다음 단계

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

CDN과 DNS를 서로 다른 Cloudflare 계정에서 유지하려면 대신 Cloudflare CDN과 Cloudflare DNS로 각각 따로 연결하십시오. 각 항목마다 별도의 가이드가 있습니다.

연결되지 않는 경우

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

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

키가 거부되었다는 메시지가 나오는 경우. 거의 대부분 다음 세 가지 중 하나입니다. 복사할 때 공백이나 줄바꿈이 함께 포함된 경우, 만료된 키인 경우, 또는 키를 복사한 후에 취소(revoked)되었거나 재생성된 경우입니다. 새로 생성하여 다시 붙여넣으십시오.

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

연결 해제

Integrations를 열고 해당 계정을 찾아 Disconnect를 누릅니다. 그러면 저장된 키가 즉시 삭제됩니다. 해당 키를 사용하던 모든 항목은 다음 작업 시점에 중지되며, 조용히 실패하는 대신 이를 의존하던 화면에 관련 내용이 표시됩니다.

연결을 해제해도 이미 수행된 작업(귀하의 계정에서 변경한 레코드, 배포 또는 설정)은 되돌려지지 않습니다. 키 자체가 유출되었을 수 있다고 생각되는 경우 공급업체 측에서도 해당 키를 취소(revoke)하십시오. 연결 해제 시 당사가 보유한 복사본만 삭제되며 공급업체 측의 복사본은 삭제되지 않습니다.