Module: Zanshin::SDK::OrganizationMembers

Included in:
Client
Defined in:
lib/zanshin/organization_members.rb

Overview

Zanshin SDK Organization Members

Instance Method Summary collapse

Instance Method Details

#create_organization_members_invite(organization_id, email, roles = nil) ⇒ Object

Create organization member invite [#reference](api.zanshin.tenchisecurity.com/#operation/createOrgamizationInvite)

Parameters:

  • organization_id (UUID) —

    of the organization

  • email (String) —

    of the new member

  • roles ('ADMIN') (defaults to: nil) —

    of the new member

Returns:

  • a Object representing the organization member invite



120
121
122
123
124
125
126
127
128
 
# File 'lib/zanshin/organization_members.rb', line 120

def create_organization_members_invite(organization_id, email, roles = nil)
  body = {
    'email' => email,
    'roles' => [roles].compact
  }
  @http.request('POST',
                "/organizations/#{validate_uuid(organization_id)}/invites",
                body)
end

#delete_organization_member(organization_id, member_id) ⇒ Object

Delete organization member [#reference](api.zanshin.tenchisecurity.com/#operation/removeOrganizationMemberById)

Parameters:

  • organization_id (UUID) —

    of the organization

  • member_id (UUID) —

    of the member

Returns:

  • a Boolean with result



61
62
63
64
 
# File 'lib/zanshin/organization_members.rb', line 61

def delete_organization_member(organization_id, member_id)
  @http.request('DELETE',
                "/organizations/#{validate_uuid(organization_id)}/members/#{validate_uuid(member_id)}")
end

#delete_organization_member_invite(organization_id, email) ⇒ Object

Delete organization member invite [#reference](api.zanshin.tenchisecurity.com/#operation/deleteOrganizationInviteByEmail)

Parameters:

  • organization_id (UUID) —

    of the organization

  • email (String) —

    of the invited member

Returns:

  • a Boolean with result



149
150
151
152
 
# File 'lib/zanshin/organization_members.rb', line 149

def delete_organization_member_invite(organization_id, email)
  @http.request('DELETE',
                "/organizations/#{validate_uuid(organization_id)}/invites/#{email}")
end

#get_organization_member(organization_id, member_id) ⇒ Object

Get details on a user’s organization membership [#reference](api.zanshin.tenchisecurity.com/#operation/getOrganizationMemberById)

Parameters:

  • organization_id (UUID) —

    of the organization

  • member_id (UUID) —

    of the member

Returns:

  • a Object representing the organization member



32
33
34
35
 
# File 'lib/zanshin/organization_members.rb', line 32

def get_organization_member(organization_id, member_id)
  @http.request('GET',
                "/organizations/#{validate_uuid(organization_id)}/members/#{validate_uuid(member_id)}")
end

#get_organization_member_invite(organization_id, email) ⇒ Object

Get organization member invite [#reference](api.zanshin.tenchisecurity.com/#operation/getOrganizationInviteByEmail)

Parameters:

  • organization_id (UUID) —

    of the organization

  • email (String) —

    of the invited member

Returns:

  • a Object representing the organization member invite



137
138
139
140
 
# File 'lib/zanshin/organization_members.rb', line 137

def get_organization_member_invite(organization_id, email)
  @http.request('GET',
                "/organizations/#{validate_uuid(organization_id)}/invites/#{email}")
end

#iter_organization_members(organization_id) ⇒ Object

Organization Members Enumerator of the users which are members of an organization [#reference](api.zanshin.tenchisecurity.com/#operation/getOrganizationMembers)

Parameters:

  • organization_id (UUID) —

    of the organization

Returns:

  • an Organization Members Enumerator object



17
18
19
20
21
22
23
 
# File 'lib/zanshin/organization_members.rb', line 17

def iter_organization_members(organization_id)
  Enumerator.new do |yielder|
    @http.request('GET', "/organizations/#{validate_uuid(organization_id)}/members").each do |e|
      yielder.yield e
    end
  end
end

#iter_organization_members_invites(organization_id) ⇒ Object

Organization Members Invites Enumerator of an organization [#reference](api.zanshin.tenchisecurity.com/#operation/getOrgamizationInvites)

Parameters:

  • organization_id (UUID) —

    of the organization

Returns:

  • an Organization Members Invites Enumerator object



104
105
106
107
108
109
110
 
# File 'lib/zanshin/organization_members.rb', line 104

def iter_organization_members_invites(organization_id)
  Enumerator.new do |yielder|
    @http.request('GET', "/organizations/#{validate_uuid(organization_id)}/invites").each do |e|
      yielder.yield e
    end
  end
end

#resend_organization_member_invite(organization_id, email) ⇒ Object

Resend organization member invitation [#reference](api.zanshin.tenchisecurity.com/#operation/resendOrganizationInviteByEmail)

Parameters:

  • organization_id (UUID) —

    of the organization

  • email (String) —

    of the invited member

Returns:

  • a Boolean with result



161
162
163
164
 
# File 'lib/zanshin/organization_members.rb', line 161

def resend_organization_member_invite(organization_id, email)
  @http.request('POST',
                "/organizations/#{validate_uuid(organization_id)}/invites/#{email}/resend")
end

#reset_organization_member_mfa(organization_id, member_id) ⇒ Object

Reset organization member MFA [#reference](api.zanshin.tenchisecurity.com/#operation/resetOrganizationMemberMfaById)

Parameters:

  • organization_id (UUID) —

    of the organization

  • member_id (UUID) —

    of the member

Returns:

  • a Boolean with result



73
74
75
76
77
78
 
# File 'lib/zanshin/organization_members.rb', line 73

def reset_organization_member_mfa(organization_id, member_id)
  @http.request(
    'POST',
    "/organizations/#{validate_uuid(organization_id)}/members/#{validate_uuid(member_id)}/mfa/reset"
  )
end

#reset_organization_member_password(organization_id, member_id) ⇒ Object

Reset organization member Password [#reference](api.zanshin.tenchisecurity.com/#operation/resetOrganizationMemberPasswordById)

Parameters:

  • organization_id (UUID) —

    of the organization

  • member_id (UUID) —

    of the member

Returns:

  • a Boolean with result



87
88
89
90
91
92
 
# File 'lib/zanshin/organization_members.rb', line 87

def reset_organization_member_password(organization_id, member_id)
  @http.request(
    'POST',
    "/organizations/#{validate_uuid(organization_id)}/members/#{validate_uuid(member_id)}/password/reset"
  )
end

#update_organization_member(organization_id, member_id, roles = nil) ⇒ Object

Update organization member [#reference](api.zanshin.tenchisecurity.com/#operation/editOrganizationMembersById)

Parameters:

  • organization_id (UUID) —

    of the organization

  • member_id (UUID) —

    of the member

  • roles ('ADMIN') (defaults to: nil) —

    of the member

Returns:

  • a Object representing the organization member



45
46
47
48
49
50
51
52
 
# File 'lib/zanshin/organization_members.rb', line 45

def update_organization_member(organization_id, member_id, roles = nil)
  body = {
    'roles' => [roles].compact
  }
  @http.request('PUT',
                "/organizations/#{validate_uuid(organization_id)}/members/#{validate_uuid(member_id)}",
                body)
end