UrlPrefix Dizeleri

HTTP Server API'sinde UrlPrefix, URL ad alanının bir bölümünü belirten kurallı bir biçime sahip geniş karakterli (UTF-16) Unicode dizesidir. Bir kullanıcı hesabı için URL ad alanının bir bölümünü ayırmak veya bir işlem için URL ad alanının bir bölümünü kaydetmek için kullanılır.

UrlPrefix Biçimi

UrlPrefix aşağıdaki söz dizimine sahiptir:

"scheme://host:port/relativeURI"

UrlPrefix'in şeması, konağı ve bağlantı noktası öğeleri mevcut ve boş olmamalıdır ve aşağıdaki kurallara uymalıdır:

düzeni

Tümü küçük harfle http veya https olmalıdır.

konağı

Tam etki alanı adı, IPv4 veya IPv6 değişmez değer dizesi ya da joker karakter olmalıdır. Küçük harf olması gereken şemadan farklı olarak konak bölümü büyük/küçük harfe duyarlı değildir. Ana bilgisayar bölümünün nasıl belirtildiğine bağlı olarak, urlPrefix aşağıdaki dört yönlendirme kategorisinden birine girer ve bunlar aşağıda daha ayrıntılı olarak açıklanmıştır:

Güçlü joker karakter

Açık

IP'ye bağlı zayıf joker karakter

Zayıf joker karakter

bağlantı noktası

Sıfırla başlamayan ve geçerli bir TCP bağlantı noktası numarasını (1 - 65.535) temsil eden ondalık sayısal dize. Bu değer joker karakter olamaz.

relativeURI

relativeURI öğesi isteğe bağlıdır, ancak varsa her zaman bir eğik çizgi karakteri ("/") tarafından izlenmesi gerekir. Bu, makinenin ad alanında şema, konak ve bağlantı noktası değerlerine göre belirtilen bir alt ağacı gösteren bir ön ek dizesidir. Küçük harf olması gereken şemadan farklı olarak relativeURI bölümü büyük/küçük harfe duyarlı değildir.

Düzgün biçimlendirilmiş UrlPrefixes örnekleri şunlardır:

• https://www.adatum.com:80/vroot/
• https://adatum.com:443/secure/database/
• https://+:80/vroot/

Host-Specifier Kategorileri

Esneklik ve kullanım kolaylığı için HTTP Sunucusu API'si konakları belirtmenin dört farklı yolunu destekler. Dört konak belirtici kategorisi öncelik sırasına göre aşağıda listelenmiştir:

Güçlü joker karakter (Artı İşareti)

UrlPrefix'in konak öğesi tek bir artı işaretinden (+) oluştuğunda, UrlPrefix şeması, bağlantı noktası ve relativeURI öğeleri bağlamındaki tüm olası konak adlarını eşleştirir ve güçlü joker karakter kategorisine girer.

Güçlü joker karakter, bir uygulamanın bir veya daha fazla relativeURI'ye yönelik isteklere hizmet etmesi gerektiğinde, bu isteklerin makineye nasıl ulaştığına veya Konak üst bilgilerinde hangi siteyi belirttiğine bakılmaksızın yararlıdır. Bu durumda güçlü bir joker karakter kullanılması, ana bilgisayar ve/veya IP adreslerinin kapsamlı bir listesini belirtme gereksinimini önler.

Açık

Konak öğesindeki tam etki alanı adı gibi açık bir ana bilgisayar adı, açık kategoriye bir UrlPrefix yerleştirir. Bu tür bir konak öğesi, gelen isteklerin Konak üst bilgileriyle doğrudan eşleştirilir.

Açık konak belirtimleri, isteğin yönlendirildiği siteye bağlı olarak farklı içerik sunan Web sunucuları gibi çok siteli uygulamalar için kullanışlıdır.

IP'ye bağlı zayıf joker karakteri

Ana bilgisayar öğesi olarak bir IP adresi göründüğünde UrlPrefix, IP'ye bağlı Zayıf Joker Karakter kategorisine girer. Bu tür UrlPrefix, belirtilen IP arabirimi için belirtilen düzen, bağlantı noktası ve relativeURI ile herhangi bir ana bilgisayar adıyla eşleşir ve henüz strong-wildcard veya açık UrlPrefix ile eşleşmemiştir. IP adresi konak öğesindeki iki biçimden birini alır:

IPv4 Değişmez Dizesini

IPv4 değişmez değeri, her biri 0-255 aralığındaki 192.168.0.0 gibi dört noktalı ondalık sayıdan oluşur.

IPv6 Değişmez Dizesini

IPv6 değişmez değer dizesi köşeli ayraç içine alınır ve iki nokta üst üste ile ayrılmış onaltılık sayılar içerir; örneğin: [::1] veya [3ffe:ffff::6ECB:0101].

IP'ye bağlı zayıf joker karakterli ana bilgisayar tanımlayıcıları, gelen istekler tarafından alınan yola göre hizmet verdikleri içeriğe göre değişiklik gösteren uygulamalara yöneliktir. Güvenliği zorlamak için IP'ye bağlı zayıf joker karakterli ana bilgisayar tanımlayıcılarına güvenmeyin.

Zayıf joker karakter (yıldız işareti)

Konak öğesi olarak yıldız işareti (*) göründüğünde UrlPrefix zayıf joker karakter kategorisine girer. Bu tür UrlPrefix, belirtilen düzen, bağlantı noktası ve relativeURI ile ilişkilendirilmiş ve henüz bir tanımlayıcı joker karakter, açık veya IP'ye bağlı zayıf joker karakter UrlPrefix ile eşleşmemiş olan herhangi bir ana bilgisayar adıyla eşleşir.

Bu konak belirtimi bazı durumlarda varsayılan tümünü yakala olarak kullanılabilir veya çok sayıda UrlPre düzeltmesi kullanmak zorunda kalmadan URL ad alanının büyük bir bölümünü belirtmek için kullanılabilir.

Rezervasyon ve Kayıt Sırasında UrlPrefix Çakışma Algılama

Rezervasyon ve kayıt amacıyla, UrlPrefix'in dört farklı kategorisi birbirinden ayrı olarak, birbirlerine başvuruda bulunmadan ele alınıyor. Farklı kategorilerde oldukları sürece çakışan UrlPrefixes kaydetmek mümkündür. Yalnızca aynı kategori içinde bir çakışma, rezervasyon girişiminin başarısız olmasına neden olur.

Örneğin, hem açık UrlPrefix https://www.adatum.com:80/vroot/ hem de çakışan güçlü urlPrefix https://+:80/vroot/farklı kategorilere ait oldukları için ayırmak mümkün olabilir. Ancak, sonraki bir https://+:80/vroot/ farklı bir kullanıcıya ayırma girişimi başarısız olur çünkü kendi kategorisindeki mevcut bir rezervasyonla çakışırdı.

Yönlendirme Davranışı

Gelen bir HTTP isteğini yönlendirirken, HTTP Sunucusu API'si güçlü joker kategoriyle başlar ve gelen URL'yi bu kategorideki hem kayıtlı hem de ayrılmış UrlPrefixes ile karşılaştırır.

Gelen URL bir rezervasyonla eşleşiyorsa ancak kayıtla eşleşmiyorsa HTTP Sunucusu API'si isteği başarısız olur. Bu, düşük öncelikli kayıtların bu kayıt için tasarlanmamış istekleri alabilmesini önler. Hata durumu 503 yerine 400 ("Hatalı İstek") olur ("Hizmet kullanılamıyor"), çünkü bazen yük dengeleme ağ geçitleri tarafından yanlışlıkla sunucunun aşırı yüklendiğini belirten bir 503 dönüşü yorumlanır.

Kategori içinde eşleşen bir kayıt bulunursa, istek bu kayıtla ilişkili istek kuyruğuna yönlendirilir. İstek her zaman bir kategorideki en uzun eşleşen UrlPrefix ile ilişkili kuyruğa yönlendirilir.

Kategoride eşleşme bulunmazsa, HTTP Sunucusu API'si açık kategoriye devam eder ve aynı yordamı yineler. Özetlemek gerekirse, kategorilerin incelendiği sıra aşağıdaki gibidir:

1. Güçlü joker karakter
2. Açık
3. zayıf joker karakter IP-Bound
4. Zayıf joker karakter

Kategorilerden herhangi birinde eşleşme bulunmazsa, HTTP Sunucusu API'si isteğin yönlendirilemeyeceğini belirtmek için durum kodu 400 olan bir yanıt gönderir.

En Uzun Eşleşme Kuralı

Her UrlPrefix kategorisinde, HTTP Server API'si bir isteği en uzun eşleşen UrlPrefix ile ilişkili kuyruğa yönlendirir. Örneğin, aşağıdaki iki UrlPrefixes'in farklı kuyruklara kaydedildiğine varsayalım:

• Queue1 https://www.adatum.com:80/
• Queue2 https://www.adatum.com:80/dir/sna/

HTTP Server API'sinde bir https://www.adatum.com:80/default.htm isteği Kuyruk1'e, https://www.adatum.com:80/dir/sna/snadefault.htm isteği de Queue2'ye yönlendirilir. En uzun tam eşleşme https://www.adatum.com:80/dir/sna UrlPrefix ile değil https://www.adatum.com:80/ UrlPrefix ile olduğundan, https://www.adatum.com:80/dir/app.htm isteğini Queue1'e yönlendirir.