...
Eroare AWS · Permisiuni IAM: AccessDenied și politici

An error occurred (MalformedPolicyDocument) when calling the CreateRole operation: Policy statement must contain principals.

Pe scurt

Politica de încredere (trust policy) a rolului nu spune cine are voie să preia rolul. La create-role, documentul --assume-role-policy-document trebuie să aibă Principal, de exemplu {"Service": "ec2.amazonaws.com"}, și acțiunea sts:AssumeRole.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un rol IAM are două feluri de politici:

  • politica de încredere (trust policy), dată la create-role cu --assume-role-policy-document: spune cine poate prelua rolul (un serviciu AWS, un utilizator, alt cont);
  • politicile de permisiuni, atașate după: spun ce poate face rolul.

Politica de încredere este o politică bazată pe resursă, deci fiecare declarație trebuie să aibă Principal. Dacă dai la create-role un document de permisiuni obișnuit (cu Action și Resource, fără Principal), IAM răspunde Policy statement must contain principals.

Greșeala apare când confunzi cele două documente sau când copiezi trust policy-ul fără blocul Principal. Pentru EC2, Lambda sau ECS, principalul este serviciul: ec2.amazonaws.com, lambda.amazonaws.com, ecs-tasks.amazonaws.com.

De ce apare: cauzele frecvente

1Ai dat politica de permisiuni în loc de cea de încredere

Greșit
BASH
{"Version": "2012-10-17", "Statement": [{"Effect": "Allow",
  "Action": "s3:GetObject", "Resource": "arn:aws:s3:::poze-ana-2026/*"}]}
Corect
BASH
{"Version": "2012-10-17", "Statement": [{"Effect": "Allow",
  "Principal": {"Service": "ec2.amazonaws.com"},
  "Action": "sts:AssumeRole"}]}

Trust policy-ul spune cine preia rolul (EC2) și permite doar sts:AssumeRole. Accesul la S3 se dă separat, cu attach-role-policy.

2Lipsește blocul Principal

Greșit
BASH
{"Version": "2012-10-17", "Statement": [{"Effect": "Allow",
  "Action": "sts:AssumeRole"}]}
Corect
BASH
{"Version": "2012-10-17", "Statement": [{"Effect": "Allow",
  "Principal": {"Service": "lambda.amazonaws.com"},
  "Action": "sts:AssumeRole"}]}

Fără Principal, declarația nu spune cui i se permite preluarea.

Repară tu

Repară eroarea, direct în pagină

Serverul web trebuie să primească rolul rol-web, pe care să-l poată prelua serviciul EC2. Scriptul ~/rol.sh dă Policy statement must contain principals, pentru că ~/trust-ec2.json nu spune cine preia rolul. Repară ~/trust-ec2.json ca serviciul ec2.amazonaws.com să poată prelua rolul (sts:AssumeRole) și rulează scriptul.

Indiciu

Adaugă în declarație "Principal": {"Service": "ec2.amazonaws.com"}.

Alte forme ale mesajului

  • An error occurred (MalformedPolicyDocument) when calling the UpdateAssumeRolePolicy operation: Policy statement must contain principals.
  • An error occurred (MalformedPolicyDocument) when calling the CreateRole operation: Invalid principal in policy: "SERVICE":"ec2.amazon.com"

Cum o eviți pe viitor

  • Ține trust policy-ul într-un fișier separat (trust-ec2.json) de politica de permisiuni (citire-s3.json).
  • Pornește de la șablonul standard: Effect: Allow, Principal: {"Service": "<serviciu>.amazonaws.com"}, Action: sts:AssumeRole.
  • Creează rolurile pentru servicii din consolă (IAM → Roles → Create role → AWS service): consola scrie singură trust policy-ul.

Întrebări frecvente

De ce politicile de permisiuni nu au Principal?

Pentru că principalul este entitatea la care le atașezi (utilizatorul, grupul sau rolul). Politicile bazate pe resursă (trust policy, politica de bucket) trebuie să spună explicit principalul.

Cum schimb trust policy-ul unui rol existent?

aws iam update-assume-role-policy --role-name rol-web --policy-document file://trust-ec2.json.

Erori înrudite

← Toate erorile AWS

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață AWS de la zero, cu exerciții la fiecare lecție

Curs Cloud: AWS fundamentals: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.