> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vantage Scope activity

> Vantage Scope activity passes ABBYY Vantage connection settings, proxy settings, and Public API Client settings to nested UiPath connector activities.

**Vantage Scope** is the container every other UiPath connector activity must live inside. **Use Skill**, **Get Results**, and **Map Fields** all run nested within a Scope. The Scope holds the credentials, proxy settings, and Public API Client settings that the nested activities share, so you configure connection details once per workflow.

<Warning>
  The **Vantage Scope** activity allows you to configure authentication using Resource Owner Password Credentials Flow and Client Credentials Flow. If you set up an External Identity Provider in Vantage, the only authentication flow that will work is the Client Credentials Flow.
</Warning>

For more information about authentication and Public API clients, see:

* [Set up an External Identity Provider](/vantage/documentation/tenant-admin/tenant-management/external-identity-provider)
* [Creating, configuring, and deleting a Public API client](/vantage/documentation/tenant-admin/tenant-management/configure-client)
* [Authentication](/vantage/developer/authentication/authentication)

## Activity properties

### Connection Settings

| Property                 | Type                                  | Description                                                                                                                                                                                                                                          |
| ------------------------ | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Authorization grant type | `IEnumerable<AuthorizationGrantType>` | The grant type that is used for authorization: `ResourceOwnerPassword` or `ClientCredentials`.                                                                                                                                                       |
| Password                 | `String`                              | The password used to connect to ABBYY Vantage.                                                                                                                                                                                                       |
| Secure Password          | `SecureString`                        | The secure password used to connect to ABBYY Vantage.                                                                                                                                                                                                |
| Server URL               | `String`                              | The ABBYY Vantage server address.                                                                                                                                                                                                                    |
| Tenant                   | `String`                              | The ABBYY Vantage tenant name or tenant identifier. Required only if the connecting user is registered in more than one tenant on the server. You can find the tenant name on the Vantage sign-in page in your browser when you enter your password. |
| Username                 | `String`                              | The user email address used to connect to ABBYY Vantage.                                                                                                                                                                                             |

### Proxy Settings (optional)

| Property        | Type           | Description                                              |
| --------------- | -------------- | -------------------------------------------------------- |
| Enable Proxy    | `Boolean`      | Allows you to use a proxy server to route HTTP requests. |
| Server URL      | `String`       | The proxy server address (e.g. `http://127.0.0.1:8080`). |
| Username        | `String`       | The username used to connect to the proxy server.        |
| Password        | `String`       | The password used to connect to the proxy server.        |
| Secure Password | `SecureString` | The secure password used to connect to the proxy server. |

### Public API Client Settings (optional)

| Property             | Type           | Description                                         |
| -------------------- | -------------- | --------------------------------------------------- |
| Client Id            | `String`       | Vantage application identifier.                     |
| Client Secret        | `String`       | Secure Vantage application key.                     |
| Secure Client Secret | `SecureString` | Secure Vantage application key as a secured string. |

## Manage credentials

Set the Vantage user password, proxy password, and Client Secret in the **Vantage Scope** activity. Use either a string parameter or the corresponding `SecureString` parameter.

A password of type `String` is stored as plain text in the XAML project file, which is not safe. Use a `String` password only when configuring the **Use Skill** and **Map Fields** activities to obtain the list of skills, or for debugging your UiPath process. Once the process is fully configured:

* If you use Resource Owner Password Credentials Flow, remove the **Password** property from the Vantage Scope activity and set up the **Secure Password** property.
* If you use Client Credentials Flow, remove the **Client Secret** property from the Vantage Scope activity and set up the **Secure Client Secret** property.

Store credentials in [UiPath Orchestrator assets](https://docs.uipath.com/orchestrator/docs/about-assets). Use the **Get Credential** activity to retrieve the password from Orchestrator and pass it to the **Vantage Scope** activity via a variable.

<Warning>
  The same type of password must be used for **Connection Settings**, **Proxy Settings**, and **Public API Client Settings**.
</Warning>

## Configure the Vantage Public API client

When you create a client in ABBYY Vantage, configure the **OAuth 2.0 Flows Settings** section for the grant type you use:

| Authorization flow                       | OAuth 2.0 client settings to enable                                                                                                                 |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Resource Owner Password Credentials Flow | **Allow Resource Owner Password Credentials Flow**                                                                                                  |
| Client Credentials Flow                  | **Allow issuing refresh tokens to refresh access tokens**, **Allow client credentials flow**, plus the required roles selected via **Manage Roles** |

<Warning>
  If you select one or more roles associated with skills via **Manage Roles**, also select the allowed skills for these roles.
</Warning>

For more information about ABBYY Vantage roles, see [Role-based access control](/vantage/documentation/tenant-admin/tenant-management/role-based-access).

## Fill in the activity fields

<Note>
  If all the properties in the Vantage Public API Client Settings are empty, the default ABBYY Vantage client is used.
</Note>

### Resource Owner Password Credentials Flow

The following fields are required for this flow.

<Frame>
  <img src="https://mintcdn.com/abbyy/Km9nwnkPeY8_wARd/images/vantage/developer/connectors/uipath/scope-ropc.jpg?fit=max&auto=format&n=Km9nwnkPeY8_wARd&q=85&s=22e34d947174db96d438b1fa57c1cac5" alt="Vantage Scope activity fields for Resource Owner Password Credentials Flow" width="1038" height="1006" data-path="images/vantage/developer/connectors/uipath/scope-ropc.jpg" />
</Frame>

### Client Credentials Flow

The following fields are required for this flow.

<Frame>
  <img src="https://mintcdn.com/abbyy/Km9nwnkPeY8_wARd/images/vantage/developer/connectors/uipath/scope-cc.jpg?fit=max&auto=format&n=Km9nwnkPeY8_wARd&q=85&s=7bd045b77f4c7f3629a27e86cf32ee6b" alt="Vantage Scope activity fields for Client Credentials Flow" width="1044" height="1030" data-path="images/vantage/developer/connectors/uipath/scope-cc.jpg" />
</Frame>

## Configure proxy settings

You can configure connector requests at runtime to go through a proxy server. The following proxy authentication types are supported: Basic, NTLM, IP authentication, and transparent proxy.

To use a proxy, select the **Vantage Scope** activity. In the **Proxy Settings (optional)** properties group, set the **Enable Proxy** property to `true`. Then specify your proxy server address in the **Server URL** property.

### Basic authentication

In the **Username** and **Password / Secure Password** properties, specify the proxy connection credentials.

### NTLM authentication

The **Username** and **Password** fields are optional. If the **Username** and **Password** fields are empty, the credentials of the user running the UiPath process are used.

## Related topics

* [Use Skill activity](/vantage/connectors/uipath/activities/use-skill)
* [Get Results activity](/vantage/connectors/uipath/activities/get-results)
* [Map Fields activity](/vantage/connectors/uipath/activities/map-fields)
