> ## 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.

# Activité Vantage Scope

> L’activité Vantage Scope transmet aux activités imbriquées du connecteur UiPath les paramètres de connexion ABBYY Vantage, les paramètres de proxy et ceux du client d’API public.

**Vantage Scope** est le conteneur dans lequel doivent être placées toutes les autres activités du connecteur UiPath : Use Skill, Get Results et Map Fields s’exécutent toutes de manière imbriquée dans un Scope. Le Scope contient les identifiants, les paramètres de proxy et les paramètres du client d’API public partagés par les activités imbriquées, afin que vous ne configuriez les détails de connexion qu’une seule fois par workflow.

<Warning>
  L’activité Vantage Scope vous permet de configurer l’authentification à l’aide des flux Resource Owner Password Credentials Flow et Client Credentials Flow. Si vous configurez un fournisseur d’identité externe dans Vantage, le seul flux d’authentification utilisable est le Client Credentials Flow.
</Warning>

Pour plus d’informations, voir :

<CardGroup cols={3}>
  <Card title="Fournisseur d’identité externe" icon="user-shield" href="/fr/vantage/documentation/tenant-admin/tenant-management/external-identity-provider">
    Configurez l’authentification unique via un fournisseur d’identité OAuth 2.0 ou SAML 2.0 pour votre tenant Vantage.
  </Card>

  <Card title="Client d’API public" icon="key" href="/fr/vantage/documentation/tenant-admin/tenant-management/configure-client">
    Créez et configurez un client d’API public pour vous authentifier auprès de l’API Vantage.
  </Card>

  <Card title="Authentification" icon="shield-check" href="/fr/vantage/developer/authentication/authentication">
    Choisissez un flux OAuth 2.0 et obtenez un jeton d’accès.
  </Card>
</CardGroup>

<div id="activity-properties">
  ## Propriétés de l’activité
</div>

<div id="connection-settings">
  ### Paramètres de connexion
</div>

| Property                     | Type                                  | Description                                                                                                                                                                                                                                                                                                                                                                           |
| ---------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type d’octroi d’autorisation | `IEnumerable<AuthorizationGrantType>` | Le type d’octroi utilisé pour l’autorisation : `ResourceOwnerPassword` ou `ClientCredentials`.                                                                                                                                                                                                                                                                                        |
| Mot de passe                 | `String`                              | Mot de passe utilisé pour se connecter à ABBYY Vantage.                                                                                                                                                                                                                                                                                                                               |
| Mot de passe sécurisé        | `SecureString`                        | Mot de passe sécurisé utilisé pour se connecter à ABBYY Vantage.                                                                                                                                                                                                                                                                                                                      |
| URL du serveur               | `String`                              | Adresse du serveur ABBYY Vantage.                                                                                                                                                                                                                                                                                                                                                     |
| Tenant                       | `String`                              | Nom du tenant ABBYY Vantage ou identifiant du tenant. Cette propriété n’est requise que si l’utilisateur dont les identifiants servent à se connecter au serveur ABBYY Vantage est enregistré dans plusieurs tenants (plus d’un) sur le serveur. Le nom du tenant se trouve sur la page de connexion à Vantage dans votre navigateur, au moment où vous saisissez votre mot de passe. |
| Nom d’utilisateur            | `String`                              | Adresse e-mail de l’utilisateur utilisée pour se connecter à ABBYY Vantage.                                                                                                                                                                                                                                                                                                           |

<div id="proxy-settings-optional">
  ### Paramètres du proxy (facultatif)
</div>

| Propriété             | Type           | Description                                                          |
| --------------------- | -------------- | -------------------------------------------------------------------- |
| Activer le proxy      | `Boolean`      | Permet d’utiliser un serveur proxy pour acheminer les requêtes HTTP. |
| URL du serveur        | `String`       | L’adresse du serveur proxy (par ex. `http://127.0.0.1:8080`).        |
| Nom d’utilisateur     | `String`       | Le nom d’utilisateur utilisé pour se connecter au serveur proxy.     |
| Mot de passe          | `String`       | Le mot de passe utilisé pour se connecter au serveur proxy.          |
| Mot de passe sécurisé | `SecureString` | Le mot de passe sécurisé utilisé pour se connecter au serveur proxy. |

<div id="public-api-client-settings-optional">
  ### Paramètres du client d’API public (facultatif)
</div>

| Property               | Type           | Description                                                            |
| ---------------------- | -------------- | ---------------------------------------------------------------------- |
| ID client              | `String`       | Identifiant de l’application Vantage.                                  |
| Secret client          | `String`       | Clé sécurisée de l’application Vantage.                                |
| Secret client sécurisé | `SecureString` | Clé sécurisée de l’application Vantage sous forme de chaîne sécurisée. |

<div id="manage-credentials">
  ### Gérer les identifiants
</div>

Le mot de passe de l’utilisateur Vantage, le mot de passe du proxy et le secret client dans les paramètres du client peuvent être définis dans l’activité Scope, soit dans un paramètre de chaîne, soit dans le paramètre correspondant de type `SecureString`.

Un mot de passe de type `String` est stocké en texte brut dans le fichier de projet XAML et n’est pas sécurisé. Un mot de passe `String` n’est recommandé que pour configurer les activités **Use Skill** et **Map Fields** afin d’obtenir la liste des compétences, ou pour déboguer votre processus UiPath. Une fois le processus entièrement configuré :

* Si vous utilisez le Resource Owner Password Credentials Flow, supprimez la propriété **Password** de l’activité Vantage Scope et configurez la propriété **Secure Password**.
* Si vous utilisez le Client Credentials Flow, supprimez la propriété **Client Secret** de l’activité Vantage Scope et configurez la propriété **Secure Client Secret**.

Nous vous recommandons d’utiliser les [assets UiPath Orchestrator](https://docs.uipath.com/orchestrator/docs/about-assets) pour stocker vos identifiants en toute sécurité. Utilisez l’activité **Get Credential** pour récupérer le mot de passe depuis Orchestrator et le transmettre à l’activité Vantage Scope via une variable.

<Warning>
  Le même type de mot de passe doit être utilisé pour les Paramètres de connexion, les Paramètres du proxy et les Paramètres du client.
</Warning>

<div id="configure-the-vantage-public-api-client">
  ### Configurer le client d’API public Vantage
</div>

Lorsque vous créez un client dans ABBYY Vantage, configurez les éléments suivants dans la section **OAuth 2.0 Flows Settings** des paramètres du client, selon le type d’octroi que vous utilisez :

| Flux d’autorisation                      | Paramètres client OAuth 2.0 à activer                                                                                                                      |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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**, ainsi que les rôles requis sélectionnés via **Manage Roles** |

<Warning>
  Si vous sélectionnez, via **Manage Roles**, un ou plusieurs rôles associés à des compétences, sélectionnez également les compétences autorisées pour ces rôles.
</Warning>

Pour plus d’informations sur les rôles ABBYY Vantage, consultez [Contrôle d’accès fondé sur les rôles](/fr/vantage/documentation/tenant-admin/tenant-management/role-based-access).

<div id="fill-in-the-activity-fields">
  ### Renseignez les champs de l’activité
</div>

<Note>
  Si toutes les propriétés des paramètres du client d’API public Vantage sont vides, le client ABBYY Vantage par défaut est utilisé.
</Note>

<Tabs>
  <Tab title="Resource Owner Password Credentials Flow">
    Champs à renseigner pour ce flux :

    <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="Champs de l’activité Vantage Scope pour le Resource Owner Password Credentials Flow" width="1038" height="1006" data-path="images/vantage/developer/connectors/uipath/scope-ropc.jpg" />
    </Frame>
  </Tab>

  <Tab title="Client Credentials Flow">
    Champs à renseigner pour ce flux :

    <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="Champs de l’activité Vantage Scope pour le Client Credentials Flow" width="1044" height="1030" data-path="images/vantage/developer/connectors/uipath/scope-cc.jpg" />
    </Frame>
  </Tab>
</Tabs>

<div id="configure-proxy-settings">
  ## Configurer les paramètres du proxy
</div>

Vous pouvez configurer, au moment de l’exécution, les requêtes du connecteur pour qu’elles transitent par un serveur proxy. Les types d’authentification proxy suivants sont pris en charge : Basic, NTLM, authentification IP et proxy transparent.

Pour utiliser un proxy, sélectionnez l’activité **Vantage Scope**. Dans le groupe de propriétés **Proxy Settings (optional)**, définissez la valeur de la propriété **Enable Proxy** sur `"true"`, puis spécifiez l’adresse de votre serveur proxy dans la propriété **Server URL**.

<Tabs>
  <Tab title="Authentification Basic">
    Indiquez, dans les propriétés **Username** et **Password / Secure Password**, les identifiants de connexion au proxy.
  </Tab>

  <Tab title="Authentification NTLM">
    Les champs **Username** et **Password** sont facultatifs. Si les champs **Username** et **Password** sont vides, les identifiants de l’utilisateur exécutant le processus UiPath sont utilisés.
  </Tab>
</Tabs>

<div id="related-topics">
  ## Sujets connexes
</div>

<CardGroup cols={3}>
  <Card title="Use Skill activity" icon="play" href="/fr/vantage/connectors/uipath/activities/use-skill">
    Créer une transaction ABBYY Vantage pour traiter un document avec une compétence.
  </Card>

  <Card title="Get Results activity" icon="circle-down" href="/fr/vantage/connectors/uipath/activities/get-results">
    Récupérer les résultats du traitement depuis ABBYY Vantage.
  </Card>

  <Card title="Map Fields activity" icon="arrow-right-arrow-left" href="/fr/vantage/connectors/uipath/activities/map-fields">
    Enregistrer les valeurs des champs extraites dans des variables UiPath.
  </Card>
</CardGroup>
