Przetwarzanie rejestracji

Interfejsy API serwera HTTP używają bazy danych routingu do stosowania kontroli dostępu podczas rejestracji. Rejestracja UrlPrefix musi przejść serię kontroli dostępu, aby upewnić się, że użytkownik rejestrujący się w przestrzeni nazw ma prawa dostępu. Użyj funkcji HttpAddUrl, aby dodać nową rejestrację.

Aby dodać nową rejestrację przy użyciu HttpAddUrl

1. Jeśli numer portu w adresie URLPrefix zawiera rezerwacje lub rejestracje dla schematu innego niż schemat w adresie UrlPrefix, rejestracja kończy się niepowodzeniem. Protokół HTTP i HTTPS nie mogą być obsługiwane na tym samym porcie.
2. Rejestracja jest umieszczana w odpowiednim zasobniku na potrzeby rejestracji. Zasobniki są oparte na typie hosta URL zgodnie z opisem w sekcji Routingu przychodzących żądań. Poniższe kroki odnoszą się do tego zasobnika.
3. Jeśli istnieje zduplikowany wpis rejestracji, zwróć kod błędu.
4. Wybierz wpisy rezerwacji, których komponenty schematu, hosta i portu są równe tym z UrlPrefix. Z nich znajdź wpis z najdłuższym względnym URI dopasowaniem. Jeśli wpis istnieje, sprawdź uprawnienia na podstawie ACL skojarzonej z tym wpisem i zakończ z sukcesem. Jeśli wpis nie istnieje, pojawia się błąd logiczny związany z kodem ERROR_ALREADY_EXISTS.

Poniższe przykłady ilustrują proces instalowania rejestracji w bazie danych routingu. Rezerwacje 1 i 2 istnieją w bazie danych routingu.

• Rezerwacja 1: https://+:80/vroot/subdir/ dla użytkownika A i użytkownika C. Ta rezerwacja jest umieszczana w zasobniku "+".
• Rezerwacja 2: https://adatum.com:80/vroot/ dla użytkownika B. Ta rezerwacja jest umieszczana w zasobniku "Jawny host".
• Rejestracja: https://+:80/vroot/subdir/ przez użytkownika B kończy się niepowodzeniem z powodu rezerwacji 1.
• Rejestracja: https://adatum.com:80/vroot/subdir/ przez użytkownika B kończy się powodzeniem z powodu rezerwacji 2.
• Rejestracja https://adatum.com:80/vroot/subdir/ przez użytkownika C kończy się niepowodzeniem z powodu bardziej konkretnej rezerwacji 2. Silna rezerwacja z użyciem symboli wieloznacznych nie ma znaczenia w kontekście jawnej rezerwacji lub rejestracji.
• Rejestracja: https://+:80/vroot/subdir/ przez użytkownika A jest udana dzięki rezerwacji 1.
• Rejestracja: https://adatum.com:80/vroot/anotherdir/ przez użytkownika B powiodła się dzięki rezerwacji 2.

Sprawdzanie dostępu do rejestracji nie obejmuje kontroli uprawnień delegowania. Nie ma kontroli dostępu na podstawie rezerwacji (zobacz HttpRemoveUrl). Jedynym wymaganiem do usunięcia rejestracji jest to, że proces wywołujący musi być twórcą rejestracji.