INTEGRITY Dokumentace

← Images / images / optimization / transformations

Řízení přístupu k originu

Obrázky se změněnou velikostí můžete poskytovat, aniž byste umožnili přístup k původnímu obrázku. Obrázky mohou být hostované na jiném serveru mimo vaši zónu a skutečný zdroj obrázku tak může zůstat zcela skrytý. Origin server může pro zobrazení původního obrázku vyžadovat ověření, aniž by o tom návštěvníci museli vědět. Přístupu k obrázku v plné velikosti lze zabránit tím, že znemožníte úpravu parametrů pro změnu velikosti.

Všechny tyto vlastnosti si můžete plně přizpůsobit, protože je řídí vlastní kód skriptu běžícího na edge v Cloudflare Workeru.

export default {
	async fetch(request, env, ctx) {
		// Here you can compute arbitrary imageURL and
		// resizingOptions from any request data ...
		return fetch(imageURL, { cf: { image: resizingOptions } });
	},
};

Tento kód se spouští při každém požadavku, návštěvníkům webu ale zůstává zdrojový kód skrytý. Díky tomu může provádět bezpečnostní kontroly a bezpečně uchovávat tajné klíče potřebné pro přístup k obrázkům.

Následující příklady jsou pouze návrhy a nemusíte je dodržovat doslovně. Adresy URL obrázků a možnosti změny velikosti můžete sestavit i mnoha jinými způsoby.

Skrytí serveru s obrázky

export default {
	async fetch(request, env, ctx) {
		const resizingOptions = {
			/* resizing options will be demonstrated in the next example */
		};

		const hiddenImageOrigin = "https://secret.example.com/hidden-directory";
		const requestURL = new URL(request.url);
		// Append the request path such as "/assets/image1.jpg" to the hiddenImageOrigin.
		// You could also process the path to add or remove directories, modify filenames, etc.
		const imageURL = hiddenImageOrigin + requestURL.pathname;
		// This will fetch image from the given URL, but to the website's visitors this
		// will appear as a response to the original request. Visitor’s browser will
		// not see this URL.
		return fetch(imageURL, { cf: { image: resizingOptions } });
	},
};

Zamezení přístupu k obrázkům v plné velikosti

Kromě ochrany adresy URL původního obrázku můžete také ověřit, že jsou povoleny pouze určité velikosti obrázků:

export default {
  async fetch(request, env, ctx) {
  const imageURL = … // detail omitted in this example, see the previous example

  const requestURL = new URL(request.url)
  const width = parseInt(requestURL.searchParams.get("width"), 10);
  const resizingOptions = { width }
  // If someone tries to manipulate your image URLs to reveal higher-resolution images,
  // you can catch that and refuse to serve the request (or enforce a smaller size, etc.)
  if (resizingOptions.width > 1000) {
    return new Response("We don't allow viewing images larger than 1000 pixels wide", { status: 400 })
  }
  return fetch(imageURL, {cf:{image:resizingOptions}})
},};

Nepoužívejte rozměry obrázku v URL adresách

Do URL nemusíte uvádět skutečné rozměry v pixelech. Velikosti můžete zapsat přímo do skriptu Workeru a zvolit je jiným způsobem, například pojmenováním předvolby v URL:

export default {
	async fetch(request, env, ctx) {
		const requestURL = new URL(request.url);
		const resizingOptions = {};

		// The regex selects the first path component after the "images"
		// prefix, and the rest of the path (e.g. "/images/first/rest")
		const match = requestURL.pathname.match(/images\/([^/]+)\/(.+)/);

		// You can require the first path component to be one of the
		// predefined sizes only, and set actual dimensions accordingly.
		switch (match && match[1]) {
			case "small":
				resizingOptions.width = 300;
				break;
			case "medium":
				resizingOptions.width = 600;
				break;
			case "large":
				resizingOptions.width = 900;
				break;
			default:
				throw Error("invalid size");
		}

		// The remainder of the path may be used to locate the original
		// image, e.g. here "/images/small/image1.jpg" would map to
		// "https://storage.example.com/bucket/image1.jpg" resized to 300px.
		const imageURL = "https://storage.example.com/bucket/" + match[2];
		return fetch(imageURL, { cf: { image: resizingOptions } });
	},
};

Ověřený origin

Transformace obrázků Cloudflare ukládají do mezipaměti obrázky se změněnou velikostí, aby se zlepšil výkon. Obrázky s omezeným přístupem se obecně nedoporučuje takto zpracovávat, protože sdílení obrázků upravených pro jednotlivé návštěvníky není bezpečné. Pokud však zákazník souhlasí s ukládáním takových obrázků do veřejné mezipaměti, Cloudflare umožňuje měnit jejich velikost prostřednictvím Workers. V současné době je to podporováno u ověřených zdrojů AWS, Azure, Google Cloud, SecureAuth a u zdrojů za Cloudflare Access.

// generate signed headers (application specific)
const signedHeaders = generatedSignedHeaders();

fetch(private_url, {
	headers: signedHeaders,
	cf: {
		image: {
			format: "auto",
			"origin-auth": "share-publicly",
		},
	},
});

Při použití tohoto kódu se na origin server předávají následující hlavičky, díky nimž je požadavek úspěšný:

Další informace najdete zde: