diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2023-05-17 19:05:49 +0300 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2023-05-17 19:05:49 +0300 |
commit | 43a25d93ebdabea52f99b05e15b06250cd8f07d7 (patch) | |
tree | dceebdc68925362117480a5d672bcff122fb625b /doc/security/user_file_uploads.md | |
parent | 20c84b99005abd1c82101dfeff264ac50d2df211 (diff) |
Add latest changes from gitlab-org/gitlab@16-0-stable-eev16.0.0-rc42
Diffstat (limited to 'doc/security/user_file_uploads.md')
-rw-r--r-- | doc/security/user_file_uploads.md | 59 |
1 files changed, 47 insertions, 12 deletions
diff --git a/doc/security/user_file_uploads.md b/doc/security/user_file_uploads.md index db2948a8bd5..498245c4efb 100644 --- a/doc/security/user_file_uploads.md +++ b/doc/security/user_file_uploads.md @@ -7,20 +7,27 @@ info: To determine the technical writer assigned to the Stage/Group associated w # User file uploads **(FREE)** +Users can upload files to: + +- Issues or merge requests in a project. +- Epics in a group. + +GitLab generates direct URLs for these images with a random 32-character ID to prevent unauthorized users from guessing the URLs. This randomization offers some security for images containing sensitive information. + +## Access control for uploaded files + > - Enforced authorization checks [introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/80117) in GitLab 14.8 [with a flag](../administration/feature_flags.md) named `enforce_auth_checks_on_uploads`. Disabled by default. > - Enforced authorization checks became [generally available](https://gitlab.com/gitlab-org/gitlab/-/issues/352291) in GitLab 15.3. Feature flag `enforce_auth_checks_on_uploads` removed. > - Project settings in the user interface [introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/88567) in GitLab 15.3. -In private or internal projects, GitLab restricts access to uploaded files (such as PDFs) -to authenticated users only. By default, image files are not subject to the same -restriction, and unauthenticated users can use the URL to view the -file. If you enable authorization checks for all media files, images -receive the same protection and are viewable only by authenticated users. +Access to non-image files uploaded to: -Users can upload files to issues, merge requests, or comments in a project. Direct URLs -to these images in GitLab contain a random 32-character ID to help prevent -unauthorized users from guessing image URLs. This randomization provides some protection -if an image contains sensitive information. +- Issues or merge requests is determined by the project visibility. +- Group epics is determined by the group visibility. + +For public projects or groups, anyone can access these files through the direct attachment URL, even if the issue, merge request, or epic is confidential. +For private and internal projects, GitLab ensures only authenticated project members can access non-image file uploads, such as PDFs. +By default, image files do not have the same restriction, and anyone can view them using the URL. To protect image files, [enable authorization checks for all media files](#enable-authorization-checks-for-all-media-files), making them viewable only by authenticated users. Authentication checks for images can cause display issues in the body of notification emails. Emails are frequently read from clients (such as Outlook, Apple Mail, or your mobile device) @@ -29,8 +36,9 @@ the client is not authorized to GitLab. ## Enable authorization checks for all media files -Non-image attachments (including PDFs) always require authentication to be viewed. -You can use this setting to extend this protection to image files. +Only authenticated project members can view non-image attachments (including PDFs) in private and internal projects. + +To apply authentication requirements to image files in private or internal projects: Prerequisite: @@ -43,7 +51,34 @@ To configure authentication settings for all media files: 1. On the left sidebar, select **Settings > General**. 1. Expand **Visibility, project features, permissions**. 1. Scroll to **Project visibility** and select **Require authentication to view media files**. - You cannot select this option for projects with **Public** visibility. + +NOTE: +You cannot select this option for public projects. + +## Delete uploaded files + +> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/92791) in GitLab 15.3. + +You should delete an uploaded file when that file contains sensitive or confidential information. When you have deleted that file, users cannot access the file and the direct URL returns a 404 error. + +Project Owners and Maintainers can use the [interactive GraphiQL explorer](../api/graphql/index.md#graphiql) to access a [GraphQL endpoint](../api/graphql/reference/index.md#mutationuploaddelete) and delete an uploaded file. + +For example: + +```graphql +mutation{ + uploadDelete(input: { projectPath: "<path/to/project>", secret: "<32-character-id>" , filename: "<filename>" }) { + upload { + id + size + path + } + errors + } +} +``` + +Project members that do not have the Owner or Maintainer role cannot access this GraphQL endpoint. <!-- ## Troubleshooting |