Grip Security

the grip security connector allows for streamlined management and security oversight of saas applications by providing essential operations like user and application data retrieval, and label management grip security specializes in comprehensive saas security management, offering visibility and control over saas usage and data access the grip security connector for swimlane turbine enables automated saas application and user management, including label creation, user information retrieval, and saas application association by integrating with grip security, swimlane turbine users can enhance their security posture, streamline saas security operations, and ensure consistent labeling and access management across their saas ecosystem limitations none to date prerequisites to effectively utilize the grip security connector with swimlane turbine, ensure you have the following api key authentication with the necessary parameters url endpoint for the grip security api access token unique token to authenticate api requests capabilities this connector provides the following capabilities create label delete a user label get saas applications for user get saas id get saas get user id get user get users for saas application list saas list users user label create label creates label for the given saas id grip security documentation for this action can be found \[here] ( https //apidocs grip security/docs/api docs/d97d503037a4b create label https //apidocs grip security/docs/api docs/d97d503037a4b create label ) delete a user label delete a specific label from the user grip security documentation for this action can be found \[here] ( https //apidocs grip security/docs/api docs/dc4b00ba8344e delete a user label https //apidocs grip security/docs/api docs/dc4b00ba8344e delete a user label ) get saas applications for user get saas applications for user grip security documentation for this action can be found \[here] ( https //apidocs grip security/docs/api docs/9a1cf7710431d get saa s applications for user https //apidocs grip security/docs/api docs/9a1cf7710431d get saa s applications for user ) get saas id retrieve the saas application id of a saas by it's name the result will be in array, in case there is more than one saas with the same name grip security documentation for this action can be found \[here] ( https //apidocs grip security/docs/api docs/83c3c79bdb1bd get saas id https //apidocs grip security/docs/api docs/83c3c79bdb1bd get saas id ) get saas retrieve the information of the saas with the matching saas id grip security documentation for this action can be found \[here] ( https //apidocs grip security/docs/api docs/1c66d637a4728 get saa s https //apidocs grip security/docs/api docs/1c66d637a4728 get saa s ) get user id retrieve the userid out of the user email address grip security documentation for this action can be found \[here] ( https //apidocs grip security/docs/api docs/9cbe8055b82d3 get user id https //apidocs grip security/docs/api docs/9cbe8055b82d3 get user id ) get user retrieve the information of the user with the matching user mail grip security documentation for this action can be found \[here] ( https //apidocs grip security/docs/api docs/4930e3a1dbc52 get user https //apidocs grip security/docs/api docs/4930e3a1dbc52 get user ) get users for saas application retrieve a list of all the users in a specific saas grip security documentation for this action can be found \[here] ( https //apidocs grip security/docs/api docs/df46c6db4c08c get users for saa s application https //apidocs grip security/docs/api docs/df46c6db4c08c get users for saa s application ) list saas retrieve a list of all the saas in the organization, including organizational data and grip data the list is paginated using query parameters grip security documentation for this action can be found \[here] ( https //apidocs grip security/docs/api docs/60dabc18f8891 list saa s https //apidocs grip security/docs/api docs/60dabc18f8891 list saa s ) list users retrieve a list of all the users in the organization, including organizational data and grip data the list is paginated using query parameters grip security documentation for this action can be found \[here] ( https //apidocs grip security/docs/api docs/7256414af9f9a list users https //apidocs grip security/docs/api docs/7256414af9f9a list users ) user label add a label for a specific user id if the specific label already exists in the env, it will add it to the user if it doesn't it will create it and add it to the user grip security documentation for this action can be found \[here] ( https //apidocs grip security/docs/api docs/95aea440bbf3e user label https //apidocs grip security/docs/api docs/95aea440bbf3e user label ) configurations api key authentication authenticates using an api key configuration parameters parameter description type required url a url to the target host string required access token access token string required actions create label creates a new label for a given saas id in grip security, necessitating the 'label' field within the json body endpoint url saas/{{saas id}}/label method post input argument name type required description saas id string required unique identifier label string required parameter for create label output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" {} } ] delete user label removes a specified label from a user in grip security by utilizing the user's id and the label name endpoint url users/{{user id}}/label method delete input argument name type required description user id string required unique identifier label string required parameter for delete user label output parameter type description status code number http status code of the response reason string response reason phrase message string response message example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "message" "string" } } ] get saas retrieves detailed information for a specific saas entry by using the provided saas id endpoint url /saas/{{saas id}} method get input argument name type required description saas id string required unique identifier output parameter type description status code number http status code of the response reason string response reason phrase id string unique identifier name string name of the resource url string url endpoint for the request logourl string url endpoint for the request gripdata object response data numberofusers number output field numberofusers numberofonboardedusers number output field numberofonboardedusers numberofoffboardedusers number output field numberofoffboardedusers ssopercentage number output field ssopercentage accessremovalsupport string output field accessremovalsupport riskscore number score value sanctiontag string output field sanctiontag labels array output field labels buisnessowner string output field buisnessowner category string output field category appinstancescount number count value sourceplatforms array output field sourceplatforms lastknownusage string output field lastknownusage assets array output field assets compliances array output field compliances primarycontact object output field primarycontact email string output field email userid string unique identifier example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "id" "497f6eca 6276 4993 bfeb 53cbbbba6f08", "name" "string", "url" "string", "logourl" "string", "gripdata" {} } } ] get saas applications for user retrieve a list of saas applications associated with a specified user id in grip security, requiring the user's unique identifier endpoint url /users/{{user id}}/saas method get input argument name type required description user id string required unique identifier limit number optional parameter for get saas applications for user offset number optional parameter for get saas applications for user output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" \[ {} ] } ] get saas id obtain a unique identifier for a specified saas application by name within grip security endpoint url /saas/{{saas name}}/id method get input argument name type required description saas name string required name of the resource output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" \[ "497f6eca 6276 4993 bfeb 53cbbbba6f08" ] } ] get user retrieve detailed information for a specified user in grip security by using the unique user id endpoint url /users/{{user id}} method get input argument name type required description user id string required unique identifier output parameter type description status code number http status code of the response reason string response reason phrase id string unique identifier mail string output field mail aliases array output field aliases fullname string name of the resource displayname string name of the resource organizationalunit string output field organizationalunit manageremail string output field manageremail gripdata object response data numberofsaas string output field numberofsaas ssopercentage string output field ssopercentage activity object output field activity platformsactivity array output field platformsactivity platform string output field platform status string status value hasactivemailbox boolean output field hasactivemailbox labels array output field labels firsteventtime string time value latesteventtime string time value lastusage string output field lastusage offboardingworkflowstatus string status value offboardingworkflowtimestamp string output field offboardingworkflowtimestamp customfields object output field customfields type string type of the resource example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "id" "8e6afaf9 ce27 419e bf33 4b02fc2e90ca", "mail" "example\@grip security", "aliases" \[], "fullname" "anonymous anonymous", "displayname" "string", "organizationalunit" "marketing", "manageremail" "manager\@grip security", "gripdata" {}, "customfields" {}, "type" "string" } } ] get user id obtain the unique id for a user in grip security using their email address as input endpoint url /users/{{user mail}}/id method get input argument name type required description user mail string required parameter for get user id output parameter type description status code number http status code of the response reason string response reason phrase userid string unique identifier example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "userid" "8e6afaf9 ce27 419e bf33 4b02fc2e90ca" } } ] get users for saas application retrieve all users associated with a specific saas application by using the provided saas id endpoint url /saas/{{saas id}}/users method get input argument name type required description saas id string required unique identifier output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" \[ {} ] } ] list saas retrieve a paginated list of all saas applications within the organization, including relevant data endpoint url /saas method get input argument name type required description limit number optional parameter for list saas offset number optional parameter for list saas output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" \[ {} ] } ] list users retrieve a comprehensive list of users from the organization, including both organizational and grip security specific data endpoint url /users method get input argument name type required description next number optional parameter for list users offset number optional parameter for list users output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" \[ {} ] } ] user label adds or creates a label for a user in grip security using the specified user id and label data endpoint url /users/{{user id}}/label method post input argument name type required description user id string required unique identifier headers object optional http headers for the request content type string optional type of the resource label string required parameter for user label output parameter type description status code number http status code of the response reason string response reason phrase message string response message example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "message" "string" } } ]