Module: Oktakit::Client::Users

Included in:

Oktakit::Client

Defined in:

lib/oktakit/client/users.rb

Instance Method Summary

• #activate_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Activate User.

• #change_password(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Change Password.

• #change_recovery_question(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Change Recovery Question.

• #create_user(options = {}) ⇒ Hash<Sawyer::Resource>

  Create User.

• #deactivate_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Deactivate User.

• #expire_password(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Expire Password.

• #forgot_password(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Forgot Password.

• #get_assigned_app_links(id, options = {}) ⇒ Array<Sawyer::Resource>

  Get Assigned App Links.

• #get_member_groups(id, options = {}) ⇒ Array<Sawyer::Resource>

  Get Member Groups.

• #get_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Get User.

• #list_users(options = {}) ⇒ Array<Sawyer::Resource>

  List Users.

• #reset_factors(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Reset Factors.

• #reset_password(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Reset Password.

• #suspend_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Suspend User.

• #unlock_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Unlock User.

• #unsuspend_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Unsuspend User.

• #update_profile(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Update Profile.

• #update_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

  Update User.

Instance Method Details

#activate_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

Activate User

Examples:

Oktakit.activate_user('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Returns empty object by default. If sendEmail is false, a user activation link.

See Also:

• http://developer.okta.com/docs/api/resources/users.html#activate-user

# File 'lib/oktakit/client/users.rb', line 125

def activate_user(id, options = {})
  post("/users/#{id}/lifecycle/activate", options)
end

#change_password(id, options = {}) ⇒ Hash<Sawyer::Resource>

Change Password

Examples:

Oktakit.change_password('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Credentials of the user

See Also:

• http://developer.okta.com/docs/api/resources/users.html#change-password

# File 'lib/oktakit/client/users.rb', line 269

def change_password(id, options = {})
  post("/users/#{id}/credentials/change_password", options)
end

#change_recovery_question(id, options = {}) ⇒ Hash<Sawyer::Resource>

Change Recovery Question

Examples:

Oktakit.change_recovery_question('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Credentials of the user

See Also:

• http://developer.okta.com/docs/api/resources/users.html#change-recovery-question

# File 'lib/oktakit/client/users.rb', line 285

def change_recovery_question(id, options = {})
  post("/users/#{id}/credentials/change_recovery_question", options)
end

#create_user(options = {}) ⇒ Hash<Sawyer::Resource>

Create User

Examples:

Oktakit.create_user

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Returns the created User.

See Also:

• http://developer.okta.com/docs/api/resources/users.html#create-user

# File 'lib/oktakit/client/users.rb', line 15

def create_user(options = {})
  post('/users', options)
end

#deactivate_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

Deactivate User

Examples:

Oktakit.deactivate_user('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Returns an empty object.

See Also:

• http://developer.okta.com/docs/api/resources/users.html#deactivate-user

# File 'lib/oktakit/client/users.rb', line 141

def deactivate_user(id, options = {})
  post("/users/#{id}/lifecycle/deactivate", options)
end

#expire_password(id, options = {}) ⇒ Hash<Sawyer::Resource>

Expire Password

Examples:

Oktakit.expire_password('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Returns the user by default. If tempPassword is true, a temporary password.

See Also:

• http://developer.okta.com/docs/api/resources/users.html#expire-password

# File 'lib/oktakit/client/users.rb', line 221

def expire_password(id, options = {})
  post("/users/#{id}/lifecycle/expire_password", options)
end

#forgot_password(id, options = {}) ⇒ Hash<Sawyer::Resource>

Forgot Password

Examples:

Oktakit.forgot_password('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Returns an empty object by default. If sendEmail is false a password reset link

See Also:

• http://developer.okta.com/docs/api/resources/users.html#forgot-password

# File 'lib/oktakit/client/users.rb', line 253

def forgot_password(id, options = {})
  post("/users/#{id}/credentials/forgot_password", options)
end

#get_assigned_app_links(id, options = {}) ⇒ Array<Sawyer::Resource>

Get Assigned App Links

Examples:

Oktakit.get_assigned_app_links('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Array<Sawyer::Resource>) —

  Array of App Links

See Also:

• http://developer.okta.com/docs/api/resources/users.html#get-assigned-app-links

# File 'lib/oktakit/client/users.rb', line 93

def get_assigned_app_links(id, options = {})
  get("/users/#{id}/appLinks", options)
end

#get_member_groups(id, options = {}) ⇒ Array<Sawyer::Resource>

Get Member Groups

Examples:

Oktakit.get_member_groups('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Array<Sawyer::Resource>) —

  Array of Groups

See Also:

• http://developer.okta.com/docs/api/resources/users.html#get-member-groups

# File 'lib/oktakit/client/users.rb', line 109

def get_member_groups(id, options = {})
  get("/users/#{id}/groups", options)
end

#get_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

Get User

Examples:

Oktakit.get_user('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Fetched User

See Also:

• http://developer.okta.com/docs/api/resources/users.html#get-user

# File 'lib/oktakit/client/users.rb', line 31

def get_user(id, options = {})
  get("/users/#{id}", options)
end

#list_users(options = {}) ⇒ Array<Sawyer::Resource>

List Users

Examples:

Oktakit.list_users

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Array<Sawyer::Resource>) —

  Array of User

See Also:

• http://developer.okta.com/docs/api/resources/users.html#list-users

# File 'lib/oktakit/client/users.rb', line 46

def list_users(options = {})
  get('/users', options)
end

#reset_factors(id, options = {}) ⇒ Hash<Sawyer::Resource>

Reset Factors

Examples:

Oktakit.reset_factors('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Returns an empty object by default.

See Also:

• http://developer.okta.com/docs/api/resources/users.html#reset-factors

# File 'lib/oktakit/client/users.rb', line 237

def reset_factors(id, options = {})
  post("/users/#{id}/lifecycle/reset_factors", options)
end

#reset_password(id, options = {}) ⇒ Hash<Sawyer::Resource>

Reset Password

Examples:

Oktakit.reset_password('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Returns an empty object by default. If sendEmail is false a password reset link

See Also:

• http://developer.okta.com/docs/api/resources/users.html#reset-password

# File 'lib/oktakit/client/users.rb', line 205

def reset_password(id, options = {})
  post("/users/#{id}/lifecycle/reset_password", options)
end

#suspend_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

Suspend User

Examples:

Oktakit.suspend_user('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Returns an empty object.

See Also:

• http://developer.okta.com/docs/api/resources/users.html#suspend-user

# File 'lib/oktakit/client/users.rb', line 157

def suspend_user(id, options = {})
  post("/users/#{id}/lifecycle/suspend", options)
end

#unlock_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

Unlock User

Examples:

Oktakit.unlock_user('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Returns an empty object

See Also:

• http://developer.okta.com/docs/api/resources/users.html#unlock-user

# File 'lib/oktakit/client/users.rb', line 189

def unlock_user(id, options = {})
  post("/users/#{id}/lifecycle/unlock", options)
end

#unsuspend_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

Unsuspend User

Examples:

Oktakit.unsuspend_user('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Returns an empty object. Returns an empty object.

See Also:

• http://developer.okta.com/docs/api/resources/users.html#unsuspend-user

# File 'lib/oktakit/client/users.rb', line 173

def unsuspend_user(id, options = {})
  post("/users/#{id}/lifecycle/unsuspend", options)
end

#update_profile(id, options = {}) ⇒ Hash<Sawyer::Resource>

Update Profile

Examples:

Oktakit.update_profile('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Updated User

See Also:

• http://developer.okta.com/docs/api/resources/users.html#update-profile

# File 'lib/oktakit/client/users.rb', line 78

def update_profile(id, options = {})
  post("/users/#{id}", options)
end

#update_user(id, options = {}) ⇒ Hash<Sawyer::Resource>

Update User

Examples:

Oktakit.update_user('id')

Parameters:

• options (:query) (defaults to: {}) —

  Hash

  Optional. Query params for request

• options (:headers) (defaults to: {}) —

  Hash

  Optional. Header params for the request.

• options (:accept) (defaults to: {}) —

  String

  Optional. The content type to accept. Default application/json

• options (:content_type) (defaults to: {}) —

  String

  Optional. The content type for the request. Default application/json

• options (Hash) (defaults to: {}) —

  Optional. Body params for request.

Returns:

• (Hash<Sawyer::Resource>) —

  Updated User

See Also:

• http://developer.okta.com/docs/api/resources/users.html#update-user

# File 'lib/oktakit/client/users.rb', line 62

def update_user(id, options = {})
  put("/users/#{id}", options)
end