Sophos Central

introduction this guide explains how to authenticate the sophos central connector in swimlane using oauth 2 0 client credentials you will register an api client in sophos central, collect the required credentials, and configure the connector asset in swimlane turbine prerequisites sophos central access requirements you must have sophos central administrator permissions to access sophos central admin console create and manage api credentials retrieve tenant and region information authorize api access for integrations required credentials during setup you will collect sophos central api base url (data region url) client id client secret x‑tenant‑id (optional but recommended) token url register a sophos central api client log in to the sophos central admin console at https //central sophos com navigate to global settings open the api credentials management section click add credential provide a name and description for the api credential assign the required access permissions for the integration click save to generate credentials copy the client id and client secret store the credentials securely retrieve tenant information after creating api credentials, navigate to the sophos central dashboard locate your tenant id from the sophos central environment alternatively call the whoami api endpoint to retrieve tenant details copy the tenant id value for use in the swimlane asset configuration determine the sophos data region url sophos central uses regional api endpoints the base api url depends on the region where your sophos central tenant is hosted region api url example united states https //api central sophos com europe https //api eu central sophos com australia https //api au central sophos com india https //api in central sophos com connector configuration in swimlane log in to turbine from the left navigation pane click orchestration and select assets click the plus (+) icon to create a new asset select sophos central from the asset type list fill in the asset settings and asset input fields as shown below click create field description required url base api url for the sophos central data region required client id sophos central api client id required client secret sophos central api client secret required x tenant id sophos tenant identifier optional token url oauth token endpoint for sophos central optional scope optional oauth permission scopes optional verify ssl enable or disable ssl verification optional http proxy proxy configuration if api traffic requires proxy optional troubleshooting ensure the client id and client secret are copied correctly from the sophos central console verify the api url corresponds to the correct sophos region if authentication fails, regenerate the api credentials and update the swimlane asset confirm the integration permissions assigned to the api credential allow the required api actions ensure outbound network access to sophos central api endpoints is allowed if your environment uses a proxy, configure the http proxy parameter result you have successfully authenticated the sophos central connector in swimlane sources https //developer sophos com/docs https //developer sophos com/docs https //developer sophos com/docs/getting started with apis https //developer sophos com/docs/getting started with apis https //developer sophos com/docs/common api https //developer sophos com/docs/common api