users

Documentation

Index

• type Devices
• type GetUsersFilters
• type User
  • func GetAllUsers(service *services.Service, filters GetUsersFilters) ([]User, *http.Response, error)
  • func GetUser(service *services.Service, userID string) (*User, *http.Response, error)
• type UserLocation
• type ZSLocation

Types

type Devices

type Devices struct {
	ID           int            `json:"id"`
	Name         string         `json:"name,omitempty"`
	UserLocation []UserLocation `json:"geo_loc,omitempty"`
	ZSLocation   []ZSLocation   `json:"zs_loc,omitempty"`
}

type GetUsersFilters

type GetUsersFilters struct {
	common.GetFromToFilters
	// The start time (in seconds) for the query. The value is entered in Unix Epoch. If not entered, returns the data for the last 2 hours.
	From int `json:"from,omitempty" url:"from,omitempty"`
	// The end time (in seconds) for the query. The value is entered in Unix Epoch. If not entered, returns the data for the last 2 hours.
	To int `json:"to,omitempty" url:"to,omitempty"`
	// The Zscaler location (ID). You can add multiple location IDs.
	Loc []int `json:"loc,omitempty" url:"loc,omitempty"`
	// The department (ID). You can add multiple department IDs.
	Dept []int `json:"dept,omitempty" url:"dept,omitempty"`
	// The active geolocation (ID). You can add multiple active geolocation IDs.
	Geo []string `json:"geo,omitempty" url:"geo,omitempty"`
	// The next_offset value from the last request. You must enter this value to get the next batch from the list. When the next_offset value becomes null, the list is complete.
	Offset string `json:"offset,omitempty" url:"offset,omitempty"`
	// The number of items that must be returned per request from the list.
	Limit int `json:"limit,omitempty" url:"limit,omitempty"`
	// Search for a user name or email. The search results include active users for the first 1000 matches.
	Q string `json:"q,omitempty" url:"q,omitempty"`
}

type User

type User struct {
	ID      int       `json:"id"`
	Name    string    `json:"name,omitempty"`
	Email   string    `json:"email,omitempty"`
	Devices []Devices `json:"devices,omitempty"`
}

func GetAllUsers

func GetAllUsers(service *services.Service, filters GetUsersFilters) ([]User, *http.Response, error)

Gets the list of all active users, their devices, active geolocations, and Zscaler locations. If the time range is not specified, the endpoint defaults to the last 2 hours.

func GetUser

func GetUser(service *services.Service, userID string) (*User, *http.Response, error)

Gets user details including the device information, active geolocations, and Zscaler locations. If the time range is not specified, the endpoint defaults to the last 2 hours.

type UserLocation

type UserLocation struct {
	ID           string  `json:"id"`
	City         string  `json:"city,omitempty"`
	State        string  `json:"state,omitempty"`
	Country      string  `json:"country,omitempty"`
	GeoLat       float32 `json:"geo_lat,omitempty"`
	GeoLong      float32 `json:"geo_long,omitempty"`
	GeoDetection string  `json:"geo_detection,omitempty"`
}

type ZSLocation

type ZSLocation struct {
	ID   int    `json:"id"`
	Name string `json:"name,omitempty"`
}