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 :
| Objet | Rôle | Ce qu'il porte |
|---|---|---|
| Utilisateur IAM | l'identité de local-cert | une paire de clés, et rien d'autre |
| Rôle IAM | ce que local-cert a le droit de faire | la politique Route53, que vous faites évoluer |
| Politique du rôle | la liste des zones autorisées | gé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
- Console AWS → IAM → Users → Create user.
- Nom :
local-cert. Laissez décoché Provide user access to the AWS Management Console. - Étape des permissions : n'attachez rien. Terminez la création.
- Ouvrez l'utilisateur → Security credentials → Create access key → cas d'usage Application running outside AWS.
- Notez l'Access key ID et la Secret access key : la seconde n'est plus consultable ensuite.
2. Saisir la clé dans local-cert
- Providers → + nouveau provider.
- Donnez un nom (
aws-prod) et collez la paire de clés. - 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
- IAM → Roles → Create role → Custom trust policy.
- Collez la politique de confiance affichée par l'assistant. Elle n'autorise que votre utilisateur à assumer le rôle :
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "LocalCertAssume",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::123456789012:user/local-cert"
},
"Action": "sts:AssumeRole"
}
]
}- Étape des permissions : n'ajoutez aucune politique gérée.
- Nom du rôle :
local-cert-dns. Créez-le. - 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 :
{
"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"
}
]
}- 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érification | En cas d'échec |
|---|---|
| Paire de clés | clé 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 :
{
"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
| Action | Portée | Pourquoi |
|---|---|---|
ListHostedZones | compte | proposer la liste des zones ; AWS n'accepte pas de la restreindre |
GetChange | compte | attendre qu'une écriture soit propagée |
GetHostedZone, ListResourceRecordSets | zones déclarées | connaître les serveurs de noms à interroger, lister les enregistrements |
ChangeResourceRecordSets | zones 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, DeleteUser | l'utilisateur IAM du provider, lui seul | facultatif : le supprimer au retrait du provider (nettoyage) |
iam:ListRolePolicies, DeleteRolePolicy | le rôle du provider, lui seul | facultatif : 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 :
{
"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.
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=…_NAMEdé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_ARNet_REGIONsont 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é
DEFAULTa 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 :
- la session du rôle supprime l'utilisateur IAM : ses clés d'accès, ses politiques inline, puis l'utilisateur ;
- 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 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é
- Dans IAM, créez une seconde clé d'accès sur l'utilisateur.
- Providers → modifier → Remplacer la paire de clés → Tester, puis Enregistrer.
- Dans IAM, désactivez l'ancienne clé, puis supprimez-la.
Le rôle et sa politique ne sont pas concernés.