Modifiche nell'API IAM Policy Builder dalla versione 1 alla versione 2

Questo argomento descrive in dettaglio le modifiche all'API IAM Policy Builder dalla versione 1 (v1) alla versione 2 (v2).

Modifiche di alto livello

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.amazonaws</groupId>
            <artifactId>aws-java-sdk-bom</artifactId>
            <version>1.12.5871</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>
        <groupId>com.amazonaws</groupId>
        <artifactId>aws-java-sdk-core</artifactId>
    </dependency>
</dependencies>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>bom</artifactId>
            <version>2.27.212</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>iam-policy-builder</artifactId>
    </dependency>
</dependencies>

^{1 Ultima versione}. ² Ultima versione.

Modifiche alle API

Policy policy = new Policy();

IamPolicy.Builder policyBuilder = IamPolicy.builder();
...
IamPolicy policy = policyBuilder.build();

policy.withtId(...);
policy.setId(...);

policyBuilder.id(...);

policyBuilder.version(...);

Statement statement = 
    new Statement(Effect.Allow)
            .withActions(...)
            .withConditions(...)
            .withId(...)
            .withPrincipals(...)
            .withResources(...);

IamStatement statement = 
    IamStatement.builder()
            .effect(IamEffect.ALLOW)
            .actions(...)
            .notActions(...)
            .conditions(...)
            .sid(...)
            .principals(...)
            .notPrincipals(...)
            .resources(...)
            .notResources(...)
            .build()

policy.withStatements(statement);
policy.setStatements(statement);

policyBuilder.addStatement(statement);

Differenze nella creazione di una dichiarazione

Operazioni

v1

L'SDK v1 dispone enumdi tipi di azioni di servizio che rappresentano Action elementi di una dichiarazione politica. I seguenti enum tipi sono alcuni esempi.

L'esempio seguente mostra la SendMessage costante forSQSActions.

Action action = SQSActions.SendMessage;

Non è possibile specificare un NotAction elemento in un'istruzione in v1.

v2

Nella v2, l'IamActioninterfaccia rappresenta tutte le azioni. Per specificare un elemento di azione specifico del servizio, passate una stringa al create metodo come illustrato nel codice seguente.

IamAction action = IamAction.create("sqs:SendMessage");

È possibile specificare un'istruzione NotAction for a con v2, come illustrato nel codice seguente.

IamAction action = IamAction.create("sqs:SendMessage");
IamStatement.builder().addNotAction(action);

Condizioni

v1

Per rappresentare le condizioni delle dichiarazioni, l'SDK v1 utilizza sottoclassi di. Condition

Ogni Condition sottoclasse definisce un enum tipo di confronto per aiutare a definire la condizione. Ad esempio, quanto segue mostra un confronto di stringhe non simile per una condizione.

Condition condition = new StringCondition(StringComparisonType.StringNotLike, "key", "value");

v2

Nella v2, si crea una condizione per una dichiarazione politica utilizzando IamCondition e fornendo unIamConditionOperator, che contiene enums per tutti i tipi.

IamCondition condition = IamCondition.create(IamConditionOperator.STRING_NOT_LIKE, "key", "value");

Risorse

v1

L'Resourceelemento di una dichiarazione politica è rappresentato dalla classe dell'SDK. Resource L'ARN viene fornito come stringa nel costruttore. Le seguenti sottoclassi forniscono costruttori di convenienza.

Nella v1, è possibile specificare un NotResource elemento per a Resource chiamando il withIsNotType metodo come illustrato nella seguente istruzione.

Resource resource = new Resource("arn:aws:s3:::mybucket").withIsNotType(true);

v2

Nella v2, si crea un Resource elemento passando un ARN al IamResource.create metodo.

IamResource resource = IamResource.create("arn:aws:s3:::mybucket");

An IamResource può essere impostato come NotResourceelemento come mostrato nel frammento seguente.

IamResource resource = IamResource.create("arn:aws:s3:::mybucket");
IamStatement.builder().addNotResource(resource);

IamResource.ALLrappresenta tutte le risorse.

Principali

v1

L'SDK v1 offre le seguenti Principal classi per rappresentare i tipi di principali che includono tutti i membri:

Non è possibile aggiungere un NotPrincipal elemento a un'istruzione.

v2

Nella v2, IamPrincipal.ALL rappresenta tutti i principali:

Per rappresentare tutti i membri in altri tipi di principali, usa IamPrincipalType le classi quando crei un. IamPrincipal

È possibile utilizzare il addNotPrincipal metodo per rappresentare un NotPrincipal elemento quando si crea una dichiarazione politica, come illustrato nella seguente dichiarazione.

IamPrincipal principal = IamPrincipal.create(IamPrincipalType.AWS, "arn:aws:iam::444455556666:root");
IamStatement.builder().addNotPrincipal(principal);