Rapid7 InsightDR V2

introduction this guide tells you how to authenticate the rapid7 insightidr v2 connector in swimlane using api key authentication you will generate a rapid7 api key, identify your insightidr region, collect the required identifiers, and configure the connector in swimlane prerequisites rapid7 access requirements you must have rapid7 permissions to access the rapid7 insight platform generate platform api keys access insightidr investigations and saved queries view your insight platform region required credentials during setup, you will collect rapid7 insightidr api base url rapid7 api key rapid7 region authentication method overview the rapid7 insightidr v2 connector supports api key authentication using the x api key header rapid7 setup take the following steps to generate a rapid7 api key log in to the rapid7 insight platform navigate to the api keys management page click generate api key or create api key provide a name and select the appropriate scope or permissions if prompted generate the key copy the api key and store it securely take the following steps to identify your insightidr region log in to your insightidr account look at the url in the browser address bar on the home page identify the region value from the url use the corresponding regional api base url for your swimlane asset supported base url format rapid7 insightidr apis use regional api endpoints the base url typically follows this format https //{region} api insight rapid7 com common regional examples region base url example us https //us api insight rapid7 com eu https //eu api insight rapid7 com ca https //ca api insight rapid7 com au https //au api insight rapid7 com us2 https //us2 api insight rapid7 com connector configuration in swimlane log in to turbine from the left hand navigation pane, click orchestration and click assets click the plus icon to open the configure your connector asset window select rapid7 insightidr v2 from the asset type list fill in the asset settings and asset input as shown below configuration – api key authentication field description required/optional url rapid7 insightidr api base url for your region required x api key rapid7 api key required verify ssl enable or disable ssl verification optional http proxy optional proxy configuration optional troubleshooting if authentication fails verify that the x api key value is correct and active ensure the url uses the correct regional endpoint for your account confirm the api key has sufficient permissions for insightidr operations check ssl verification and proxy settings if requests fail to connect if you receive authorisation errors, regenerate the api key and update the swimlane asset you have successfully authenticated the rapid7 insightidr v2 connector in swimlane sources rapid7 insightidr api documentation https //help rapid7 com/insightidr/en us/api/v2/docs html https //help rapid7 com/insightidr/en us/api/v2/docs html rapid7 manage platform api keys https //docs rapid7 com/insight/managing platform api keys/ https //docs rapid7 com/insight/managing platform api keys/ rapid7 product apis and regions https //docs rapid7 com/insight/product apis/ https //docs rapid7 com/insight/product apis/