Créer une clé d'API Porkbun

Suivez ce guide pour générer une clé d'API Porkbun et une clé secrète pour InfraNest, et pour vous assurer que Porkbun autorise réellement cette clé à agir — une étape que presque tout le monde manque la première fois.

Vue d'ensemble

• Porkbun exige deux identifiants — une clé d'API et une clé d'API secrète — pour permettre à InfraNest de gérer vos domaines.
• Créer la clé ne prend qu'une minute, mais Porkbun exige aussi que vous activiez l'accès à l'API pour vos domaines séparément, sinon chaque modification tentée par InfraNest sera refusée.
• Vous pouvez éventuellement restreindre davantage la clé avec une liste d'adresses IP autorisées, une liste de domaines autorisés et des contrôles de dépenses.

Créer la clé

1. Connectez-vous à Porkbun.
2. Allez dans Account → API Access (porkbun.com/account/api).
3. Sélectionnez Create API Key et donnez-lui un nom que vous reconnaîtrez, par exemple InfraNest.
4. Porkbun vous affiche une clé d'API commençant par pk1_ et une clé d'API secrète commençant par sk1_.
5. Copiez les deux et collez-les dans InfraNest — voir Connect Porkbun.

WarningLa clé secrète n'est affichée qu'une seule fois. Si vous la perdez, créez une nouvelle paire de clés plutôt que d'essayer de la récupérer.

Activez ensuite l'accès à l'API pour vos domaines

C'est l'étape que les gens oublient. Créer une clé ne lui permet pas, en elle-même, d'agir sur vos domaines. Porkbun contrôle l'accès à l'API par domaine, et celui-ci est désactivé par défaut.

Le symptôme est sans équivoque une fois qu'on le connaît : tous vos domaines apparaissent dans InfraNest parfaitement normalement, puis chaque modification que vous tentez — serveurs de noms, renouvellement automatique, un enregistrement DNS — est refusée. Votre clé n'a aucun problème.

Vous avez deux façons de résoudre cela :

1. Tout en une fois (recommandé). Sur la même page Account → API Access, activez Opt In All Domains. Les nouveaux domaines que vous enregistrez plus tard sont alors inclus automatiquement.
2. Un domaine à la fois. Dans votre liste de domaines sur porkbun.com/account, ouvrez un domaine et activez son interrupteur API Access.

InfraNest signale tout domaine encore désactivé avec un indicateur NO API et explique quoi faire, donc si vous n'en avez traité que certains, vous pouvez voir lesquels restent.

Optionnel : restreindre la clé

Porkbun peut restreindre davantage une clé. Les deux paramètres sont optionnels et désactivés sauf si vous les activez — vous les trouverez derrière l'icône en forme d'engrenage à côté de la clé sur la page API Access.

• Source IP allowlist — n'accepter que les requêtes provenant de certaines adresses. Si vous définissez cela, ajoutez l'adresse IP affichée sur le formulaire de connexion Porkbun d'InfraNest, sinon chaque requête sera refusée quelle que soit la justesse de votre clé.
• Target domain allowlist — n'autoriser la clé à agir que sur certains domaines. C'est une correspondance exacte, donc lister example.com ne couvre aucun autre domaine que vous possédez.

Si vous n'êtes pas sûr, laissez les deux champs vides. C'est le réglage par défaut de Porkbun et il fonctionne.

Optionnel : contrôles de dépenses

Porkbun dépense à partir du crédit prépayé de votre compte, et la même page API Access permet de limiter le montant qu'une clé peut dépenser par mois et de vous envoyer un e-mail lorsque le solde descend sous un montant que vous choisissez. InfraNest lit les deux et les affiche sur la connexion, afin qu'une limite mensuelle que vous définissez ici ne vous surprenne pas plus tard.

NoteUne limite de dépenses mensuelle refuse les débits même lorsque votre solde est sain. Si un renouvellement échoue et que le solde semble correct, vérifiez ce paramètre.