AWS-Zugriff einrichten

Verbinde dein AWS-Konto, damit InfraNest deine Route 53-DNS-Zonen und Route 53 Domains verwalten sowie deine ACM-Zertifikate lesen kann. Dieser Artikel richtet sich an alle, die den AWS-Zugriff zum ersten Mal einrichten.

#Überblick

• InfraNest benötigt Zugriff auf Route 53, Route 53 Domains und ACM, um deine Domains und DNS-Einträge anzuzeigen und zu verwalten.
• Du kannst den Zugriff über eine IAM-Rolle (empfohlen) oder über Access Keys gewähren.
• Beide Methoden benötigen die Berechtigung, Dinge zu ändern, nicht nur zu lesen — mit reinem Lesezugriff werden zwar deine Listen befüllt, aber jede Änderung, die du in InfraNest vornehmen möchtest, wird abgelehnt.

NoteWenn du eine bestimmte AWS-Funktion nicht nutzt (zum Beispiel Route 53 Domains), kannst du deren Berechtigungen weglassen — entferne einfach das Häkchen bei dieser Gruppe in der Verbindung in InfraNest. Listen werden auch ohne Schreibzugriff geladen, Änderungen werden jedoch abgelehnt.

#IAM-Rolle einrichten (empfohlen)

Eine Rolle bedeutet, dass InfraNest deine Secrets niemals speichert, und du kannst den Zugriff jederzeit widerrufen, indem du die Rolle löschst.

1. Öffne in InfraNest Integrationen → AWS, wähle Verbinden und anschließend IAM role unter Connection method. Das Formular zeigt die AWS account ID von InfraNest sowie eine generierte External ID — notiere dir beide, du wirst sie benötigen.

2. Gehe in der AWS IAM console zu Roles → Create role, wähle AWS account → Another AWS account, gib die Account-ID von InfraNest ein, aktiviere Require external ID und füge die External ID ein.
3. Hänge eine Policy mit den unten aufgeführten Berechtigungen an.
4. Benenne die Rolle (zum Beispiel InfraNest), erstelle sie und kopiere anschließend ihre ARN von der Übersichtsseite der Rolle.

#Stattdessen Access Keys einrichten

1. Gehe in der AWS IAM console zu Users → Create user und hänge eine Policy mit den unten aufgeführten Berechtigungen an.
2. Öffne die Security credentials des Benutzers und wähle Create access key → Third-party service.
3. Kopiere die Access key ID und den Secret access key. Der Secret Access Key wird nur einmal angezeigt, speichere ihn also an einem sicheren Ort.

#Die richtigen Berechtigungen wählen

Am schnellsten geht es mit den verwalteten AWS-Policies: AmazonRoute53FullAccess, AmazonRoute53DomainsFullAccess und AWSCertificateManagerReadOnly.

Wenn du lieber eine eigene Policy schreiben möchtest, sind dies die Aktionen, die InfraNest verwendet:

• 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 (Zertifikate) — acm:ListCertificates, acm:GetCertificate, acm:DescribeCertificate. Dies ist reiner Lesezugriff.
• Nur Access Keys — sts:GetCallerIdentity, damit InfraNest erkennen kann, zu welchem AWS-Konto die Keys gehören.

#Verbindung in InfraNest abschließen

1. Gehe zurück zu InfraNest und folge Connect Amazon Web Services (AWS).
2. Gib deine Rollen-ARN ein (falls du eine IAM-Rolle eingerichtet hast) oder deine Access Keys (falls du diese stattdessen erstellt hast).

#Tipps

TipBevorzuge nach Möglichkeit die IAM-Rollen-Methode — so vermeidest du das Speichern langlebiger Secrets, und du kannst den Zugriff leicht widerrufen, indem du die Rolle in AWS löschst.