Zarządzanie użytkownikami i politykami IAM w S3 (dla endpoint: s3-2.atman.pl)
Wprowadzenie
Otrzymany od Atman klucz główny (root) konta pozwala samodzielnie tworzyć użytkowników IAM, generować im klucze dostępowe i nadawać uprawnienia przez polityki. Do zarządzania służy standardowe AWS CLI (lub dowolne SDK zgodne z AWS IAM) skierowane na nasz endpoint S3.
Klucz główny ma pełne uprawnienia do wszystkich bucketów i użytkowników konta. Należy traktować go jak hasło administratora: używać wyłącznie do zarządzania użytkownikami, a aplikacjom wydawać osobne klucze użytkowników IAM z minimalnymi uprawnieniami. W przykładach użyto zanonimizowanych nazw — należy podmeinić je na własne:
Symbol w instrukcji |
Znaczenie |
|---|---|
|
Adres endpointu S3 otrzymany od nas |
|
Profil AWS CLI z kluczem głównym konta |
|
Nazwa tworzonego użytkownika IAM |
|
Nazwa bucketa |
Konfiguracja AWS CLI
Wystarczy AWS CLI w wersji 2 i jeden profil z kluczem głównym. Instrukcję instalacji można zlaneźć w (dokumentacji AWS CLI).
1. Utwórzenie profil z kluczem głównym:
aws configure --profile konto-root
# AWS Access Key ID: <ACCESS_KEY_ROOT>
# AWS Secret Access Key: <SECRET_KEY_ROOT>
# Default region name: default
# Default output format: js# Default output format: json
2. Sprawdzenie połączenia
Powinna pojawić się lista bucketów konta, (może być pusta):
aws --profile konto-root --endpoint-url https://s3.example.com s3 ls
IAM działa pod tym samym adresem co S3, więc każde polecenie aws iam … również wymaga --endpoint-url https://s3.example.com. Region jest wymagany przez CLI, ale nie ma znaczenia dla działania — należy pozostawić default.
Aby nie powtarzać parametrów, w kolejnych krokach można ustawić zmienne:
export AWS_PROFILE=konto-root
export EP=https://s3.example.com
Jest też możliwość dodania endpointa w pliku ~/.aws/config umożliwia to pomijanie w poleceniach --endpoint-url https://s3.example.com
[profile konto-root]
endpoint_url = https://s3.example.com
Tworzenie użytkownika i kluczy
Nowy użytkownik nie ma żadnych uprawnień, dopóki nie zostaną mu przydzielone polityki (kolejna sekcja).
1. Utwórzenie użytkownika:
aws --endpoint-url https://s3.example.com iam create-user --user-name app-user-01
2. Wygenerowanie dla użytkownika klucze dostępowego:
aws --endpoint-url https://s3.example.com iam create-access-key --user-name app-user-01
Przykładowa odpowiedź:
{
"AccessKey": {
"UserName": "app-user-01",
"AccessKeyId": "<ACCESS_KEY_ID>",
"Status": "Active",
"SecretAccessKey": "<SECRET_ACCESS_KEY>"
}
}
SecretAccessKey jest wyświetlany tylko raz — należy zapisać go od razu w bezpiecznym miejscu (np. w menedżerze haseł lub sejfie sekretów). Jeśli zostanie zgubiony , trzeba wygenerować nowy klucz i usunąć stary (sekcja o rotacji).
Użytkownik może mieć jednocześnie wiele kluczy, co umożliwia rotację bez przerwy w działaniu aplikacji.
Nadawanie uprawnień
Uprawnienia nadawane są polityką w formacie JSON, zapisaną w pliku i dołączoną do użytkownika poleceniem put-user-policy. Jeden użytkownik może mieć kilka polityk o różnych nazwach; uprawnienia się sumują, a jawne Deny zawsze wygrywa.
aws --endpoint-url https://s3.example.com iam put-user-policy \
--user-name app-user-01 \
--policy-name FullAccess \
--policy-document file://policy.json
Ponowne wywołanie z tą samą nazwą polityki nadpisuje ją nową treścią.
Przykład 1: pełny dostęp do S3
Użytkownik może tworzyć buckety i wykonywać dowolne operacje na wszystkich bucketach konta.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "s3:*",
"Resource": "*"
}
]
}
Przykład 2: tylko odczyt jednego bucketa
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:ListBucket", "s3:GetBucketLocation"],
"Resource": "arn:aws:s3:::example-bucket"
},
{
"Effect": "Allow",
"Action": "s3:GetObject",
"Resource": "arn:aws:s3:::example-bucket/*"
}
]
}
Uprawnienia do samego bucketa (np. listowanie) dotyczą ARN-u bez /*, a do obiektów — ARN-u z /*. Pominięcie jednego z nich to najczęstsza przyczyna błędu AccessDenied.
Polityki zarządzane (opcjonalnie)
Zamiast własnego JSON-a można podłączyć gotową politykę zarządzaną:
aws --endpoint-url https://s3.example.com iam attach-user-policy \
--user-name app-user-01 \
--policy-arn arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccessaws:policy/AmazonS3ReadOnlyAccess
Dostępne są AmazonS3FullAccess i AmazonS3ReadOnlyAccess. Polityki zarządzane obejmują wszystkie buckety konta, więc do ograniczeń na konkretny bucket można wykorzystać własne polityki.
Weryfikacja i zarządzanie
Najczęściej używane polecenia (wszystkie z kluczem głównym i --endpoint-url https://s3.example.com):
Cel |
Polecenie |
|---|---|
Lista użytkowników |
|
Klucze użytkownika |
|
Polityki inline użytkownika |
|
Treść polityki |
|
Podłączone polityki zarządzane |
|
Przykład:
Sprawdzenie polityk użytkownika.
aws --endpoint-url https://s3.example.com iam list-user-policies --user-name app-user-01
{
"PolicyNames": [
"FullAccess"
]
}
Usuwanie polityk
Polityka inline (dodana przez put-user-policy):
aws --endpoint-url https://s3.example.com iam delete-user-policy \
--user-name app-user-01 \
--policy-name FullAccess
Nazwy polityk inline można sprawdzić przez:
aws --endpoint-url https://s3.example.com iam list-user-policies --user-name app-user-01
Polityka zarządzana (dodana przez attach-user-policy):
aws --endpoint-url https://s3.example.com iam detach-user-policy \
--user-name app-user-01 \
--policy-arn arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccess
Podłączone polityki zarządzane można sprawdzić przez:
aws --endpoint-url https://s3.example.com iam list-attached-user-policies --user-name app
Rotacja kluczy i usuwanie użytkownika
Rotacja klucza bez przerwy w działaniu
Należy wygenerować drugi klucz:
aws iam create-access-key --user-name app-user-01.Podmienić klucz w aplikacji i sprawdzić, czy działa.
Dezaktywować stary klucz (można go jeszcze przywrócić):
aws --endpoint-url https://s3.example.com iam update-access-key \
--user-name app-user-01 --access-key-id <STARY_ACCESS_KEY_ID> --status Inactive
Po kilku dniach bez problemów można usunąć stary klucz:
aws --endpoint-url https://s3.example.com iam delete-access-key \
--user-name app-user-01 --access-key-id <STARY_ACCESS_KEY_ID>
Rotacja klucza głównego (root)
Możliwa jest rotacja klucza głównego przez klienta w następujący sposób:
aws --endpoint-url https://s3.example.com iam create-access-keyOtrzymanie nowego klucza — stary nadal działa.
Zaktualizowanie profilu
konto-root(aws configure --profile konto-root) i we wszystkich miejscach, gdzie klucz główny jest zapisany.Sprawdzenie działania, np.
aws --profile konto-root --endpoint-url https://s3.example.com iam list-users.Dezaktywowaniestarego klucza
aws --profile konto-root --endpoint-url https://s3.example.com iam update-access-key --access-key-id <STARY_KEY_ID> --status InactiveUsunięcie starego klucza
aws --profile konto-root --endpoint-url https://s3.example.com iam delete-access-key --access-key-id <STARY_KEY_ID>
Rotacja klucza głównego nie wpływa na klucze użytkowników IAM ani na działanie aplikacji, które z nich korzystają.
Usunięcie użytkownika
Użytkownika można usunąć dopiero po usunięciu jego kluczy i polityk:
aws --endpoint-url https://s3.example.com iam delete-access-key --user-name app-user-01 --access-key-id <ACCESS_KEY_ID>
aws --endpoint-url https://s3.example.com iam delete-user-policy --user-name app-user-01 --policy-name FullAccess
aws --endpoint-url https://s3.example.com iam detach-user-policy --user-name app-user-01 --policy-arn arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccess
aws --endpoint-url https://s3.example.com iam delete-user --user-name app-user-01
Usunięcie użytkownika nie usuwa bucketów ani danych — należą one do konta, nie do użytkownika.
Dobre praktyki i najczęstsze błędy
Bezpieczeństwo
Nie należy używać klucza głównego w aplikacjach ani skryptach produkcyjnych — tylko do zarządzania IAM.
Każda aplikacja lub system dostaje osobnego użytkownika z minimalnymi uprawnieniami (np. tylko jeden bucket lub prefiks).
Należy rotować klucze regularnie, np. co 90 dni, i od razu po odejściu osoby, która je znała.
Nie należy zapisiwać kluczy w repozytoriach kodu; można je trzymać w menedżerze haseł lub sejfie sekretów.
W razie podejrzenia wycieku klucza głównego należy natychmiast wygenerować nowy.
Najczęstsze błędy
Objaw |
Przyczyna i rozwiązanie |
|---|---|
|
Brak |
|
Polityka nadaje uprawnienia tylko do |
|
Polecenie wykonano kluczem zwykłego użytkownika zamiast klucza głównego |
|
Błąd składni JSON — sprawdź plik np. przez |
|
Użytkownik ma jeszcze klucze lub polityki — usuń je najpierw |
|
Użytkownik ma już dwa klucze — usuń nieużywany |
W razie pytań lub problemów prosimy o kontakt z naszym działem wsparcia, podając nazwę użytkownika, wykonane polecenie i pełny komunikat błędu (bez kluczy sekretnych).