astarte/astarte_pairing_api Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Astarte Pairing API

镜像概述与主要用途

Astarte Pairing API是Astarte平台提供的配对REST API，主要用于Astarte生态系统中的设备和代理获取传输凭据，支持设备安全接入平台的核心功能，包括API密钥的获取与SSL证书的更新。

核心功能与特性

• API密钥获取：允许设备通过API请求获取用于与Astarte平台通信的API密钥
• SSL证书更新：支持设备对用于安全通信的SSL证书进行更新，确保传输层安全性

使用场景与适用范围

• 设备首次接入：新设备在接入Astarte平台时，通过该API获取初始通信凭据
• 凭据定期更新：设备或代理在API密钥过期或SSL证书即将到期时，通过API进行凭据更新
• Astarte生态集成：适用于所有基于Astarte平台构建的物联网系统中，需要设备与平台安全通信的场景

使用方法与配置说明

基本部署

可通过Docker容器部署Astarte Pairing API，示例docker run命令：

bash
docker run -d -p 8080:8080 --name astarte-pairing-api astarte/pairing-api

核心配置参数

（注：具体配置参数需根据Astarte平台版本及部署环境调整，以下为常见配置项示例）

• 端口映射：默认暴露8080端口，可通过-p参数映射至主机端口
• 环境变量：可通过-e设置必要环境变量，如ASTARTE_REALM（指定Astarte领域）、ASTARTE_CORE_URL（Astarte核心服务地址）等

API调用说明

设备或代理通过RESTful API调用获取凭据，基础请求示例：

• 获取API密钥：POST /v1/{realm}/devices/{device_id}/credentials
• 更新SSL证书：PUT /v1/{realm}/devices/{device_id}/certificates

具体API规范及请求/响应格式请参考Astarte官方文档。