2013-05-14 08:33:31 -04:00
|
|
|
module API
|
2012-06-27 07:32:56 -04:00
|
|
|
module APIHelpers
|
2013-03-28 14:37:44 -04:00
|
|
|
PRIVATE_TOKEN_HEADER = "HTTP_PRIVATE_TOKEN"
|
|
|
|
PRIVATE_TOKEN_PARAM = :private_token
|
|
|
|
SUDO_HEADER ="HTTP_SUDO"
|
|
|
|
SUDO_PARAM = :sudo
|
|
|
|
|
2012-06-27 07:32:56 -04:00
|
|
|
def current_user
|
2013-03-28 14:37:44 -04:00
|
|
|
@current_user ||= User.find_by_authentication_token(params[PRIVATE_TOKEN_PARAM] || env[PRIVATE_TOKEN_HEADER])
|
|
|
|
identifier = sudo_identifier()
|
|
|
|
# If the sudo is the current user do nothing
|
|
|
|
if (identifier && !(@current_user.id == identifier || @current_user.username == identifier))
|
|
|
|
render_api_error!('403 Forbidden: Must be admin to use sudo', 403) unless @current_user.is_admin?
|
|
|
|
begin
|
2013-06-28 08:59:05 -04:00
|
|
|
@current_user = User.by_username_or_id(identifier)
|
2013-03-28 14:37:44 -04:00
|
|
|
rescue => ex
|
|
|
|
not_found!("No user id or username for: #{identifier}")
|
|
|
|
end
|
2013-06-28 08:59:05 -04:00
|
|
|
not_found!("No user id or username for: #{identifier}") if current_user.nil?
|
2013-03-28 14:37:44 -04:00
|
|
|
end
|
|
|
|
@current_user
|
|
|
|
end
|
|
|
|
|
|
|
|
def sudo_identifier()
|
2013-06-28 08:59:05 -04:00
|
|
|
identifier ||= params[SUDO_PARAM] ||= env[SUDO_HEADER]
|
|
|
|
# Regex for integers
|
2013-03-28 14:37:44 -04:00
|
|
|
if (!!(identifier =~ /^[0-9]+$/))
|
|
|
|
identifier.to_i
|
|
|
|
else
|
|
|
|
identifier
|
|
|
|
end
|
2012-06-27 07:32:56 -04:00
|
|
|
end
|
|
|
|
|
2012-07-06 09:08:17 -04:00
|
|
|
def user_project
|
2013-06-27 17:49:26 -04:00
|
|
|
@project ||= find_project(params[:id])
|
2012-12-12 05:54:28 -05:00
|
|
|
@project || not_found!
|
|
|
|
end
|
|
|
|
|
2013-06-27 17:49:26 -04:00
|
|
|
def find_project(id)
|
|
|
|
project = Project.find_by_id(id) || Project.find_with_namespace(id)
|
2012-12-12 05:54:28 -05:00
|
|
|
|
|
|
|
if project && can?(current_user, :read_project, project)
|
|
|
|
project
|
2012-07-25 08:24:28 -04:00
|
|
|
else
|
2012-12-12 05:54:28 -05:00
|
|
|
nil
|
2012-07-25 08:24:28 -04:00
|
|
|
end
|
2012-07-06 09:08:17 -04:00
|
|
|
end
|
|
|
|
|
2012-09-03 07:46:29 -04:00
|
|
|
def paginate(object)
|
|
|
|
object.page(params[:page]).per(params[:per_page].to_i)
|
|
|
|
end
|
|
|
|
|
2012-06-27 07:32:56 -04:00
|
|
|
def authenticate!
|
2012-09-10 03:41:46 -04:00
|
|
|
unauthorized! unless current_user
|
2012-06-27 07:32:56 -04:00
|
|
|
end
|
2012-09-10 02:06:11 -04:00
|
|
|
|
2012-10-02 05:46:01 -04:00
|
|
|
def authenticated_as_admin!
|
|
|
|
forbidden! unless current_user.is_admin?
|
|
|
|
end
|
|
|
|
|
2012-09-10 02:06:11 -04:00
|
|
|
def authorize! action, subject
|
|
|
|
unless abilities.allowed?(current_user, action, subject)
|
2012-09-10 03:41:46 -04:00
|
|
|
forbidden!
|
2012-09-10 02:06:11 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2013-09-29 09:04:57 -04:00
|
|
|
def authorize_admin_project
|
|
|
|
authorize! :admin_project, user_project
|
|
|
|
end
|
|
|
|
|
2012-12-12 05:54:28 -05:00
|
|
|
def can?(object, action, subject)
|
|
|
|
abilities.allowed?(object, action, subject)
|
|
|
|
end
|
|
|
|
|
2013-02-27 11:50:30 -05:00
|
|
|
# Checks the occurrences of required attributes, each attribute must be present in the params hash
|
|
|
|
# or a Bad Request error is invoked.
|
|
|
|
#
|
|
|
|
# Parameters:
|
|
|
|
# keys (required) - A hash consisting of keys that must be present
|
|
|
|
def required_attributes!(keys)
|
|
|
|
keys.each do |key|
|
|
|
|
bad_request!(key) unless params[key].present?
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2012-09-16 13:08:57 -04:00
|
|
|
def attributes_for_keys(keys)
|
2012-09-16 12:51:04 -04:00
|
|
|
attrs = {}
|
|
|
|
keys.each do |key|
|
2013-07-31 06:52:23 -04:00
|
|
|
attrs[key] = params[key] if params[key].present? or (params.has_key?(key) and params[key] == false)
|
2012-09-16 12:51:04 -04:00
|
|
|
end
|
|
|
|
attrs
|
|
|
|
end
|
|
|
|
|
2012-09-10 03:41:46 -04:00
|
|
|
# error helpers
|
|
|
|
|
|
|
|
def forbidden!
|
2012-09-10 06:49:00 -04:00
|
|
|
render_api_error!('403 Forbidden', 403)
|
2012-09-10 03:41:46 -04:00
|
|
|
end
|
|
|
|
|
2013-02-13 09:48:52 -05:00
|
|
|
def bad_request!(attribute)
|
|
|
|
message = ["400 (Bad request)"]
|
|
|
|
message << "\"" + attribute.to_s + "\" not given"
|
|
|
|
render_api_error!(message.join(' '), 400)
|
|
|
|
end
|
|
|
|
|
2012-09-10 03:41:46 -04:00
|
|
|
def not_found!(resource = nil)
|
|
|
|
message = ["404"]
|
|
|
|
message << resource if resource
|
|
|
|
message << "Not Found"
|
2012-09-10 06:49:00 -04:00
|
|
|
render_api_error!(message.join(' '), 404)
|
2012-09-10 03:41:46 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
def unauthorized!
|
2012-09-10 06:49:00 -04:00
|
|
|
render_api_error!('401 Unauthorized', 401)
|
2012-09-10 03:41:46 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
def not_allowed!
|
2012-09-10 06:49:00 -04:00
|
|
|
render_api_error!('Method Not Allowed', 405)
|
|
|
|
end
|
|
|
|
|
|
|
|
def render_api_error!(message, status)
|
|
|
|
error!({'message' => message}, status)
|
2012-09-10 03:41:46 -04:00
|
|
|
end
|
|
|
|
|
2012-09-21 06:22:30 -04:00
|
|
|
private
|
2012-09-10 02:06:11 -04:00
|
|
|
|
|
|
|
def abilities
|
|
|
|
@abilities ||= begin
|
2013-06-28 08:59:05 -04:00
|
|
|
abilities = Six.new
|
|
|
|
abilities << Ability
|
|
|
|
abilities
|
|
|
|
end
|
2012-09-10 02:06:11 -04:00
|
|
|
end
|
2012-06-27 07:32:56 -04:00
|
|
|
end
|
|
|
|
end
|