foreman/app/controllers/api/v2/users_controller.rb @ 355bce36
e1a1fa81 | Joseph Mitchell Magen | module Api
|
|
module V2
|
|||
dc38aad3 | Joseph Magen | class UsersController < V2::BaseController
|
|
355bce36 | Ohad Levy | include Foreman::Controller::UsersMixin
|
|
e1a1fa81 | Joseph Mitchell Magen | include Api::Version2
|
|
include Api::TaxonomyScope
|
|||
dc38aad3 | Joseph Magen | before_filter :find_resource, :only => %w{show update destroy}
|
|
api :GET, "/users/", "List all users."
|
|||
param :search, String, :desc => "filter results"
|
|||
param :order, String, :desc => "sort results"
|
|||
param :page, String, :desc => "paginate results"
|
|||
param :per_page, String, :desc => "number of entries per request"
|
|||
e1a1fa81 | Joseph Mitchell Magen | ||
def index
|
|||
dc38aad3 | Joseph Magen | @users = User.search_for(*search_options).paginate(paginate_options)
|
|
e1a1fa81 | Joseph Mitchell Magen | end
|
|
dc38aad3 | Joseph Magen | api :GET, "/users/:id/", "Show an user."
|
|
param :id, String, :required => true
|
|||
e1a1fa81 | Joseph Mitchell Magen | def show
|
|
dc38aad3 | Joseph Magen | @user
|
|
end
|
|||
api :POST, "/users/", "Create an user."
|
|||
# TRANSLATORS: API documentation - do not translate
|
|||
description <<-DOC
|
|||
Adds role 'Anonymous' to the user by default
|
|||
DOC
|
|||
param :user, Hash, :required => true do
|
|||
param :login, String, :required => true
|
|||
param :firstname, String, :required => false
|
|||
param :lastname, String, :required => false
|
|||
param :mail, String, :required => true
|
|||
param :admin, :bool, :required => false, :desc => "Is an admin account?"
|
|||
param :password, String, :required => true
|
|||
param :auth_source_id, Integer, :required => true
|
|||
end
|
|||
def create
|
|||
if @user.save
|
|||
process_success
|
|||
else
|
|||
process_resource_error
|
|||
end
|
|||
end
|
|||
api :PUT, "/users/:id/", "Update an user."
|
|||
# TRANSLATORS: API documentation - do not translate
|
|||
description <<-DOC
|
|||
Adds role 'Anonymous' to the user if it is not already present.
|
|||
Only admin can set admin account.
|
|||
DOC
|
|||
param :id, String, :required => true
|
|||
param :user, Hash, :required => true do
|
|||
param :login, String
|
|||
param :firstname, String, :allow_nil => true
|
|||
param :lastname, String, :allow_nil => true
|
|||
param :mail, String
|
|||
param :admin, :bool, :desc => "Is an admin account?"
|
|||
param :password, String
|
|||
e1a1fa81 | Joseph Mitchell Magen | end
|
|
dc38aad3 | Joseph Magen | def update
|
|
if @user.update_attributes(params[:user])
|
|||
355bce36 | Ohad Levy | update_sub_hostgroups_owners
|
|
dc38aad3 | Joseph Magen | process_success
|
|
else
|
|||
process_resource_error
|
|||
end
|
|||
end
|
|||
api :DELETE, "/users/:id/", "Delete an user."
|
|||
param :id, String, :required => true
|
|||
def destroy
|
|||
if @user == User.current
|
|||
deny_access "You are trying to delete your own account"
|
|||
else
|
|||
process_response @user.destroy
|
|||
end
|
|||
end
|
|||
df4c1afc | Dominic Cleal | protected
|
|
def resource_identifying_attributes
|
|||
%w(id login)
|
|||
end
|
|||
dc38aad3 | Joseph Magen | ||
df4c1afc | Dominic Cleal | end
|
|
e1a1fa81 | Joseph Mitchell Magen | end
|
|
end
|