Authentification authentication
Vue d’ensemble
La variable Edge Network Server API gère à la fois la collecte de données authentifiées et non authentifiées, en fonction de la source des événements et du domaine de collecte de l’API.
Pour chaque requête, la variable Server API vérifie le flux de données access type . Grâce à ce paramètre, les clients peuvent configurer un flux de données pour accepter les données authentifiées ou les données authentifiées et non authentifiées. Par défaut, les deux types de données sont acceptés.
Pour plus d’informations sur la configuration du type d’accès au flux de données, consultez la documentation sur la manière de créer et configurer un flux de données.
Vous trouverez ci-dessous un résumé du comportement, basé sur le flux de données Access Type configuration et le point de terminaison sur lequel la requête est reçue.
Appels API provenant d’un serveur privé sur server.adobedc.net
doit toujours être authentifié.
Conditions préalables prerequisites
Avant d’effectuer des appels à la fonction Server API, assurez-vous de respecter les conditions préalables suivantes :
- Vous disposez d’un compte d’organisation ayant accès à Adobe Experience Platform.
- Votre compte d’Experience Platform a la variable
developer
etuser
rôles activés pour le profil de produit de l’API Adobe Experience Platform. Contactez votre Admin Console pour activer ces rôles pour votre compte. - Vous avez une Adobe ID. Si vous ne possédez pas d’Adobe ID, accédez à la Console Adobe Developer et créez un compte.
Collecte des informations d’identification credentials
Pour lancer des appels aux API Platform, vous devez d’abord suivre le tutoriel sur l’authentification. Le tutoriel sur l’authentification indique les valeurs de chacun des en-têtes requis dans tous les appels API Experience Platform, comme illustré ci-dessous :
- Authorization: Bearer
{ACCESS_TOKEN}
- x-api-key :
{API_KEY}
- x-gw-ims-org-id:
{ORG_ID}
Les ressources d’Experience Platform peuvent être isolées dans des sandbox virtuels spécifiques. Dans les requêtes aux API Platform, vous pouvez spécifier le nom et l’identifiant du sandbox dans lequel l’opération aura lieu. Il s’agit de paramètres facultatifs.
- x-sandbox-name:
{SANDBOX_NAME}
Toutes les requêtes qui contiennent un payload (POST, PUT, PATCH) nécessitent un en-tête de type de média supplémentaire :
- Content-Type:
application/json
Configuration des autorisations d’écriture de jeux de données dataset-write-permissions
Pour configurer les autorisations d’écriture de jeux de données, accédez au Admin Console, recherchez le profil de produit associé à votre clé API, puis définissez les autorisations suivantes :
- Dans le Environnements de test , sélectionnez l’environnement de test datastream .
- Dans le Data Management , sélectionnez Gestion des jeux de données autorisation.
Dépannage des erreurs d’autorisation troubleshooting-authorization
EXEG-0500-401
Ce message d'erreur s'affiche dans l'une des situations suivantes :
- La variable
authorization
valeur d’en-tête manquante. - La variable
authorization
La valeur d’en-tête n’inclut pas la valeur requiseBearer
jeton. - Le format du jeton d’autorisation fourni n’est pas valide.
- Le flux de données nécessite une authentification, mais les en-têtes requis ne sont pas présents dans la requête.
EXEG-0501-401
Ce message d'erreur s'affiche dans l'une des situations suivantes :
- L’appel API n’a pas le paramètre requis
x-user-token
en-tête . - Le format du jeton utilisateur fourni n’est pas valide.
EXEG-0502-401
EXEG-0503-401
EXEG-0504-401
Ce message d'erreur s'affiche dans l'une des situations suivantes :
- Le compte de développeur n’a pas accès au contexte du produit Adobe Experience Platform.
- Le compte de la société n’est pas encore autorisé à Adobe Experience Platform.
EXEG-0505-401
acp.foundation
Portée IMS.EXEG-0506-401
WRITE
accès à l’environnement de test de l’Experience Platform dans lequel le flux de données est défini.