클라이언트 경계 존중하기

루트를 가져오고 기능을 읽을 수는 있지만, 진짜 역할은 이를 준수하는 것입니다. 신뢰할 수 있는 서버는 호스트가 정한 범위 안에서만 작동합니다. 🚧

파일에 접근하기 전에 해당 경로가 클라이언트의 루트 중 하나 안에 있는지 확인하세요. 그렇지 않다면 허용된 영역 밖으로 나가지 말고 거부해야 합니다.

../../etc와 같은 교묘한 경로는 루트에서 빠져나갈 수 있습니다. 허용된 폴더와 비교하기 전에 항상 경로를 절대적이고 정규화된 경로로 resolve하세요.

확인된 경로가 루트에 대해 상대적인지 테스트하세요. pathlib 도우미는 경로가 루트 밖으로 벗어나면 오류를 발생시키므로, 진행해도 되는지 명확한 예 또는 아니오로 판단할 수 있습니다.

클라이언트가 기능을 선언하지 않았다면 호출하지 마세요. 경계를 존중한다는 것은 협상을 신뢰하고, 제공된 적 없는 기능을 함부로 사용하지 않는다는 뜻입니다.

루트가 비어 있거나 지원되지 않을 때 파일 시스템을 추측하지 마세요. 임의의 경로를 가져오는 대신 도구가 수행하는 작업을 줄이고 그 이유를 사용자에게 알리세요.

루트는 바깥쪽 한계를 정하지만, 더 엄격하게 제한할 수도 있습니다. 최소 권한의 원칙에 따라 작업에 정말 필요한 것만 요청하고 나머지는 건드리지 마세요.

존중해야 할 것은 경로만이 아닙니다. 호스트의 처리 속도와 제한도 존중하여 호출을 지나치게 많이 보내거나 사용자가 요청한 취소를 무시하지 마세요.

루트의 list_changed 알림이 도착하면 캐시된 경로를 다시 확인하세요. 1분 전에는 허용되었던 폴더가 이제는 사용자의 현재 범위 밖에 있을 수 있습니다.

요청이 루트 밖을 가리키면 모델이 읽을 수 있는 명확한 오류를 반환하세요. 사용자가 승인하지 않은 작업을 조용히 수행하는 것보다 정중하게 거부하는 편이 낫습니다.

경계를 존중하는 서버를 사용자는 계속 설치해 둡니다. 적절한 범위 제한은 강력한 도구를 사용자가 안심하고 접근 권한을 부여할 수 있는 안전한 도구로 바꿉니다. 💛

경로를 확인된 형태로 변환하고, 경로가 루트 안에 있는지 확인하며, 선언되지 않은 기능은 건너뛰고, 기능을 우아하게 축소하며, 범위 밖의 작업은 거부합니다. 이것이 서버를 신뢰할 수 있게 만드는 방법입니다. ✅