# Registering the connector

After a connector has been started, it must be registered with OpenIAM so that it can receive messages that are being sent by the other services in OpenIAM. These messages will tell the connector what to do. Examples of messages include:

* find a user;
* create a user; and
* reset a password.

To register a connector, go to: **Webconsole** > **Provisioning** > **Connectors**.

You will see a list of connectors that have already been registered out of the box. Unless you are working with a custom connector, your connector should already be registered on this list. To configure it, click the **Actions** button next to the connector and you will see the screen below.

<figure><img src="/files/a87596158f5a6608d59aa07f2efbc0d4e14accb5" alt=""><figcaption></figcaption></figure>

Make note of the value in the first **Connector Queue** as you will need to add this to the server side connector configuration as well.

{% hint style="info" %}
You can replace the queue name value with any unique alpha-numeric sequence with no spaces.
{% endhint %}

### Adding the queue name to the connector configuration

To add the queue name to the connector configuration, follow the steps described below.

{% stepper %}
{% step %}

### Copy start script

Copy the `start.sh` file into `connectors` and call it <kbd>\[connector name]\_start.sh</kbd>.
{% endstep %}

{% step %}

### Add Java options

Open the new start script file and add the following Java options:

```bash
-Dorg.openiam.connector.queue=[Connector Queue]_Request
-Dorg.openiam.connector.queueResponseName=[Connector Queue]_Response
```

{% endstep %}

{% step %}

### Create systemd service

Copy the system service file `/etc/systemd/system/openiam-connector\@.service` to `/etc/systemd/system/openiam-connector-[connector-name].service` and change the `ExecStart` property to point to the new `[connector name]_start.sh`.
{% endstep %}

{% step %}

### Start the connector

Start the connector with:

```bash
./start.sh connector-file-name
```

{% endstep %}
{% endstepper %}

The example for the connector is shown below.

<figure><img src="/files/f98c7dd44c36b805d943db4bcac3a05c9201d905" alt=""><figcaption></figcaption></figure>

New Java options look as follows.

```bash
-Dorg.openiam.connector.queue=TestDb_Connector_0001_Request
-Dorg.openiam.connector.queueResponseName=TestDb_Connector_0001_Response
```


---

# 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-beta.openiam.com/application-onboarding/connectors/registering-the-connector.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.