Modifications apportées à l'API IAM Policy Builder de la version 1 à la version 2

Cette rubrique décrit les modifications apportées à l'API IAM Policy Builder de la version 1 (v1) à la version 2 (v2).

Changements de haut niveau

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

¹ Dernière version. ² Dernière version.

Modifications de l'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);

Différences dans l'élaboration d'une déclaration

Actions

v1

Le SDK v1 comporte des enumtypes d'actions de service qui représentent des Action éléments d'une déclaration de politique. Les enum types suivants en sont des exemples.

L'exemple suivant montre la SendMessage constante pourSQSActions.

Action action = SQSActions.SendMessage;

Vous ne pouvez pas spécifier d'NotActionélément dans une instruction dans la version 1.

v2

Dans la version 2, l'IamActioninterface représente toutes les actions. Pour spécifier un élément d'action spécifique au service, transmettez une chaîne à la create méthode comme indiqué dans le code suivant.

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

Vous pouvez spécifier a NotAction pour une instruction avec v2 comme indiqué dans le code suivant.

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

Conditions

v1

Pour représenter les conditions des instructions, le SDK v1 utilise des sous-classes de. Condition

Chaque Condition sous-classe définit un enum type de comparaison pour aider à définir la condition. Par exemple, ce qui suit montre une comparaison de chaînes différentes pour une condition.

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

v2

Dans la version 2, vous créez une condition pour une déclaration de politique en utilisant IamCondition et en fournissant unIamConditionOperator, qui contient enums pour tous les types.

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

Ressources

v1

L'Resourceélément d'une déclaration de politique est représenté par la Resource classe du SDK. Vous fournissez l'ARN sous forme de chaîne dans le constructeur. Les sous-classes suivantes fournissent des constructeurs pratiques.

Dans la version 1, vous pouvez spécifier un NotResource élément pour a Resource en appelant la withIsNotType méthode comme indiqué dans l'instruction suivante.

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

v2

Dans la version 2, vous créez un Resource élément en transmettant un ARN à la IamResource.create méthode.

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

Un IamResource peut être défini comme NotResourceélément comme indiqué dans l'extrait suivant.

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

IamResource.ALLreprésente toutes les ressources.

Principaux

v1

Le SDK v1 propose les Principal classes suivantes pour représenter les types de principes qui incluent tous les membres :

Vous ne pouvez pas ajouter d'NotPrincipalélément à une déclaration.

v2

Dans la version 2, IamPrincipal.ALL représente tous les principes :

Pour représenter tous les membres dans d'autres types de directeurs, utilisez les IamPrincipalType classes lorsque vous créez unIamPrincipal.

Vous pouvez utiliser addNotPrincipal cette méthode pour représenter un NotPrincipal élément lorsque vous créez une déclaration de politique, comme indiqué dans l'instruction suivante.

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