The AI-Native Device Platform
User Manual

awaBerry | S3 Speichereinstellungen

Verbinden Sie S3-kompatiblen Cloud-Speicher mit awaBerry. Unterstützt AWS, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, Ionos und benutzerdefinierte...

S3-Speichereinstellungen

Zusammenfassung

Diese Seite ermöglicht es Ihnen, Ihren eigenen S3-kompatiblen Speicher für Dateien einzurichten und zu verwalten. Sie können aus verschiedenen vordefinierten Anbietern wählen oder einen benutzerdefinierten S3-Dienst nutzen, Ihre Zugangsdaten eingeben und die Verbindung sowie Berechtigungen überprüfen. Die korrekte Konfiguration Ihres S3-Speichers ermöglicht direkte und unbegrenzte Datei-Uploads und -Downloads innerhalb der Anwendung.

Seitenaufruf

Sie können diese Seite aufrufen, indem Sie zu folgender Adresse navigieren: /user_s3

Seitenfunktionen

  • Ein-/Ausschalter: Ermöglicht Ihnen, die Nutzung Ihres eigenen S3-kompatiblen Speichers zu aktivieren oder zu deaktivieren.
  • Dropdown für S3-Anbieter: Wählen Sie aus einer Liste gängiger S3-Anbieter (AWS S3, Cloudflare R2, DigitalOcean Spaces, Backblaze B2, IONOS S3) oder wählen Sie 'Benutzerdefinierte URL', falls Ihr Anbieter nicht aufgeführt ist.
  • Cloudflare-Konto-ID-Feld: (Erscheint, wenn 'Cloudflare R2' ausgewählt ist) Geben Sie hier Ihre Cloudflare-Konto-ID ein. Die S3-URL wird automatisch generiert.
  • DigitalOcean-Region-Dropdown: (Erscheint, wenn 'DigitalOcean Spaces' ausgewählt ist) Wählen Sie die Region für Ihren DigitalOcean Space. Die S3-URL wird automatisch generiert.
  • Backblaze B2-Endpunktfeld: (Erscheint, wenn 'Backblaze B2' ausgewählt ist) Geben Sie die spezifische Endpunkt-URL ein, die von Backblaze B2 für Ihren Bucket bereitgestellt wird.
  • S3-URL-Feld: Dieses Feld zeigt den Endpunkt für Ihren S3-Speicher an. Für 'Benutzerdefinierte URL' geben Sie diese manuell ein. Für andere Anbieter kann sie vorausgefüllt oder automatisch generiert werden.
  • Bucket-Name-Feld: Geben Sie den genauen Namen Ihres S3-Buckets ein, in dem Sie Ihre Dateien speichern möchten.
  • Region-Feld: Geben Sie die geografische Region an, in der Ihr S3-Bucket gehostet wird (z. B. us-west-1 für AWS).
  • Zugriffsschlüssel-Feld: Geben Sie Ihren S3-Zugriffsschlüssel ein, der eine eindeutige Kennung für Ihr S3-Konto oder Ihren Benutzer ist.
  • Geheimer Schlüssel-Feld: Geben Sie Ihren S3-Geheimschlüssel ein. Dieser hochsensible Schlüssel wird verschlüsselt und sicher mittels Ihrer Zwei-Faktor-Authentifizierung gespeichert.
  • Überprüfen und Speichern-Schaltfläche: Klicken Sie auf diese Schaltfläche, nachdem Sie Ihre S3-Details eingegeben haben. Die Anwendung testet Ihre Verbindung ohne Berücksichtigung von CORS. Bei Erfolg werden Ihre Anmeldedaten gespeichert und Sie fahren mit der CORS-Konfiguration fort.
  • Berechtigungseinstellungen (CORS) Abschnitt: Sobald Ihre S3-Anmeldedaten validiert sind, erscheint dieser Abschnitt. Er enthält wichtige Anweisungen und Codebeispiele (für AWS S3, Cloudflare R2) zur Konfiguration von Cross-Origin Resource Sharing (CORS) auf Ihrem S3-Bucket. CORS ist entscheidend für direkte Datei-Uploads und -Downloads von Ihrem Webbrowser ohne Größenbeschränkungen.
  • Einrichtung eigener Berechtigungen für browserbasierte S3-Datei-Uploads/-Downloads: Ein Link zu einer FAQ-Seite für detaillierte CORS-Einrichtungsanweisungen.
  • CORS-Test-Schaltfläche: Nachdem Sie CORS auf Ihrem S3-Bucket konfiguriert haben, klicken Sie auf diese Schaltfläche, um zu überprüfen, ob die CORS-Richtlinie korrekt eingerichtet ist und die direkte Browserinteraktion mit Ihrem S3-Speicher ermöglicht.

Szenario-Ausführungen

Mögliche Nutzungsschritte auf dieser Seite

Szenario 1: Aktivierung und erfolgreiche Konfiguration von AWS S3-Speicher

  1. S3-Speicher aktivieren: Suchen Sie den Schalter "S3-Speicher für Datei-Uploads/-Downloads einrichten" und schalten Sie ihn auf "EIN". Dies zeigt die Konfigurationsoptionen an.
  2. Anbieter auswählen: Wählen Sie im Dropdown-Menü "S3-Anbieter auswählen" die Option "AWS S3".
  3. S3-Details eingeben: Füllen Sie die folgenden Felder mit Ihren spezifischen AWS S3-Informationen aus:
    • "Bucket-Name": (z. B. my-unique-aws-bucket)
    • "Region": (z. B. eu-central-1)
    • "Zugriffsschlüssel": Ihr AWS S3-Zugriffsschlüssel.
    • "Geheimer Schlüssel": Ihr AWS S3-Geheimschlüssel. Denken Sie daran, dass dieser zur Sicherheit verschlüsselt wird.
  4. Anmeldedaten überprüfen und speichern: Klicken Sie auf die Schaltfläche "Überprüfen und Speichern". Die Anwendung testet die Verbindung zu Ihrem AWS S3-Bucket mit den bereitgestellten Schlüsseln.
  5. CORS-Konfiguration: Wenn Ihre Anmeldedaten gültig sind, erscheint die Meldung "S3-Anmeldedaten sind gültig" und ein Abschnitt "Berechtigungseinstellungen (CORS)" wird sichtbar. Befolgen Sie die bereitgestellten Anweisungen, insbesondere das CORS-Richtlinienbeispiel für AWS S3, und wenden Sie es auf die CORS-Einstellungen Ihres AWS S3-Buckets in der AWS Management Console an.
  6. CORS testen: Nachdem Sie Ihre CORS-Richtlinie bei AWS aktualisiert haben, klicken Sie auf die Schaltfläche "CORS testen" auf dieser Seite.
  7. Bestätigung: Wenn der CORS-Test erfolgreich ist, sehen Sie die Meldung "CORS-Konfiguration ist gültig", die bestätigt, dass Ihr S3-Speicher nun vollständig für unbegrenzte Datei-Uploads und -Downloads konfiguriert ist.

Szenario 2: Aktivierung und erfolgreiche Konfiguration von Cloudflare R2-Speicher

  1. S3-Speicher aktivieren: Schalten Sie den Schalter "S3-Speicher für Datei-Uploads/-Downloads einrichten" auf "EIN".
  2. Anbieter auswählen: Wählen Sie "Cloudflare R2" im Dropdown-Menü "S3-Anbieter auswählen".
  3. Cloudflare-Konto-ID eingeben: Geben Sie im Feld "Cloudflare-Konto-ID" Ihre Cloudflare-Konto-ID ein. Beachten Sie, dass das Feld "Generierte S3-URL" automatisch ausgefüllt wird.
  4. R2-Details eingeben: Füllen Sie Folgendes aus:
    • "Bucket-Name": (z. B. my-r2-storage)
    • "Zugriffsschlüssel": Ihr Cloudflare R2-Zugriffsschlüssel.
    • "Geheimer Schlüssel": Ihr Cloudflare R2-Geheimschlüssel.
  5. Anmeldedaten überprüfen und speichern: Klicken Sie auf "Überprüfen und Speichern". Nach erfolgreicher Verbindung erscheint die Meldung "S3-Anmeldedaten sind gültig".
  6. CORS-Konfiguration: Im Abschnitt "Berechtigungseinstellungen (CORS)" finden Sie das CORS-Richtlinienbeispiel für Cloudflare R2. Implementieren Sie diese Richtlinie in Ihren Cloudflare R2-Bucket-Einstellungen.
  7. CORS testen: Klicken Sie auf die Schaltfläche "CORS testen" auf dieser Seite.
  8. Bestätigung: Die Meldung "CORS-Konfiguration ist gültig" bestätigt die erfolgreiche Einrichtung und ermöglicht direkte Dateioperationen mit Ihrem R2-Speicher.

Szenario 3: Deaktivierung des S3-Speichers

  1. S3-Speicher deaktivieren: Suchen Sie den Schalter "S3-Speicher für Datei-Uploads/-Downloads einrichten" und schalten Sie ihn auf "AUS".
  2. Änderungen speichern: Klicken Sie auf die Schaltfläche "Speichern".
  3. Bestätigung: Alle Ihre S3-Konfigurationsdetails werden aus der Anwendung gelöscht und die Nutzung Ihres eigenen S3-Speichers wird deaktiviert.

Mögliche Fehler, die auf dieser Seite auftreten können

Fehler 1: S3-Verbindungstest fehlgeschlagen (Ungültige Anmeldedaten)

Ursache: Dieser Fehler, angezeigt durch "S3-Verbindungstest fehlgeschlagen. Bitte überprüfen Sie Ihre Anmeldedaten.", tritt auf, wenn die Anwendung keine erfolgreiche Verbindung zu Ihrem S3-Speicher mit der angegebenen S3-URL, dem Bucket-Namen, dem Zugriffsschlüssel oder dem geheimen Schlüssel herstellen kann. Dies bedeutet normalerweise, dass eines oder mehrere dieser Details falsch sind oder Ihr S3-Benutzer/Ihre Rolle nicht über die erforderlichen Berechtigungen zum Zugriff auf den Bucket verfügt.

Behebung:

  1. Überprüfen Sie sorgfältig jedes Eingabefeld auf Tippfehler.
  2. Verifizieren Sie Ihren Zugriffsschlüssel und geheimen Schlüssel direkt in der Verwaltungskonsole Ihres S3-Anbieters.
  3. Stellen Sie sicher, dass der angegebene "Bucket-Name" und die "Region" exakt mit Ihrer S3-Einrichtung übereinstimmen.
  4. Überprüfen Sie die Berechtigungen, die Ihrem S3-Zugriffsschlüssel zugewiesen sind. Er benötigt mindestens Lese- und Schreibzugriff auf den angegebenen Bucket.

Fehler 2: Fehlende erforderliche Informationen

Ursache: Wenn Sie versuchen, "Überprüfen und Speichern" auszuführen, ohne alle erforderlichen Felder auszufüllen (z. B. "Bucket-Name", "Zugriffsschlüssel", "Geheimer Schlüssel" oder anbieterspezifische IDs wie "Cloudflare-Konto-ID"), wird direkt unter dem leeren Feld eine rote Fehlermeldung angezeigt, die angibt, was fehlt (z. B. "Bitte Bucket-Namen eingeben").

Behebung: Füllen Sie einfach alle erforderlichen Felder aus, wie in den Fehlermeldungen angegeben.

Fehler 3: Falsches S3-URL-Format

Ursache: Bei Verwendung eines "Benutzerdefinierte URL"-Anbieters oder "Backblaze B2" muss das Feld "S3-URL" mit http:// oder https:// beginnen. Wenn Sie eine URL ohne dieses Präfix eingeben, erhalten Sie eine Fehlermeldung wie "URL muss mit http:// oder https:// beginnen".

Behebung: Korrigieren Sie die URL, indem Sie http:// oder https:// am Anfang hinzufügen und sicherstellen, dass es sich um eine gültige Webadresse handelt.

Fehler 4: CORS-Test fehlgeschlagen

Ursache: Nachdem Ihre S3-Anmeldedaten erfolgreich validiert wurden, bedeutet eine Fehlermeldung "CORS-Test fehlgeschlagen. Bitte überprüfen Sie Ihre CORS-Konfiguration.", wenn Sie auf "CORS testen" klicken und diese Meldung erhalten, dass die Cross-Origin Resource Sharing (CORS)-Richtlinie Ihres S3-Buckets nicht korrekt eingerichtet ist. Diese Richtlinie ist entscheidend dafür, dass Ihr Webbrowser direkt Dateien in/aus Ihrem S3-Speicher hochladen und herunterladen kann. Ohne sie können Dateioperationen eingeschränkt sein (z. B. maximal 50 MB über den awaBerry Cloud-Proxy).

Behebung:

  1. Gehen Sie erneut zum Abschnitt "Berechtigungseinstellungen (CORS)" auf der Seite.
  2. Kopieren Sie sorgfältig das bereitgestellte JSON-CORS-Richtlinienbeispiel, das zu Ihrem S3-Anbieter (AWS S3, Cloudflare R2 usw.) passt.
  3. Navigieren Sie zu den Einstellungen Ihres S3-Buckets in der Verwaltungskonsole Ihres S3-Anbieters und fügen Sie diese CORS-Richtlinie präzise ein/konfigurieren Sie sie.
  4. Speichern Sie die Änderungen in der Konsole Ihres S3-Anbieters und kehren Sie dann zu dieser Seite zurück, um erneut auf "CORS testen" zu klicken.
Navigate ← User Settings Main Page ← awaBerry User Manual Main Page