Cambium cnMaestro
cnMaestro setup
First step, you need to create a WLAN configured to support ePSKs.
Form the Configuration menu, select WiFi Profiles. Open the WLANs tab.
Add a new WLAN. Set the Name and the SSID (e.g. "Residents WiFi"). Set the Security to WPA2 Pre-Shared Key and change the default Passphrase with a complex value (no one will use this passphrase).
Set Client Isolation to Disable (each resident will have its own VLAN and all the devices will be able to communicate regardless of the AP they are connected to)
![](https://docs.cusna.io/~gitbook/image?url=https%3A%2F%2F3426155342-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDvdioCJduzKTpzAv3Sij%252Fuploads%252FB0xWfhaSbrHiuS9204py%252Fimage.png%3Falt%3Dmedia%26token%3D204ce2b9-744c-4933-9f1c-b4f8d56d9718&width=768&dpr=4&quality=100&sign=cc4df8db&sv=1)
Cusna implements an automatic VLAN management to segregate each resident traffic. Cusna uses by default the slot of VLANs 2000-4000 so you should avoid using these VLANs for any other purposes.
Once you have a WLAN you can assign it to one or multiple AP Groups.
ePSK are managed at the WLAN level by cnMaestro, so if you assign the same WLAN to multiple AP groups (for example on different locations), a user will be able to connect to WiFi with the same ePSK on all the APs where such WLAN is deployed.
Distributed communities scenario
If you want users to be able to connect with the same ePSK in multiple locations (or AP groups), you should create one WLAN and assigned to multiple AP groups.
In Cusna you can still create a dedicated Location for each physical site, even if multiple Locations are assigned to the same WLAN profile. In the alternative, you can create a single "virtual" Location matching all the AP groups where the WLAN is deployed.
In Cusna, an Account is always associated with one Location. If the Account visits a different location where the same WLAN is deployed, he would be able to connect with the same ePSK.
If you are assigning VLANs to the Account, the same VLAN should be enable on all the sites.
In Cusna, an email address can be associated to ONLY one Account in the same Organization.
Isolated communities scenario
If you want to create isolated communities, where a user is able to connect only in one specific Location, you need to create a dedicated WLAN for each AP Group (assuming you are using a dedicated AP Group per each Location).
Note that a user, with the same email, cannot exists with different Accounts on different Locations.
Cusna setup
To connect Cusna to your Cambium account you need to get the hostname of your cnMaestro account. You can easily identify the hostname form the URL base of your browser once you are logged in in your cnMaestro account.
![](https://docs.cusna.io/~gitbook/image?url=https%3A%2F%2F3426155342-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDvdioCJduzKTpzAv3Sij%252Fuploads%252F1unrHf5NtGSQ4glluAHS%252Fimage.png%3Falt%3Dmedia%26token%3D72591240-ac76-451f-96d6-da888998516c&width=768&dpr=4&quality=100&sign=670f8890&sv=1)
Then you need to generate an API Client and retrieve a client ID and Client Secret. Go to Network Services and open API Client
Click Add API Client and fill the Basic Information form as follow:
Name: any name, such as Cusna
Description: any text such as Cusna
Expiration Time: Cusna will refresh the API access automatically, but we recommend enter a greater value than the default one, such as 10000
Token Renewal Time: enter the same value as entered above
Click Save.
Copy the Client ID and Client Secret that appear on the screen after saving
![](https://docs.cusna.io/~gitbook/image?url=https%3A%2F%2F3426155342-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDvdioCJduzKTpzAv3Sij%252Fuploads%252FCa4KqGPURscTdja2ruIa%252Fimage.png%3Falt%3Dmedia%26token%3Dd0483f63-1cac-4382-a3db-59c9cf490d95&width=768&dpr=4&quality=100&sign=e920196f&sv=1)
Go to Settings in your Cusna account and select Cambium (cnMaestro).
Enter the requested value;
hostname
Client ID
Client Secret
Click Setup.
![](https://docs.cusna.io/~gitbook/image?url=https%3A%2F%2F3426155342-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDvdioCJduzKTpzAv3Sij%252Fuploads%252FOUsEvRCHpdlLh4jkg8Rq%252Fimage.png%3Falt%3Dmedia%26token%3D05ae10b9-40f2-4dd0-b7b3-580b56e2a2fa&width=768&dpr=4&quality=100&sign=285c0aa&sv=1)
After clicking Setup, you'll see the Cambium integration in the list.
![](https://docs.cusna.io/~gitbook/image?url=https%3A%2F%2F3426155342-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDvdioCJduzKTpzAv3Sij%252Fuploads%252FTqCJjXJiYWqXNB2ZEmOL%252Fimage.png%3Falt%3Dmedia%26token%3D59a9d30f-c759-4deb-a26c-744bc17e2d2d&width=768&dpr=4&quality=100&sign=1aa2f822&sv=1)
You can change the Client ID and Client Secret in future, but you can't change the account hostname
Operating Cusna
Creating Locations
When you create or edit a Location in the Cusna dashboard, in the WiFi configuration section, you have to pick the WLAN that you have enabled on the Access Point of the related to property.
Creating Accounts
When you create a new Account, a new PSK user will be created in your cnMaestro account with a predefined WiFi Passphrase. The Account of type Tenant and Visitors, receive an activation email with the default passphrase and QR code, and a link to the WiFi Portal where can change the passphrase.
To avoid synchronization problems, do not manage manually the ePSKs in the cnMaestro interface
Last updated