Configuration de l'accès aux API setting-up-api-access
Pour configurer l’accès aux API d’Adobe Campaign Standard, procédez comme suit. Chacune de ces étapes est détaillée dans la documentation Adobe Developer.
-
Vérifiez que vous disposez d’un certificat numérique, ou créez-en un si nécessaire. Les clés publique et privée fournies avec le certificat sont nécessaires dans les étapes suivantes.
-
Créez une nouvelle intégration avec Adobe Campaign Service dans Adobe Developer et configurez-la. Vos informations d’identification seront alors générées (clé d’API, secret client…).
-
Créez un jeton Web JSON (JWT) à partir des informations d’identification précédemment générées, et signez-le avec votre clé privée. Le jeton JWT code toutes les informations d’identité et de sécurité dont Adobe a besoin pour vérifier votre identité et vous accorder l’accès à l’API.
note important IMPORTANT JWT (JSON Web Tokens) est actuellement en cours d’obsolescence et est remplacé par OAuth. La transition se fera progressivement dans les prochaines versions de Campaign. Bien que les informations d’identification du compte de service (JWT) aient été marquées comme obsolètes, elles continueront de fonctionner jusqu’au 27 janvier 2025. Par conséquent, vous devez migrer votre application ou intégration pour utiliser les nouvelles informations d’identification OAuth serveur à serveur avant le 27 janvier 2025. L’authentification OAuth est préférable. Vous trouverez tous les éléments à migrer de l’authentification JWT vers l’authentification OAuth sur ces pages : -
Échangez votre JWT pour un jeton d’accès via une requête POST. Ce jeton d’accès devra être utilisé dans chaque en-tête de vos requêtes d’API.
Pour établir une session d’API Adobe I/O de service à service sécurisée, chaque requête adressée à un service Adobe doit inclure les informations ci-dessous dans l’en-tête d’autorisation.
-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'
-
<ORGANIZATION> : il s’agit de votre ORGANIZATION ID personnel, fourni par Adobe pour chacune de vos instances :
- <ORGANIZATION> : votre instance de production,
- <ORGANIZATION-mkt-stage> : votre instance d’évaluation.
Pour obtenir votre valeur ORGANIZATION ID, contactez votre administrateur ou votre administratrice ou votre contact technique Adobe. Vous pouvez également la récupérer dans Adobe I/O lors de la création d’une nouvelle intégration, dans la liste des licences (voir la documentation Adobe Developer).
-
<ACCESS_TOKEN> : votre jeton d’accès personnel, récupéré lors de l’échange de votre jeton Web JSON par le biais d’une requête POST.
-
<API_KEY> : votre clé d’API personnelle. Elle est fournie dans Adobe I/O après la création d’une nouvelle intégration avec Adobe Campaign Service.
Résolution des problèmes
Lors de l’intégration d’Adobe IO, si l’erreur suivante s’affiche :
{
"code": 502,
"message": "Oops. Something went wrong. Check your URI and try again."
}
Pour vérifier si le paramètre CNAME est correctement créé, contactez votre administrateur ou votre contact technique Adobe.