# Utiliser une API pour ajouter des adresses IP à votre liste d'autorisation d'adresses IP

Disponible dans...

* Cloud API Services Platform
* Cloud Big Data
* Cloud Big Data Platform
* Cloud Data Fabric
* Cloud Data Integration
* Cloud Data Management Platform
* Cloud Pipeline Designer Standard Edition
* Data Fabric

Utilisez la méthode POST sur l'endpoint /v1/management/ip-allowlist/ips pour ajouter des IP à votre liste d'autorisation d'adresses IP.

Dans cet exemple, Talend API Tester est utilisé pour générer des requêtes d'API. Pour plus d'informations concernant Talend API Tester, consultez le [Guide d'utilisation de Talend Cloud API Tester](https://help.qlik.com/talend/r/fr-FR/Cloud/api-tester-user-guide).

## Avant de commencer

Prérequis : votre liste d'autorisation doit exister. Si non, créez-la à l'aide de la méthode POST sur l'endpoint /v1/management/ip-allowlist, comme présenté dans la section précédente. Tous les endpoints disponibles sont expliqués dans la section suivante.

## Procédure

1. Si vous n'avez pas encore de jeton d'accès personnel, dans l'onglet Users (Utilisateurs), générez un jeton d'accès personnel pour votre compte :
   1. Dans le coin en haut à droite, cliquez sur votre identifiant.
   2. Cliquez sur Profile preferences (Préférences du profil) &gt; Personal access tokens (Jetons d'accès personnel) &gt; Add token (Ajouter un jeton).
   3. Saisissez un nom pour le jeton et cliquez sur Generate (Générer).
2. Dans le champ près de la liste déroulante Method, saisissez l'endpoint de la liste d'autorisation d'IP à utiliser : https://api.&lt;your\_environment&gt;.cloud.talend.com/v1/management/ip-allowlist/ips

   Par exemple, votre environnement se présente comme suit :
   * ap
   * eu
   * us
   * us-west
   * au

   Pour plus d'informations concernant les environnements disponibles, consultez [Accéder aux applications Talend Cloud](https://help.qlik.com/talend/fr-FR/installation-guide-windows/Cloud/talend-cloud-application-url).
3. Dans la zone HEADERS, cliquez sur Add header. Dans le champ name qui s'affiche, saisissez Authroization et dans le champ value, saisissez Bearer, ainsi que votre jeton d'accès personnel. Saisissez un espace afin de séparer Bearer de votre jeton d'accès personnel.
4. Dans la zone Body, saisissez les IP suivantes :
   ### Exemple
   ```
   [
     {
       "description": "Data Prep user1",
       "ip": "230.65.223.167"
     },
     {
   	"description": "Data Prep user2",
       "ip": "230.65.223.169"
     }
   ]
   ```

   ![IP saisies dans la zone Body (Corps).](https://help.qlik.com/talend/fr-FR/management-console-user-guide/Resources/images/api_ip_allowlisting.png)
5. Cliquez sur Send pour envoyer votre requête.

## Résultats

Le code de statut 201 est retourné et les adresses IP sont ajoutées à votre liste d'autorisation. ![Liste d'IP bien ajoutées à la liste d'autorisation.](https://help.qlik.com/talend/fr-FR/management-console-user-guide/Resources/images/ip_allowlist_with_api.png)

De manière alternative, vous pouvez exécuter une commande curl dans votre invite de commande pour effectuer cette opération.

```
curl -X POST "https://api.<your_environment>.cloud.talend.com/v1/management/ip-allowlist/ips" -H "accept: */*" -H "Authorization: Bearer <your_access_token>" -H "Content-Type: application/json" -d "[ { \"description\": \"Data Prep user1\", \"ip\": \"230.65.223.167\" }, {\t\"description\": \"Data Prep user2\", \"ip\": \"230.65.223.169\" }]"
```