Respektowanie ograniczeń klienta

Możesz pobierać korzenie i odczytywać możliwości, ale najważniejsze jest ich respektowanie. Godny zaufania serwer pozostaje w granicach wyznaczonych przez hosta. 🚧

Przed uzyskaniem dostępu do dowolnego pliku potwierdź, że jego ścieżka znajduje się w obrębie jednego z korzeni klienta. Jeśli tak nie jest, odmów zamiast wychodzić poza dozwolony obszar.

Podstępna ścieżka, taka jak ../../etc, może wyprowadzić poza korzeń. Zawsze najpierw rozwiąż ją do absolutnej, znormalizowanej ścieżki, a dopiero potem porównaj z dozwolonymi folderami.

Sprawdź, czy rozwiązana ścieżka jest względna względem korzenia. Pomocnik pathlib zgłasza wyjątek, jeśli ścieżka wychodzi poza korzeń, zapewniając jednoznaczną odpowiedź, czy można kontynuować.

Jeśli klient nie zadeklarował danej możliwości, nie wywołuj jej. Respektowanie granic oznacza zaufanie do uzgodnienia, a nie sprawdzanie funkcji, których nigdy nie zaoferowano.

Gdy korzenie są puste lub nie są obsługiwane, nie zgaduj, co znajduje się w systemie plików. Ogranicz działanie narzędzia i wyjaśnij użytkownikowi dlaczego, zamiast sięgać do przypadkowych ścieżek.

Korzenie wyznaczają zewnętrzną granicę, ale można zastosować jeszcze większe ograniczenia. Proś tylko o to, czego naprawdę wymaga zadanie — zgodnie z zasadą minimalnych uprawnień — i pozostaw resztę nietkniętą.

Respektowanie ograniczeń wykracza poza ścieżki. Szanuj również tempo i limity hosta, aby nie zasypywać go wywołaniami ani nie ignorować żądanej przez użytkownika anulacji.

Gdy nadejdzie powiadomienie list_changed dotyczące korzeni, sprawdź ponownie wszystkie ścieżki przechowywane w pamięci podręcznej. Folder dozwolony minutę temu może już znajdować się poza bieżącym zakresem użytkownika.

Jeśli żądanie wskazuje miejsce poza korzeniami, zwróć jasny błąd, który model będzie mógł odczytać. Uprzejma odmowa jest lepsza niż ciche wykonanie działania, na które użytkownik nigdy nie zezwolił.

Użytkownicy pozostawiają zainstalowane te serwery, które respektują granice. Dobre ograniczenie zakresu zmienia potężne narzędzie w bezpieczne rozwiązanie, któremu chętnie udzielają dostępu. 💛

Rozwiązujesz ścieżki, potwierdzasz, że znajdują się w obrębie korzenia, pomijasz niezadeklarowane funkcje, zachowujesz poprawne działanie zastępcze i odmawiasz pracy poza zakresem. To właśnie czyni serwer godnym zaufania. ✅