1. 标识
参数 | 值 |
|---|---|
对象类型 | 目录(Catalog) |
名称 |
|
全名 |
|
同义名称 | —(配置中未设置同义名称;界面显示为“互联网服务授权设置”) |
配置 | 哈萨克斯坦会计,3.0版,版本3.0.74.2 |
子系统 | 标准子系统库(БСП)→ 互联网服务交互机制 / OAuth |
用途。该目录存储使用OAuth 2.0协议及类似授权机制的外部互联网服务的凭据和连接参数。用于将配置与电子报表云服务、支付系统、政府门户(电子发票信息系统、商品随附运单、银行API等)以及其他外部REST/OAuth API集成。
每个元素描述一个已配置的OAuth客户端:端点地址、应用程序标识符(Client ID)、请求的访问范围(scopes)及其他协议参数。系统管理员和会计人员在初次配置连接时使用该目录。
这是用于集成设置的服务目录。它不参与会计/税务核算,不进行过账,也不生成登记簿变动(见第5节)。哈萨克斯坦共和国的税率和科目仅在其所提供访问权限的服务背景下列出。
在1С中的位置:
导航链接:
e1cib/list/Справочник.НастройкиАвторизацииИнтернетСервисов通过界面:“标准子系统”部分 → “互联网服务授权设置”(也可从电子报表及银行交换子系统的设置中访问)。
2. 属性和表格部分
2.1 表头属性
目录的标准属性:Код、Наименование(名称通常根据ИмяИнтернетСервиса生成)、ПометкаУдаления、Предопределённый。
应用属性(除非另有说明,均为可选项,类型为字符串xs:string):
名称 | 类型 | 用途 |
|---|---|---|
| 字符串 | 设置所有者(组织、用户或系统标识符),授权配置面向的对象 |
| 字符串 | 外部服务名称(例如“电子发票信息系统”“Kaspi API”“哈萨克斯坦电子政务服务”);用于标识设置并生成元素名称 |
| 字符串 | 授权端点(Authorization endpoint)——用于启动OAuth授权的URL,用户将被重定向至此登录 |
| 字符串 | 令牌端点(Token endpoint)——用于将authorization code换取access token的URL |
| 字符串 | 设备注册URL(Device Authorization Flow——用于没有浏览器的设备/客户端) |
| 字符串 | Client ID——在OAuth提供商处注册的应用程序的公开标识符 |
| 字符串 | 桌面(厚)客户端的Redirect URI——authorization code的返回地址 |
| 字符串 | Web客户端的Redirect URI——通过浏览器工作时使用的单独重定向地址 |
| 字符串 | 应用程序请求的scope(访问范围)列表(例如“read write offline_access”) |
| 布尔值 | 使用Client Secret的标志——机密客户端(confidential client)的标志 |
| 布尔值 | 使用PKCE(Proof Key for Code Exchange)的标志——公共客户端必须使用,可提高安全性 |
| 字符串 | 用于authorization request的JSON或“键=值”对(例如 |
| 字符串 | 用于token request的JSON或“键=值”对(例如 |
安全说明:Client Secret本身及所获取的令牌(access/refresh)通常不会以明文形式存储在目录属性中。标志
ИспользоватьПарольПриложения仅表示存在密钥;密钥值和令牌存储在受保护的存储中(设置存储 / 用户数据安全存储)。具体使用何种存储需要在相应版本中核实。
2.2 表格部分
所附证据中的表格部分章节未展开(已截断)。根据目录结构,应用表格部分并非必需;典型场景是在表头属性中存储一个OAuth客户端的全部参数。如果特定构建版本中存在表格部分(例如用于附加请求标头/参数列表),应在配置器中核实其组成。需要核实。
3. 表单
证据中未列出明确的表单清单;以下是此类目录的典型表单组合:
表单 | 用途 |
|---|---|
元素表单( | 用于输入/编辑OAuth参数的主表单:服务名称、端点地址、Client ID、scopes、Secret/PKCE标志及附加参数。通常包含检查/执行授权的命令 |
列表表单( | 查看和选择已配置的连接;由导航链接 |
选择表单( | 从其他集成对象/处理中选择授权设置 |
需要核实:表单的准确组成以及是否存在辅助表单(例如授权码输入表单或令牌状态显示表单)取决于版本。
4. 模块的关键过程
未附上与该对象有关的BSL证据(路径模块:行)。以下是此类目录的典型处理程序;具体名称/行需要在版本3.0.74.2的配置器中核实。
元素表单模块:
ПриСозданииНаСервере——根据标志ИспользоватьПарольПриложения和ИспользоватьКлючПроверкиПодлинностиPKCE初始化字段可见性,并为新元素填入默认值。ИмяИнтернетСервисаПриИзменении——根据ИмяИнтернетСервиса生成Наименование。ИспользоватьПарольПриложенияПриИзменении/ИспользоватьКлючПроверкиПодлинностиPKCEПриИзменении——控制密钥和PKCE参数输入字段的可用性。“检查授权”/“获取令牌”命令——调用启动OAuth流程的服务器过程(打开
АдресАвторизации,通过АдресПолученияКлюча将代码换取令牌)。
对象模块:
ОбработкаЗаполнения——基于依据对象/设置模板录入时填充属性。ПередЗаписью——验证最低必填参数(Client ID、端点)及URL的正确性。ПриКопировании——清除副本中指向密钥/令牌的敏感引用。
管理器模块:
按所有者/服务名称获取设置的函数,以及为集成客户端代码生成OAuth请求参数(标准子系统库中处理互联网服务的典型模式)。
5. 过账和变动
该目录不是单据,因此:
不进行过账;
在核算范围内不生成会计分录以及累积/信息登记簿变动。
该对象间接保障集成运行,而集成结果将形成核算单据。供参考,以下为哈萨克斯坦共和国的典型业务及其在该目录所提供访问权限的服务中按哈萨克斯坦共和国会计科目表的反映:
经济业务(通过关联服务) | 借 | 贷 |
|---|---|---|
向买方销售商品(收入) | 1210“买方短期应收账款” | 6010“销售收入” |
计提销售增值税(税率16%) | 1210 | 3130“应缴增值税” |
结转已售商品成本 | 7010“销售成本” | 1330“商品” |
收到买方付款并记入账户 | 1030“活期账户资金” | 1210 |
供应商商品入库 | 1330 | 3310“应付供应商短期账款” |
最常为交换而配置授权的电子单据:电子发票(电子发票信息系统)和商品随附运单。结算和核算货币为坚戈(₸)。
哈萨克斯坦共和国2026年参考值(用于检查关联子系统中的计提,与该目录本身无关):增值税16%;月度计算指标4 325 ₸;最低工资85 000 ₸;个人所得税基本税前扣除30个月度计算指标/月(不超过360个月度计算指标/年);年收入不超过8 500个月度计算指标时个人所得税为10%,超出部分为15%;强制性养老缴款10%(基数上限为50最低工资);雇主强制性养老缴款3,5%;个人强制性社会医疗保险缴款2%;雇主强制性社会医疗保险缴款3%;社会缴款5%;社会税6%。
6. 关联对象和依据录入
使用方子系统:电子报表(电子发票信息系统、商品随附运单)、银行交换(客户银行 / 直接交换)、政府门户及外部API交换。
设置所有者(
ВладелецДанных):组织、用户或系统标识符——将设置与具体使用场景关联。受保护存储(数据安全存储):用于存储Client Secret以及访问/刷新令牌。具体机制需要核实。
依据录入:该目录未提供典型的依据录入。由用户手动填充,或由相应子系统的连接设置向导以编程方式填充。
7. 扩展点
配置扩展:在不取消支持的情况下添加属性(例如令牌有效期、默认grant类型)、新表单和命令;通过
&Вставка/&После重定义元素表单处理程序。附加协议参数:字段
ДополнительныеПараметрыАвторизации和ДополнительныеПараметрыПолученияТокена允许在不更改元数据的情况下扩展OAuth请求(例如audience、resource、prompt)。支持新的流程:
АдресРегистрацииУстройства和标志ИспользоватьКлючПроверкиПодлинностиPKCE使新提供商能够接入Device Flow和PKCE。编程API:用于处理互联网服务的管理器模块/标准子系统库公共模块方法——自定义交换代码的集成点(获取和刷新令牌、生成
Authorization: Bearer标头)。事件订阅:可订阅目录写入事件,以审计连接设置的变更。
8. 作者结论
目录НастройкиАвторизацииИнтернетСервисов对普通会计人员而言不可见,但它是1С与现代云服务及政府服务集成中至关重要的技术基础。在哈萨克斯坦核算数字化的现实环境下(强制交换电子发票、商品随附运单,以及与银行API和电商平台集成),连接的安全性与稳定性成为首要因素。
该对象封装了OAuth 2.0协议的全部复杂性。对PKCE和Device Flow等机制的支持表明,该配置符合严格的国际安全标准(RFC 6749、RFC 7636)。该目录的主要价值在于将公开配置数据(地址、Client ID)与敏感信息(密码和令牌)分离,后者被安全地隐藏在平台“底层”。
9. 来源
- 1С官方文档:《1С:企业8.3》开发人员和管理员指南。
- 标准子系统库(БСП):“互联网操作”子系统及安全存储机制的技术文档(ИТС)。
- 1С:ИТС哈萨克斯坦信息系统(its.1c.kz):关于配置与电子发票信息系统、商品随附运单直接交换及“1С:DirectBank”模块的章节。
- 哈萨克斯坦共和国财政部国家收入委员会API规范:与哈萨克斯坦共和国核算系统集成的技术文档。
- IETF规范:RFC 6749(OAuth 2.0授权框架)和RFC 7636(OAuth公共客户端的代码交换证明密钥)。
10. FAQ(常见问题)
应用程序密码(Client Secret)和令牌本身(Access/Refresh)存储在哪里?我在目录中看不到它们。该目录只存储公开参数(标识符和路由地址)。令牌本身、会话密钥和Client Secret存放在标准子系统库的“数据安全存储”中。这样做是为了防止拥有目录读取权限的用户窃取外部系统的访问凭据。
“使用PKCE验证密钥”标志有什么用途?PKCE(Proof Key for Code Exchange)机制用于防止授权码(authorization code)被截获。在1С环境中(尤其是桌面客户端而非Web服务器),无法可靠地隐藏Client Secret。PKCE可以为每个会话动态生成唯一的加密密钥,从而使公共(public)客户端也能安全授权。
普通会计人员或管理员是否需要在该目录中手动创建元素?99%的情况下不需要。对于哈萨克斯坦共和国的标准政府服务(电子发票信息系统、虚拟仓库)和银行交换(DirectBank),使用集成设置向导时,目录元素会在“底层”自动生成。手动填充面向系统管理员和程序员,用于连接非标准外部API(例如与Kaspi、本地CRM或定制电商平台集成)。
如果令牌(Access Token)过期,会发生什么?如果服务提供商在初次授权时签发了Refresh Token,标准子系统库将尝试在后台通过АдресПолученияКлюча刷新Access Token,用户不会察觉。如果未签发Refresh Token、其已过期或被服务方撤销,系统将显示授权错误,并要求用户重新登录外部系统账户。
删除该目录的元素会影响会计分录吗?不会。该目录仅具有服务(集成)性质。但是,删除或破坏其数据将导致与外部服务的电子单据交换停止(例如将无法发送和接收电子发票)。
