Créer une clé API Porkbun

Créer une clé API Porkbun ne prend qu'une minute, mais une étape supplémentaire piège presque tout le monde — alors ne vous arrêtez pas une fois votre clé copiée.

#Vue d'ensemble

• InfraNest se connecte à Porkbun à l'aide d'une clé API et d'une clé API secrète, toutes deux créées sur le site de Porkbun.
• Créer la clé n'est que la moitié du travail — Porkbun exige aussi que vous activiez l'accès API pour chaque domaine séparément.
• Vous pouvez éventuellement restreindre davantage la clé ou définir des limites de dépenses, mais aucune de ces options n'est requise pour démarrer.

#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 reconnaissable, comme InfraNest.
4. Porkbun vous affiche une API key commençant par pk1_ et une Secret API key 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.

#Activer l'accès API pour vos domaines

C'est l'étape que tout le monde manque. Créer une clé ne lui permet pas, en soi, d'agir sur vos domaines. Porkbun contrôle l'accès 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 normalement dans InfraNest, puis chaque modification que vous tentez — serveurs de noms, renouvellement automatique, un enregistrement DNS — est refusée. Votre clé n'a pourtant rien d'anormal.

Vous avez deux façons de corriger 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 par la suite sont alors inclus automatiquement.
2. Domaine par domaine. Dans votre liste de domaines sur porkbun.com/account, ouvrez un domaine et activez son interrupteur API Access.

InfraNest signale tout domaine encore exclu avec un message expliquant le problème et la marche à suivre, donc si vous n'en avez fait qu'une partie, vous pouvez voir lesquels il reste à traiter.

#Optionnel : restreindre la clé

Porkbun peut verrouiller une clé davantage. Ces deux réglages sont optionnels et désactivés tant que vous ne les activez pas — trouvez-les derrière l'icône d'engrenage à côté de la clé sur la page API Access.

• Source IP allowlist — n'accepter les requêtes que depuis certaines adresses. Laissez ce champ vide : InfraNest ne se connecte pas depuis une adresse fixe, donc avec une liste blanche, chaque requête peut être refusée, aussi correcte que soit 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ébite votre crédit de compte prépayé, et la même page API Access peut limiter le montant qu'une clé peut dépenser par mois et vous envoyer un e-mail lorsque le solde descend en dessous d'un montant que vous choisissez. InfraNest lit ces deux informations et les affiche sur la connexion, donc une limite mensuelle que vous définissez ici ne vous surprendra pas plus tard.

NoteUne limite de dépense mensuelle refuse les débits même lorsque votre solde est suffisant. Si un renouvellement échoue alors que le solde semble correct, vérifiez ce réglage.

#Dépannage

• Chaque modification est refusée, mais la clé semble correcte — vous avez probablement sauté l'étape d'accès API par domaine ci-dessus. Vérifiez Opt In All Domains ou l'interrupteur API Access de chaque domaine.
• Le renouvellement échoue alors que le solde semble correct — vérifiez si une limite de dépense mensuelle est définie sur la clé.