为设备、用户和组织添加参考信息- Code42支持

概述

引用字段允许您向Code42环境中的设备、用户和组织添加描述性信息。此描述性信息可用于为管理员添加额外的上下文，也可用于与外部系统集成。

本文描述如何使用来自Code42控制台和Code42 API的引用字段。

引用字段

Code42平台为设备和用户支持以下参考字段。在Incydr Basic、Advanced和Gov F1中，还可以将此信息添加到组织中。

外部引用:用于可选的外部参考信息，例如序列号、资产标签、员工ID或帮助台问题ID。
笔记:用于可选的描述信息。

注意事项

本文中的示例使用命令行工具旋度与Code42 API交互。有关可用于与API交互的工具列表，请参见与Code42 API交互的工具．

使用Code42控制台编辑引用信息

Incydr专业，企业，地平线和政府F2

登录到Code42控制台．
从管理>环境中,选择设备或用户．
单击设备或用户的名称。
点击参考查看任何现有的参考信息。
点击编辑添加或更新参考信息。
- 使用外部引用来记录可选的外部参考信息，如序列号、资产标签或员工id。
- 输入任何笔记设备或用户信息。
- 点击保存以保存更改。

Incydr基础，高级，和政府F1

为代理现代化更新了Code42控制台视图
如果下面的细节与您的Code42控制台体验不同，那么您可能启用了代理现代化。检查Code42控制台帐户菜单以确认代理现代化在您的产品计划下面列出。如果是这样，请参阅上面的Incydr Professional, Enterprise, Horizon和Gov F2部分寻求帮助。

另请参阅开始Incydr代理现代化以获取有关Agent现代化的新特性和更新特性的更多信息。betway提款

登录到Code42控制台．
从管理>环境中,选择设备，用户,或组织．
单击设备名称、用户名称或组织名称。
从操作菜单中选择编辑．
点击参考．
配置设备、用户或组织的引用字段:
- 外部引用
- 笔记
点击保存．

使用Code42 API添加参考信息

如果需要，可以考虑使用Code42 API添加参考信息:

通过脚本为Code42环境中的许多设备、用户或组织添加参考信息。
在您的环境中配置一个外部系统以自动设置参考信息。

下面的示例说明如何一次为一个用户、设备或组织设置参考信息。如果希望同时为许多项设置值，可以使用示例作为自定义脚本的基础。在下面的例子中:

将console.us.code42.com替换为您使用的基本URL访问Code42云实例．
取代< auth_token >与一个身份验证令牌．

Code42开发者门户
看到Code42开发者门户获取更多API文档和资源。门户提供:

Incydr方法文档的单一访问点，包括Code42的方法REST API， Python SDKpy42,命令行界面
单个请求URL对于每个云实例的Code42 API调用
API参考文档

尽可能多地使用Code42开发者门户来满足您的API需求。门户中的api是Incydr用户与Code42集成的首选方式。如果您使用的Code42 api没有出现在Code42开发者门户上，联系我们的技术支持工程师以获得与Code42集成的最佳方式的指导。

使用Code42 API为设备添加参考信息

Code42 API电脑资源允许您设置computerExtRef而且笔记设备参数。

查找设备的guid使用以下方法之一:

以userUid拥有该设备的用户:

curl -X GET 'https://console.us.code42.com/api/v1/Computer?userUid=' -H '授权:承载< auth_token >| python3 -mjson.tool

搜索设备的名字：

curl -X GET 'https://console.us.code42.com/api/v1/Computer?q=' -H '授权:持有者< auth_token >| python3 -mjson.tool

定位设备的guid在输出中。例如:
```
“guid”:“681099810721783680”
```

设置computerExtRef而且笔记适当设备的参数guid：

curl -X PUT -d '{"computerExtRef": "资产410"，"notes": "关于设备的注释"}' -H '内容类型:应用程序/json' 'https://console.us.code42.com/api/v1/Computer/?idType=guid' -H '授权:持有者< auth_token >| python3 -mjson.tool

检查命令的输出来验证这一点computerExtRef而且笔记包含正确的值。

使用Code42 API为用户添加参考信息

Code42 API用户资源允许您设置userExtRef而且笔记用户参数。

查找用户的userUid使用以下方法之一:

通过电子邮件地址搜索用户:

curl -X GET 'https://console.us.code42.com/api/v1/User?email=' -H '授权:持有者< auth_token >| python3 -mjson.tool

通过用户名搜索用户:

curl -X GET 'https://console.us.code42.com/api/v1/User?username=' -H '授权:持有者< auth_token >| python3 -mjson.tool

通过姓和名搜索用户:

curl -X GET 'https://console.us.code42.com/api/v1/User?q=<姓>&&<姓>' -H '授权:持有者< auth_token >| python3 -mjson.tool

定位用户的userUid在输出中。例如:
```
:“userUid fa1633c3e5507360”
```

设置userExtRef而且笔记适当的参数userUid：

curl -X PUT -d '{"userExtRef": "ID040189"， "notes": "关于用户的注释"}' -H 'Content-Type: application/json' 'https://console.us.code42.com/api/v1/User/?idType=uid' -H '授权:持有者< auth_token >| python3 -mjson.tool

检查命令的输出来验证这一点userExtRef而且笔记包含正确的值。

使用Code42 API为组织添加参考信息

Code42 APIOrg资源允许您设置orgExtRef而且笔记组织参数。

查找该组织的orgUid通过搜索它的名字:

curl -X GET 'https://console.us.code42.com/api/v1/Org?q=' -H '授权:承载< auth_token >| python3 -mjson.tool

定位该组织的orgUid在输出中。例如:
```
“orgUid”:“691968598454770525”
```

设置orgExtRef而且笔记适当的参数orgUid：

curl -X PUT -d '{"orgExtRef": "组织标识符"，"notes": "关于该组织的注释"}' -H 'Content-Type: application/json' 'https://console.us.code42.com/api/v1/Org/?idType=orgUid' -H '授权:持有者< auth_token >| python3 -mjson.tool

检查命令的输出来验证这一点orgExtRef而且笔记包含正确的值。

概述