达实智能AIoT平台是功能强大，高性能，易上手的现代化物联网平台，以「万物智联」为使命，为设备互联互通提供底座。
一、能力概览
不同系统或平台之间自动更新和保持用户信息一致。
多个应用系统之间实现用户只需一次登录就可以访问所有关联应用
# **二、立即开始**
## 1、[通讯录同步](http://aiot.docs.chn-das.com/doc-4940134?nav=01H0KSG13F67YAYBBA53HMD94H)
### 1.1、第三方为数据源头
```mermaid
sequenceDiagram
第三方 ->> 实施: 获取配置信息
实施->>AIoT: 创建对应的数据源
第三方-->>AIoT: 通过数据源配置拉取用户数据
```
1.2、AIoT为数据源头
sequenceDiagram
实施->>AIoT: 登录
AIoT-->>第三方: 提供访问凭证配置信息
AIoT-->> 第三方: 提供用户数据
:::tip
为了确保顺畅和安全的访问，访问凭证不仅需要处于启用状态，还应当已经针对所需的接口进行了授权。倘若尝试使用未经适当授权的访问凭证来生成令牌并请求访问某个接口，系统将会返回403状态码，这表明此类请求被禁止。
:::
[获取组织列表](http://aiot.docs.chn-das.com/api-158050262?nav=01H27MYKQ6D73J6YG0DMWC6F4N)
包含 物业组织、企业组织
[获取组织下用户列表](http://aiot.docs.chn-das.com/api-157992160?nav=01H27MYKQ6D73J6YG0DMWC6F4N)
包含 物业用户、企业用户
:::tip
租户用户ID 为 实际业务使用的用户id
手机号 全平台唯一
用户账号 全平台唯一
:::
2、单点登录对接
2.1.1、对接达实oauth2单点登录
sequenceDiagram
对接方-->> 实施: 提供回调地址
实施 -->> AIoT: 新建单点登录配置
实施 -) 对接方: 提供单点登录配置
对接方 -->> AIoT: 获取授权码
AIoT -) 对接方: 重定向回调地址并携带授权码
对接方 -->> AIoT: 授权码获取令牌
AIoT -) 对接方: 返回用户令牌
对接方 -->> AIoT: 获取用户信息
AIoT -) 对接方: AIoT用户信息转换为第三方登录信息
:::tip
授权模式 仅需要配置 授权码模式、刷新令牌模式即可
:::
[获取授权码](http://aiot.docs.chn-das.com/api-82250752?nav=01H0KSC4JY9SE3666BRAC1V8XN)
[依据授权码获取令牌](http://aiot.docs.chn-das.com/api-82251180?nav=01H0KSC4JY9SE3666BRAC1V8XN)
[登录-用户详情接口](http://aiot.docs.chn-das.com/api-85356449?nav=01H0KSC4JY9SE3666BRAC1V8XN)
2.2.1、第三方应用嵌入达实APP/小程序
第三方主动对接：
（一）对接用户令牌
操作步骤
sequenceDiagram
实施->>AIoT(web端): 登录
AIoT(web端)-->>APP引擎(应用): 门户设计-应用中心-新增第三方应用。链接第三方链接,参数内容 选择授权码
操作步骤
```mermaid
sequenceDiagram
实施->>AIoT(web端): 登录
AIoT(web端)-->>APP引擎(应用): 门户设计-应用中心-新增第三方应用。链接第三方链接
（二）对接授权码
sequenceDiagram
对接方-->> 实施: 提供回调地址
实施 -->> AIoT: 新建单点登录配置
实施 -) 对接方: 提供单点登录配置
对接方 -->> AIoT: 应用页面配置回调地址链接
AIoT -) 对接方: 重定向回调地址并携带授权码
对接方 -->> AIoT: 授权码获取令牌
AIoT -) 对接方: 返回用户令牌
对接方 -->> AIoT: 获取用户信息
AIoT -) 对接方: AIoT用户信息转换为第三方登录信息
:::tip
授权模式 仅需要配置 授权码模式、刷新令牌模式即可
:::
:::tip
access_token 选择 用户TOKEN
response_type 固定值 code
client_id 单点登录配置-凭证ID(clientID)
redirect_uri 单点登录配置-回调地址(redirectUrl)
state 时间戳
应用中心-链接内容 填充 {{域名}}/api/justauth/oauth-server/v1/visitor/oauth/authorize
:::
[依据授权码获取令牌](http://aiot.docs.chn-das.com/api-205037350?nav=01H0KSC4JY9SE3666BRAC1V8XN)
[登录-用户详情接口](http://aiot.docs.chn-das.com/api-205037649?nav=01H0KSC4JY9SE3666BRAC1V8XN)
达实适配第三方：
sequenceDiagram
实施->>AIoT(web端): 登录
AIoT(web端)-->>APP引擎(应用): 门户设计-应用中心-新增第三方应用。链接填达实通用链接
新建数据源：
新建h5应用
:::tip
1、达实通用链接：
{{域名}}/api/custom-datasource/custom/v1/third-login/portal?source={{来源}}&project={{项目id}}&subfix={{第三方地址后缀}}&redirect_url={{第三方页面地址}}
source：标识第三方。例如：达实-das
project: 数据数据源所在项目一致
redirect_url：第三方页面地址
subfix：第三方地址需要补充的后缀
2、此方式需要在数据源-项目下配置 一个第三方的数据源
3、传入参数-参数名称: 必须有 access_token 用户TOKEN
:::
2.2.2、达实h5链接嵌入第三方应用
sequenceDiagram
实施->>第三方: 提供中间页链接
第三方-->>达实h5: 打开达实h5链接并携带可获取用户身份的标识
达实h5-->>达实服务端: 将链接参数完整的传递至免登接口
达实适配第三方:
备注：
达实h5链接：APP承载页。链接地址固定
免登接口：{{域名}}/api/customer/customer/v1/visitor/{{来源}}/app/login?project= {{项目id}}&redirect_url={{aiot具体应用地址}}&等其它参数
其它参数：用于获取第三方用户信息
第三方主动对接：
待实现
达实AIoT
