Running a vendor extended integration locally

Complete the following steps to run a vendor extended integration locally.

1. Retrieve your integration ID
2. Create an API token
3. Download and install the basic integration
4. Edit the configuration file
5. Upload the configuration file

Retrieve your integration ID

Before you navigate away from your integration, copy your integration ID. The Integration ID is displayed in the sidebar of the integration overview page. 

Create an API token

Your Oomnitza token can be created in Configuration > Security > API tokens

Download and install the integration source code

If you have not done so already, you can download the integration source code and generate the config.inifile. Refer to Installing a basic integration and complete steps 1 to 3, depending on your operating system.

For more information, such as which Python version to install, review the documentation on GitHub.  

1. Download Python and the required dependencies. 
2. Download and install the Oomnitza basic integration.
3. Generate theconfig.inifile that will be used to store the Oomnitza credentials.

Edit the configuration file

Add or update the following information to your config.inifile.

[oomnitza]
url= https://<name_of_instance>.oomnitza.com 
api token = <my_Oomnitza_token> 

[managed.IntegrationID]
saas_authorization = {"headers": { "Authorization": "Bearer APIKey"}}

Integration ID

The IntegrationID should be replaced with the ID you retrieved previously. 

SaaS Authorization

For SaaS Authorization, you can only supply basic, session-based, or API key authentication. For example, for basic authentication, you might use:

[oomnitza]
url= https://<name_of_instance>.oomnitza.com 
api token = <my_Oomnitza_token>

[managed.IntegrationID]
saas_authorization = {"headers": {"Authorization": "Basic username:password"}}

For session-based authentication, you might use:

[oomnitza]
url = https://example.oomnitza.com
api_token = i_am_oomnitza_api_token_1

[managed.IntegrationID]
local_inputs = {"username": "john.smith", "password": "supErs3cr3T"}

Oomnitza GitHub Documentation

Important
You cannot use your AWS or OAuth credentials in managed mode. To use these authentication methods, you must select Cloud as the installation type when creating an extended integration. 

Upload the configuration file

To upload the integration information to Oomnitza, run the connector.py file.

python connector.py

Re-open the integration in the Configuration > Integrations menu and complete the following steps:

1. Select Launch to activate your integration.
2. Click Test Run.
3. Click Sync Sessions and copy the test run payload to the clipboard. If you encounter any errors, see troubleshooting integrations.
4. When the test run is successful, click Run Now.

Result
The user or asset data is streamed to Oomnitza.
To view the information that is collected about your assets, click Assets. To view the information about software, click the Software tab.  

To view the information that is collected about your users, click People. If you selected User plus SaaS User when running the user integration, you can also find a list of users in the Software > SaaS menu

Additional information 

Creating an API token

Integration errors