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

https://s3.example.com

Adres endpointu S3 otrzymany od nas

konto-root

Profil AWS CLI z kluczem głównym konta

app-user-01

Nazwa tworzonego użytkownika IAM

example-bucket

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

aws iam list-users

Klucze użytkownika

aws iam list-access-keys --user-name app-user-01

Polityki inline użytkownika

aws iam list-user-policies --user-name app-user-01

Treść polityki

aws iam get-user-policy --user-name app-user-01 --policy-name FullAccess

Podłączone polityki zarządzane

aws iam list-attached-user-policies --user-name app-user-01

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

  1. Należy wygenerować drugi klucz: aws iam create-access-key --user-name app-user-01.

  2. Podmienić klucz w aplikacji i sprawdzić, czy działa.

  3. 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
  1. 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:

  1. aws --endpoint-url https://s3.example.com iam create-access-key

  2. Otrzymanie nowego klucza — stary nadal działa.

  3. Zaktualizowanie profilu konto-root (aws configure --profile konto-root) i we wszystkich miejscach, gdzie klucz główny jest zapisany.

  4. Sprawdzenie działania, np. aws --profile konto-root --endpoint-url https://s3.example.com iam list-users.

  5. Dezaktywowaniestarego klucza aws --profile konto-root --endpoint-url  https://s3.example.com  iam update-access-key --access-key-id <STARY_KEY_ID> --status Inactive

  6. Usunię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

Could not connect to the endpoint URL lub żądanie trafia do AWS

Brak --endpoint-url https://s3.example.com w poleceniu

AccessDenied przy listowaniu bucketa

Polityka nadaje uprawnienia tylko do arn:aws:s3:::example-bucket/*; dodaj s3:ListBucket na arn:aws:s3:::example-bucket

AccessDenied przy tworzeniu użytkownika

Polecenie wykonano kluczem zwykłego użytkownika zamiast klucza głównego

MalformedPolicyDocument

Błąd składni JSON — sprawdź plik np. przez jq . policy.json

DeleteConflict przy usuwaniu użytkownika

Użytkownik ma jeszcze klucze lub polityki — usuń je najpierw

LimitExceeded przy tworzeniu klucza

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).