身份验证

概述

的 Edge Network Server API 根据事件源和API收集域,处理经过身份验证和未经身份验证的数据收集。

对于每个请求, Server API 验证数据流 access type 设置。 使用此设置,客户可以配置数据流以接受经过身份验证的数据,或者同时接受经过身份验证的数据和未经身份验证的数据。 默认情况下,两种类型的数据均被接受。

有关配置数据流访问类型的详细信息,请参阅有关如何 创建和配置数据流.

以下是基于数据流的行为摘要 Access Type 配置和接收请求的端点。

Access Type edge.adobedc.net server.adobedc.net
混合(默认) 不验证请求 验证请求
已验证 验证请求 验证请求

来自上的专用服务器的API调用 server.adobedc.net 应始终进行身份验证。

先决条件

在对 Server API,确保满足以下先决条件:

  • 您拥有有权访问Adobe Experience Platform的IMS组织帐户。
  • 您的Experience Platform帐户具有 developeruser 为Adobe Experience Platform API产品配置文件启用了角色。 联系您的 Admin Console 管理员为您的帐户启用这些角色。
  • 你有Adobe ID。 如果您没有Adobe ID,请转到 Adobe Developer控制台 并创建一个新帐户。

收集凭据

要调用Platform API,您必须先完成 身份验证教程. 完成身份验证教程可为所有Experience PlatformAPI调用中每个所需标头的值,如下所示:

  • 授权:持有者 {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Experience Platform中的资源可以与特定虚拟沙箱隔离。 在对Platform API的请求中,您可以指定操作将在其中进行的沙盒的名称和ID。 这些是可选参数。

  • x-sandbox-name: {SANDBOX_NAME}
注意

有关Experience Platform中沙箱的详细信息,请参阅 沙盒概述文档.

所有包含有效负载(POST、PUT、PATCH)的请求都需要额外的媒体类型标头:

  • Content-Type: application/json

配置数据集写入权限

要配置数据集写入权限,请转到 Admin Console,找到附加到您的API密钥的产品配置文件,并设置以下权限:

  • 在 沙箱 ,请选择数据流沙盒。
  • 在 数据管理 选择 管理数据集 权限。

授权错误疑难解答

错误代码 错误消息 描述
EXEG-0500-401 授权令牌无效 出现以下任何情况时,都会显示此错误消息:
  • authorization 缺少标头值。
  • authorization 标头值不包括必需的 Bearer 令牌。
  • 提供的授权令牌的格式无效。
  • 数据流需要进行身份验证,但请求缺少必需的标头。
EXEG-0501-401 用户授权令牌无效 出现以下任何情况时,都会显示此错误消息:
  • API调用缺少必需的 x-user-token 标题。
  • 提供的用户令牌的格式无效。
EXEG-0502-401 授权令牌无效 当提供的授权令牌具有有效格式(JWT),但其签名无效时,将显示此错误消息。 检查 身份验证教程 了解如何获取有效的JWT令牌。
EXEG-0503-401 授权令牌无效 当提供的授权令牌过期时,将显示此错误消息。 通过 身份验证教程 以生成新令牌。
EXEG-0504-401 缺少必需的产品上下文 出现以下任何情况时,都会显示此错误消息:
  • 开发人员帐户无权访问Adobe Experience Platform产品上下文。
  • 公司帐户尚无权AdobeExperience Platform。
EXEG-0505-401 缺少所需的授权令牌范围 此错误仅适用于服务帐户身份验证。 当调用中包含的服务授权令牌属于无权访问的服务帐户时,将显示错误消息 acp.foundation IMS范围。
EXEG-0506-401 无法写入的沙盒 当开发人员帐户没有 WRITE 对其中定义了数据流的Experience Platform沙盒的访问。

在此页面上