Accéder au contenu principal Passer au contenu complémentaire

S'authentifier à une API REST Talend Cloud Data Stewardship

Vous aurez parfois besoin d'accéder à des API REST Talend Cloud Data Stewardship et d'effectuer des actions comme vérifier les événements d'audit ou lister des campagnes en particulier. Pour ce faire, vous devez implémenter une méthode d'authentification et d'autorisation d'API.

Les requêtes d'API nécessitent des jetons d'accès. Pour plus d'informations, consultez Générer un jeton d'accès personnel.

Procédure

  1. Récupérez un jeton d'authentification en suivant l'une des méthodes suivantes :
    • Si le SSO est activé, générez un jeton d'accès depuis le portail Cloud.
    • Si le SSO n'est pas activé, ouvrez un terminal et exécutez une requête POST pour appeler un identifiant API.

      Cette API fournit un jeton d'authentification dans l'en-tête de réponse authorization.

    Vous trouverez ci-dessous un exemple de requête POST de connexion et sa réponse utilisant un identifiant et un mot de passe.

    Exemple

    curl -v -X POST '<TDS_URL>/data-stewardship/login?client-app=STUDIO' -F username=<USERNAME> -F password=<PASSWORD>
    > POST /data-stewardship/login?client-app=STUDIO HTTP/1.1
    > Host: <TDS-HOST>
    > User-Agent: curl/7.47.0
    > Accept: */*
    ...
    < access-control-expose-headers: authorization
    < authorization: Bearer eyJraWQiOiJpYW0tb2lkYy1jbG91ZCIsImQu2WembcCA
    ...
  2. Dans les appels d'API Talend Cloud Data Stewardship, saisissez le jeton généré depuis Talend Cloud ou récupéré par la requête POST .
    Vous trouverez ci-dessous un exemple de requête pour lister les campagnes appartenant à un gestionnaire de campagnes en particulier et la réponse correspondante.

    Exemple

    curl -X GET 'https://<TDS-HOST>/data-stewardship/api/v1/campaigns/owned'
     -H 'Authorization: Bearer eyJraWQiOiJpYW0tb2lkYy1jbG91ZCIsImQu2WembcCA'
    Response:
    []

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !