AWS-toegang instellen

Koppel je AWS-account zodat InfraNest je Route 53 DNS-zones en Route 53 Domains kan beheren en je ACM-certificaten kan uitlezen. Dit artikel is bedoeld voor iedereen die voor het eerst AWS-toegang instelt.

#Overzicht

• InfraNest heeft toegang nodig tot Route 53, Route 53 Domains en ACM om je domeinen en DNS-records te tonen en te beheren.
• Je kunt toegang verlenen met een IAM-rol (aanbevolen) of met access keys.
• Beide methoden hebben toestemming nodig om dingen te wijzigen, niet alleen te lezen — alleen-lezen toegang vult je lijsten, maar elke wijziging die je probeert te maken in InfraNest wordt geweigerd.

NoteAls je een bepaalde AWS-functie niet gebruikt (bijvoorbeeld Route 53 Domains), kun je de bijbehorende machtigingen weglaten — vink die groep gewoon uit bij de verbinding in InfraNest. Lijsten worden nog steeds geladen zonder schrijftoegang, maar wijzigingen worden geweigerd.

#Een IAM-rol instellen (aanbevolen)

Met een rol slaat InfraNest nooit je geheimen op, en je kunt de toegang op elk moment intrekken door de rol te verwijderen.

1. Open in InfraNest Integrations → AWS, selecteer Connect en kies IAM role bij Connection method. Het formulier toont InfraNest's AWS account ID en een gegenereerde External ID — noteer beide, je hebt ze nodig.

2. Ga in de AWS IAM console naar Roles → Create role, kies AWS account → Another AWS account, voer InfraNest's account-ID in, vink Require external ID aan en plak de External ID erin.
3. Koppel een policy met de hieronder vermelde machtigingen.
4. Geef de rol een naam (bijvoorbeeld InfraNest), maak hem aan en kopieer vervolgens de ARN van de samenvattingspagina van de rol.

#Access keys instellen in plaats daarvan

1. Ga in de AWS IAM console naar Users → Create user en koppel een policy met de hieronder vermelde machtigingen.
2. Open de Security credentials van de gebruiker en kies Create access key → Third-party service.
3. Kopieer de Access key ID en Secret access key. De secret access key wordt maar één keer getoond, bewaar deze dus op een veilige plek.

#De juiste machtigingen kiezen

De snelste optie is om de door AWS beheerde policies te gebruiken: AmazonRoute53FullAccess, AmazonRoute53DomainsFullAccess en AWSCertificateManagerReadOnly.

Als je liever je eigen policy schrijft, zijn dit de acties die InfraNest gebruikt:

• Route 53 (DNS) — route53:ListHostedZones, route53:ListResourceRecordSets, route53:ChangeResourceRecordSets, route53:CreateHostedZone, route53:DeleteHostedZone.
• Route 53 Domains — route53domains:ListDomains, GetDomainDetail, CheckDomainAvailability, CheckDomainTransferability, ListPrices, RegisterDomain, TransferDomain, RenewDomain, RetrieveDomainAuthCode, UpdateDomainNameservers, UpdateDomainContact, UpdateDomainContactPrivacy, EnableDomainTransferLock, DisableDomainTransferLock, EnableDomainAutoRenew, DisableDomainAutoRenew, AssociateDelegationSignerToDomain, DisassociateDelegationSignerToDomain.
• ACM (certificaten) — acm:ListCertificates, acm:GetCertificate, acm:DescribeCertificate. Dit is alleen-lezen.
• Alleen access keys — sts:GetCallerIdentity, zodat InfraNest kan achterhalen tot welk AWS-account de keys behoren.

#De koppeling in InfraNest afronden

1. Ga terug naar InfraNest en volg Connect Amazon Web Services (AWS).
2. Voer je role-ARN in (als je een IAM-rol hebt ingesteld) of je access keys (als je die in plaats daarvan hebt aangemaakt).

#Tips

TipGeef, indien mogelijk, de voorkeur aan de IAM-rolmethode — hiermee hoef je geen langdurig geldige geheimen op te slaan en je kunt de toegang eenvoudig intrekken door de rol in AWS te verwijderen.