An error occurred (MalformedPolicyDocument) when calling the CreateRole operation: Policy statement must contain principals.
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-rolecu--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
{"Version": "2012-10-17", "Statement": [{"Effect": "Allow",
"Action": "s3:GetObject", "Resource": "arn:aws:s3:::poze-ana-2026/*"}]}{"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
{"Version": "2012-10-17", "Statement": [{"Effect": "Allow",
"Action": "sts:AssumeRole"}]}{"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ă 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"}.
Reparația
Adaugă principalul (serviciul EC2) în politica de încredere:
cat > ~/trust-ec2.json <<'EOF'
{"Version": "2012-10-17", "Statement": [{"Effect": "Allow", "Principal": {"Service": "ec2.amazonaws.com"}, "Action": "sts:AssumeRole"}]}
EOF
bash ~/rol.shDe ce merge
Documentul dat la create-role este politica de încredere a rolului și, fiind o politică bazată pe resursă, fiecare declarație trebuie să spună principalul. Cu "Principal": {"Service": "ec2.amazonaws.com"} și sts:AssumeRole, IAM acceptă documentul și creează rol-web, pe care instanțele EC2 îl pot prelua printr-un instance profile.
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
An error occurred (MalformedPolicyDocument) when calling the CreatePolicy operation: Policy statement must contain resources. Documentul de politică IAM nu e valid: aici un Statement nu are câmpul Resource, obligatoriu în politicile de identitate. Adaugă "Resource" cu ARN-urile pe care se aplică acțiunile (de exemplu arn:aws:s3:::bucket și arn:aws:s3:::bucket/*) și creează din nou politica. An error occurred (InvalidParameterValueException) when calling the CreateFunction operation: The role defined for the function cannot be assumed by Lambda. Rolul dat în --role nu există sau politica lui de încredere nu permite serviciului lambda.amazonaws.com să-l preia. Pune în trust policy "Principal": {"Service": "lambda.amazonaws.com"} (aws iam update-assume-role-policy) și creează funcția din nou. An error occurred (AccessDenied) when calling the AssumeRole operation: User: arn:aws:iam::123456789012:user/ion is not authorized to perform: sts:AssumeRole on resource: arn:aws:iam::123456789012:role/rapoarte-rol Nu poți prelua rolul pentru că trust policy-ul lui nu te include (sau rolul nu există ori ți se cere MFA). Adaugă ARN-ul tău în Principal din politica de încredere a rolului (aws iam update-assume-role-policy) și, dacă e nevoie, dă-ți și sts:AssumeRole în politica ta. Î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.
