Utiliser NasDash

Authentification et rôles

Administrateur, lecteurs, mode public, sessions et listes d'autorisation.

Les administrateurs gèrent réglages, utilisateurs et modifications. Les lecteurs reçoivent une configuration filtrée et les accès en lecture autorisés. Configurez les comptes dans Réglages → Utilisateurs et accès, puis vérifiez avec une véritable session lecteur.

Une installation neuve est privée et crée seulement admin. Le guide de premier démarrage remplace le code de configuration par un nouveau mot de passe administrateur. Le passage en mode public dans le guide ou les Paramètres crée viewer s’il manque, avec un accès initial à toutes les pages et tous les widgets. Son mot de passe aléatoire n’est jamais affiché. Limitez ses permissions dans Paramètres → Utilisateurs et accès, et définissez-y un mot de passe seulement si quelqu’un doit se connecter en tant que viewer. Les comptes et permissions existants sont conservés.

Identités et listes autorisées

En mode public, les requêtes anonymes utilisent les permissions du compte viewer enregistré. En mode privé, elles reçoivent 401. Les lecteurs connectés utilisent leur rôle et permissions actuels ; les administrateurs ont toutes les lectures. Le jeton d’un utilisateur supprimé reçoit 401 dans les deux modes. allowedTabs et allowedWidgets limitent les onglets et types de widgets : par compatibilité, une liste vide signifie un accès illimité dans cette liste. Une ressource API est autorisée si au moins un onglet ou widget associé est autorisé. Masquer un bouton n’est pas un contrôle d’autorisation.

Correspondances des ressources serveur

RessourceOngletsWidgets
État des servicesdashboardquickstats, networkgraph
Métriques machinesdashboarddevices, quickstats
Calendrier—calendar
Topologie réseaunetworksnetworkgraph
Tailscalenetworkstailscale
Liste des conteneurs Dockerdocker, networksdockercontainers
Détails Docker, journaux, images, volumesdocker—

Les widgets de contenu actuels nécessitent aussi leur famille d’autorisation : DNS, Médias (musique et téléchargements compris), Photos, API personnalisée, VPN ou Onduleur. Autorisez les widgets nécessaires dans Paramètres → Utilisateurs et accès et vérifiez avec une session lecteur.

Les modifications exigent un administrateur et les droits du fournisseur choisi. Le réglage affichant les boutons Démarrer/Arrêter des widgets agit sur la présentation, pas sur l’autorisation API. Un proxy de socket limite aussi les méthodes API autorisées.

Configuration et sessions révocables

GET /api/config renvoie une copie filtrée sans modifier le cache serveur. Les identifiants sont masqués pour toutes les identités. Les lecteurs ne reçoivent pas les catégories secrètes, ressources interdites, URL de daemon/chemins de socket et identifiants d’intégrations. Les liens de services autorisés restent utilisables. Changer mot de passe, rôle ou listes incrémente sessionVersion ; les requêtes suivantes rejettent les anciens jetons et imposent une nouvelle connexion. Les anciens jetons sans cette valeur utilisent la version zéro. Gardez les clés persistantes et tout secret d’environnement existant stables ; consultez les variables et sauvegardes.

Choisissez explicitement Tout, certaines entrées ou Aucun pour les droits. Aucun refuse cette liste ; les anciennes listes vides gardent leur sens sans restriction pour compatibilité. Les widgets machines partagent le droit aux données machines : masquer CPU en autorisant un autre widget machine ne limite pas les valeurs de chaque capteur. Vérifiez pages et API avec une session lecteur séparée. L’URL privée du calendrier reste sur le serveur ; les lecteurs reçoivent les événements, pas son jeton d’accès.