2017-02-06 18:38:17 +00:00
|
|
|
module API
|
|
|
|
module V3
|
|
|
|
class Users < Grape::API
|
|
|
|
include PaginationParams
|
|
|
|
|
|
|
|
before do
|
|
|
|
allow_access_with_scope :read_user if request.get?
|
|
|
|
authenticate!
|
|
|
|
end
|
|
|
|
|
|
|
|
resource :users, requirements: { uid: /[0-9]*/, id: /[0-9]*/ } do
|
|
|
|
desc 'Get the SSH keys of a specified user. Available only for admins.' do
|
|
|
|
success ::API::Entities::SSHKey
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
requires :id, type: Integer, desc: 'The ID of the user'
|
|
|
|
use :pagination
|
|
|
|
end
|
|
|
|
get ':id/keys' do
|
|
|
|
authenticated_as_admin!
|
|
|
|
|
|
|
|
user = User.find_by(id: params[:id])
|
|
|
|
not_found!('User') unless user
|
|
|
|
|
|
|
|
present paginate(user.keys), with: ::API::Entities::SSHKey
|
|
|
|
end
|
|
|
|
|
|
|
|
desc 'Get the emails addresses of a specified user. Available only for admins.' do
|
|
|
|
success ::API::Entities::Email
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
requires :id, type: Integer, desc: 'The ID of the user'
|
|
|
|
use :pagination
|
|
|
|
end
|
|
|
|
get ':id/emails' do
|
|
|
|
authenticated_as_admin!
|
|
|
|
user = User.find_by(id: params[:id])
|
|
|
|
not_found!('User') unless user
|
|
|
|
|
|
|
|
present user.emails, with: ::API::Entities::Email
|
|
|
|
end
|
2017-02-20 12:31:11 +00:00
|
|
|
|
|
|
|
desc 'Block a user. Available only for admins.'
|
|
|
|
params do
|
|
|
|
requires :id, type: Integer, desc: 'The ID of the user'
|
|
|
|
end
|
|
|
|
put ':id/block' do
|
|
|
|
authenticated_as_admin!
|
|
|
|
user = User.find_by(id: params[:id])
|
|
|
|
not_found!('User') unless user
|
|
|
|
|
|
|
|
if !user.ldap_blocked?
|
|
|
|
user.block
|
|
|
|
else
|
|
|
|
forbidden!('LDAP blocked users cannot be modified by the API')
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
desc 'Unblock a user. Available only for admins.'
|
|
|
|
params do
|
|
|
|
requires :id, type: Integer, desc: 'The ID of the user'
|
|
|
|
end
|
|
|
|
put ':id/unblock' do
|
|
|
|
authenticated_as_admin!
|
|
|
|
user = User.find_by(id: params[:id])
|
|
|
|
not_found!('User') unless user
|
|
|
|
|
|
|
|
if user.ldap_blocked?
|
|
|
|
forbidden!('LDAP blocked users cannot be unblocked by the API')
|
|
|
|
else
|
|
|
|
user.activate
|
|
|
|
end
|
|
|
|
end
|
2017-02-20 14:35:05 +00:00
|
|
|
|
|
|
|
desc 'Get the contribution events of a specified user' do
|
|
|
|
detail 'This feature was introduced in GitLab 8.13.'
|
|
|
|
success ::API::V3::Entities::Event
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
requires :id, type: Integer, desc: 'The ID of the user'
|
|
|
|
use :pagination
|
|
|
|
end
|
|
|
|
get ':id/events' do
|
|
|
|
user = User.find_by(id: params[:id])
|
|
|
|
not_found!('User') unless user
|
|
|
|
|
|
|
|
events = user.events.
|
|
|
|
merge(ProjectsFinder.new.execute(current_user)).
|
|
|
|
references(:project).
|
|
|
|
with_associations.
|
|
|
|
recent
|
|
|
|
|
|
|
|
present paginate(events), with: ::API::V3::Entities::Event
|
|
|
|
end
|
2017-02-20 19:32:44 +00:00
|
|
|
|
|
|
|
desc 'Delete an existing SSH key from a specified user. Available only for admins.' do
|
|
|
|
success ::API::Entities::SSHKey
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
requires :id, type: Integer, desc: 'The ID of the user'
|
|
|
|
requires :key_id, type: Integer, desc: 'The ID of the SSH key'
|
|
|
|
end
|
|
|
|
delete ':id/keys/:key_id' do
|
|
|
|
authenticated_as_admin!
|
|
|
|
|
|
|
|
user = User.find_by(id: params[:id])
|
|
|
|
not_found!('User') unless user
|
|
|
|
|
|
|
|
key = user.keys.find_by(id: params[:key_id])
|
|
|
|
not_found!('Key') unless key
|
|
|
|
|
|
|
|
present key.destroy, with: ::API::Entities::SSHKey
|
|
|
|
end
|
2017-02-06 18:38:17 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
resource :user do
|
|
|
|
desc "Get the currently authenticated user's SSH keys" do
|
|
|
|
success ::API::Entities::SSHKey
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
use :pagination
|
|
|
|
end
|
|
|
|
get "keys" do
|
|
|
|
present current_user.keys, with: ::API::Entities::SSHKey
|
|
|
|
end
|
|
|
|
|
|
|
|
desc "Get the currently authenticated user's email addresses" do
|
|
|
|
success ::API::Entities::Email
|
|
|
|
end
|
|
|
|
get "emails" do
|
|
|
|
present current_user.emails, with: ::API::Entities::Email
|
|
|
|
end
|
2017-02-20 19:32:44 +00:00
|
|
|
|
|
|
|
desc 'Delete an SSH key from the currently authenticated user' do
|
|
|
|
success ::API::Entities::SSHKey
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
requires :key_id, type: Integer, desc: 'The ID of the SSH key'
|
|
|
|
end
|
|
|
|
delete "keys/:key_id" do
|
|
|
|
key = current_user.keys.find_by(id: params[:key_id])
|
|
|
|
not_found!('Key') unless key
|
|
|
|
|
|
|
|
present key.destroy, with: ::API::Entities::SSHKey
|
|
|
|
end
|
2017-02-06 18:38:17 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|