Admin rights mandatory on DSM side

[osmeest]

Feedback

I tried to integrate my Synology DS218play (running DSM 7.2) in HomeAssistant with a HA specific user created on the NAS.
It failed consistently until I put the user in the administrators group.
I believe this should be mentioned explicitly in the documentation for the integration. (I read somewhere this was mandatory starting with DSM 7.1).
I also gave it permissions to use DSM but I'm not sure if that's required.

URL

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

Version

2025.1.2

Additional information

No response

[home-assistant]

Hey there @hacf-fr, @Quentame, @mib1185, mind taking a look at this feedback as it has been labeled with an integration (synology_dsm) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of synology_dsm 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 synology_dsm 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.

[mib1185]

it is menationed in the Separate User Configuration section?

[osmeest]

Now that you say it, it is indeed written "You must grant the user admin rights in order to access utilization information".
I interpreted this as giving access to DSM app. Seeing the list of groups proposed by DSM (users, http, administrators), I was a bit reluctant to put it as member of the administrators group. Until I realised this was the only way. I also tried putting the user in the http group but that doesn't work either.

All in all, I believe it would probably be more explicit if it was written as "the user must be in the administrators group in DSM".

My 2c,

[mib1185]

You must grant the user admin rights

This is a quiet common phrase and it describes that the user has to have admin rights - it is up to the user, how they want to achieve this - maybe through a direct membership of the administrators group or indirect via other group memberships