README
¶
go-ise
go-ise is a Go client library for Cisco ISE. It is based on Nathan's excellent goaci module and features a simple, extensible API and advanced JSON manipulation.
Getting Started
Installing
To start using go-ise, install Go and go get:
$ go get -u github.com/netascode/go-ise
Basic Usage
package main
import "github.com/netascode/go-ise"
func main() {
client, _ := ise.NewClient("https://1.1.1.1", "user", "pwd")
res, _ := client.Get("/ers/config/internaluser")
println(res.Get("SearchResult.resources.#.name").String())
}
This will print something like:
["user1","user2","user3"]
Result manipulation
ise.Result uses GJSON to simplify handling JSON results. See the GJSON documentation for more detail.
res, _ := client.Get("/ers/config/internaluser")
for _, user := range res.Get("SearchResult.resources").Array() {
println(user.Get("@pretty").String()) // pretty print internal users
}
POST data creation
ise.Body is a wrapper for SJSON. SJSON supports a path syntax simplifying JSON creation.
body := ise.Body{}.
Set("InternalUser.name", "User1").
Set("InternalUser.password", "Cisco123")
client.Post("/ers/config/internaluser", body.Str)
Documentation
See the documentation for more details.
Documentation
¶
Overview ¶
Package ise is a Cisco ISE REST client library for Go.
Index ¶
- Constants
- func BackoffDelayFactor(x float64) func(*Client)
- func BackoffMaxDelay(x int) func(*Client)
- func BackoffMinDelay(x int) func(*Client)
- func Insecure(x bool) func(*Client)
- func MaxRetries(x int) func(*Client)
- func NoLogPayload(req *Req)
- func RequestTimeout(x time.Duration) func(*Client)
- type Body
- type Client
- func (client *Client) Backoff(attempts int) bool
- func (client *Client) Delete(path string, mods ...func(*Req)) (Res, error)
- func (client *Client) Do(req Req) (Res, string, error)
- func (client *Client) Get(path string, mods ...func(*Req)) (Res, error)
- func (client Client) NewReq(method, uri string, body io.Reader, mods ...func(*Req)) Req
- func (client *Client) Post(path, data string, mods ...func(*Req)) (Res, string, error)
- func (client *Client) Put(path, data string, mods ...func(*Req)) (Res, error)
- type Req
- type Res
Constants ¶
const DefaultBackoffDelayFactor float64 = 3
const DefaultBackoffMaxDelay int = 60
const DefaultBackoffMinDelay int = 2
const DefaultMaxRetries int = 3
Variables ¶
This section is empty.
Functions ¶
func BackoffDelayFactor ¶
BackoffDelayFactor modifies the backoff delay factor from the default of 3.
func BackoffMaxDelay ¶
BackoffMaxDelay modifies the maximum delay between two retries from the default of 60.
func BackoffMinDelay ¶
BackoffMinDelay modifies the minimum delay between two retries from the default of 2.
func Insecure ¶
Insecure determines if insecure https connections are allowed. Default value is true.
func MaxRetries ¶
MaxRetries modifies the maximum number of retries from the default of 3.
func NoLogPayload ¶
func NoLogPayload(req *Req)
NoLogPayload prevents logging of payloads. Primarily used by the Login and Refresh methods where this could expose secrets.
func RequestTimeout ¶
RequestTimeout modifies the HTTP request timeout from the default of 60 seconds.
Types ¶
type Body ¶
type Body struct {
Str string
}
Body wraps SJSON for building JSON body strings. Usage example:
Body{}.Set("name", "ABC").Str
type Client ¶
type Client struct {
// HttpClient is the *http.Client used for API requests.
HttpClient *http.Client
// Url is the ISE IP or hostname, e.g. https://10.0.0.1:443 (port is optional).
Url string
// Usr is the ISE username.
Usr string
// Pwd is the ISE password.
Pwd string
// Insecure determines if insecure https connections are allowed.
Insecure bool
// Maximum number of retries
MaxRetries int
// Minimum delay between two retries
BackoffMinDelay int
// Maximum delay between two retries
BackoffMaxDelay int
// Backoff delay factor
BackoffDelayFactor float64
}
Client is an HTTP ISE client. Use ise.NewClient to initiate a client. This will ensure proper processing of modifiers.
func NewClient ¶
NewClient creates a new ISE HTTP client. Pass modifiers in to modify the behavior of the client, e.g.
client, _ := NewClient("https://ise1.cisco.com", "user", "password", RequestTimeout(120))
func (*Client) Do ¶
Do makes a request. Requests for Do are built ouside of the client, e.g.
req := client.NewReq("GET", "/ers/config/internaluser", nil)
res, _, _ := client.Do(req)
func (*Client) Get ¶
Get makes a GET request and returns a GJSON result. Results will be the raw data structure as returned by ISE
type Req ¶
type Req struct {
// HttpReq is the *http.Request obejct.
HttpReq *http.Request
// LogPayload indicates whether logging of payloads should be enabled.
LogPayload bool
}
Req wraps http.Request for API requests.
type Res ¶
Res is an API response returned by client requests. This is a GJSON result, which offers advanced and safe parsing capabilities. https://github.com/tidwall/gjson
Source Files