# Finding service connector credentials for Khaos Control

## Required credentials

To [add a Patchworks connector](/product-documentation/patchworks-services/service-connectors/adding-a-service-connector.md) for **Khaos Control**, the following API details are required for **Basic Auth** authentication:

<table><thead><tr><th>Credential</th><th data-type="checkbox">Required</th><th>Note</th></tr></thead><tbody><tr><td><a href="#building-your-url">URL</a></td><td>true</td><td>A standard form of URL is expected, with minor changes for your own company. </td></tr></tbody></table>

## Obtaining credentials

The credentials listed above are needed so that Patchworks can access the required data in **Khaos Control**. To obtain these details, follow the steps below.

### Building Your URL

The base URL is in the form:

```
https://IP or domain:port/khaosxxx.exe/wsdl/IKosWeb
```

You need to update some elements of this URL, as summarised below:

| URL Element  | Required Value                                                  | Notes                                                                                                                                                                                      |
| ------------ | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| https\://    | https or http                                                   | Either the HTTP or HTTPS URL can be used however for security reasons it is preferred that the HTTPS URL is used as this will ensure that data being passed to and from Khaos is encrypted |
| IP or domain | 159.65.213.32                                                   | For Patchworks to successfully send data to and get data from **Khaos Control**, the requesting IP address must be whitelisted.                                                            |
| khaosxxx.exe | Replace xxx with the value provided by Khaos for your instance. | This is often a shortened version of your company name - for example: `khaospwks.exe`.                                                                                                     |
| wsdl         | wsdl                                                            | No change required - static value.                                                                                                                                                         |
| IKosWeb      | IKosWeb                                                         | No change required - static value.                                                                                                                                                         |


---

# 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://doc.wearepatchworks.com/product-documentation/patchworks-services/service-systems/supported-service-systems/khaos-control-service-connector/finding-service-connector-credentials-for-khaos-control.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.
