Przejdź do treści

Endpointy i region

Do połączenia z Cloud4You Object Storage S3 potrzebujesz poprawnego endpointu oraz regionu.

Region

Cloud4You Object Storage S3 używa regionu:

eu-pl-1

Jeżeli aplikacja wymaga podania regionu, wpisz dokładnie:

eu-pl-1

Główny endpoint

Dla większości zastosowań zalecamy używanie głównego endpointu:

https://s3.cloud4you.pl

To jest domyślny adres, który należy podawać w:

  • AWS CLI,
  • rclone,
  • aplikacjach backupowych,
  • klientach graficznych,
  • bibliotekach i SDK zgodnych z Amazon S3 API,
  • własnych aplikacjach.

Dostępne endpointy

Cloud4You Object Storage S3 udostępnia następujące endpointy:

Endpoint Zastosowanie
https://s3.cloud4you.pl główny endpoint
https://s3-waw.cloud4you.pl endpoint WAW
https://s3-jaw.cloud4you.pl endpoint JAW

Którego endpointu używać?

Jeżeli nie otrzymałeś innych zaleceń, używaj:

https://s3.cloud4you.pl

Konfiguracja aplikacji

Typowa konfiguracja klienta S3 wygląda tak:

Endpoint:
https://s3.cloud4you.pl

Region:
eu-pl-1

Access Key:
<otrzymany Access Key>

Secret Key:
<otrzymany Secret Key>

Niektóre aplikacje używają innych nazw pól.

Możesz spotkać między innymi:

S3 Endpoint
Service URL
Endpoint URL
Server
S3 URL
Region
AWS Region

Nie dodawaj nazwy bucketa do endpointu

Jeżeli aplikacja posiada osobne pole na nazwę bucketa, endpoint powinien pozostać:

https://s3.cloud4you.pl

a nazwa bucketa powinna znaleźć się w osobnym polu.

Przykład:

Endpoint:
https://s3.cloud4you.pl

Bucket:
firma-backup

Nie konfiguruj endpointu w taki sposób:

https://s3.cloud4you.pl/firma-backup

chyba że dokumentacja konkretnej aplikacji wymaga podania pełnej ścieżki.

HTTPS

Publiczne endpointy Cloud4You Object Storage S3 wykorzystują HTTPS.

Przykład:

https://s3.cloud4you.pl

Nie używaj:

http://s3.cloud4you.pl

Nie wyłączaj weryfikacji certyfikatu

Jeżeli aplikacja zgłasza błąd certyfikatu TLS, nie zalecamy wyłączania jego weryfikacji.

Najpierw sprawdź:

  • poprawność endpointu,
  • datę i czas systemowy,
  • aktualność systemowego magazynu certyfikatów,
  • czy połączenie nie jest przechwytywane przez lokalny proxy lub firewall.

Virtual-hosted style

W trybie virtual-hosted style nazwa bucketa znajduje się w nazwie hosta.

Dla bucketa:

firma-backup

adres może wyglądać następująco:

https://firma-backup.s3.cloud4you.pl

Podobnie dla endpointów lokalizacyjnych:

https://firma-backup.s3-waw.cloud4you.pl
https://firma-backup.s3-jaw.cloud4you.pl

Wiele klientów S3 korzysta z tego sposobu adresowania automatycznie.

Nie musisz ręcznie tworzyć takiego adresu, jeżeli aplikacja posiada osobne pola:

Endpoint
Bucket

Path-style

Niektóre aplikacje używają adresowania typu path-style.

Przykład:

https://s3.cloud4you.pl/firma-backup

Jeżeli aplikacja posiada opcję podobną do:

Force Path Style
Path Style Access
Use Path Style

może być konieczne jej włączenie w przypadku problemów kompatybilności.

Najpierw użyj ustawień domyślnych

Jeżeli aplikacja poprawnie łączy się z usługą, nie zmieniaj sposobu adresowania bucketów.

Opcji Force Path Style używaj przede wszystkim wtedy, gdy wymaga tego konkretna aplikacja lub pojawia się problem z połączeniem.

Endpoint a dane dostępowe

Access Key i Secret Key identyfikują użytkownika usługi.

Nie wpisuj w polach Access Key lub Secret Key:

  • adresu endpointu,
  • nazwy bucketa,
  • regionu,
  • Tenant ID.

Typowa konfiguracja składa się z czterech osobnych wartości:

Endpoint   = https://s3.cloud4you.pl
Region     = eu-pl-1
Access Key = <Access Key>
Secret Key = <Secret Key>

Przykład AWS CLI

Lista bucketów:

aws \
  --profile cloud4you \
  --endpoint-url https://s3.cloud4you.pl \
  --region eu-pl-1 \
  s3api list-buckets

Przykład rclone

W konfiguracji rclone:

Endpoint:
https://s3.cloud4you.pl

Region:
eu-pl-1

Problemy z połączeniem

Jeżeli aplikacja nie może połączyć się z usługą, sprawdź kolejno:

  1. czy endpoint zaczyna się od https://,
  2. czy wpisano poprawny region eu-pl-1,
  3. czy Access Key jest poprawny,
  4. czy Secret Key jest poprawny,
  5. czy czas systemowy urządzenia jest poprawny,
  6. czy firewall pozwala na połączenia HTTPS,
  7. czy aplikacja nie wymaga włączenia Path Style Access.

Zalecana konfiguracja

Jeżeli nie masz szczególnych wymagań, użyj:

Endpoint:
https://s3.cloud4you.pl

Region:
eu-pl-1

To jest zalecana konfiguracja dla standardowych połączeń z Cloud4You Object Storage S3.