Welche Vorteile Ihnen die Verbindung bietet
Wenn Sie Ihr eigenes Akamai-Konto verknüpfen, können Sie eine Website über Ihr CDN statt über unseres ausliefern. Die Zone, der Datenverkehr und die Abrechnung laufen über Ihr Konto, und Sie können den Cache dennoch direkt über Ihr Zinn®-Dashboard leeren und die CDN-Einstellungen anpassen – ganz ohne zwischen verschiedenen Oberflächen zu wechseln.
Bevor Sie beginnen
Ein Akamai-Vertrag mit Property Manager und Fast Purge.
1. Erstellen Sie den Schlüssel bei Akamai
Öffnen Sie im Akamai Control Center Identity and Access Management und wählen Sie Create API client. Wählen Sie einen erweiterten Client aus, damit Sie die entsprechenden APIs auswählen können, und erteilen Sie beide folgenden Berechtigungen:
- Property Manager – Lesezugriff, damit wir Ihre Properties einsehen können;
- Fast Purge – damit wir diese leeren können. Dies ist eine separate Berechtigung; ohne diese können wir zwar Ihre Properties einsehen, sie jedoch nicht leeren.
Akamai zeigt daraufhin die EdgeGrid-Anmeldeinformationen des Clients an: einen Host, ein Client-Token, ein Client-Secret sowie ein Access-Token. Kopieren Sie alle vier Werte.
2. Stellen Sie hier die Verbindung her
Öffnen Sie Integrations in Ihrem Dashboard und wählen Sie Connect an account. Wählen Sie Your own CDN als Gruppe und Akamai als Konto aus, füllen Sie die Felder API host, Client token, Client secret und Access token aus und klicken Sie auf Connect account.
Wir überprüfen Ihre Eingaben, bevor diese gespeichert werden. Ein Schlüssel, der nicht funktioniert, wird zu keinem Zeitpunkt gespeichert, und Sie erhalten eine Fehlermeldung mit dem genauen Grund. Ein gültiger Schlüssel wird verschlüsselt in unserem Secrets-Tresor aufbewahrt – niemals in unserer Datenbank – und wird danach nie wieder angezeigt, auch nicht für Sie.
Was als Nächstes geschieht
- Öffnen Sie den Reiter CDN einer Website. Unter Where this site is served from wird dieses Konto als Ziel angezeigt. Wählen Sie es aus und bestätigen Sie den Vorgang; wir erstellen die Website-Konfiguration in Ihrem Konto, überprüfen diese und migrieren die Website erst danach, sodass die Erreichbarkeit während des Wechsels erhalten bleibt.
- Über denselben Reiter können Sie den Cache der Website leeren und deren CDN-Einstellungen in Ihrem Konto anpassen.
- Bei der Verbindung überprüfen wir, wozu der Schlüssel berechtigt ist: Auflistung Ihrer Zonen oder Properties, detailliertes Auslesen einer Property, Leeren des Cache, Ändern von Einstellungen sowie – sofern vom Anbieter unterstützt – geografische Regeln. Die Prüfliste neben der Verbindung zeigt an, welche dieser Funktionen bestätigt werden konnten, sodass fehlende Berechtigungen bereits vor der Migration einer Website auf das Konto sichtbar sind.
- Im Artikel Deploy a site to your own CDN account wird die Migration einer Website zwischen Konten im Detail beschrieben.
Sollte keine Verbindung zustande kommen
Properties werden angezeigt, aber das Leeren schlägt fehl. Dem API-Client fehlt die Berechtigung für Fast Purge. Fügen Sie diese dem Client im Identity and Access Management hinzu.
Die Verbindung wurde abgewiesen. Einer der vier Werte wurde in das falsche Feld eingefügt – der Host ist die lange Adresse, die auf akamaiapis.net endet, und die drei Tokens werden leicht verwechselt.
Es wird angezeigt, dass der Schlüssel abgewiesen wurde. Fast immer liegt dies an einem der folgenden Umstände: einem mitkopierten Leerzeichen oder Zeilenumbruch, einem abgelaufenen Schlüssel oder einem Schlüssel, der nach dem Kopieren widerrufen oder neu generiert wurde. Erstellen Sie einen neuen Schlüssel und fügen Sie ihn erneut ein.
Die Verbindung wird hergestellt, aber ein späterer Vorgang schlägt fehl. Der Schlüssel authentifiziert sich erfolgreich, verfügt jedoch nicht über die für die Aktion erforderliche Berechtigung. Erstellen Sie einen neuen Schlüssel mit den oben aufgeführten Berechtigungen, trennen Sie anschließend die bestehende Verbindung und verbinden Sie den neuen Schlüssel.
Trennen der Verbindung
Öffnen Sie Integrations, suchen Sie das Konto und klicken Sie auf Disconnect. Dadurch wird der gespeicherte Schlüssel umgehend gelöscht. Sämtliche Vorgänge, die diesen Schlüssel verwendet haben, werden beim nächsten Ausführen gestoppt, und die davon abhängigen Ansichten weisen darauf hin, anstatt im Stillen fehlzuschlagen.
Das Trennen der Verbindung macht bereits durchgeführte Aktionen nicht rückgängig – Datensätze, Bereitstellungen oder Einstellungen, die wir an Ihrem Konto vorgenommen haben, bleiben unverändert. Wenn Sie vermuten, dass der Schlüssel selbst kompromittiert wurde, sollten Sie diesen zusätzlich direkt beim Anbieter widerrufen; durch das Trennen der Verbindung wird nur unsere Kopie entfernt, nicht jedoch Ihre.