Bağlantı kurmanın size sağladıkları
Cloudflare hesabınızı bağlamak, hesabınızdaki Cloudflare Pages'e statik siteler yayınlamamıza ve sitelerinizin DNS ile önbelleğini buradan sunmamıza olanak tanır. Her şey kendi Cloudflare kontrol panelinizde ve kendi Cloudflare planınızda yer alır.
Başlamadan önce
Kullanmak istediğiniz alan adlarının bölge (zone) olarak eklendiği bir Cloudflare hesabı gerekir. Bağlantı kurmak için ücretsiz plan yeterlidir; her bir bölgede yapabilecekleriniz ise planınızın izin verdikleriyle sınırlıdır.
1. Anahtarı Cloudflare üzerinde oluşturun
Cloudflare kontrol panelinde Profilim → API Belirteçleri (My Profile → API Tokens) bölümünü açın ve sırasıyla Belirteç Oluştur (Create Token) ile Özel Belirteç Oluştur (Create Custom Token) seçeneklerini belirleyin. Bir ad verin, aşağıdaki izinleri ekleyin ve Bölge Kaynakları (Zone Resources) altında erişmemizi istediğiniz bölgeleri (tüm bölgeler veya yalnızca belirttikleriniz) seçin. Gözden geçirin ve Belirteç Oluştur (Create Token) butonuna basın. Cloudflare belirteci yalnızca bir kez gösterir; bu aşamada kopyalayın.
Şu izinleri ekleyin:
- Zone → Zone → Read
- Zone → DNS → Edit
- Zone → Cache Purge → Purge
- Zone → Zone Settings → Edit
- Account → Cloudflare Pages → Edit — yalnızca Pages'e siteler yayınlamamızı istiyorsanız. Bu izin olmadan da belirteç bağlanır; DNS ve önbellek için çalışmaya devam eder.
Eski alternatif. Belirteç yerine Global API Anahtarınız (Global API Key) ve giriş yaptığınız e-posta adresiyle de (Profilim → API Belirteçleri → API Anahtarları → Global API Anahtarı → Görüntüle / My Profile → API Tokens → API Keys → Global API Key → View) bağlantı kurabilirsiniz. Cloudflare bunu önermez: Global API Anahtarı, giriş bilgilerinizin sahip olduğu her izni tüm bölgelerde taşır ve sınırlandırılamaz. Mümkünse bir belirteç kullanın.
2. Buradan bağlayın
Kontrol panelinizde Entegrasyonları açın ve Bir hesap bağlayı seçin. Grup olarak Cloudflare hesabı (Pages, CDN & DNS) ve hesap olarak Cloudflareı seçin, API belirtecini — veya eski alternatif için API anahtarı ile Hesap e-postasını — doldurun ve Hesabı bağlaya basın.
Yapıştırdığınız bilgileri herhangi bir şey kaydedilmeden önce test ederiz. Çalışmayan bir anahtar asla saklanmaz ve yanıtta neyin hatalı olduğu belirtilir. Çalışan bir anahtar ise veritabanımızda asla tutulmayıp gizli bilgi kasamızda şifrelenmiş olarak saklanır ve size dahi bir daha asla gösterilmez.
Sonrasında ne olur?
- Statik bir site oluşturduğunuzda veya taşıdığınızda Cloudflare Pages bir dağıtım hedefi olarak görünür ve derlemeyi hesabınızdaki bir Pages projesine yayınlarız.
- Bölgeleriniz, bir alan adının DNS'ini ve bir sitenin önbelleğini bu hesaptan sunabilir.
- Belirtecin bölgelerinizi okuyabildiğini, DNS'i düzenleyebildiğini, önbelleği temizleyebildiğini ve bölge ayarlarını değiştirebildiğini kontrol ederiz. Bağlantının yanındaki kontrol listesi bunlardan hangilerini doğrulayabildiğimizi gösterir.
CDN ve DNS'i farklı Cloudflare hesaplarında tutmak istiyorsanız, bunları ayrı ayrı Cloudflare CDN ve Cloudflare DNS olarak bağlayın — her birinin kendi kılavuzu bulunmaktadır.
Bağlantı kurulamazsa
Bir izin doğrulanmamış olarak görünüyor. Cloudflare, bir belirtecin kendi izinlerini listelemesine her zaman izin vermez; bu nedenle bazıları ancak ilk kullandığımızda doğrulanır. Bir işlem daha sonra yetki hatasıyla başarısız olursa, belirteci Profilim → API Belirteçleri (My Profile → API Tokens) altından düzenleyin ve eksik izni ekleyin — belirteç değeri değişmediğinden yeniden bağlantı kurmanız gerekmez.
Bir bölge eksik. Belirtecin Bölge Kaynakları (Zone Resources) bu bölgeyi içermiyordur. Belirteci söz konusu bölgeyi veya tüm bölgeleri içerecek şekilde düzenleyin.
Anahtarın reddedildiği belirtiliyor. Neredeyse her zaman şu üç durumdan biridir: anahtarla birlikte kopyalanan bir boşluk veya satır sonu, süresi dolmuş bir anahtar ya da kopyalamanızdan sonra iptal edilmiş veya yeniden oluşturulmuş bir anahtar. Yeni bir tane oluşturun ve tekrar yapıştırın.
Bağlanıyor ancak daha sonra bir işlem başarısız oluyor. Anahtar doğrulanıyor ancak işlemin gerektirdiği bir izne sahip değil. Yukarıda listelenen izinlere sahip yeni bir anahtar oluşturun, ardından eski bağlantıyı kesip yeni anahtarı bağlayın.
Bağlantıyı kesme
Entegrasyonları açın, hesabı bulun ve Bağlantıyı Kese basın. Bu işlem saklanan anahtarı anında siler. Bu anahtarı kullanan her şey bir sonraki işleminde durur ve buna bağımlı ekranlar sessizce hata vermek yerine durumu açıkça belirtir.
Bağlantıyı kesmek daha önce yapılmış işlemleri geri almaz — hesabınızda değiştirdiğimiz kayıtlar, dağıtımlar veya ayarlar olduğu gibi kalır. Anahtarın kendisinin sızdırılmış olabileceğini düşünüyorsanız, sağlayıcı üzerinden de anahtarı iptal edin; bağlantıyı kesmek sağlayıcıdaki kopyayı değil, yalnızca bizdekini siler.