Grip Security
58 min
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 ) 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 ) 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 ) 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 ) 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 ) 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 ) 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 ) 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 ) 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 ) 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 ) 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 ) 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 path parameters saas id string required parameters for the create label action label string optional parameter for create label input example {"json body" {"label" ""},"path parameters" {"saas id" ""}} output parameter type description status code number http status code of the response reason string response reason phrase output 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 path parameters user id string required parameters for the delete user label action label string optional parameter for delete user label input example {"json body" {"label" ""},"path parameters" {"user id" ""}} output parameter type description status code number http status code of the response reason string response reason phrase message string response message output 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 path parameters saas id string required parameters for the get saas action input example {"path parameters" {"saas id" ""}} 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 gripdata numberofusers number response data gripdata numberofonboardedusers number response data gripdata numberofoffboardedusers number response data gripdata ssopercentage number response data gripdata accessremovalsupport string response data gripdata riskscore number response data gripdata sanctiontag string response data gripdata labels array response data gripdata buisnessowner string response data gripdata category string response data gripdata appinstancescount number response data gripdata sourceplatforms array response data gripdata lastknownusage string response data gripdata assets array response data gripdata compliances array response data gripdata primarycontact object response data gripdata primarycontact email string response data gripdata primarycontact userid string response data output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"id" "497f6eca 6276 4993 bfeb 53cbbbba6f08","name" "string","url" "string","logourl" "string","gripdata" {"numberofusers" 0,"numberofonboardedusers" 0,"numberofoffboardedusers" 0,"ssopercentage" 0,"accessremovalsupport" "supported","riskscore" 0,"sanctiontag" "sanctioned","labels" \[],"buisnessowner" "string","category" "string","appinstancescount" 0,"sourceplatforms" \[],"lastknownusage" "2019 08 24t14 15 22z","assets" \[],"compli 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 path parameters user id string required parameters for the get saas applications for user action parameters limit number optional parameters for the get saas applications for user action parameters offset number optional parameters for the get saas applications for user action input example {"parameters" {"limit" 100,"offset" 0},"path parameters" {"user id" "12345"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {},"reason" "ok","json body" \[{"saas" {},"saasuser" {}}]} 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 path parameters saas name string required parameters for the get saas id action input example {"path parameters" {"saas name" ""}} output parameter type description status code number http status code of the response reason string response reason phrase output 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 path parameters user id string required parameters for the get user action input example {"path parameters" {"user id" ""}} 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 gripdata numberofsaas string response data gripdata ssopercentage string response data gripdata activity object response data gripdata activity platformsactivity array response data gripdata activity platformsactivity platform string response data gripdata activity platformsactivity status string response data gripdata activity hasactivemailbox boolean response data gripdata labels array response data gripdata firsteventtime string response data gripdata latesteventtime string response data gripdata lastusage string response data gripdata offboardingworkflowstatus string response data gripdata offboardingworkflowtimestamp string response data customfields object output field customfields type string type of the resource output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"id" "8e6afaf9 ce27 419e bf33 4b02fc2e90ca","mail" "example\@grip security","aliases" \["string"],"fullname" "anonymous anonymous","displayname" "string","organizationalunit" "marketing","manageremail" "manager\@grip security","gripdata" {"numberofsaas" "5","ssopercentage" "32","activity" {},"labels" \[],"firsteventtime" "2019 08 24t14 15 22z","latesteventtime" "2019 08 24t14 15 22z","lastusage" "2019 08 24t14 15 22z","offboardingwo 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 path parameters user mail string required parameters for the get user id action input example {"path parameters" {"user mail" ""}} output parameter type description status code number http status code of the response reason string response reason phrase userid string unique identifier output 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 path parameters saas id string required parameters for the get users for saas application action input example {"path parameters" {"saas id" ""}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {},"reason" "ok","json body" \[{"user" {},"saasuser" {}}]} 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 parameters limit number optional parameters for the list saas action parameters offset number optional parameters for the list saas action input example {"parameters" {"limit" 100,"offset" 0}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {},"reason" "ok","json body" \[{"id" "497f6eca 6276 4993 bfeb 53cbbbba6f08","name" "string","url" "string","logourl" "string","gripdata" {}}]} 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 parameters next number optional parameters for the list users action parameters offset number optional parameters for the list users action input example {"parameters" {"next" 1,"offset" 0}} output parameter type description status code number http status code of the response reason string response reason phrase output 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"}]} 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 path parameters user id string required parameters for the user label action headers object optional http headers for the request headers content type string optional http headers for the request label string optional parameter for user label input example {"json body" {"label" "alpha123"},"path parameters" {"user id" "12345"},"headers" {"content type" "application/json"}} output parameter type description status code number http status code of the response reason string response reason phrase message string response message output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"message" "string"}} response headers header description example content type the media type of the resource application/json date the date and time at which the message was originated thu, 01 jan 2024 00 00 00 gmt