README

此插件是为SeAT编写的，为您的实例提供了一种使用查询和授权权限系统来管理Teamspeak的方式。

要求

• 为了使此驱动程序与Teamspeak一起工作，目标Teamspeak服务器必须是3.12.x或更高版本。确保您正在运行最新版本
• 必须启用Teamspeak服务器上的REST Api（http或https查询协议） - 见下文说明

安装

包部署

裸金属安装

在您的seat目录中（默认：/var/www/seat），输入以下内容

php artisan down
composer require warlof/seat-teamspeak

php artisan vendor:publish --force --all
php artisan migrate
php artisan up

现在，当您登录到SeAT时，您应该在侧边栏中看到一个连接器类别。

Docker安装

在您的docker-compose.yml文件所在的目录中，编辑.env配置文件（默认：/opt/seat-docker/.env）

找到SEAT_PLUGINS行，并在末尾追加warlof/seat-teamspeak:^5.0。

• 如果该行以尖括号#开头，将其替换为SEAT_PLUGINS=warlof/seat-teamspeak:^5.0。
• 如果您已经定义了其他插件，请将逗号追加到现有值的末尾SEAT_PLUGINS=author/package,warlof/seat-teamspeak:^5.0。

完成后，您可以使用docker-compose up -d重新启动您的堆栈。

Teamspeak服务器配置

访问您的Teamspeak服务器并找到query_ip_whitelist.txt文件。将Seat安装服务器的IP地址添加到列表中，以避免在运行作业时发生洪水式封禁。别忘了在query_ip_whitelist.txt末尾添加一个空行。

如果您尚未这样做，您必须启用http或https协议以允许服务器查询。这可以通过将一个或两个追加到环境变量TS3SERVER_QUERY_PROTOCOLS（如果使用Docker）或作为启动参数的query_protocols（如果使用blade安装）来完成。

注意

所使用的IP地址必须是SeAT将用于联系您的Teamspeak服务器的IP地址。如果您有两个服务器通过私有网络连接，并且您计划让SeAT联系该网络上的teamspeak实例，您必须添加该网络的SeAT 私有IP而不是其公共IP地址。

完成此配置后，我们将生成一个API密钥，该密钥将由SeAT用于向Teamspeak发送命令。为此，请使用您选择的工具（例如：putty或YaTQA）使用serveradmin账户在teamspeak服务器上进行认证

1. 使用login serveradmin ${serveradminpassword}对服务器进行认证
2. 使用apikeyadd scope=manage lifetime=0为SeAT生成新的API密钥

服务器应该回答类似的内容

TS3
Welcome to the TeamSpeak 3 ServerQuery interface, type "help" for a list of commands and "help <command>" for information on a specific command.
error id=0 msg=ok
apikey=BAByFoiEXZfnSJyE6dbXFiW_nn_SdwkclpKNz9j id=4 sid=0 cldbid=1 scope=manage time_left=unlimited created_at=1582102492 expires_at=1582102492
error id=0 msg=ok

在上面的示例中，生成的API密钥是BAByFoiEXZfnSJyE6dbXFiW_nn_SdwkclpKNz9j。这是您将需要设置SeAT中连接器的部分。

连接器设置

在您的SeAT实例上使用管理员账户进行认证。您可以使用内置的管理员用户，通过运行 php artisan seat:admin:login 来获得适当的权限。

在侧边栏中，点击 Connector，然后点击 Settings。

将配置更改以满足您的Teamspeak服务器设置，进入 Teamspeak 块。

• 服务器地址：用户将使用该地址连接到您的Teamspeak实例（可以是IP地址或域名）
• 服务器端口：用户将使用该端口连接到您的Teamspeak实例（默认为 9987）
• Api Base Uri：SeAT将使用该URL来联系您的Teamspeak服务器（默认为 http://teamspeak_address:10080 或 https://teamspeak_address:10443）
• Api Key：这是您在之前步骤中生成的密钥

初始化

在您的SeAT实例上使用管理员账户进行认证。您可以使用内置的管理员用户，通过运行 php artisan seat:admin:login 来获得适当的权限。

在侧边栏中，点击 Connector，然后点击 Settings。

在驱动程序下拉列表中，选择 Teamspeak 并点击 Update Sets 按钮，这将排队一个作业来获取您当前定义的所有服务器组。

通过 Access Management 部分授权访问。

调度器

在您的SeAT实例上使用管理员账户进行认证。您可以使用内置的管理员用户，通过运行 php artisan seat:admin:login 来获得适当的权限。

在侧边栏中，点击 Settings，然后点击 Schedule。

• 添加 seat-connector:apply:policies（建议每30分钟执行一次）

为了授权访问 Identities 部分，您必须将权限 seat-connector.view 添加到您分配给用户的角色中。

查询权限

以下列出了所需的权限和使用的查询模式列表