Sony CNA-2 Parameter Controllable Device Integration Configuration

Sony CNA-2 Parameter Controllable Device Integration Configuration

Configuration Overview

The CNA-2 Node uses two connections. hi signs in to the CNA-2 Web API over HTTPS, and CNA-2 posts Tally and assignment changes to a webhook listener on hi. Both connections must work for the Node to show the current state.

Before You Begin

• The hi server address that CNA-2 posts to must be an IP address. CNA-2 does not accept webhook URLs with a host name.

• Use Node admin and open Inventory > Nodes. See Manage Nodes.

• Confirm the license and minimum hi version in Required Configuration.

• Get access to the CNA-2 Settings menu and a CNA-2 account with Admin or Senior Operator authority.

• Use the root account created at the first Web UI sign-in, or add an account under Settings > User Account > Add New User. Only accounts with Admin or Senior Operator authority can use the Web API.

• Sony requires the optional software HZC-GWCN2 for some SSCP functions, such as MSU emulation mode, multi-camera control, and CCU format control. hi uses the Web API and not SSCP.

• When the CNA-2 is part of a federation, Settings > Federation > Access Token > WebAPI Enable must be On.

• Confirm the network access in Network Requirements. hi needs outbound TCP 443 to the CNA-2, and the CNA-2 needs to reach the hi server on the webhook Port, 31000 by default.

Configure CNA-2 Web API and Webhook

Use this configuration for every CNA-2 Node.

Device Configuration

1. Connect the CNA-2 to a management network that the hi server can reach. Enable the CNA-2 network interface and record its IP address.

2. Set Settings > System > System Mode to Management, and then set Settings > System > Management Mode to Web API.

3. Set Settings > System > CNS Mode to MCS. hi addresses Web API domain 0, which Sony assigns to MCS.

4. Set Settings > System > MCS Settings > Master Mode to On.

5. Set Settings > Maintenance > Web API > Protocol to Https.

6. Optionally install a server certificate under Settings > Maintenance > Certification Install > CNA-2 Web CertFile. hi 3.0.0 does not validate it, so place the CNA-2 on a trusted management network.

7. Create the account that hi uses under Settings > User Account > Add New User, with Admin or Senior Operator authority. You can also use the root account.

8. Set Settings > Maintenance > Webhook > Protocol to Http. CNA-2 has two LAN ports. It sends webhook packets from the LAN port in the same subnet as the registered URL, and from LAN1 when the URL is in a different subnet. Place the hi server so that this path is reachable.

9. If the CNA-2 is a federation child, set Settings > Federation > Access Token > WebAPI Enable to On.

10. If 10 webhook server URLs are already registered under Settings > Maintenance > Webhook > Server, remove a stale entry. CNA-2 stores up to 10 URLs.

hi Configuration

1. Add the Sony CNA-2 Parameter Controllable Device in Inventory.

2. Enter the CNA-2 address in Host / IP Address. hi connects over HTTPS on Port 443; the Port is not configurable.

3. Enter the CNA-2 account in Username and Password.

4. Leave Root SSL certificate empty and Accept Untrusted SSL Root Certificate at No. hi 3.0.0 does not validate the CNA-2 certificate, so these settings have no effect.

5. Set Webhook port to a free Port from 31000 to 31999. The default is 31000.

6. Create the Node. When it connects, hi signs in, removes its previous webhook entry, and registers http://<hi server address>:<Webhook port>/webhook under a name that starts with hi-.

All settings in this procedure remain editable after the Node is created.

Settings Summary

Common Checks

Verify the Configuration

Open the Node in Inventory. Confirm that Mic Gain 1 of a connected camera shows a value within 5 seconds. Then change the RCP assignment of a Panel that is not in use, and confirm that RCP Assignment > Panel n updates in hi without a refresh. This confirms webhook delivery.