身份验证 authentication
概述
Edge Network Server API会根据事件源和API收集域处理经过身份验证的数据收集和未经过身份验证的数据收集。
对于每个请求，Server API验证数据流access type设置。 使用此设置，客户可以配置数据流以接受经过身份验证的数据，或同时接受经过身份验证和未经身份验证的数据。 默认情况下，接受这两种类型的数据。
有关配置数据流访问类型的详细信息，请参阅有关如何创建和配置数据流的文档。
以下是基于数据流Access Type配置和接收请求的端点的行为摘要。
Access Type
edge.adobedc.net
server.adobedc.net
混合（默认）
不对请求进行身份验证
验证请求
已验证
验证请求
验证请求
来自server.adobedc.net上专用服务器的API调用应始终进行身份验证。
先决条件 prerequisites
在调用Server API之前，请确保您满足以下先决条件：
- 您拥有有权访问Adobe Experience Platform的组织帐户。
- 您的Experience Platform帐户已为Adobe Experience Platform API产品配置文件启用
developer和user角色。 请与您的Admin Console管理员联系，为您的帐户启用这些角色。 - 你有Adobe ID。 如果您没有Adobe ID，请转到Adobe Developer Console并创建新帐户。
收集凭据 credentials
要调用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}
NOTE
有关Experience Platform中沙盒的更多信息，请参阅沙盒概述文档。
所有包含有效负载(POST、PUT、PATCH)的请求都需要额外的媒体类型标头：
- 内容类型：
application/json
配置数据集写入权限 dataset-write-permissions
要配置数据集写入权限，请转到Admin Console，找到附加到API密钥的产品配置文件，并设置以下权限：
- 在沙盒部分中，选择数据流沙盒。
- 在数据管理部分中，选择 管理数据集 权限。
授权错误疑难解答 troubleshooting-authorization
错误代码
错误消息
描述
EXEG-0500-401授权标记无效
此错误消息会在以下任意情况下显示：
- 缺少
authorization标头值。 authorization标头值不包含所需的Bearer令牌。- 所提供的授权令牌的格式无效。
- 数据流需要身份验证，但请求缺少所需的标头。
EXEG-0501-401用户授权令牌无效
此错误消息会在以下任意情况下显示：
- API调用缺少所需的
x-user-token标头。 - 提供的用户令牌的格式无效。
EXEG-0504-401缺少所需的产品上下文。
此错误消息会在以下任意情况下显示：
- 开发人员帐户无权访问Adobe Experience Platform产品上下文。
- 公司帐户尚无权使用AdobeExperience Platform。
EXEG-0505-401缺少所需的授权令牌范围
此错误仅适用于服务帐户身份验证。 当调用中包含的服务授权令牌属于无权访问
acp.foundation IMS范围的服务帐户时，将显示错误消息。EXEG-0506-401无法访问沙盒进行写入
当开发人员帐户对定义数据流的Experience Platform沙盒没有
WRITE访问权限时，会显示此错误消息。recommendation-more-help
f36c2cef-1417-40aa-a11d-5d0abaee121b