Połącz swoje konto Cloudflare dla Pages, CDN i DNS

Co daje połączenie konta

Połączenie konta Cloudflare pozwala nam publikować witryny statyczne w usłudze Cloudflare Pages na Państwa koncie oraz obsługiwać z niego system DNS i pamięć podręczną Państwa witryn. Wszystko znajduje się w Państwa własnym panelu Cloudflare i w ramach Państwa własnego planu Cloudflare.

Zanim zaczną Państwo

Konto Cloudflare z domenami, których chcą Państwo używać, dodanymi do niego jako strefy. Do połączenia wystarczy plan bezpłatny; zakres możliwości w poszczególnych strefach zależy od posiadanego planu.

1. Wygenerowanie klucza w Cloudflare

W panelu Cloudflare proszę otworzyć My Profile → API Tokens i wybrać Create Token, a następnie Create Custom Token. Proszę nadać mu nazwę, dodać poniższe uprawnienia i w sekcji Zone Resources wybrać strefy, do których mamy mieć dostęp — wszystkie strefy lub tylko wskazane. Proszę sprawdzić konfigurację i kliknąć Create Token. Cloudflare wyświetla token tylko raz; należy go wtedy skopiować.

Proszę dodać następujące uprawnienia:

• Zone → Zone → Read
• Zone → DNS → Edit
• Zone → Cache Purge → Purge
• Zone → Zone Settings → Edit
• Account → Cloudflare Pages → Edit — tylko jeśli mamy publikować witryny w usłudze Pages. Token

bez tego uprawnienia nadal umożliwia połączenie i obsługę DNS oraz pamięci podręcznej.

Starsza alternatywa. Zamiast tokena można połączyć się za pomocą klucza Global API Key oraz adresu e-mail używanego do logowania (My Profile → API Tokens → API Keys → Global API Key → View). Cloudflare odradza to rozwiązanie: klucz Global API Key posiada wszystkie uprawnienia przypisane do loginu we wszystkich strefach i nie można go ograniczyć. Jeśli to możliwe, zaleca się użycie tokena.

2. Nawiązanie połączenia tutaj

W panelu proszę otworzyć sekcję Integrations i wybrać Connect an account. Proszę wybrać Cloudflare account (Pages, CDN & DNS) jako grupę oraz Cloudflare jako konto, wypełnić pole API token — lub, w przypadku starszej alternatywy, API key oraz Account email — a następnie kliknąć Connect account.

Wprowadzone dane są testowane przed zapisaniem. Klucz, który nie działa, nigdy nie jest przechowywany, a komunikat informuje o przyczynie błędu. Działający klucz jest bezpiecznie szyfrowany w naszym magazynie wpisów tajnych — nigdy w bazie danych — i nie jest już nikomu pokazywany, nawet Państwu.

Co dzieje się dalej

• Usługa Cloudflare Pages pojawi się jako cel wdrożenia podczas tworzenia lub przenoszenia witryny

statycznej, a my opublikujemy wersję roboczą w projekcie Pages na Państwa koncie.

• Państwa strefy mogą obsługiwać DNS domeny oraz pamięć podręczną witryny z tego konta.
• Sprawdzamy, czy token może odczytywać strefy, edytować DNS, czyścić pamięć podręczną i zmieniać ustawienia strefy.

Lista kontrolna obok połączenia wskazuje, które z tych uprawnień udało się potwierdzić.

Jeśli chcą Państwo zachować CDN i DNS na różnych kontach Cloudflare, należy połączyć je oddzielnie jako Cloudflare CDN i Cloudflare DNS — każda z tych opcji posiada własną instrukcję.

W przypadku problemów z połączeniem

Uprawnienie wyświetla się jako niepotwierdzone. Cloudflare nie zawsze zezwala tokenowi na wylistowanie własnych uprawnień, dlatego niektóre z nich są potwierdzane dopiero przy pierwszym użyciu. Jeśli późniejsza operacja zakończy się błędem uprawnień, proszę edytować token w My Profile → API Tokens i dodać brakujące uprawnienie — wartość tokena nie ulega zmianie, więc ponowne łączenie nie jest wymagane.

Brakuje strefy. Sekcja Zone Resources tokena jej nie obejmuje. Należy wyedytować token, aby uwzględnić tę strefę lub wszystkie strefy.

Pojawia się komunikat o odrzuceniu klucza. Prawie zawsze wynika to z jednej z trzech przyczyn: skopiowania spacji lub znaku nowego wiersza, wygaśnięcia klucza albo jego unieważnienia bądź ponownego wygenerowania po skopiowaniu. Należy utworzyć nowy klucz i wkleić go ponownie.

Połączenie działa, ale późniejsza operacja kończy się niepowodzeniem. Klucz przeszedł uwierzytelnienie, ale brakuje mu uprawnienia wymaganego do danej operacji. Należy utworzyć nowy klucz z uprawnieniami wymienionymi powyżej, a następnie odłączyć stare połączenie i podłączyć nowy klucz.

Odłączanie

Proszę otworzyć Integrations, odnaleźć konto i kliknąć Disconnect. Spowoduje to natychmiastowe usunięcie zapisanego klucza. Wszelkie procesy korzystające z niego zostaną zatrzymane przy następnej operacji, a ekrany, które od niego zależały, wyświetlą odpowiedni komunikat zamiast błędu bez powiadomienia.

Odłączenie nie cofa wcześniej wykonanych czynności — rekordy, wdrożenia czy ustawienia zmienione na Państwa koncie pozostają bez zmian. W przypadku podejrzenia wycieku samego klucza należy go unieważnić również u dostawcy usługi; odłączenie usuwa naszą kopię, a nie kopię po stronie dostawcy.