home-assistant / home-assistant.io

:blue_book: Home Assistant User documentation
https://www.home-assistant.io
Other
4.97k stars 7.28k forks source link

Ruckus One - Connecting to MSP Customer tenants #35651

Open ablanken opened 4 days ago

ablanken commented 4 days ago

Feedback

MSPs can create Ruckus One tenants for their customers. Customers can have varying levels of access to these tenants while the MSP manages licensing, and can assist with config, setup, and troubleshooting.

Customer admin users can create API tokens for these tenants.

My MSP customer tenant dashboard URL looks like the following (when I log in as a customer): https://MSPNAME.msp.ruckus.cloud//t/dashboard

I entered this URL as per the documentation, but received a connection error message. I then removed "MSPNAME.msp." from the URL and the integration started working.

It would be great if MSP customer URLs could be handled automatically, or if the documentation could be updated to help MSP customer users with the setup. My tenant is US-based. I'm guessing that EU and Asia MSP customer users may need to make slightly different modifications.

URL

https://www.home-assistant.io/integrations/ruckus_unleashed/

Version

2024.11.0

Additional information

I also found it interesting that when an MSP admin logs in to one of these customer tenants, the URL takes the standard form (e.g. https://ruckus.cloud/tenantid/t/). One possible interim solution could be to refer to your MSP as to what the dashboard URL should be set to.

home-assistant[bot] commented 4 days ago

Hey there @lanrat, @ms264556, @gabe565, mind taking a look at this feedback as it has been labeled with an integration (ruckus_unleashed) you are listed as a code owner for? Thanks!

Code owner commands Code owners of `ruckus_unleashed` can trigger bot actions by commenting: - `@home-assistant close` Closes the feedback. - `@home-assistant rename Awesome new title` Renames the feedback. - `@home-assistant reopen` Reopen the feedback. - `@home-assistant unassign ruckus_unleashed` Removes the current integration label and assignees on the feedback, add the integration domain after the command. - `@home-assistant add-label needs-more-information` Add a label (needs-more-information) to the feedback. - `@home-assistant remove-label needs-more-information` Remove a label (needs-more-information) on the feedback.
ms264556 commented 2 days ago

I've asked about the EU and Asia URLs on the Ruckus Community forum. Once I get a response then I'll create a bugfix PR to handle these extra URL patterns.

If you independently discover the relevant MSP URLs for Asia & EU then please add them in a comment here: it's hit and miss with the Ruckus Community whether you get a quick response from a Ruckus rep, or no response at all.

ablanken commented 1 day ago

Thanks for looking into this.

The settings to manage the customer portal are normally hidden until (per region) MSP licenses are activated.

I appended /v/portalSetting to the end of the URL after switching tenant region to reveal the MSP URL patterns for those regions:

image

XYZ.msp.eu.ruckus.cloud & XYZ.msp.asia.ruckus.cloud

ms264556 commented 1 day ago

Great. That's what I wanted to know. I'll make the change tonight.