Aller au contenu
local-cert
Parcourir la documentation

Provider AWS

Un provider est une identité sur un compte AWS, que local-cert utilise pour lire et écrire dans Route53. Vous en créez un par compte — aws-prod, aws-lab — puis vous déclarez vos domaines dessus.

Le modèle

Trois objets côté AWS, chacun avec un rôle précis :

ObjetRôleCe qu'il porte
Utilisateur IAMl'identité de local-certune paire de clés, et rien d'autre
Rôle IAMce que local-cert a le droit de fairela politique Route53, que vous faites évoluer
Politique du rôlela liste des zones autoriséesgénérée par local-cert, collée par vous

La clé stockée dans local-cert ne donne donc aucun droit par elle-même : elle permet seulement d'assumer le rôle. Ajouter une zone, c'est modifier la politique du rôle ; la clé ne change jamais.

L'assistant de la page Providers déroule ces étapes et génère chaque document avec vos vrais identifiants. Ce guide les détaille.

1. Créer l'utilisateur IAM

  1. Console AWS → IAM → Users → Create user.
  2. Nom : local-cert. Laissez décoché Provide user access to the AWS Management Console.
  3. Étape des permissions : n'attachez rien. Terminez la création.
  4. Ouvrez l'utilisateur → Security credentials → Create access key → cas d'usage Application running outside AWS.
  5. Notez l'Access key ID et la Secret access key : la seconde n'est plus consultable ensuite.

2. Saisir la clé dans local-cert

  1. Providers → + nouveau provider.
  2. Donnez un nom (aws-prod) et collez la paire de clés.
  3. Vérifier la clé : local-cert appelle sts:GetCallerIdentity, qui ne demande aucun droit, et affiche l'ARN de l'utilisateur. C'est cet ARN qui sert à générer la suite.

La clé secrète est chiffrée en base (AES-256-GCM avec MASTER_KEY) et n'est jamais réaffichée ni renvoyée par l'API.

3. Créer le rôle

  1. IAM → Roles → Create role → Custom trust policy.
  2. Collez la politique de confiance affichée par l'assistant. Elle n'autorise que votre utilisateur à assumer le rôle :
Politique de confiance (exemple)
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "LocalCertAssume",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::123456789012:user/local-cert"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}
  1. Étape des permissions : n'ajoutez aucune politique gérée.
  2. Nom du rôle : local-cert-dns. Créez-le.
  3. Ouvrez le rôle → Permissions → Add permissions → Create inline policy → onglet JSON, et collez la politique de droits de l'assistant. À ce stade elle ne contient que le nécessaire pour lister les zones :
Politique de droits initiale
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "LocalCertListZones",
      "Effect": "Allow",
      "Action": "route53:ListHostedZones",
      "Resource": "*"
    },
    {
      "Sid": "LocalCertPollChange",
      "Effect": "Allow",
      "Action": "route53:GetChange",
      "Resource": "*"
    },
    {
      "Sid": "LocalCertRemoveUser",
      "Effect": "Allow",
      "Action": [
        "iam:ListAccessKeys",
        "iam:DeleteAccessKey",
        "iam:ListUserPolicies",
        "iam:DeleteUserPolicy",
        "iam:DeleteUser"
      ],
      "Resource": "arn:aws:iam::123456789012:user/local-cert"
    },
    {
      "Sid": "LocalCertRemoveOwnPolicy",
      "Effect": "Allow",
      "Action": [
        "iam:ListRolePolicies",
        "iam:DeleteRolePolicy"
      ],
      "Resource": "arn:aws:iam::123456789012:role/local-cert-dns"
    }
  ]
}
  1. Nommez la politique (local-cert-route53), enregistrez, puis copiez l'ARN du rôle dans l'assistant.

4. Tester et enregistrer

Tester la connexion enchaîne trois vérifications, chacune dépendant de la précédente :

VérificationEn cas d'échec
Paire de clésclé inconnue, désactivée ou mal recopiée
Rôle (AssumeRole)ARN du rôle erroné, ou politique de confiance qui ne nomme pas le bon utilisateur
Zones (ListHostedZones)politique de droits absente du rôle, ou pas encore propagée

IAM applique une modification en quelques secondes : un test lancé juste après un collage peut échouer une fois. Quand les trois lignes sont à OK, Enregistrer.

5. Ajouter des domaines

Le provider sait maintenant lister vos zones, mais n'a encore le droit d'écrire dans aucune. Ces droits s'ajoutent zone par zone : Ajouter un domaine. Une fois quelques zones déclarées, la politique du rôle ressemble à ceci :

Politique de droits avec deux zones (exemple)
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "LocalCertListZones",
      "Effect": "Allow",
      "Action": "route53:ListHostedZones",
      "Resource": "*"
    },
    {
      "Sid": "LocalCertPollChange",
      "Effect": "Allow",
      "Action": "route53:GetChange",
      "Resource": "*"
    },
    {
      "Sid": "LocalCertReadZone",
      "Effect": "Allow",
      "Action": [
        "route53:GetHostedZone",
        "route53:ListResourceRecordSets"
      ],
      "Resource": [
        "arn:aws:route53:::hostedzone/Z0123456ABCDEFGHIJK",
        "arn:aws:route53:::hostedzone/Z0987654ZYXWVUTSRQP"
      ]
    },
    {
      "Sid": "LocalCertWriteRecords",
      "Effect": "Allow",
      "Action": "route53:ChangeResourceRecordSets",
      "Resource": [
        "arn:aws:route53:::hostedzone/Z0123456ABCDEFGHIJK",
        "arn:aws:route53:::hostedzone/Z0987654ZYXWVUTSRQP"
      ],
      "Condition": {
        "ForAllValues:StringEquals": {
          "route53:ChangeResourceRecordSetsRecordTypes": [
            "TXT",
            "A",
            "AAAA"
          ],
          "route53:ChangeResourceRecordSetsActions": [
            "UPSERT",
            "DELETE"
          ]
        }
      }
    },
    {
      "Sid": "LocalCertRemoveUser",
      "Effect": "Allow",
      "Action": [
        "iam:ListAccessKeys",
        "iam:DeleteAccessKey",
        "iam:ListUserPolicies",
        "iam:DeleteUserPolicy",
        "iam:DeleteUser"
      ],
      "Resource": "arn:aws:iam::123456789012:user/local-cert"
    },
    {
      "Sid": "LocalCertRemoveOwnPolicy",
      "Effect": "Allow",
      "Action": [
        "iam:ListRolePolicies",
        "iam:DeleteRolePolicy"
      ],
      "Resource": "arn:aws:iam::123456789012:role/local-cert-dns"
    }
  ]
}

Le bouton politique de chaque provider régénère ce document à tout moment à partir des domaines réellement déclarés.

Ce que la politique autorise

ActionPortéePourquoi
ListHostedZonescompteproposer la liste des zones ; AWS n'accepte pas de la restreindre
GetChangecompteattendre qu'une écriture soit propagée
GetHostedZone, ListResourceRecordSetszones déclaréesconnaître les serveurs de noms à interroger, lister les enregistrements
ChangeResourceRecordSetszones déclarées, types TXT / A / AAAA, actions UPSERT / DELETEécrire le TXT de validation ; publier l'adresse d'un hôte si vous le demandez
iam:ListAccessKeys, DeleteAccessKey, ListUserPolicies, DeleteUserPolicy, DeleteUserl'utilisateur IAM du provider, lui seulfacultatif : le supprimer au retrait du provider (nettoyage)
iam:ListRolePolicies, DeleteRolePolicyle rôle du provider, lui seulfacultatif : vider le rôle au retrait du provider

Plusieurs comptes AWS

Deux façons de couvrir un second compte, selon ce que vous voulez isoler.

Un provider par compte

Refaites les étapes 1 à 4 dans l'autre compte et nommez le provider en conséquence. Chaque compte a sa propre clé ; en révoquer une n'affecte pas l'autre. C'est la configuration la plus simple à raisonner.

Une seule clé, un rôle par compte

L'utilisateur reste dans le compte A ; le rôle est créé dans le compte B, avec la même politique de confiance (l'ARN de l'utilisateur du compte A). Entre comptes, l'utilisateur doit en plus être autorisé à assumer ce rôle. Attachez-lui cette politique inline :

Politique de l'utilisateur, cas inter-comptes
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "LocalCertAssumeDnsRole",
      "Effect": "Allow",
      "Action": "sts:AssumeRole",
      "Resource": "arn:aws:iam::123456789012:role/local-cert-dns"
    }
  ]
}

Créez ensuite un second provider avec la même paire de clés et l'ARN du rôle du compte B.

Variantes

Sans rôle

Décochez Passer par un rôle IAM dans l'assistant : la politique de droits se colle alors directement sur l'utilisateur. C'est une étape de moins, au prix d'une clé qui porte elle-même les droits.

Sans clé

Si local-cert tourne dans AWS ou dans un cluster avec IRSA, cochez Pas de clé : le provider utilise les credentials du processus (rôle d'instance, rôle de pod, variables d'environnement). Un rôle à assumer reste possible par-dessus.

Déclarer un provider par variables d'environnement

Quand les credentials doivent venir du déploiement plutôt que de la base — secrets gérés par l'orchestrateur, infrastructure décrite en code — un provider se déclare par variables. Tout est facultatif : sans aucune variable, les providers se gèrent uniquement depuis la console.

.env
PROVIDER_AWS_DEFAULT_NAME="Default AWS"
PROVIDER_AWS_DEFAULT_ACCESS_KEY_ID=AKIA…
PROVIDER_AWS_DEFAULT_SECRET_ACCESS_KEY=…
PROVIDER_AWS_DEFAULT_ROLE_ARN=arn:aws:iam::123456789012:role/local-cert-dns

# un second compte : même bloc, autre libellé
PROVIDER_AWS_PROD_NAME="aws-prod"
PROVIDER_AWS_PROD_ACCESS_KEY_ID=AKIA…
PROVIDER_AWS_PROD_SECRET_ACCESS_KEY=…
  • _NAME déclare le provider ; c'est la seule variable obligatoire du bloc. Le libellé (DEFAULT, PROD…) est libre.
  • Sans paire de clés, le provider utilise les credentials du processus. _ROLE_ARN et _REGION sont facultatifs.
  • Ces providers apparaissent dans la console avec la mention environnement. On peut les tester et générer leur politique, mais pas les modifier ni les retirer : cela se fait dans les variables, suivi d'un redémarrage. Leur clé secrète n'est jamais écrite en base.
  • Le libellé DEFAULT a une particularité : les domaines déclarés avant l'arrivée des providers y sont rattachés au démarrage.

Retirer un provider et nettoyer AWS

Providers → retirer efface le provider de local-cert. En cochant Nettoyer aussi côté AWS, le provider défait d'abord ce que l'assistant vous a fait créer :

  1. la session du rôle supprime l'utilisateur IAM : ses clés d'accès, ses politiques inline, puis l'utilisateur ;
  2. elle supprime ensuite la politique du rôle lui-même.

IAM ne permet pas à une identité de se supprimer entièrement : un rôle ne se supprime qu'une fois vidé de ses politiques, et c'est d'elles que vient le droit de le faire. Il reste donc le rôle local-cert-dns, sans aucun droit et que plus personne ne peut assumer. La console affiche la commande pour le supprimer avec un compte administrateur :

AWS CLI
aws iam delete-role --role-name local-cert-dns
  • Sans rôle, le provider ne peut que supprimer sa propre clé d'accès ; l'utilisateur reste, sans identifiant.
  • Les droits correspondants sont les blocs LocalCertRemove… de la politique générée. Ils ne visent que l'utilisateur et le rôle du provider et ne permettent que de supprimer : une clé volée pourrait couper local-cert, pas étendre ses droits. Retirez-les du document si vous ne voulez pas de cette option.
  • Un provider créé avant cette option doit d'abord recevoir la politique à jour (bouton politique). Si AWS refuse avant toute suppression, le provider est conservé.
  • L'option n'est pas proposée quand un autre provider utilise le même utilisateur ou le même rôle, ni pour les providers déclarés par variables d'environnement.
  • Si l'utilisateur a des politiques gérées attachées ou appartient à un groupe, IAM refuse sa suppression : le nettoyage s'arrête là et liste ce qui reste à faire.

Rotation de la clé

  1. Dans IAM, créez une seconde clé d'accès sur l'utilisateur.
  2. Providers → modifier → Remplacer la paire de clés → Tester, puis Enregistrer.
  3. Dans IAM, désactivez l'ancienne clé, puis supprimez-la.

Le rôle et sa politique ne sont pas concernés.