debian-mirror-gitlab/lib/gitlab/git_access.rb

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

542 lines
14 KiB
Ruby
Raw Normal View History

2018-12-13 13:39:08 +05:30
# frozen_string_literal: true
2022-07-23 23:45:48 +05:30
# Checks a user's access to perform a git action.
# All public methods in this class return an instance of `GitlabAccessStatus`
2014-09-02 18:07:02 +05:30
module Gitlab
class GitAccess
2018-11-18 11:00:15 +05:30
include Gitlab::Utils::StrongMemoize
2020-04-08 14:13:33 +05:30
ForbiddenError = Class.new(StandardError)
2017-09-10 17:25:29 +05:30
NotFoundError = Class.new(StandardError)
2018-12-13 13:39:08 +05:30
TimeoutError = Class.new(StandardError)
2016-11-24 13:41:30 +05:30
2019-02-15 15:39:39 +05:30
# Use the magic string '_any' to indicate we do not know what the
# changes are. This is also what gitlab-shell does.
ANY = '_any'
2016-11-24 13:41:30 +05:30
ERROR_MESSAGES = {
upload: 'You are not allowed to upload code for this project.',
download: 'You are not allowed to download code from this project.',
2018-03-17 18:26:18 +05:30
auth_upload: 'You are not allowed to upload code.',
auth_download: 'You are not allowed to download code.',
deploy_key_upload: 'This deploy key does not have write access to this project.',
2017-09-10 17:25:29 +05:30
no_repo: 'A repository for this project does not exist yet.',
2021-06-08 01:23:25 +05:30
project_not_found: "The project you were looking for could not be found or you don't have permission to view it.",
2017-09-10 17:25:29 +05:30
command_not_allowed: "The command you're trying to execute is not allowed.",
upload_pack_disabled_over_http: 'Pulling over HTTP is not allowed.',
2018-03-17 18:26:18 +05:30
receive_pack_disabled_over_http: 'Pushing over HTTP is not allowed.',
read_only: 'The repository is temporarily read-only. Please try again later.',
2019-02-15 15:39:39 +05:30
cannot_push_to_read_only: "You can't push code to a read-only GitLab instance.",
push_code: 'You are not allowed to push code to this project.'
2017-08-17 22:00:37 +05:30
}.freeze
2016-11-24 13:41:30 +05:30
2018-12-13 13:39:08 +05:30
INTERNAL_TIMEOUT = 50.seconds.freeze
LOG_HEADER = <<~MESSAGE
Push operation timed out
Timing information for debugging purposes:
MESSAGE
2018-12-05 23:21:45 +05:30
DOWNLOAD_COMMANDS = %w{git-upload-pack git-upload-archive}.freeze
PUSH_COMMANDS = %w{git-receive-pack}.freeze
2016-11-24 13:41:30 +05:30
ALL_COMMANDS = DOWNLOAD_COMMANDS + PUSH_COMMANDS
2014-09-02 18:07:02 +05:30
2020-10-24 23:57:45 +05:30
attr_reader :actor, :protocol, :authentication_abilities,
2021-02-22 17:27:13 +05:30
:repository_path, :redirected_path, :auth_result_type,
2020-10-24 23:57:45 +05:30
:cmd, :changes
attr_accessor :container
2014-09-02 18:07:02 +05:30
2021-01-03 14:25:43 +05:30
def self.error_message(key)
self.ancestors.each do |cls|
return cls.const_get('ERROR_MESSAGES', false).fetch(key)
rescue NameError, KeyError
next
end
raise ArgumentError, "No error message defined for #{key}"
end
2021-02-22 17:27:13 +05:30
def initialize(actor, container, protocol, authentication_abilities:, repository_path: nil, redirected_path: nil, auth_result_type: nil)
2020-10-24 23:57:45 +05:30
@actor = actor
@container = container
@protocol = protocol
2020-04-08 14:13:33 +05:30
@authentication_abilities = Array(authentication_abilities)
2020-10-24 23:57:45 +05:30
@repository_path = repository_path
2018-03-17 18:26:18 +05:30
@redirected_path = redirected_path
2018-05-09 12:01:36 +05:30
@auth_result_type = auth_result_type
2015-04-26 12:48:37 +05:30
end
2016-09-13 17:45:13 +05:30
def check(cmd, changes)
2018-11-18 11:00:15 +05:30
@changes = changes
2020-10-24 23:57:45 +05:30
@cmd = cmd
2018-11-18 11:00:15 +05:30
2016-11-24 13:41:30 +05:30
check_protocol!
2018-03-17 18:26:18 +05:30
check_valid_actor!
2016-11-24 13:41:30 +05:30
check_active_user!
2020-10-24 23:57:45 +05:30
check_authentication_abilities!
check_command_disabled!
check_command_existence!
2018-11-20 20:47:30 +05:30
2020-10-24 23:57:45 +05:30
custom_action = check_custom_action
2018-11-20 20:47:30 +05:30
return custom_action if custom_action
2020-10-24 23:57:45 +05:30
check_db_accessibility!
check_container!
2017-08-17 22:00:37 +05:30
check_repository_existence!
2015-09-11 14:41:01 +05:30
2014-09-02 18:07:02 +05:30
case cmd
when *DOWNLOAD_COMMANDS
2017-08-17 22:00:37 +05:30
check_download_access!
2014-09-02 18:07:02 +05:30
when *PUSH_COMMANDS
2018-11-18 11:00:15 +05:30
check_push_access!
2014-09-02 18:07:02 +05:30
end
2021-04-29 21:17:54 +05:30
check_additional_conditions!
2016-11-24 13:41:30 +05:30
2020-04-08 14:13:33 +05:30
success_result
2014-09-02 18:07:02 +05:30
end
2020-10-24 23:57:45 +05:30
def logger
@logger ||= Checks::TimedLogger.new(timeout: INTERNAL_TIMEOUT, header: LOG_HEADER)
end
2022-07-23 23:45:48 +05:30
def guest_can_download?
2020-10-24 23:57:45 +05:30
Guest.can?(download_ability, container)
2015-04-26 12:48:37 +05:30
end
2020-09-03 11:15:55 +05:30
def deploy_key_can_download_code?
authentication_abilities.include?(:download_code) &&
deploy_key? &&
deploy_key.has_access_to?(container) &&
2022-07-23 23:45:48 +05:30
(project? && repository_access_level != ::Featurable::DISABLED)
2020-09-03 11:15:55 +05:30
end
2022-07-23 23:45:48 +05:30
def user_can_download?
2020-10-24 23:57:45 +05:30
authentication_abilities.include?(:download_code) &&
user_access.can_do_action?(download_ability)
end
# @return [Symbol] the name of a Declarative Policy ability to check
def download_ability
raise NotImplementedError
end
# @return [Symbol] the name of a Declarative Policy ability to check
def push_ability
raise NotImplementedError
2016-09-29 09:46:39 +05:30
end
2018-05-09 12:01:36 +05:30
def request_from_ci_build?
return false unless protocol == 'http'
auth_result_type == :build || auth_result_type == :ci
end
2016-08-24 12:49:21 +05:30
def protocol_allowed?
2022-07-23 23:45:48 +05:30
Gitlab::ProtocolAccess.allowed?(protocol, project: project)
2014-09-02 18:07:02 +05:30
end
private
2022-07-23 23:45:48 +05:30
# when accessing via the CI_JOB_TOKEN
def build_can_download_code?
authentication_abilities.include?(:build_download_code) && user_access.can_do_action?(:build_download_code)
end
def build_can_download?
build_can_download_code?
end
def deploy_token_can_download?
deploy_token?
end
# When overriding this method, be careful using super
# as deploy_token_can_download? and build_can_download?
# do not consider the download_ability in the inheriting class
# for deploy tokens and builds
def can_download?
deploy_key_can_download_code? ||
2023-03-04 22:38:38 +05:30
deploy_token_can_download? ||
build_can_download? ||
user_can_download? ||
guest_can_download?
2022-07-23 23:45:48 +05:30
end
2020-10-24 23:57:45 +05:30
def check_container!
2021-01-03 14:25:43 +05:30
# Strict nil check, to avoid any surprises with Object#present?
# which can delegate to #empty?
raise NotFoundError, not_found_message if container.nil?
2020-10-24 23:57:45 +05:30
check_project! if project?
2021-09-30 23:02:18 +05:30
add_container_moved_message!
2020-10-24 23:57:45 +05:30
end
def check_project!
2020-04-08 14:13:33 +05:30
check_project_accessibility!
end
2020-10-24 23:57:45 +05:30
def check_custom_action
# no-op: Overridden in EE
2018-11-20 20:47:30 +05:30
end
2020-04-08 14:13:33 +05:30
def check_for_console_messages
return console_messages unless key?
key_status = Gitlab::Auth::KeyStatusChecker.new(actor)
if key_status.show_console_message?
console_messages.push(key_status.console_message)
else
console_messages
end
end
def console_messages
2019-07-07 11:18:12 +05:30
[]
end
2018-03-17 18:26:18 +05:30
def check_valid_actor!
2020-04-08 14:13:33 +05:30
return unless key?
2018-03-17 18:26:18 +05:30
2022-07-16 23:28:13 +05:30
if !actor.valid?
2020-04-08 14:13:33 +05:30
raise ForbiddenError, "Your SSH key #{actor.errors[:key].first}."
2022-07-16 23:28:13 +05:30
elsif actor.expired?
raise ForbiddenError, "Your SSH key has expired."
2018-03-17 18:26:18 +05:30
end
end
2016-11-24 13:41:30 +05:30
def check_protocol!
2018-05-09 12:01:36 +05:30
return if request_from_ci_build?
2016-11-24 13:41:30 +05:30
unless protocol_allowed?
2020-04-08 14:13:33 +05:30
raise ForbiddenError, "Git access over #{protocol.upcase} is not allowed"
2016-11-24 13:41:30 +05:30
end
end
def check_active_user!
2018-10-15 14:42:47 +05:30
return unless user
unless user_access.allowed?
message = Gitlab::Auth::UserAccessDeniedReason.new(user).rejection_message
2020-04-08 14:13:33 +05:30
raise ForbiddenError, message
2016-11-24 13:41:30 +05:30
end
end
2020-10-24 23:57:45 +05:30
def check_authentication_abilities!
2018-03-17 18:26:18 +05:30
case cmd
when *DOWNLOAD_COMMANDS
unless authentication_abilities.include?(:download_code) || authentication_abilities.include?(:build_download_code)
2020-10-24 23:57:45 +05:30
raise ForbiddenError, error_message(:auth_download)
2018-03-17 18:26:18 +05:30
end
when *PUSH_COMMANDS
unless authentication_abilities.include?(:push_code)
2020-10-24 23:57:45 +05:30
raise ForbiddenError, error_message(:auth_upload)
2018-03-17 18:26:18 +05:30
end
end
end
2016-11-24 13:41:30 +05:30
def check_project_accessibility!
2021-01-03 14:25:43 +05:30
raise NotFoundError, not_found_message unless can_read_project?
2017-09-10 17:25:29 +05:30
end
2020-10-24 23:57:45 +05:30
def not_found_message
error_message(:project_not_found)
end
2021-09-30 23:02:18 +05:30
def add_container_moved_message!
2018-03-17 18:26:18 +05:30
return if redirected_path.nil?
2017-09-10 17:25:29 +05:30
2021-09-30 23:02:18 +05:30
container_moved = Checks::ContainerMoved.new(repository, user, protocol, redirected_path)
2017-09-10 17:25:29 +05:30
2021-09-30 23:02:18 +05:30
container_moved.add_message
2017-09-10 17:25:29 +05:30
end
2020-10-24 23:57:45 +05:30
def check_command_disabled!
if upload_pack?
2017-09-10 17:25:29 +05:30
check_upload_pack_disabled!
2020-10-24 23:57:45 +05:30
elsif receive_pack?
2017-09-10 17:25:29 +05:30
check_receive_pack_disabled!
end
end
def check_upload_pack_disabled!
if http? && upload_pack_disabled_over_http?
2020-10-24 23:57:45 +05:30
raise ForbiddenError, error_message(:upload_pack_disabled_over_http)
2017-09-10 17:25:29 +05:30
end
end
def check_receive_pack_disabled!
if http? && receive_pack_disabled_over_http?
2020-10-24 23:57:45 +05:30
raise ForbiddenError, error_message(:receive_pack_disabled_over_http)
2016-11-24 13:41:30 +05:30
end
end
2020-10-24 23:57:45 +05:30
def check_command_existence!
2016-11-24 13:41:30 +05:30
unless ALL_COMMANDS.include?(cmd)
2020-10-24 23:57:45 +05:30
raise ForbiddenError, error_message(:command_not_allowed)
2016-11-24 13:41:30 +05:30
end
end
2020-10-24 23:57:45 +05:30
def check_db_accessibility!
return unless receive_pack?
2018-03-17 18:26:18 +05:30
if Gitlab::Database.read_only?
2020-04-08 14:13:33 +05:30
raise ForbiddenError, push_to_read_only_message
2018-03-17 18:26:18 +05:30
end
end
2017-08-17 22:00:37 +05:30
def check_repository_existence!
2020-10-24 23:57:45 +05:30
raise NotFoundError, no_repo_message unless repository.exists?
end
def no_repo_message
error_message(:no_repo)
2014-09-02 18:07:02 +05:30
end
2015-04-26 12:48:37 +05:30
2017-08-17 22:00:37 +05:30
def check_download_access!
2022-07-23 23:45:48 +05:30
return if can_download?
raise ForbiddenError, download_forbidden_message
2015-04-26 12:48:37 +05:30
end
2020-10-24 23:57:45 +05:30
def download_forbidden_message
error_message(:download)
end
def project?
2021-01-03 14:25:43 +05:30
# Strict nil check, to avoid any surprises with Object#present?
# which can delegate to #empty?
!project.nil?
2020-10-24 23:57:45 +05:30
end
def project
container if container.is_a?(::Project)
end
2018-11-18 11:00:15 +05:30
def check_push_access!
2021-01-03 14:25:43 +05:30
if project&.repository_read_only?
2020-10-24 23:57:45 +05:30
raise ForbiddenError, error_message(:read_only)
2018-03-17 18:26:18 +05:30
end
2018-05-09 12:01:36 +05:30
if deploy_key?
2018-03-17 18:26:18 +05:30
unless deploy_key.can_push_to?(project)
2020-10-24 23:57:45 +05:30
raise ForbiddenError, error_message(:deploy_key_upload)
2018-03-17 18:26:18 +05:30
end
2017-08-17 22:00:37 +05:30
elsif user
2018-03-17 18:26:18 +05:30
# User access is verified in check_change_access!
2015-04-26 12:48:37 +05:30
else
2020-10-24 23:57:45 +05:30
raise ForbiddenError, error_message(:upload)
2015-04-26 12:48:37 +05:30
end
2017-08-17 22:00:37 +05:30
2018-11-18 11:00:15 +05:30
check_change_access!
2015-04-26 12:48:37 +05:30
end
2020-10-24 23:57:45 +05:30
def user_can_push?
user_access.can_do_action?(push_ability)
end
2018-11-18 11:00:15 +05:30
def check_change_access!
2019-02-15 15:39:39 +05:30
if changes == ANY
2021-03-11 19:13:27 +05:30
can_push = deploy_key? ||
2023-03-04 22:38:38 +05:30
user_can_push? ||
2020-10-24 23:57:45 +05:30
project&.any_branch_allows_collaboration?(user_access.user)
2019-02-15 15:39:39 +05:30
unless can_push
2020-10-24 23:57:45 +05:30
raise ForbiddenError, error_message(:push_code)
2019-02-15 15:39:39 +05:30
end
else
2021-09-04 01:27:46 +05:30
check_access!
2016-11-24 13:41:30 +05:30
end
end
2021-09-04 01:27:46 +05:30
def check_access!
Checks::ChangesAccess.new(
changes_list.changes,
2017-08-17 22:00:37 +05:30
user_access: user_access,
project: project,
2018-12-13 13:39:08 +05:30
protocol: protocol,
logger: logger
2020-10-24 23:57:45 +05:30
).validate!
2018-12-13 13:39:08 +05:30
rescue Checks::TimedLogger::TimeoutError
raise TimeoutError, logger.full_message
2017-08-17 22:00:37 +05:30
end
def deploy_key
actor if deploy_key?
end
def deploy_key?
2023-01-10 11:22:00 +05:30
actor.is_a?(DeployKey) && !Gitlab::ExternalAuthorization.enabled?
2017-08-17 22:00:37 +05:30
end
2018-05-09 12:01:36 +05:30
def deploy_token
actor if deploy_token?
end
def deploy_token?
2023-01-10 11:22:00 +05:30
actor.is_a?(DeployToken) && !Gitlab::ExternalAuthorization.enabled?
2018-05-09 12:01:36 +05:30
end
2017-09-10 17:25:29 +05:30
def ci?
actor == :ci
end
2020-04-08 14:13:33 +05:30
def key?
actor.is_a?(Key)
end
2017-08-17 22:00:37 +05:30
def can_read_project?
2017-09-10 17:25:29 +05:30
if deploy_key?
2017-08-17 22:00:37 +05:30
deploy_key.has_access_to?(project)
2018-05-09 12:01:36 +05:30
elsif deploy_token?
deploy_token.has_access_to?(project)
2017-08-17 22:00:37 +05:30
elsif user
user.can?(:read_project, project)
2017-09-10 17:25:29 +05:30
elsif ci?
2022-11-25 23:54:43 +05:30
false
2017-08-17 22:00:37 +05:30
end || Guest.can?(:read_project, project)
end
2017-09-10 17:25:29 +05:30
def http?
protocol == 'http'
end
2021-02-22 17:27:13 +05:30
def ssh?
protocol == 'ssh'
end
2020-10-24 23:57:45 +05:30
def upload_pack?
cmd == 'git-upload-pack'
2017-09-10 17:25:29 +05:30
end
2020-10-24 23:57:45 +05:30
def receive_pack?
cmd == 'git-receive-pack'
2017-09-10 17:25:29 +05:30
end
def upload_pack_disabled_over_http?
!Gitlab.config.gitlab_shell.upload_pack
end
def receive_pack_disabled_over_http?
!Gitlab.config.gitlab_shell.receive_pack
end
2015-04-26 12:48:37 +05:30
protected
2020-10-24 23:57:45 +05:30
def error_message(key)
2021-01-03 14:25:43 +05:30
self.class.error_message(key)
2020-10-24 23:57:45 +05:30
end
2020-04-08 14:13:33 +05:30
def success_result
::Gitlab::GitAccessResult::Success.new(console_messages: check_for_console_messages)
2019-07-31 22:56:46 +05:30
end
2018-11-18 11:00:15 +05:30
def changes_list
2019-02-15 15:39:39 +05:30
@changes_list ||= Gitlab::ChangesList.new(changes == ANY ? [] : changes)
2018-11-18 11:00:15 +05:30
end
2016-08-24 12:49:21 +05:30
def user
2020-10-24 23:57:45 +05:30
strong_memoize(:user) do
2016-08-24 12:49:21 +05:30
case actor
when User
actor
2018-05-09 12:01:36 +05:30
when DeployKey
nil
2016-08-24 12:49:21 +05:30
when Key
2018-05-09 12:01:36 +05:30
actor.user
2016-08-24 12:49:21 +05:30
end
2020-10-24 23:57:45 +05:30
end
2016-08-24 12:49:21 +05:30
end
2017-09-10 17:25:29 +05:30
def user_access
@user_access ||= if ci?
CiAccess.new
2018-10-15 14:42:47 +05:30
elsif user && request_from_ci_build?
2020-10-24 23:57:45 +05:30
BuildAccess.new(user, container: container)
2021-03-11 19:13:27 +05:30
elsif deploy_key?
2021-02-22 17:27:13 +05:30
DeployKeyAccess.new(deploy_key, container: container)
2017-09-10 17:25:29 +05:30
else
2020-10-24 23:57:45 +05:30
UserAccess.new(user, container: container)
2017-09-10 17:25:29 +05:30
end
2015-04-26 12:48:37 +05:30
end
2018-03-17 18:26:18 +05:30
def push_to_read_only_message
2020-10-24 23:57:45 +05:30
error_message(:cannot_push_to_read_only)
2018-03-17 18:26:18 +05:30
end
def repository
2020-04-22 19:07:51 +05:30
container&.repository
end
def check_size_before_push!
if check_size_limit? && size_checker.above_size_limit?
raise ForbiddenError, size_checker.error_message.push_error
end
end
def check_push_size!
return unless check_size_limit?
# Use #check_repository_disk_size to get correct push size whenever a lot of changes
# gets pushed at the same time containing the same blobs. This is only
# doable if GIT_OBJECT_DIRECTORY_RELATIVE env var is set and happens
# when git push comes from CLI (not via UI and API).
#
# Fallback to determining push size using the changes_list so we can still
# determine the push size if env var isn't set (e.g. changes are made
# via UI and API).
if check_quarantine_size?
check_repository_disk_size
else
check_changes_size
end
end
def check_quarantine_size?
git_env = ::Gitlab::Git::HookEnv.all(repository.gl_repository)
git_env['GIT_OBJECT_DIRECTORY_RELATIVE'].present?
end
def check_repository_disk_size
check_size_against_limit(repository.object_directory_size)
end
def check_changes_size
2021-10-27 15:23:28 +05:30
revs = ['--not', '--all', '--not']
revs += changes_list.map { |change| change[:newrev] }
2020-04-22 19:07:51 +05:30
2021-10-27 15:23:28 +05:30
changes_size = repository.blobs(revs).sum(&:size)
2021-09-30 23:02:18 +05:30
check_size_against_limit(changes_size)
2020-04-22 19:07:51 +05:30
end
def check_size_against_limit(size)
if size_checker.changes_will_exceed_size_limit?(size)
raise ForbiddenError, size_checker.error_message.new_changes_error
end
end
def check_size_limit?
strong_memoize(:check_size_limit) do
changes_list.any? { |change| !Gitlab::Git.blank_ref?(change[:newrev]) }
end
end
def size_checker
container.repository_size_checker
2018-03-17 18:26:18 +05:30
end
2021-04-29 21:17:54 +05:30
# overriden in EE
def check_additional_conditions!
end
2022-07-23 23:45:48 +05:30
def repository_access_level
project&.repository_access_level
end
2014-09-02 18:07:02 +05:30
end
end
2019-12-04 20:38:33 +05:30
2021-06-08 01:23:25 +05:30
Gitlab::GitAccess.prepend_mod_with('Gitlab::GitAccess')