Pixis
49 min
the pixis connector allows seamless integration with the pixis platform, enabling automated network management and security operations pixis is a comprehensive network security management platform that allows for the monitoring and control of network access based on device mac addresses the pixis turbine connector enables users to automate critical network security operations such as authorizing, blocking, and querying mac addresses, as well as managing custom security policies and retrieving customer specific data by integrating with swimlane turbine, security teams can enhance their network security posture, streamline access control processes, and gain valuable insights into network activity without manual intervention limitations none to date supported versions this pixis connector uses the lastest version additional docs configuration prerequisites to utilize the pixis connector with swimlane turbine, ensure you have the following prerequisites api key authentication with the following parameters url endpoint for the pixis api account your pixis account identifier watchword a secure passphrase used for api authentication capabilities this pixis connector provides the following capabilities authorize mac block mac get customer column by ip get customer column by mac get mac by ip mac policy query pre check white list update custom fields by ip update custom fields by mac authorize mac initiates a mac address authorization process in pixis, requiring specific headers and a data body block mac blocks a specified mac address using pixis by providing necessary headers and data body get customer column by ip retrieve customer column data for a specific site and ip address in pixis using required path parameters and headers get customer column by mac retrieves customer column data for a specified mac address within a given sitename using the pixis connector get mac by ip retrieve the mac address associated with a given ip from pixis, requiring specific headers and a data body mac policy query executes a query for mac policy details in pixis using specified headers and data body pre check white list verifies if elements are on the whitelist in pixis by checking against provided headers and data body update custom fields by ip updates specified custom fields for a device using its ip address within the pixis sitename context requires path parameters 'sitename' and 'ip', along with 'custom column' in json body update custom fields by mac updates specific custom fields for a device identified by mac address in the specified site within pixis configurations pixis api authentication authenticates using account and watchword for the pixis api configuration parameters parameter description type required url a url to the target host string required account account for the pixis api string required watchword watchword for the pixis api string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions authorize mac initiates a mac address authorization in pixis with required headers and data body endpoint url /apiv2/authorizemac method post input argument name type required description headers object required http headers for the request content type string required type of the resource accept string required parameter for authorize mac data body object required response data isauth string required parameter for authorize mac macs string optional parameter for authorize mac siteid string optional unique identifier sitename string optional name of the resource starttime string optional time value endtime string optional time value output parameter type description status code number http status code of the response reason string response reason phrase code string output field code message string response message example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "code" "inputmacformaterror", "message" "dolore incididunt ullamco dolor quis" } } ] block mac blocks a specified mac address on the pixis platform using provided headers and data body for network security endpoint url /apiv2/blockmac method post input argument name type required description headers object required http headers for the request content type string required type of the resource accept string required parameter for block mac data body object required response data isblock string required parameter for block mac macs string optional parameter for block mac siteid string optional unique identifier sitename string optional name of the resource output parameter type description status code number http status code of the response reason string response reason phrase code string output field code message string response message example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "code" "inputmacformaterror", "message" "dolore incididunt ullamco dolor quis" } } ] get customer column by ip retrieve customer column data for a specific site and ip address in pixis, utilizing the provided path parameters and headers endpoint url /apiv2/ipinfo/{{sitename}}/{{ip}}/custom column method get input argument name type required description sitename string required name of the resource ip string required parameter for get customer column by ip headers object required http headers for the request accept string required parameter for get customer column by ip output parameter type description status code number http status code of the response reason string response reason phrase custom column object output field custom column esse bc string output field esse bc ip string output field ip sitename string name of the resource siteid string unique identifier example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "custom column" {}, "ip" "aliqua consectetur", "sitename" "aliqua", "siteid" "consequat" } } ] get customer column by mac retrieves customer column data for a specified mac address within a given sitename using the pixis connector requires path parameters and headers endpoint url /apiv2/macinfo/{{sitename}}/{{mac}}/custom column method get input argument name type required description sitename string required name of the resource mac string required parameter for get customer column by mac headers object required http headers for the request accept string required parameter for get customer column by mac output parameter type description status code number http status code of the response reason string response reason phrase custom column object output field custom column dolor 3 string output field dolor 3 dolore9 string output field dolore9 eiusmod 1 string output field eiusmod 1 mac string output field mac sitename string name of the resource siteid string unique identifier example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "custom column" {}, "mac" "aebb59 ce fa3f", "sitename" "sit culpa", "siteid" "duis nisi dolor laborum sunt" } } ] get mac by ip retrieve the mac address associated with a specified ip from pixis, necessitating specific headers and a data body for execution endpoint url /apiv2/getmacbyip method post input argument name type required description headers object required http headers for the request content type string required type of the resource accept string required parameter for get mac by ip data body object required response data ip string required parameter for get mac by ip siteid string optional unique identifier sitename string optional name of the resource output parameter type description status code number http status code of the response reason string response reason phrase code string output field code message string response message example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "code" "inputmacformaterror", "message" "dolore incididunt ullamco dolor quis" } } ] mac policy query executes a query for mac policy details in pixis using specified headers and data body endpoint url /apiv2/macpolicyquery method post input argument name type required description headers object required http headers for the request content type string required type of the resource accept string required parameter for mac policy query data body object required response data mac string required parameter for mac policy query siteid string optional unique identifier sitename string optional name of the resource output parameter type description status code number http status code of the response reason string response reason phrase code string output field code message string response message example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "code" "inputmacformaterror", "message" "dolore incididunt ullamco dolor quis" } } ] pre check white list verifies elements against the whitelist in pixis using provided headers and data body endpoint url /apiv2/precheckwhitelist method post input argument name type required description headers object required http headers for the request content type string required type of the resource accept string required parameter for pre check white list data body object required response data iswhitelist string required parameter for pre check white list macs string required parameter for pre check white list siteid string optional unique identifier sitename string optional name of the resource starttime string optional time value endtime string optional time value output parameter type description status code number http status code of the response reason string response reason phrase code string output field code message string response message example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "code" "inputmacformaterror", "message" "dolore incididunt ullamco dolor quis" } } ] update custom fields by ip updates custom fields for a device by ip within the pixis sitename context, requiring 'sitename', 'ip', and 'custom column' endpoint url /apiv2/ipinfo/{{sitename}}/{{ip}}/custom column method put input argument name type required description sitename string required name of the resource ip string required parameter for update custom fields by ip headers object required http headers for the request content type string required type of the resource accept string required parameter for update custom fields by ip custom column object required parameter for update custom fields by ip in668 string required parameter for update custom fields by ip eiusmod53d string required parameter for update custom fields by ip output parameter type description status code number http status code of the response reason string response reason phrase code string output field code message string response message example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "code" "inputmacformaterror", "message" "dolore incididunt ullamco dolor quis" } } ] update custom fields by mac updates custom fields for a device by mac address in a specified site on pixis, requiring sitename, mac, and custom column details endpoint url /apiv2/macinfo/{{sitename}}/{{mac}}/custom column method put input argument name type required description sitename string required name of the resource mac string required parameter for update custom fields by mac headers object required http headers for the request content type string required type of the resource accept string required parameter for update custom fields by mac custom column object required parameter for update custom fields by mac in668 string required parameter for update custom fields by mac eiusmod53d string required parameter for update custom fields by mac output parameter type description status code number http status code of the response reason string response reason phrase code string output field code message string response message example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "code" "inputmacformaterror", "message" "dolore incididunt ullamco dolor quis" } } ]