OCPP2.0 C部分Authorization解析

 C. Authorization
1. Introduction
          该功能块描述了所有与授权相关的功能，包括各种用户授权方式（在线和/或离线）、AuthorizeRequest 消息处理/行为、授权缓存功能等。当用户希望将电动汽车从充电站拔下时，充电站需要验证用户是否是启动充电的用户，或该用户是否在同一组中，因此被允许终止充电。
           一旦授权通过，充电站会通知充电站管理系统（CSMS）充电已停止。
    为了改善用户体验，充电站可以支持使用授权缓存进行本地授权。
    LocalAuthorizeOffline配置变量控制充电站在离线时是否使用授权缓存对用户进行授权。
    LocalPreAuthorize配置变量控制充电站在未与CSMS进行授权的情况下，是否使用授权缓存启动一个交易。

1.1. ID Tokens
         现在，OCPP 可以使用多种不同类型的授权。OCPP 1.x 仅支持 RFID，而现在还支持信用卡、PIN 码、简单的启动按钮等。
          一个IDTokenType包含了用于授权的标识符。它被定义为大小写不敏感的字符串和一个类型的组合。IDTokenType类的消息数据元素（包括GroupId）可以包含对充电站管理系统（CSMS）有意义的任何数据（例如，用于识别充电活动的发起者），充电站不得对此类数据的格式或内容做任何假设，除非在IdTokenType的描述中提供了（例如，通过假设它是类似UID的值，必须只包含十六进制字符和/或偶数位数字）。
    通过本地令牌读卡器硬件获取的IdToken数据通常是物理IdToken的UID值（通常表示为8、14或20个十六进制数字字符）。
注意：为促进互操作性，根据迄今为止在IdTokenType数据类型为ISO14443的情况下的普遍做法，建议将这些UID表示为UID字节的十六进制表示。
根据ISO 14443-3，十六进制字符串中应首先包含字节0。（字节0的最高有效位先出现）
1.1.1. Additional Info
AdditionalInfo可以用于发送额外信息，这些信息可以在与IdToken的常规授权之外由充电站管理系统（CSMS）进行验证。

AdditionalInfo包含一个或多个自定义类型，需要所有相关方事先达成一致。当实现了AdditionalInfo时，充电站还应在常规操作中缓存和包含AdditionalInfo，并设置配置变量AdditionalInfoItemsPerMessage。当未实现AdditionalInfo或使用不受支持的AdditionalInfo.type时，CSMS/充电站可以忽略AdditionalInfo。
1.2. Group ID Tokens
充电站管理系统（CSMS）具有将一组身份令牌视为“组”的能力，从而允许组中的任何一个令牌启动交易，并且同一令牌或同一组中的另一个令牌停止交易。这支持了家庭或企业中的多个驾驶员使用一个或多个共享电动汽车的常见用例，这些电动汽车都使用同一个充电合同账户。
用作“GroupId”的IDTokenType通常会使用共享的中央账户标识符作为GroupId，而不是账户的第一张/主要的RFID卡的UID。

身份令牌（idTags）被分组用于授权目的，通过在IdTokenInfo中的可选的groupIdToken元素中指定一个共同的组标识符：
如果两个IdTokens的GroupIdTokens匹配（且它们不为空），则认为它们属于同一组。（通过idTags中的groupIdToken来看是不是同一个group的卡）
注意：即使GroupId具有与idToken相同的名义数据类型（IdTokenType），该元素的值可能不符合IdTokenType的常见格式和/或可能不表示实际有效的IdTokenType（例如，它可能是一个常见的共享“账户号码”）：因此，不应将GroupId值用于与提交的Token值进行比较（除非它也作为idToken值出现）。（注意区分GroupI和idToken中的IdTokenType）
1.3. Authorization Cache
充电站可以实现一个授权缓存，该缓存可以自主地记录已由充电站管理系统（CSMS）成功授权的先前提交的标识符。授权缓存可用于加速充电站的授权流程，因为使用本地存储的缓存意味着用户不必等待充电站在CSMS上检查授权。当存在时，授权缓存的操作会由AuthCacheEnabled配置变量进行报告（并在可能的情况下进行控制）。通用授权缓存条目的可选过期时间可以在配置变量AuthCacheLifeTime中设置。如果希望为特定条目设置不同的过期时间，可以在例如AuthorizeResponse中的iDTokenInfo返回的cacheExpiryDateTime中进行设置。

有关如何实现/使用授权缓存功能的更多信息，请参阅用例C10 - 在授权缓存中存储授权数据和C12 - 启动交易 - 使用缓存ID。

当充电站同时支持授权缓存和费率信息时（请参阅：费率和成本），不应将费率信息存储在授权缓存中，因为该信息可能会过时。

充电站可以支持离线时对任何提交的标识符进行授权，以避免对不能通过授权缓存条目明确授权的正当用户拒绝充电。关于此功能的详细信息请参阅未知离线授权。

建议将个人信息安全地存储在授权缓存中，例如，只将散列的idTokens存储在缓存中。
1.4. Local Authorization List
本地授权列表是一个包含可以与CSMS同步的标识符列表。它允许在离线状态下对用户进行授权，并在充电站和CSMS之间的通信速度较慢时实现更快的（表观）授权响应时间。CSMS可以通过发送完整的标识符列表来替换本地授权列表，也可以通过发送变更列表（添加、更新、删除）来将变更应用到本地授权列表中。支持此操作的方法包括GetLocalListVersion和SendLocalList。

该列表包含了所有（或部分）标识符的授权状态以及缓存到期日期cacheExpiryDateTime。这些值可以用于在本地授权期间向用户提供更精细的信息（例如，通过显示消息）。

有关如何实现/使用本地授权列表功能的更多信息，请参阅用例D01 - 发送本地授权列表，C13 - 通过本地授权列表进行离线授权和C14 – 通过本地授权列表进行在线授权。

注意：请注意授权缓存和本地授权列表机制之间的区别：授权缓存是充电站上的一个自主机制，而本地授权列表是在CSMS和充电站之间同步的列表（起源于CSMS）。

授权缓存和本地授权列表是不同的逻辑数据结构。当充电站同时支持授权缓存和本地授权列表时，充电站应该将本地授权列表条目视为优先于授权缓存条目，针对相同的标识符。

以下配置变量由充电站用于提供关于本地授权列表的信息：

LocalAuthListEntries（同时报告本地授权列表中的最大IdTokens数量）
LocalAuthListEnabled
LocalAuthListAvailable
ItemsPerMessageSendLocalList

ItemsPerMessageSendLocalList 
BytesPerMessageSendLocalList
1.5. Unknown Offline Authorization
在离线状态下，充电站可以允许自动授权任何“未知”的标识符，这些标识符在本地授权列表和/或授权缓存中找不到。当支持时，未知离线授权功能的操作由OfflineTxForUnknownIdEnabled配置变量进行报告（并在可能的情况下进行控制）。当与CSMS的连接恢复时，充电站必须发送排队
的TransactionEventRequest消息。这些消息可能包含了离线授权的交易，如交易相关消息处理中所述。有关充电站在此情况下继续/停止交易的选项，请参阅C15 - 未知离线授权。