Une production externe vous demande de créer un accès pour remonter les données de billetterie d'un spectacle particulier sur leur outil Arenametrix/Delight/Pims, et vous voulez qu'elle ne voie bien que les données de son propre spectacle. Le jeton créé automatiquement par « Connecter un partenaire » ne le permet pas : il donne accès à l'ensemble de votre contrat. Il faut passer par une application privée dont le rôle est limité à un seul spectacle.

Pourquoi ne pas passer par « Connecter un partenaire »¶

Arenametrix/Delight/Pims figurent parmi les applications partenaires, et « Connecter un partenaire » est la voie la plus rapide pour obtenir un jeton. Mais ce jeton n'est pas restreignable : celui qui le détient peut lire tout votre contrat, y compris les autres spectacles et leurs commandes.

Une application privée fonctionne autrement : son jeton est rattaché à un rôle, et c'est ce rôle qui fixe ce qu'il peut lire. En limitant ce rôle à un spectacle, vous limitez le jeton à ce spectacle. Arenametrix/Delight/Pims accepte ce jeton, que vous lui communiquez comme celui d'une application partenaire.

Créer le branchement¶

Vous avez besoin d'un accès administrateur.

Créer un rôle limité au spectacle¶

1. Ouvrez le menu Paramétrage / Droits d'accès, puis cliquez sur « Créer un nouveau rôle ».
2. Nommez le rôle avec le nom de la production ou du spectacle, par exemple « Pims - Nom de la production ». Quand vous aurez plusieurs rôles de ce type, le nom vous évitera de les confondre.
3. Cochez « Voir les événements » dans la section Événements. Sous la case, la liste affiche « Voir tous les événements » : ouvrez-la et sélectionnez uniquement le ou les spectacles concernés. Laissée par défaut, elle donnerait accès à toute votre programmation.

[CAPTURE : la section Événements des permissions du rôle, avec la case « Voir les événements » cochée et la liste déroulante « Voir tous les événements » sous la case]

4. Cochez « Voir les participants et les commandes ». Avec « Voir les événements », ce sont les deux seules permissions dont Arenametrix/Delight/Pims ont besoin pour cet usage. N'en ajoutez pas d'autres : si le jeton était un jour compromis, le risque reste limité à de la lecture sur ce spectacle.
5. Enregistrez le rôle.

Créer l'application privée¶

1. Ouvrez la page Applications, depuis Paramétrage / Droits d'accès, puis cliquez sur « Créer une application privée ».
2. Remplissez les champs :
   • Nom : libre, il sert à vous y retrouver. Reprenez le nom du rôle
   • URL : l'adresse du site qui va utiliser l'API Mapado, ici vous pouvez mettre l'URL de Arenametrix/Delight/Pims selon le cas
   • Rôle par défaut : choisissez le rôle que vous venez de créer. C'est ce champ qui limite les droits du jeton
3. Copiez le jeton d'accès avec le bouton à droite du jeton.

[CAPTURE : l'application privée créée, avec le jeton d'accès et le bouton de copie à droite]

4. Communiquez à Arenametrix/Delight/Pims le jeton d'accès et l'identifiant de votre contrat, affiché en haut de la page Applications sous la forme /v1/contracts/xxxxxx.

Plusieurs productions¶

Répétez les deux étapes pour chaque production qui vous le demande : un rôle, une application privée, un jeton. Chaque production ne reçoit que son jeton et ne voit que son spectacle.

À savoir¶

• Les rôles par défaut (Accès complet, Manager, Guichet) ne sont pas modifiables : pour limiter un jeton, créez toujours un rôle dédié
• Vous n'avez pas besoin d'inviter de collaborateur pour ce branchement : seuls le rôle et l'application privée sont à créer