如何使用Apigee X OAuthv2作为Cassandra上的跨环境缓存且无需使用Apigee apps

核心需求实现步骤（无需使用Apigee Apps） #

你完全可以不依赖Apigee Apps完成配置，直接通过OAuthv2策略+底层Cassandra存储实现跨环境级别的令牌-属性绑定缓存，具体操作如下：

• 第一步：存储外部令牌并绑定自定义属性
  调用OAuthV2策略的ExternalAuthorization操作，将外部生成的令牌写入Apigee底层Cassandra，同时绑定你需要关联的自定义属性，同一环境下的所有API代理都可以共享读取该数据，天然满足跨代理的缓存需求。参考策略配置：

  <OAuthV2 async="false" continueOnError="false" enabled="true" name="Store-External-Token">
      <Operation>ExternalAuthorization</Operation>
      <!-- 填入你获取外部令牌的上下文变量位置，此处示例为请求查询参数 -->
      <ExternalAccessToken>request.queryparam.external_token</ExternalAccessToken>
      <!-- 有效期和外部令牌保持一致，单位为秒 -->
      <ExpiresIn>3600</ExpiresIn>
      <Attributes>
          <!-- 按需求添加绑定属性，ref对应属性值的来源变量 -->
          <Attribute name="user_id" ref="request.header.user_id"/>
          <Attribute name="custom_scope" ref="flow.variable.custom_scope"/>
          <Attribute name="tenant_id" ref="request.queryparam.tenant_id"/>
      </Attributes>
      <GenerateResponse enabled="false"/>
  </OAuthV2>
  

• 第二步：请求读取关联属性
  后续请求携带令牌访问时，调用OAuthV2策略的VerifyAccessToken操作校验令牌，校验通过后所有绑定的属性会自动注入到流程上下文变量中，变量格式为accesstoken.{自定义属性名}，可直接在后续流程中调用。参考策略配置：

  <OAuthV2 async="false" continueOnError="false" enabled="true" name="Verify-And-Get-Attributes">
      <Operation>VerifyAccessToken</Operation>
      <!-- 填入请求携带令牌的位置，此处示例为Authorization请求头 -->
      <AccessToken>request.header.Authorization</AccessToken>
      <GenerateResponse enabled="true"/>
  </OAuthV2>
  

• 第三步：可选内存缓存优化
  如果你需要更高的读取性能，可以搭配Apigee内置的PopulateCache和LookupCache策略，将高频访问的令牌属性存到节点内存缓存中，命中缓存时直接返回属性，跳过Cassandra查询，进一步降低延迟。

无需使用Apigee Apps的原理说明 #

Apigee Apps是面向开发者生态、应用身份管控的功能模块，仅当你需要做应用配额、开发者权限隔离、应用密钥管理这类能力时才需要使用。OAuthv2的ExternalAuthorization操作本身不强制要求关联App ID，你可以直接写入无应用绑定的独立令牌，底层Cassandra存储不会做强制关联校验，完全可以满足你的需求。 #

注意事项 #

• 单令牌绑定的所有自定义属性总大小建议不超过1KB，过大的属性会降低Cassandra读写性能，非核心属性建议存储到业务侧缓存，仅将核心关联字段存入令牌属性
• 内存缓存的过期时间需要设置为短于令牌本身的有效期，避免缓存数据与Cassandra中存储的令牌状态不一致
• 写入外部令牌时建议先做唯一性校验，避免重复写入覆盖已有的属性数据

内容的提问来源于stack exchange，提问作者Simone R.C.