Veritas NetBackup™ WebSocket 服务 (NBWSS) 参考指南

Last Published:
Product(s): NetBackup & Alta Data Protection (8.1.1)

WebSocket 端点详细信息及其格式

要与基于云的应用程序通信，NetBackup 需要使用 WebSocket 协议建立与云应用程序的安全连接。NetBackup 连接到称为 WebSocket 端点的云应用程序界面。要进行连接，NetBackup 需要端点相关的某些详细信息。

表：定义 WebSocket 端点的条目描述了 WebSocket 端点所需的信息。

表：定义 WebSocket 端点的条目

端点详细信息

描述

token

云应用程序的安全令牌。

当 NetBackup 启动与云应用程序的连接时，它将向该应用程序发送令牌。应用程序随后会对令牌进行验证。如果应用程序接受令牌，则会在 NetBackup 与应用程序之间建立安全连接。如果应用程序不接受令牌，则不建立连接。

priority

端点在组内的优先级。数字越小，优先级越高。

通过优先级，NetBackup 可以确定尝试与此服务器组进行连接所依据的顺序。每个服务器组仅有一个连接可以处于活动状态。

groupId

端点所属的组的唯一标识符。

hostName

包含端点的云服务器的主机名或 IP 地址。

url

NetBackup 连接到的 WebSocket 端点的完整 URL。

WebSocket URL 以 wss:// 开头

注意:

不支持 ws://。

重要信息：您可能需要与云服务提供商协作，以获取端点详细信息。端点详细信息必须按下列任一方式提供给 NetBackup：

  • 采用 JavaScript 对象表示法格式的文件（JSON 文件）。如果服务提供商未以 JSON 文件格式提供端点详细信息，则可自行将信息格式设置为 JSON 文件。

    注意:

    端点详细信息必须包括用于访问云应用程序的安全令牌。服务提供商应以安全的方式小心谨慎地向您发送应用程序令牌。

  • 通过 URL。NetBackup 使用 URL 请求来自云应用程序的端点详细信息。

注意:

NetBackup 在端点详细信息中的任何位置都不支持撇号 (')。

JSON 文件格式的 WebSocket 端点详细信息

下文显示了采用 JavaScript 对象表示法 (JSON) 格式的 WebSocket 端点详细信息：

{
      "token": "security_token ....",
      "priority": numeric_value,
      "groupId": "group_ID",
      "hostName": "host_name.domain", 
      "url": "wss://host_name.domain:port/uri"
}

请注意以下几点：

  • 在此版本的 NetBackup 中，每个 JSON 文件都必须指定单个端点，而不是多个端点。

  • 文件以左大括号 ({) 开始，以右大括号 (}) 结束。

  • 条目包含以逗号分隔的 name:value 对。

  • 每个字符串都引在双引号 ("") 内（优先级值除外）。

  • 五个 name:value 对（token、priority、groupID、hostName 和 url）可按任何顺序显示。

  • NetBackup 在文件中的任何位置都不支持撇号 (')。

  • 将 JSON 格式的信息以文本文件形式保存在 NetBackup 主服务器可以访问的位置中。

  • 有关 JSON 格式的背景知识，请参见 JavaScript 对象表示法的相关“网络工作组”备忘录：

    http://www.ietf.org/rfc/rfc4627.txt?number=4627

下面是定义 WebSocket 端点的 JSON 格式文件的示例：

{
      "token": "MIID4TCCAsmgAwIBAgIEBZCDRzANBgkqhkiG9w0BAQsFADBxMQs
DVQQGEwJVUzELMAkGA1UECBMCQ0ExFjAUBgNVBAcTDU1vdW50YWluIFZpZXcx
vzu0n2rWon48ncp6jMjOFiWqMRXnV8Q0vOEpAzUV7Qml92EMV6z0PinAgMBAA
GjgYAwfjBdBgNVHREEVjBUgiJ2b21yaGVsNnU1LXZtMDQuZW5nYmEuc3ltYW
G7IsZ2fTDWKLGxbAG5NNKwEfD11LFhKGwaHkOXYkVi+HVnFEFKK0gxVWg==",
      "priority": 1,
      "groupId": "GROUPID1",
      "hostName": "vrhel6u5-vm4.acme.com",
      "url": "wss://vrhel6u5-vm4.acme.com:14146/cfs/nbufacade"
}

有关 JSON 文件示例的说明：

  • 此示例以令牌开头。令牌是在 NetBackup 请求连接时云应用程序用于对 NetBackup 进行身份验证的字符串。

    小心:

    从服务提供商处获取端点信息时，请确保以安全的方式提供令牌。

  • 文件中的下一个条目是 priority，后跟 groupId、hostName 和云服务器的 url。

得到 JSON 格式的文件后，请使用 NetBackup“WebSocket 服务器”对话框上的 FILE 选项指定此文件。NetBackup 即会从该文件中提取端点详细信息。使用以下过程：

请参见保存 WebSocket 服务器端点的 NetBackup 凭据。

通过 Web 获取的 WebSocket 端点详细信息

云应用程序可以生成一个 URL，NetBackup 可使用该 URL 请求 WebSocket 端点详细信息。使用以下过程在 NetBackup“WebSocket 服务器”对话框中输入该 URL：

请参见保存 WebSocket 服务器端点的 NetBackup 凭据。