AWS quick documentation change
Summary
Added new troubleshooting section for 'ACL validation errors' and updated file format/size references to point to a centralized limits page.
Security assessment
The change adds documentation about ACL (Access Control List) validation errors, which are related to authorization and permissions. This helps users troubleshoot security configuration issues with knowledge base connectors, specifically when ACL permissions are missing. However, there is no evidence this addresses a specific security vulnerability or incident; it's general troubleshooting guidance.
Diff
diff --git a/quick/latest/userguide/troubleshooting-knowledge-bases.md b/quick/latest/userguide/troubleshooting-knowledge-bases.md index 58b22b5d8..ad708f51a 100644 --- a//quick/latest/userguide/troubleshooting-knowledge-bases.md +++ b//quick/latest/userguide/troubleshooting-knowledge-bases.md @@ -7 +7 @@ -Documents don't appear in your knowledge baseRefresh job failsRefresh job completes with issuesRefresh job succeeds but no documents appearFile format issues during refreshAccess denied errors +Documents don't appear in your knowledge baseRefresh job failsRefresh job completes with issuesRefresh job succeeds but no documents appearFile format issues during refreshAccess denied errorsACL validation errors @@ -21 +21 @@ When documents you expect to see don't appear in your knowledge base, several fa - * **Unsupported file format** – Verify your documents are in supported formats: Word, Excel, PowerPoint, PDF, CSV, TXT, RTF, JSON, XML, HTML + * **Unsupported file format** – Verify your documents are in a supported format. For supported formats and size limits, see [File size and content limits](./knowledge-base-integrations.html#file-size-and-content-limits). @@ -23 +23 @@ When documents you expect to see don't appear in your knowledge base, several fa - * **File size too large** – Each file must be less than 50 MB. + * **File size too large** – Verify the file is within the size limits. For details, see [File size and content limits](./knowledge-base-integrations.html#file-size-and-content-limits). @@ -129,12 +129 @@ If a refresh job shows as successful but no documents appear in your knowledge b -Quick knowledge bases support specific file formats. Files must meet format, size, and character limit requirements. - -**Requirements:** - - * **Supported formats:** Word, Excel, PowerPoint, PDF, CSV, TXT, RTF, JSON, XML, HTML - - * **File size limit:** 50 MB per file - - * **File condition:** Not corrupted or password-protected - - - +Quick knowledge bases support specific file formats. Files must meet format, size, and character limit requirements. For the full list of supported formats and limits, see [File size and content limits](./knowledge-base-integrations.html#file-size-and-content-limits). @@ -182,0 +172,15 @@ Access denied errors typically occur due to authentication or authorization issu +## ACL validation errors + +If your sync report shows items with status **SKIPPED** and error type **VALIDATION_ERROR** with the message "File has no ACL while crawlACL is true, skipping ingestion," the app registration used by your knowledge base connector is missing the required ACL permissions. + +**To resolve:** + + 1. Verify the app registration has the correct API permissions for ACL crawling. The required permissions vary by connector. See the permissions section in your connector's setup documentation. + + 2. Confirm that admin consent has been granted for all required permissions. + + 3. Re-run a full sync after fixing permissions. + + + + @@ -189 +193 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please -Best practices for managing ACLs in knowledge bases +Monitor index storage usage