xMATTERS

introduction this guide tells you how to authenticate the xmatters connector in swimlane using http basic authentication oauth 2 0 password credentials you will obtain xmatters credentials, configure oauth (if applicable), collect required identifiers, and configure the connector in swimlane prerequisites requirement description platform access access the xmatters platform user management view and manage users and devices workflow management create and manage workflows oauth configuration configure oauth clients (for oauth authentication) api access access api endpoints required credentials during setup, you will collect for http basic authentication url username password for oauth 2 0 password credentials url username password client id xmatters setup take the following steps to retrieve api endpoint url log in to your xmatters instance identify your base api url in the following format https //\<company> xmatters com/api/xm/1 verify access to the api endpoint oauth 2 0 setup (optional) take the following steps to obtain client id log in to the xmatters web interface navigate to workflows → oauth clients locate or create an oauth client copy the client id take the following steps to verify user credentials ensure the user account has sufficient permissions confirm username and password are active verify access to incidents, events, and devices connector configuration in swimlane log in to turbine from the left hand navigation pane, click orchestration and click assets asset homepage opens click the plus icon to open the configure your connector asset window select xmatters from the asset type list fill in the asset settings and asset input as shown configuration – http basic authentication field description required/optional url xmatters api base url required username xmatters username required password xmatters password required verify ssl enable/disable ssl verification optional http proxy optional proxy configuration optional configuration – oauth 2 0 password credentials field description required/optional url xmatters api base url required oauth2 username xmatters username required oauth2 password xmatters password required client id oauth client id required verify ssl enable/disable ssl verification optional http proxy optional proxy configuration optional fields with marks are required troubleshooting if authentication fails ensure the url is correct and accessible verify username and password are correct confirm the user has sufficient permissions ensure the client id is valid (for oauth) check if the oauth client is properly configured verify api access is enabled in xmatters check network or proxy restrictions you have successfully authenticated the xmatters connector in swimlane sources xmatters api documentation (official) https //help xmatters com https //help xmatters com xmatters oauth documentation https //help xmatters com/xmapi/ https //help xmatters com/xmapi/