> ## Documentation Index > Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt > Use this file to discover all available pages before exploring further. # 方式二：接入钉钉安全渲染组件 > 本文档介绍如何接入钉钉安全渲染组件，实现通讯录加密。 ## **背景信息** 企业通讯录（用户名、用户职位、部门名称）是企业的重要敏感数据，根据服务商不同的应用部署方式有不同的要求，其中部分需要接入通讯录加密，否则无法上架应用市场。钉钉为了满足“**在开发者无法获取到敏感字段的前提下，在用户侧获取这些敏感字段**”的需求，提供了安全渲染组件（open-data）解决方案，以提供更加安全良好的体验。 ## **操作步骤** 1. 在前端页面中拼接用户登录态URL。 **说明** **登录态URL** 的构成，主要依赖 **回调URL**（ISV自己的前端页面链接，比如应用首页URL、使用了H5渲染组件的页面URL等）。当在客户端跳转访问 **登录态URL** 后，最终会重定向到 **回调URL**。 1. 对回调 URL 进行 encode。 **说明** 步骤中均以 *[https://open.dingtalk.com/document](https://open.dingtalk.com/document)* 举例。 ``` https%3A%2F%2Fopen.dingtalk.com%2Fdocument ``` 2. 添加 **固定前缀** `http://auth.dingtalk.com/login?redirectUri=`。 ``` http://auth.dingtalk.com/login?redirectUri=https%3A%2F%2Fopen.dingtalk.com%2Fdocument ``` 3. 再次进行 encode。 ``` http%3A%2F%2Fauth.dingtalk.com%2Flogin%3FredirectUri%3Dhttps%253A%252F%252Fopen.dingtalk.com%252Fdocument ``` 4. 添加 **固定前缀**`https://login.dingtalk.com/oauth2/auth?response_type=code&client_id=dingwa4tibze6jwz7mgv&scope=openid&state=dddd&redirect_uri=`，拼接得到 **登录态URL**。 ``` https://login.dingtalk.com/oauth2/auth?response_type=code&client_id=dingwa4tibze6jwz7mgv&scope=openid&state=dddd&redirect_uri=http%3A%2F%2Fauth.dingtalk.com%2Flogin%3FredirectUri%3Dhttps%253A%252F%252Fopen.dingtalk.com%252Fdocument ``` 5. 在前端页面引入 open-data SDK。 ``` ``` **说明** * SDK 脚本需要放在\标签中，并置于其他所有的\ ``` 2. 当页面上有数据需要进行安全渲染时，需要在页面上构造 dt-open-data 元素，并正确设置其 open-type 和 open-id 属性。当dom元素设置完成后，需要调用 DTOpenData.update 方法，传入需要进行渲染的dom元素对象即可自动完成渲染。 **说明** DTOpenData.update方法一次性传入的dom节点数量不可以超过200个，否则无法正常渲染。 ```

``` | **属性** | **类型** | **是否必填** | **说明** | | --------- | ------ | -------- | ---------------------------------------------------------------------- | | open-type | String | 是 | 开放数据的类型： - userName：用户名称 - userTitle：用户职位 - deptName：部门名称 | | open-id | String | 是 | 当openType值为： - userName：用户userId - userTitle：用户userId - deptName：部门名称 | ## **SDK 使用示例** ```

点击加载数据

``` ## **（可选）内容转译** #### **消息通知模板内容转译** 发通知消息时，可以在内容中以模板参数语法包含id，钉钉会将其替换为成员名或部门名，涉及服务端api： * 发送工作通知需要在原接口参数上添加`enable_id_trans`字段且置为true，才能开启转译，仅第三方应用需要用到，企业内部应用可以忽略。 **通讯录ID转译模板语法** ``` $departmentName=DEPARTMENT_ID$ $userName=USER_ID$ ``` 其中 DEPARTMENT\_ID 是数字类型的部门id，USER\_ID 是用户ID，例如： * 将$departmentName=1$替换成部门id为“1”对应的部门名称，如“钉钉用户体验部”。 * 将$userName=00001$替换成userid为“lisi007”对应的用户名，如“李四”。 #### **通讯录转译** * [异步转译通讯录ID](/zh/open/development/asynchronous-address-book-file-content-translation) * [获取异步转译任务结果](/zh/open/development/obtains-the-results-of-an-asynchronous-translation-task)