# BigFix (formally IBM BigFix)

## Connection Requirements

{% stepper %}
{% step %}

### IP

BigFix Server IP Address.
{% endstep %}

{% step %}

### Port

Port number (optional, default: 52311).
{% endstep %}

{% step %}

### Username

The username which is going to be used by OctoXLabs CSAM PLATFORM Asset to fetch data from BigFix.

The following conditions must be satisfied to use the BigFix REST API:

* The WebReports service must be running. If you installed multiple Web Reports servers, local or remote, the Web Reports server that is selected for using the REST API is the first entry that appears in the table dbo.AGGREGATEDBY contained in the database BFEnterprise.
* The user logging into the REST API must be defined as a BigFix Console operator (<https://help.hcltechsw.com/bigfix/10.0/platform/Platform/Console/c\\_adding\\_local\\_operators.html>) with the Can use REST API and the Custom Content permissions set to YES in its definition or in one of the assigned roles.
* If you plan to use the REST API over HTTPS, you must apply the configuration described in Customizing HTTPS on REST API.
* The IEM CLI does not support the BigFix FIPS-compliant cryptography library. If you plan to use that library in your REST API HTTP environment, use a different REST API Client.
* Ensure that the font set in the command prompt properties of your workstation is set to a value different from Raster Fonts, otherwise you might get this warning message "Warning: Current console font may not display locale characters correctly".
  {% endstep %}

{% step %}

### Password

The Password of the provided username.
{% endstep %}

{% step %}

### Is Secure?

IP address secure or not.
{% endstep %}

{% step %}

### Use Query Based Version?

Instead of conventional request you may prefer to use the query endpoint.

Example query:

{% code title="Example Query" %}

```
(names of it, ids of it, last report time of it, operating systems of it, ip addresses of it, agent versions of it) of bes computers whose (name of it = "name_of_the_hosts_will_be_here")
```

{% endcode %}
{% endstep %}

{% step %}

### BES Property For Installed Softwares

In addition to our base query, if you want to fetch installed software information on computers, you need to create a report on BigFix and enter the name of the analyze in here.
{% endstep %}

{% step %}

### Timeout

Amount of time that will be waited for API response. (default: 90)
{% endstep %}

{% step %}

### Thread Count

Amount of multiple threads that will be generated during discovery process. (max: 32, min: 1, default: 32)

Note: Increasing the number may decrease the discovery time for this adapter; however, it will use more resources.
{% endstep %}

{% step %}

### Sleep

Amount of time that will be waited between thread generation. (default: 0)
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Please perform a connection test to ensure there is a valid connection to the host.

When the discovery operation is finalized, you will be able to see the details on the Assets page.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.octoxlabs.com/adapters/adapters/bigfix-formally-ibm-bigfix.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.