Forfaits, packages et paliers de permission

Trois écrans se côtoient sous Catalog et sont facilement confondus.

• Une edition est le forfait d’abonnement — ce sur quoi un client se trouve. Palier, prix, et la carte des droits : plafonds de capacité, commutateurs de modules et indicateurs de capacités.
• Un package est une ligne du catalogue de facturation — ce qu’un client achète en plus. Un entrepôt supplémentaire, un pack d’assistance, un lot de crédits. Il n’accorde aucun droit.
• Un vertical est le secteur dans lequel un client opère. En lecture seule ici, activé compte par compte.

En une phrase : l’edition dit ce qu’un client peut faire, les packages disent ce qu’il a acheté en plus, les verticals disent dans quel secteur il est.

Editions

Créer un forfait

1. Allez dans Catalog → Editions et cliquez sur New edition.
2. Saisissez le Name (key). C’est l’identifiant, et il est définitif.
3. Saisissez le Display name, choisissez le Tier (Basic, Standard, Growth, Professional ou Enterprise) et ajoutez une Description.
4. Laissez Active coché pour qu’on puisse s’y abonner.
5. Sous Pricing, réglez Monthly price, Annual price, Setup fee, Trial days et Monthly credits, et cochez Allow setup-fee installments si les frais de mise en service peuvent être étalés.
6. Sous Entitlements, parcourez les trois groupes :
   • License & limits — des plafonds numériques. Laissez une case vide pour illimité.
   • Modules — activé ou désactivé.
   • Capabilities — activé ou désactivé, ou une liste déroulante. Tout ce à quoi vous ne touchez pas conserve la valeur par défaut de la plateforme.
7. Cliquez sur Create edition.
8. Vérifiez la carte Feature snapshot en lecture seule. C’est exactement ce qu’un client reçoit quand le forfait est approvisionné.

Saisir une clé existante dans le formulaire New edition écrase ce forfait

Créer une edition est un upsert basé sur le nom. Il n’y a pas d’erreur « existe déjà » et pas d’avertissement — si vous saisissez la clé d’un forfait en production, vous venez de le remplacer.

Vérifiez la clé dans la liste Editions avant de créer quoi que ce soit.

Quiconque peut voir Editions peut les supprimer

Le catalogue de permissions ne définit délibérément aucune permission de création ou de suppression pour les editions — l’intention était qu’elles soient initialisées et jamais gérées par un utilisateur. La console propose quand même New edition et Delete, et comme la couche d’autorisation se rabat sur la permission par défaut de la ressource quand une permission spécifique n’est pas définie, les deux ne demandent que la permission de consultation.

En pratique : n’accordez provider.editions qu’aux opérateurs à qui vous confieriez la suppression d’un forfait. La permission manage_features est déclarée mais n’est jamais réellement consultée.

Modifier un forfait plus tard

Rouvrez l’edition, changez les contrôles, Save changes. Name (key) reste verrouillé.

Les clients existants ne sont pas mis à jour rétroactivement. Ils gardent les droits qui leur ont été approvisionnés jusqu’à ce que quelqu’un les réapprovisionne. L’avertissement de suppression le dit : “Tenants on it keep their provisioned features until reprovisioned.”

La liste Editions n’a ni filtres ni recherche, et les editions inactives sont mêlées aux actives.

Packages

1. Allez dans Catalog → Packages et cliquez sur New package.
2. Saisissez le Name.
3. Choisissez le Kind — subscription, license add-on, credit pack ou service pack. Cela restreint le champ suivant.
4. Choisissez le Type, l’Unit et le Status.
5. Saisissez l’Amount.
6. Pour un credit pack, saisissez Credits per pack.
7. Ajoutez éventuellement une Image URL et une Description, et cochez Recurring charge pour une facturation par période.
8. Cliquez sur Create package.

Sur un package existant, Resolve price vous permet de coller l’identifiant d’un client et de voir si une dérogation négociée s’applique, ou le prix catalogue sinon.

Un package de kind « subscription » n’est pas un forfait

C’est un substitut dans le catalogue de facturation pour qu’un forfait puisse apparaître sur une facture. Pour changer ce qu’un forfait accorde, modifiez toujours l’Edition, jamais le package.

Verticals

Catalog → Verticals est une liste en lecture seule des secteurs enregistrés sur la plateforme. Vous ne pouvez pas en ajouter, en modifier ni en retirer ici — la liste vient du logiciel lui-même.

Activer un vertical pour un client donné se fait sur la page de ce compte, dans la limite du plafond de secteurs du forfait.

Permission tiers

Platform → Permission tiers est la matrice forfait-permission : quel palier d’abonnement une permission exige avant de fonctionner, et éventuellement quel module doit aussi être activé.

C’est la version modifiable à chaud de ce qui serait autrement codé en dur, donc reclasser une permission ne demande aucune nouvelle version.

Reclasser une permission

1. Allez dans Platform → Permission tiers.
2. Trouvez la permission avec le champ Search, ou restreignez avec les pastilles Category.
3. Cliquez sur le crayon.
4. Changez le Minimum tier — Any (ungated), Basic, Standard, Growth, Professional ou Enterprise.
5. Définissez éventuellement un Required module / vertical pour que la permission exige aussi que cette fonctionnalité soit activée.
6. Ajoutez une Note expliquant pourquoi.
7. Cliquez sur Save.

Pour ouvrir une permission à tous les forfaits, mettez le palier sur Any (ungated) ou supprimez la ligne.

C’est la modification la plus dangereuse de la console, et elle n’a pas de confirmation

Une modification enregistrée prend effet immédiatement, sur tous les comptes de la plateforme. La matrice en cache est rafraîchie et l’instantané de permissions de chaque compte est jeté sur-le-champ.

Relevez le palier d’une permission largement détenue et tous les comptes en dessous de ce palier la perdent d’un coup — en plein service, sans avertissement pour eux et sans aperçu « N comptes concernés » pour vous.

Seul Delete vous avertit, et seulement à propos du risque inverse : “This permission will become ungated (available on every plan). Applies to all tenants immediately.”

Faites les changements de palier délibérément, en dehors des heures de service, et vérifiez un compte du forfait concerné juste après.

Sur une barrière existante, le Permission prefix est verrouillé. Pour pointer une barrière vers une autre permission, supprimez-la et créez-en une nouvelle.

À lire aussi

• Comptes clients
• Facturation et factures
• La console d’hébergement