代理API键

TCell Agents使用API键来控制来自TCell代理到TCell云的所有通信的身份验证和访问控制。本指南描述：

您还可以使用API来管理您的API密钥和代理。测试API.在这里。

范围和权限

代理API键有两个范围：

服务器代理适用于服务器端上的任何代理，无论web服务器代理或应用程序服务器代理。

这JS代理是在浏览器内运行的客户端代理。

此外，每个代理密钥都具有应用范围。应用程序范围表示密钥可用于哪个应用程序。密钥可以在其应用范围下具有一个或多个应用程序。此外，它可以是“主键”，表示它对于给定帐户的所有应用程序有效。

为简单起见，请使用主密钥开始。但是，如果您管理多个应用程序，建议遵循最小权限原则，只提供给定密钥所需的应用程序范围（理想情况下为单个应用程序）

对于JS代理，有一个预创建的密钥称为“默认JS代理密钥”。这是一个为方便起见提供的主密钥，可以在再次创建范围严格的密钥后删除。

管理员可以创建和配置API键。这可以如下所示：

以下是具有“App1-EGSTG”和“App2-Lu1MP”的权限的服务器代理密钥的示例：

以下是创建作为主密钥的密钥的示例：

除了创建键之外，还可以编辑现有键 - 例如，更改应用程序权限 - 通过在“API键”选项卡中为现有键选择编辑图标来更改应用程序权限。

如上所述，每个代理都具有用于从代理通信到TCELL云的API密钥。这是配置的在“整个管理员”窗口中的“下载代理”选项卡中。下载代理在此处将提供一个配置文件，其中包含为给定应用程序配置的API密钥。

此外，选择键时有方便选择。“创建新API键”这将生成带有应用程序名称和用户名的主服务器代理密钥。对于生产实例，建议在API键部分中创建API键，并在下载配置文件时选择它。

此外，还可以通过环境变量定义在配置文件中定义的任何内容。看服务器代理选项更多细节。

在一个容器环境中，典型的做法是使用环境变量而不是配置文件，因此当一个如上所述下载配置文件时，可以相应地设置等效环境变量。

如前所述，密钥可以将其范围用于特定的应用程序或应用程序，以及将所有应用程序具有全局权限作为主密钥。

拥有全局权限可以简化使用，特别是在入门时。但是，对于生产实例，建议的方法是将每个密钥（服务器代理和JS代理）的作用域限定到特定的应用程序。这遵循最小特权的安全原则。

如果键意外暴露，则会限制曝光。此外，这使得可以轻松地创建和推出一个新密钥，因为卷展栏仅需要完成单个应用程序而不是使用TCell的所有应用程序。

这个页面对你有帮助吗？