mirror of
https://github.com/strongdm/comply
synced 2024-08-27 17:56:48 +00:00
154 lines
4.5 KiB
Go
154 lines
4.5 KiB
Go
package jira
|
|
|
|
import (
|
|
"fmt"
|
|
"net/url"
|
|
)
|
|
|
|
// GroupService handles Groups for the JIRA instance / API.
|
|
//
|
|
// JIRA API docs: https://docs.atlassian.com/jira/REST/server/#api/2/group
|
|
type GroupService struct {
|
|
client *Client
|
|
}
|
|
|
|
// groupMembersResult is only a small wrapper around the Group* methods
|
|
// to be able to parse the results
|
|
type groupMembersResult struct {
|
|
StartAt int `json:"startAt"`
|
|
MaxResults int `json:"maxResults"`
|
|
Total int `json:"total"`
|
|
Members []GroupMember `json:"values"`
|
|
}
|
|
|
|
// Group represents a JIRA group
|
|
type Group struct {
|
|
ID string `json:"id"`
|
|
Title string `json:"title"`
|
|
Type string `json:"type"`
|
|
Properties groupProperties `json:"properties"`
|
|
AdditionalProperties bool `json:"additionalProperties"`
|
|
}
|
|
|
|
type groupProperties struct {
|
|
Name groupPropertiesName `json:"name"`
|
|
}
|
|
|
|
type groupPropertiesName struct {
|
|
Type string `json:"type"`
|
|
}
|
|
|
|
// GroupMember reflects a single member of a group
|
|
type GroupMember struct {
|
|
Self string `json:"self,omitempty"`
|
|
Name string `json:"name,omitempty"`
|
|
Key string `json:"key,omitempty"`
|
|
EmailAddress string `json:"emailAddress,omitempty"`
|
|
DisplayName string `json:"displayName,omitempty"`
|
|
Active bool `json:"active,omitempty"`
|
|
TimeZone string `json:"timeZone,omitempty"`
|
|
}
|
|
|
|
type GroupSearchOptions struct {
|
|
StartAt int
|
|
MaxResults int
|
|
IncludeInactiveUsers bool
|
|
}
|
|
|
|
// Get returns a paginated list of users who are members of the specified group and its subgroups.
|
|
// Users in the page are ordered by user names.
|
|
// User of this resource is required to have sysadmin or admin permissions.
|
|
//
|
|
// JIRA API docs: https://docs.atlassian.com/jira/REST/server/#api/2/group-getUsersFromGroup
|
|
//
|
|
// WARNING: This API only returns the first page of group members
|
|
func (s *GroupService) Get(name string) ([]GroupMember, *Response, error) {
|
|
apiEndpoint := fmt.Sprintf("/rest/api/2/group/member?groupname=%s", url.QueryEscape(name))
|
|
req, err := s.client.NewRequest("GET", apiEndpoint, nil)
|
|
if err != nil {
|
|
return nil, nil, err
|
|
}
|
|
|
|
group := new(groupMembersResult)
|
|
resp, err := s.client.Do(req, group)
|
|
if err != nil {
|
|
return nil, resp, err
|
|
}
|
|
|
|
return group.Members, resp, nil
|
|
}
|
|
|
|
// Get returns a paginated list of members of the specified group and its subgroups.
|
|
// Users in the page are ordered by user names.
|
|
// User of this resource is required to have sysadmin or admin permissions.
|
|
//
|
|
// JIRA API docs: https://docs.atlassian.com/jira/REST/server/#api/2/group-getUsersFromGroup
|
|
func (s *GroupService) GetWithOptions(name string, options *GroupSearchOptions) ([]GroupMember, *Response, error) {
|
|
var apiEndpoint string
|
|
if options == nil {
|
|
apiEndpoint = fmt.Sprintf("/rest/api/2/group/member?groupname=%s", url.QueryEscape(name))
|
|
} else {
|
|
apiEndpoint = fmt.Sprintf(
|
|
"/rest/api/2/group/member?groupname=%s&startAt=%d&maxResults=%d&includeInactiveUsers=%t",
|
|
url.QueryEscape(name),
|
|
options.StartAt,
|
|
options.MaxResults,
|
|
options.IncludeInactiveUsers,
|
|
)
|
|
}
|
|
req, err := s.client.NewRequest("GET", apiEndpoint, nil)
|
|
if err != nil {
|
|
return nil, nil, err
|
|
}
|
|
|
|
group := new(groupMembersResult)
|
|
resp, err := s.client.Do(req, group)
|
|
if err != nil {
|
|
return nil, resp, err
|
|
}
|
|
return group.Members, resp, nil
|
|
}
|
|
|
|
// Add adds user to group
|
|
//
|
|
// JIRA API docs: https://docs.atlassian.com/jira/REST/cloud/#api/2/group-addUserToGroup
|
|
func (s *GroupService) Add(groupname string, username string) (*Group, *Response, error) {
|
|
apiEndpoint := fmt.Sprintf("/rest/api/2/group/user?groupname=%s", groupname)
|
|
var user struct {
|
|
Name string `json:"name"`
|
|
}
|
|
user.Name = username
|
|
req, err := s.client.NewRequest("POST", apiEndpoint, &user)
|
|
if err != nil {
|
|
return nil, nil, err
|
|
}
|
|
|
|
responseGroup := new(Group)
|
|
resp, err := s.client.Do(req, responseGroup)
|
|
if err != nil {
|
|
jerr := NewJiraError(resp, err)
|
|
return nil, resp, jerr
|
|
}
|
|
|
|
return responseGroup, resp, nil
|
|
}
|
|
|
|
// Remove removes user from group
|
|
//
|
|
// JIRA API docs: https://docs.atlassian.com/jira/REST/cloud/#api/2/group-removeUserFromGroup
|
|
func (s *GroupService) Remove(groupname string, username string) (*Response, error) {
|
|
apiEndpoint := fmt.Sprintf("/rest/api/2/group/user?groupname=%s&username=%s", groupname, username)
|
|
req, err := s.client.NewRequest("DELETE", apiEndpoint, nil)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
resp, err := s.client.Do(req, nil)
|
|
if err != nil {
|
|
jerr := NewJiraError(resp, err)
|
|
return resp, jerr
|
|
}
|
|
|
|
return resp, nil
|
|
}
|