Bağlantının size sağladıkları
Cloudflare hesabınızı bağlamanız, statik siteleri hesabınızdaki Cloudflare Pages üzerine yayımlamamı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 barındırılır.
Başlamadan önce
Kullanmak istediğiniz alan adlarının bölge olarak eklendiği bir Cloudflare hesabı gereklidir. 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 My Profile → API Tokens bölümünü açın, Create Token ve ardından Create Custom Token seçeneğini belirleyin. Bir ad verin, aşağıda belirtilen izinleri ekleyin ve Zone Resources altında bizim erişmemizi istediğiniz bölgeleri seçin; tüm bölgeler veya yalnızca adını belirttikleriniz. Bilgileri gözden geçirin ve Create Token düğmesine basın. Cloudflare token'ı 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 siteleri Pages üzerine yayımlamamızı istiyorsanız. Bu izne sahip olmayan bir token yine de bağlanır ve DNS ile önbellek için çalışır.
Eski alternatif. Token yerine Global API Key değeriniz ve oturum açtığınız e-posta adresinizle bağlantı kurabilirsiniz (My Profile → API Tokens → API Keys → Global API Key → View). Cloudflare bunu önermez: Global API Key, oturumunuzun sahip olduğu tüm izinleri her bölgede taşır ve kapsamı daraltılamaz. Mümkünse bir token kullanın.
2. Buradan bağlayın
Kontrol panelinizde Integrations bölümünü açın ve Connect an account seçeneğini seçin. Grup olarak Cloudflare account (Pages, CDN & DNS), hesap olarak Cloudflare öğesini seçin, API token alanını doldurun (veya eski alternatif için API key ve Account email alanlarını doldurun) ve Connect account düğmesine basın.
Herhangi bir veri kaydedilmeden önce yapıştırdığınız bilgileri test ederiz. Çalışmayan bir anahtar hiçbir zaman saklanmaz ve sonuç ekranında neyin yanlış olduğu belirtilir. Çalışan bir anahtar ise veritabanımızda değil, gizli anahtar kasamızda şifrelenmiş olarak saklanır ve size bile bir daha asla gösterilmez.
Sonraki adımda 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 derleme çıktısını hesabınızdaki bir Pages projene yayımlarız.
- Bölgeleriniz bu hesaptan bir alan adının DNS'ini ve bir sitenin önbelleğini sunabilir.
- Token'ın 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, bunların hangilerini onaylayabildiğ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 vardır.
Bağlantı kurulamazsa
Bir izin onaylanmamış olarak görünüyor. Cloudflare, bir token'ın kendi izinlerini listelemesine her zaman izin vermez; bu nedenle bazı izinler ilk kez kullanıldığımızda onaylanır. Bir işlem daha sonra yetki hatasıyla başarısız olursa, My Profile → API Tokens bölümünden token'ı düzenleyin ve eksik izni ekleyin; token değeri değişmez, bu nedenle yeniden bağlanmaya gerek yoktur.
Bir bölge eksik. Token'ın Zone Resources ayarı o bölgeyi içermiyordur. Token'ı o 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 kopyaladıktan sonra iptal edilmiş veya yeniden oluşturulmuş bir anahtar. Yeni bir tane oluşturun ve tekrar yapıştırın.
Bağlantı kuruluyor ancak daha sonra bir işlem başarısız oluyor. Anahtar kimlik doğrulaması yapıyor ancak işlemin gerektirdiği bir izne sahip değil. Yukarıda listelenen izinlerle yeni bir anahtar oluşturun, ardından eski bağlantıyı koparıp yeni anahtarı bağlayın.
Bağlantıyı kesme
Integrations bölümünü açın, hesabı bulun ve Disconnect düğmesine basın. Bu işlem, saklanan anahtarı derhal siler. Bu anahtarı kullanan her şey sonraki işleminde durur ve buna bağlı ekranlar sessizce başarısız olmak yerine durumu bildirir.
Bağlantıyı kesmek daha önce yapılanları geri almaz; hesabınızda değiştirdiğimiz kayıtlar, dağıtımlar veya ayarlar olduğu gibi kalır. Anahtarınızın sızdırılmış olabileceğini düşünüyorsanız, onu sağlayıcı tarafında da iptal edin; bağlantıyı kesmek bizim kopyamızı siler, onlarınkini değil.