# Connecting Robots to Orchestrator

> You can connect your robots to Orchestrator in different ways based on the robot authentication settings configured in Orchestrator, typically by an administrator. If you are not aware of any robot authentication settings, please ask your Orchestrator administrator to provide details so as to be able to use the right method to connect your robot.

You can connect your robots to Orchestrator in different ways based on the robot authentication settings configured in Orchestrator, typically by an administrator. If you are not aware of any robot authentication settings, please ask your Orchestrator administrator to provide details so as to be able to use the right method to connect your robot.

## What Are My Authentication Settings

The robot authentication settings can be seen and configured on **Tenant > Settings**, on the **Robot security** tab, usually by an administrator. Your Orchestrator administrator should provide you with details so as to be able to use the right method to connect your robot.

[More on robot authentication](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/robot-authentication#robot-authentication).

[Instructions on how to change robot authentication settings](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/robot-authentication#robot-authentication).

## Connecting Attended Robots to Orchestrator

### Using the Service URL (Interactive Sign-In)

Sign in with your credentials to connect your robot to Orchestrator. This gives the robot access to Orchestrator resources and provides the user with operational rights to products such as Studio or the Assistant.

1. Open the Assistant.
2. On the **Preferences** menu, select **Orchestrator settings**. The **Orchestrator configuration** window is displayed.
3. For the **Connection type** field, select **Service URL**. The content of the window is adjusted according to the selection.
4. For the **Service URL** field, enter the URL of the Orchestrator instance you want to connect to.
5. Select **Sign In**. You are directed to the **Login** page of your Orchestrator instance.
6. Log in as usual.

Once your identity is confirmed, the Assistant is populated with the automations in the Orchestrator folders you can access.

Figure 1. Connecting using the Service URL

![Screenshot of the Orchestrator configuration interface](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-screenshot-of-the-orchestrator-configuration-interface-226343-a7985807-e480abe6.webp)

:::note
* When using Interactive Sign-In, there is no need to create [machine objects](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/about-machines#machines) in Orchestrator.
* You require the **View** permission on **Packages** at the tenant level to download packages and libraries.
:::

### Using the Client Credentials in the Assistant

Use client credentials to connect attended robots to Orchestrator. The client ID - client secret pair is generated via machine template objects in Orchestrator.

There are two ways to connect your robot with client credentials: using the Assistant or the command line.

1. Open the Assistant.
2. On the **Preferences** menu, select **Orchestrator settings**. The **Orchestrator configuration** window is displayed.
3. For the **Connection type** field, select **Client ID**. The content of the window is adjusted according to the selection.
4. For the **Orchestrator URL** field, enter the URL of the Orchestrator instance to which you want to connect.

Make sure to add the Orchestrator URL and the `AccountLogicalName` and `ServiceName`, such as `https://cloud.uipath.com/uipathtokyo/uipathkyoto/`.

5. For the **Client ID** field, enter the client ID generated by the machine object in Orchestrator.
6. For the **Client Secret** field, enter the client secret generated by the machine object in Orchestrator.
7. Select **Connect**. The robot is now connected to Orchestrator.

Figure 2. Connecting using Client ID

![Screenshot of the Orchestrator configuration interface](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-screenshot-of-the-orchestrator-configuration-interface-226503-931ef820-30ef1246.webp)

### Using the Client Credentials in the Command Line

1. Open Command Prompt.
2. Go to the directory where your robot is installed. For example:
   ```
   cd C:\Program Files\UiPath\Studio
   ```
3. Use the `--connect`, `--url`, `--clientID`, and `--clientSecret` command-line arguments to connect your robot and pass the Orchestrator URL, client ID, and client secret. For example:
   ```
   UiRobot.exe --connect --url <OrchestratorURL> --clientID <clientID> --clientSecret <clientSecret>
   ```
   :::note
   When using PowerShell, you need to escape the `$` character in the client secret using "". For example, you should pass a client secret such as `Bepx8O3XqSHrt$ZU` as `"Bepx8O3XqSHrt""$""ZU"`.
   :::

## Connecting Unattended Robots to Orchestrator

In unattended automation, the host machine is connected and licensed in unattended mode so the designated way to execute processes is Orchestrator. If you want to use the machine in attended mode (opening the Assistant) when Interactive Sign-In is enforced, you need to sign in, otherwise you cannot see the processes in the Assistant, and the robot appears as "Connected, Unlicensed".

### Using the Client Credentials in the Assistant

Use client credentials to connect unattended robots to Orchestrator. The client ID - client secret pair is generated via machine template objects in Orchestrator.

There are two ways to connect your robot with client credentials: using the Assistant or the command line.

1. Open the Assistant.
2. On the **Preferences** menu, select **Orchestrator settings**. The **Orchestrator configuration** window is displayed.
3. For the **Connection type** field, select **Client ID**. The content of the window is adjusted according to the selection.
4. For the **Orchestrator URL** field, enter the URL of the Orchestrator instance to which you want to connect.

Make sure to add the Orchestrator URL and the `AccountLogicalName` and `ServiceName`, such as `https://cloud.uipath.com/uipathtokyo/uipathkyoto/`.

5. For the **Client ID** field, enter the client ID generated by the machine object in Orchestrator.
6. For the **Client Secret** field, enter the client secret generated by the machine object in Orchestrator.
7. Select **Connect**. The robot is now connected to Orchestrator.

Figure 3. Connecting using Client ID

![Screenshot of the Orchestrator configuration interface](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-screenshot-of-the-orchestrator-configuration-interface-226503-931ef820-30ef1246.webp)

On a successful connection, Assistant will display a warning dot, followed by the `Connected as Unattended` message.

The warning is displayed when connected to an active Windows session and you are missing attended capabilities. To enable **Attended** mode, sign in with your RPA Developer account.  

![UiPath Assistant displaying the warning dot and 'Connected as Unattended' status message.](https://dev-assets.cms.uipath.com/assets/images/orchestrator/UiPath_Assistant-621f485d.webp)

:::note
When you are connected as Unattended, the following error will be logged in **Windows Event Viewer** > **Application events**:

UiPath.Service.Host 25.10.7.0

[Http Status 401][Orchestrator Error Code

InvalidLoginMethod]UiPath.Robot.Core.Orchestrator.OrchestratorHttpException

Could not obtain user token. You are connected as Unattended, sign in, or enable the troubleshooting session from Orchestrator.
::: 

### Using the Client Credentials in the Command Line

1. Open Command Prompt.
2. Go to the directory where your robot is installed. For example:
   ```
   cd C:\Program Files\UiPath\Studio
   ```
3. Use the `--connect`, `--url`, `--clientID`, and `--clientSecret` command-line arguments to connect your robot and pass the Orchestrator URL, client ID, and client secret. For example:
   ```
   UiRobot.exe --connect --url <OrchestratorURL> --clientID <clientID> --clientSecret <clientSecret>
   ```
   :::note
   When using PowerShell, you need to escape the `$` character in the client secret using "". For example, you should pass a client secret such as `Bepx8O3XqSHrt$ZU` as `"Bepx8O3XqSHrt""$""ZU"`.
   :::

## Update the Default Orchestrator URL for Mac

To update the default Orchestrator URL service when using the Assistant on a Mac, change it from store.json (/Applications/UiPath Assistant.app/Contents/Robot/uipath.config~/Library/Application Support/UiPath/store.json):

```
"MAIN_WINDOW_SERVICE_LOGIN_DETAILS": {
        "nextServiceUrl": "https://cloud.uipath.com",
        "defaultServiceUrl": "https://cloud.uipath.com"
    }
```