matterbridge/vendor/github.com/slack-go/slack/admin.go

208 lines
6.5 KiB
Go
Raw Permalink Normal View History

2016-09-05 07:34:37 -07:00
package slack
import (
2017-07-16 05:29:46 -07:00
"context"
2016-09-05 07:34:37 -07:00
"fmt"
"net/url"
2019-09-07 13:46:58 -07:00
"strings"
2016-09-05 07:34:37 -07:00
)
2019-09-07 13:46:58 -07:00
func (api *Client) adminRequest(ctx context.Context, method string, teamName string, values url.Values) error {
resp := &SlackResponse{}
err := parseAdminResponse(ctx, api.httpclient, method, teamName, values, resp, api)
2016-09-05 07:34:37 -07:00
if err != nil {
2019-09-07 13:46:58 -07:00
return err
2016-09-05 07:34:37 -07:00
}
2019-09-07 13:46:58 -07:00
return resp.Err()
2016-09-05 07:34:37 -07:00
}
// DisableUser disabled a user account, given a user ID
func (api *Client) DisableUser(teamName string, uid string) error {
2017-07-16 05:29:46 -07:00
return api.DisableUserContext(context.Background(), teamName, uid)
}
// DisableUserContext disabled a user account, given a user ID with a custom context
func (api *Client) DisableUserContext(ctx context.Context, teamName string, uid string) error {
2016-09-05 07:34:37 -07:00
values := url.Values{
"user": {uid},
2018-08-09 15:38:19 -07:00
"token": {api.token},
2016-09-05 07:34:37 -07:00
"set_active": {"true"},
"_attempts": {"1"},
}
2019-09-07 13:46:58 -07:00
if err := api.adminRequest(ctx, "setInactive", teamName, values); err != nil {
return fmt.Errorf("failed to disable user with id '%s': %s", uid, err)
2016-09-05 07:34:37 -07:00
}
return nil
}
// InviteGuest invites a user to Slack as a single-channel guest
2017-07-16 05:29:46 -07:00
func (api *Client) InviteGuest(teamName, channel, firstName, lastName, emailAddress string) error {
return api.InviteGuestContext(context.Background(), teamName, channel, firstName, lastName, emailAddress)
}
// InviteGuestContext invites a user to Slack as a single-channel guest with a custom context
func (api *Client) InviteGuestContext(ctx context.Context, teamName, channel, firstName, lastName, emailAddress string) error {
2016-09-05 07:34:37 -07:00
values := url.Values{
"email": {emailAddress},
"channels": {channel},
"first_name": {firstName},
"last_name": {lastName},
"ultra_restricted": {"1"},
2018-08-09 15:38:19 -07:00
"token": {api.token},
"resend": {"true"},
2016-09-05 07:34:37 -07:00
"set_active": {"true"},
"_attempts": {"1"},
}
2019-09-07 13:46:58 -07:00
err := api.adminRequest(ctx, "invite", teamName, values)
2016-09-05 07:34:37 -07:00
if err != nil {
return fmt.Errorf("Failed to invite single-channel guest: %s", err)
}
return nil
}
// InviteRestricted invites a user to Slack as a restricted account
2017-07-16 05:29:46 -07:00
func (api *Client) InviteRestricted(teamName, channel, firstName, lastName, emailAddress string) error {
return api.InviteRestrictedContext(context.Background(), teamName, channel, firstName, lastName, emailAddress)
}
// InviteRestrictedContext invites a user to Slack as a restricted account with a custom context
func (api *Client) InviteRestrictedContext(ctx context.Context, teamName, channel, firstName, lastName, emailAddress string) error {
2016-09-05 07:34:37 -07:00
values := url.Values{
"email": {emailAddress},
"channels": {channel},
"first_name": {firstName},
"last_name": {lastName},
"restricted": {"1"},
2018-08-09 15:38:19 -07:00
"token": {api.token},
"resend": {"true"},
2016-09-05 07:34:37 -07:00
"set_active": {"true"},
"_attempts": {"1"},
}
2019-09-07 13:46:58 -07:00
err := api.adminRequest(ctx, "invite", teamName, values)
2016-09-05 07:34:37 -07:00
if err != nil {
return fmt.Errorf("Failed to restricted account: %s", err)
}
return nil
}
// InviteToTeam invites a user to a Slack team
2017-07-16 05:29:46 -07:00
func (api *Client) InviteToTeam(teamName, firstName, lastName, emailAddress string) error {
return api.InviteToTeamContext(context.Background(), teamName, firstName, lastName, emailAddress)
}
// InviteToTeamContext invites a user to a Slack team with a custom context
func (api *Client) InviteToTeamContext(ctx context.Context, teamName, firstName, lastName, emailAddress string) error {
2016-09-05 07:34:37 -07:00
values := url.Values{
"email": {emailAddress},
"first_name": {firstName},
"last_name": {lastName},
2018-08-09 15:38:19 -07:00
"token": {api.token},
2016-09-05 07:34:37 -07:00
"set_active": {"true"},
"_attempts": {"1"},
}
2019-09-07 13:46:58 -07:00
err := api.adminRequest(ctx, "invite", teamName, values)
2016-09-05 07:34:37 -07:00
if err != nil {
return fmt.Errorf("Failed to invite to team: %s", err)
}
return nil
}
// SetRegular enables the specified user
2017-07-16 05:29:46 -07:00
func (api *Client) SetRegular(teamName, user string) error {
return api.SetRegularContext(context.Background(), teamName, user)
}
// SetRegularContext enables the specified user with a custom context
func (api *Client) SetRegularContext(ctx context.Context, teamName, user string) error {
2016-09-05 07:34:37 -07:00
values := url.Values{
"user": {user},
2018-08-09 15:38:19 -07:00
"token": {api.token},
2016-09-05 07:34:37 -07:00
"set_active": {"true"},
"_attempts": {"1"},
}
2019-09-07 13:46:58 -07:00
err := api.adminRequest(ctx, "setRegular", teamName, values)
2016-09-05 07:34:37 -07:00
if err != nil {
return fmt.Errorf("Failed to change the user (%s) to a regular user: %s", user, err)
}
return nil
}
// SendSSOBindingEmail sends an SSO binding email to the specified user
2017-07-16 05:29:46 -07:00
func (api *Client) SendSSOBindingEmail(teamName, user string) error {
return api.SendSSOBindingEmailContext(context.Background(), teamName, user)
}
// SendSSOBindingEmailContext sends an SSO binding email to the specified user with a custom context
func (api *Client) SendSSOBindingEmailContext(ctx context.Context, teamName, user string) error {
2016-09-05 07:34:37 -07:00
values := url.Values{
"user": {user},
2018-08-09 15:38:19 -07:00
"token": {api.token},
2016-09-05 07:34:37 -07:00
"set_active": {"true"},
"_attempts": {"1"},
}
2019-09-07 13:46:58 -07:00
err := api.adminRequest(ctx, "sendSSOBind", teamName, values)
2016-09-05 07:34:37 -07:00
if err != nil {
return fmt.Errorf("Failed to send SSO binding email for user (%s): %s", user, err)
}
return nil
}
// SetUltraRestricted converts a user into a single-channel guest
func (api *Client) SetUltraRestricted(teamName, uid, channel string) error {
2017-07-16 05:29:46 -07:00
return api.SetUltraRestrictedContext(context.Background(), teamName, uid, channel)
}
// SetUltraRestrictedContext converts a user into a single-channel guest with a custom context
func (api *Client) SetUltraRestrictedContext(ctx context.Context, teamName, uid, channel string) error {
2016-09-05 07:34:37 -07:00
values := url.Values{
"user": {uid},
"channel": {channel},
2018-08-09 15:38:19 -07:00
"token": {api.token},
2016-09-05 07:34:37 -07:00
"set_active": {"true"},
"_attempts": {"1"},
}
2019-09-07 13:46:58 -07:00
err := api.adminRequest(ctx, "setUltraRestricted", teamName, values)
2016-09-05 07:34:37 -07:00
if err != nil {
return fmt.Errorf("Failed to ultra-restrict account: %s", err)
}
return nil
}
// SetRestricted converts a user into a restricted account
2019-09-07 13:46:58 -07:00
func (api *Client) SetRestricted(teamName, uid string, channelIds ...string) error {
return api.SetRestrictedContext(context.Background(), teamName, uid, channelIds...)
2017-07-16 05:29:46 -07:00
}
// SetRestrictedContext converts a user into a restricted account with a custom context
2019-09-07 13:46:58 -07:00
func (api *Client) SetRestrictedContext(ctx context.Context, teamName, uid string, channelIds ...string) error {
2016-09-05 07:34:37 -07:00
values := url.Values{
"user": {uid},
2018-08-09 15:38:19 -07:00
"token": {api.token},
2016-09-05 07:34:37 -07:00
"set_active": {"true"},
"_attempts": {"1"},
2019-09-07 13:46:58 -07:00
"channels": {strings.Join(channelIds, ",")},
2016-09-05 07:34:37 -07:00
}
2019-09-07 13:46:58 -07:00
err := api.adminRequest(ctx, "setRestricted", teamName, values)
2016-09-05 07:34:37 -07:00
if err != nil {
2019-09-07 13:46:58 -07:00
return fmt.Errorf("failed to restrict account: %s", err)
2016-09-05 07:34:37 -07:00
}
return nil
}