INTEGRITY Dokumentace

Registrace zařízení

Registrace zařízení představuje jednotlivou relaci Cloudflare One Client na fyzickém zařízení, čímž propojíte uživatele (nebo service token) a zařízení s vaší Organizace Zero Trust. Vytvoří se při prvním Cloudflare One Client ověří na tomto zařízení.

Každá registrace zařízení zahrnuje jedinečný veřejný klíč, profil zařízení, a virtuální IP adresy (jedna IPv4 a jedna IPv6), které identifikují zařízení ve vaší síti.

Jedno fyzické zařízení může mít více registrací zařízení, například pokud si více uživatelů dělí jeden notebook a každý z nich zaregistruje Cloudflare One Client pomocí vlastních přihlašovacích údajů.

Klíčové koncepty

Koncept Definice
Uživatel Osoba, jejíž identitu ověřuje váš poskytovatel identity (IdP) a která může do vaší organizace Zero Trust registrovat zařízení.
Licenční místo Fakturovatelná jednotka spotřebovaná při ověření uživatele ve vaší organizaci Zero Trust. Každý uživatel zabírá jedno licenční místo bez ohledu na to, kolik zařízení zaregistruje. Servisní tokeny nespotřebovávají licenční místa.
Service token Přihlašovací údaje, které automatizované systémy používají k ověření vůči vašim zásadám Cloudflare One.
Registrace zařízení Jednotlivá relace klienta Cloudflare One na fyzickém zařízení s vlastním veřejným klíčem, profil zařízení, a virtuální IP adresy (jedna IPv4 a jedna IPv6).
Relace Časově omezený JSON Web Token (JWT), který určuje, jak dlouho může uživatel přistupovat k aplikaci Access, než se musí znovu ověřit. Na rozdíl od relací je registrace zařízení trvalá: nevyprší a existuje, dokud ji neodstraníte.

Zkontrolovat stav registrace zařízení

Chcete-li zjistit, kolik registrací zařízení je přidruženo k danému zařízení:

  1. Přihlaste se do Cloudflare dashboard a přejděte na Zero Trust > Týmy a zdroje > Zařízení.
  2. Vyberte zařízení a vyberte Zobrazit podrobnosti.
  3. Přejděte níže na Uživatelé a zkontrolujte uživatele, kteří se na tomto zařízení zaregistrovali.

Chcete-li zkontrolovat stav registrace zařízení:

  1. V Cloudflare dashboard, přejděte na Zero Trust > Týmy a zdroje > Zařízení.
  2. Vyberte zařízení a vyberte Zobrazit podrobnosti.
  3. Přejděte níže na Uživatelé a najděte uživatele přiřazeného k zařízení.
  4. Zkontrolujte stav (například Active nebo Revoked) registrace zařízení v Stav.

Chcete-li získat seznam všech registrací zařízení, včetně aktivních a odvolaných:

Seznam registrací
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/devices/registrations?status=all&per_page=50" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
{
		"created_at": "2026-01-26T19:27:49.770372Z",
		"device": {
			"client_version": "2025.10.186",
			"id": "11ffb86f-3f0c-4306-b4a2-e62f872b166a",
			"name": "My Device"
		},
		"id": "11ffb86f-3f0c-4306-b4a2-e62f872b166a",
		"key": "<U+QTP50RsWfeLGHF4tlGDnmGeuwtsz46KCHr5OyhWq00Rsdfl45mgnQAuEJ6CO0YrkyTl9FUf5iB0bwYR3g4EEFEHhtu6jFaqfMrBMBSz6itv9HQXkaR9OieKQ==",
		"key_type": "secp256r1",
		"last_seen_at": "2026-01-29T00:57:57.925979Z",
		"revoked_at": "2026-01-29T00:58:16.704026Z",
		"tunnel_type": "masque",
		"updated_at": "2026-01-29T00:58:16.704026Z",
		"user": {
			"email": "[email protected]",
			"id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
			"name": ""
		}
	},

A revoked_at časové razítko značí, že registrace zařízení má stav Odvoláno. Pokud revoked_at je null nebo chybí, znamená to, že stav registrace je aktivní.

Smazaná registrace zařízení se natrvalo odstraní z účtu a v seznamu zařízení se už nezobrazí. Smazání je nevratné a zařízení je potřeba znovu zaregistrovat.

Stav registrace

Registrace mohou mít následující stavy:

Stav Popis
Aktivní Registrováno a připojitelné přes Cloudflare One Client. Toto je očekávaný provozní stav.
Odvolaný Veřejný klíč registrace je zneplatněn. Zrušení registrace neuvolní přiřazené virtuální IP adresy.

Spravovat registrace zařízení

Následující tabulka shrnuje akce dostupné pro správu registrací zařízení a samotných zařízení. U všech akcí platí, že pokud se uživatel nebo service token může znovu ověřit, vytvoří se automaticky nová registrace. Chcete-li přístup odebrat trvale, přečtěte si Správa zařízení.

Akce Co dělá Byly virtuální IP adresy uvolněny? Kdy použít
Odstraňte registraci Trvale odstraní jednu registraci zařízení a její konfiguraci. Ano Chcete uživateli úplně zrušit registraci na zařízení a uvolnit virtuální IP adresu.
Odvolat registraci Zneplatní veřejný klíč registrace a znemožní jí připojení. Záznam registrace zůstává zachován. Ne Chcete zařízení dočasně zablokovat, aby se nemohlo připojit, ale zachovat záznam registrace.
Odstraňte zařízení Odstraní fyzický záznam zařízení a všechny jeho přidružené registrace. Ano Chcete zařízení a všechny související registrace úplně odebrat.

Odstraňte registraci zařízení

Jedno zařízení může mít více registrací. Odstranění jedné registrace neovlivní ostatní registrace na stejném zařízení.

Chcete-li odstranit registraci zařízení:

  1. V Cloudflare dashboard, přejděte na Zero Trust > Týmy a zdroje > Zařízení.
  2. Vyberte zařízení > Zobrazit podrobnosti.
  3. Přejděte na Uživatelé a zaškrtněte políčko vedle registrace zařízení, kterou chcete odstranit.
  4. Vyberte Akce > Odstraňte přístup.

Chcete-li odstranit jednu registraci zařízení pomocí API:

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Zero Trust Write
Odstraňte registraci
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/devices/registrations/$REGISTRATION_ID" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Chcete-li hromadně odstranit více registrací zařízení:

curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/device/registrations/registrations?id=reg_id_1&id=reg_id_2&id=reg_id_3" \
	--request DELETE\
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Registrace zařízení je nyní trvale odstraněna a jeho virtuální IP adresa se uvolní zpět do fondu dostupných adres pro opětovné přiřazení.

Odvolat registraci zařízení

Zrušením registrace zařízení se znehodnotí přidružený veřejný klíč, takže se dané zařízení již nebude moci připojit k síti Cloudflare. Zrušení registrace zařízení neuvolní virtuální IP adresy, které jsou k ní přiřazené. Protože virtuální IP adresy jsou omezeným zdrojem, společnost Cloudflare důrazně doporučuje registraci raději smazat než zrušit.

  1. V Cloudflare dashboard, přejděte na Zero Trust > Týmy a zdroje > Zařízení.
  2. Vyberte zařízení a vyberte Zobrazit podrobnosti.
  3. Chcete-li odvolat přístup, vyberte Odvolat přístup. Tím se odvolá přístup pro všechny přidružené registrace na daném zařízení.
  4. Chcete-li obnovit odvolaný přístup, přejděte dolů na Uživatelé sekci a pomocí zaškrtávacího políčka vyberte jednoho nebo více uživatelů. Vyberte Akce > Obnovit přístup.

Odstraňte zařízení

Odstraněním zařízení se fyzické zařízení odebere z vašeho účtu Cloudflare Zero Trust. Tato akce automaticky smaže všechny přidružené registrace zařízení.

Zařízení bez aktivních registrací (protože všechny registrace byly odstraněny) jsou ve výchozím nastavení skrytá v části Cloudflare One > Týmy a zdroje > Zařízení tabulce. Možná budete muset upravit filtr, abyste zobrazili zařízení s nulovým počtem registrací.

Chcete-li odstranit zařízení:

  1. V Cloudflare One > Týmy a zdroje > Zařízení.
  2. Vyberte zařízení a vyberte Zobrazit podrobnosti.
  3. Vyberte Smazat.

Správa zařízení

Správa licenčních míst (fakturace) a správa přístupu jsou samostatné procesy. Odstranění registrace zařízení neuvolní uživatelovo licenční místo ani mu nezabrání v přístupu k interním prostředkům. Chcete-li uživateli přístup zcela odebrat, musíte podniknout další kroky popsané níže.

Odebrat přístup uživatele

Odstranění nebo zrušení registrace nebude trvalé, pokud se uživatel může znovu ověřit. Abyste uživateli zabránili v opětovném ověření a vytváření nových registrací zařízení, musíte ho odebrat z vašeho zásady registrace zařízení nebo od vašeho poskytovatele identity (IdP).

Po odebrání přístupu uživatele, chcete-li zařízení zcela vyřadit z provozu, odebrat přístup servisního tokenu, pokud nějaký existuje. Zařízení s existujícími registracemi zůstanou připojena ke Cloudflare, dokud nebudou tyto konkrétní registrace zařízení ručně odstraněny.

Odebrat přístup service tokenu

Pokud smažete registraci zařízení servisního tokenu, automaticky se bez zásahu uživatele vytvoří nová registrace zařízení pro tento servisní token. Aby bylo smazání registrace zařízení trvalé, musíte v zásadách registrace zařízení odebrat daný servisní token.

Chcete-li service tokenu zablokovat opětovné ověření, musíte buď:

  1. Odstraňte zásadu registrace přiřazenou k tokenu, nebo ji upravte tak, aby token dále neobsahovala (odebráním jejího konkrétního pravidla Include).
  2. (Volitelné) Odstraňte token služby.
    Tento token služby nelze použít k vytváření nových registrací.
    Token služby nelze odstranit, dokud je připojený k zásadě registrace zařízení.
  3. Odstraňte token služby registrace zařízení.
  4. (Volitelné) Chcete-li zařízení zcela vyřadit z provozu, odebrat přístup uživatele, pokud nějaký existuje. Zařízení s existujícími registracemi zůstanou připojena ke Cloudflare, dokud nebudou tyto konkrétní registrace zařízení ručně odstraněny.

Správa licenčních míst (fakturace)

Odstranění zařízení nebo registrace zařízení neovlivní využití licenčních míst. Licenční místa jsou vázána na identitu uživatele, nikoli na jednotlivá zařízení.

Chcete-li zabránit tomu, aby uživatel využíval licenční místo, musíte ho odebrat ze své organizace Zero Trust.

Odebráním uživatele z vaší Zero Trust organizace se uvolní licenční místo, které uživatel zabíral. Uživatel se ale bude nadále zobrazovat ve vašem seznamu uživatelů.

Chcete-li odebrat uživatele ze své organizace Zero Trust:

  1. V Cloudflare dashboard, přejděte na Zero Trust > Tým a zdroje > Uživatelé.
  2. Vyberte zaškrtávací políčko vedle uživatele s Aktivní stav v Využití licenčních míst sloupec.
  3. Vyberte Akce > Odebrat uživatele.
  4. Vyberte Odebrat.

Uživatel se nyní zobrazí jako Neaktivní a přestane zabírat licenční místo. Pokud je uživatel odebrán, ale později se přesto ověří, znovu spotřebuje licenční místo. Abyste zabránili uživateli v ověření, musíte jej odebrat z zásady registrace zařízení nebo od vašeho poskytovatele identity (IdP).

Chcete-li automatizovat odebírání uživatelů, kteří se po určitou dobu nepřihlásili ani nezahájili registraci zařízení, zapněte vypršení platnosti licenčního místa nebo využít SCIM a odebrat uživatele, když jsou deaktivováni u vašeho poskytovatele identity.