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

Cette rubrique détaille les modifications apportées au IAM Policy Builder API 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.

APImodifications

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

La version 1 SDK comporte des enumtypes d'actions de service qui représentent Action des é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, la v1 SDK 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 SDK's. Vous le fournissez 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 passant 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

La v1 SDK propose les Principal classes suivantes pour représenter les types de directeurs 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);