All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.apache.hadoop.fs.s3a.auth.RolePolicies Maven / Gradle / Ivy

Go to download

This module contains code to support integration with Amazon Web Services. It also declares the dependencies needed to work with AWS services.

There is a newer version: 3.4.1
Show newest version
/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.apache.hadoop.fs.s3a.auth;

import static org.apache.hadoop.fs.s3a.auth.RoleModel.*;

/**
 * Operations, statements and policies covering the operations
 * needed to work with S3 and S3Guard.
 */
public final class RolePolicies {

  private RolePolicies() {
  }

  /**
   * All S3 operations: {@value}.
   */
  public static final String S3_ALL_OPERATIONS = "s3:*";

  /**
   * All S3 buckets: {@value}.
   */
  public static final String S3_ALL_BUCKETS = "arn:aws:s3:::*";


  public static final String S3_ALL_LIST_OPERATIONS = "s3:List*";

  public static final String S3_ALL_LIST_BUCKET = "s3:ListBucket*";

  public static final String S3_LIST_BUCKET = "s3:ListBucket";

  /**
   * This is used by the abort operation in S3A commit work.
   */
  public static final String S3_LIST_BUCKET_MULTPART_UPLOADS =
      "s3:ListBucketMultipartUploads";


  /**
   * List multipart upload is needed for the S3A Commit protocols.
   */
  public static final String S3_LIST_MULTIPART_UPLOAD_PARTS
      = "s3:ListMultipartUploadParts";

  /**
   * abort multipart upload is needed for the S3A Commit protocols.
   */
  public static final String S3_ABORT_MULTIPART_UPLOAD
      = "s3:AbortMultipartUpload";

  /**
   * All s3:Delete* operations.
   */
  public static final String S3_ALL_DELETE = "s3:Delete*";


  public static final String S3_DELETE_OBJECT = "s3:DeleteObject";

  public static final String S3_DELETE_OBJECT_TAGGING
      = "s3:DeleteObjectTagging";

  public static final String S3_DELETE_OBJECT_VERSION
      = "s3:DeleteObjectVersion";

  public static final String S3_DELETE_OBJECT_VERSION_TAGGING
      = "s3:DeleteObjectVersionTagging";

  /**
   * All s3:Get* operations.
   */
  public static final String S3_ALL_GET = "s3:Get*";

  public static final String S3_GET_OBJECT = "s3:GetObject";

  public static final String S3_GET_OBJECT_ACL = "s3:GetObjectAcl";

  public static final String S3_GET_OBJECT_TAGGING = "s3:GetObjectTagging";

  public static final String S3_GET_OBJECT_TORRENT = "s3:GetObjectTorrent";

  public static final String S3_GET_OBJECT_VERSION = "s3:GetObjectVersion";

  public static final String S3_GET_OBJECT_VERSION_ACL
      = "s3:GetObjectVersionAcl";

  public static final String S3_GET_OBJECT_VERSION_TAGGING
      = "s3:GetObjectVersionTagging";

  public static final String S3_GET_OBJECT_VERSION_TORRENT
      = "s3:GetObjectVersionTorrent";


  /**
   * S3 Put*.
   * This covers single an multipart uploads, but not list/abort of the latter.
   */
  public static final String S3_ALL_PUT = "s3:Put*";

  public static final String S3_PUT_OBJECT = "s3:PutObject";

  public static final String S3_PUT_OBJECT_ACL = "s3:PutObjectAcl";

  public static final String S3_PUT_OBJECT_TAGGING = "s3:PutObjectTagging";

  public static final String S3_PUT_OBJECT_VERSION_ACL
      = "s3:PutObjectVersionAcl";

  public static final String S3_PUT_OBJECT_VERSION_TAGGING
      = "s3:PutObjectVersionTagging";

  public static final String S3_RESTORE_OBJECT = "s3:RestoreObject";

  /**
   * Actions needed to read data from S3 through S3A.
   */
  public static final String[] S3_PATH_READ_OPERATIONS =
      new String[]{
          S3_GET_OBJECT,
      };

  /**
   * Actions needed to read data from S3 through S3A.
   */
  public static final String[] S3_ROOT_READ_OPERATIONS =
      new String[]{
          S3_LIST_BUCKET,
          S3_LIST_BUCKET_MULTPART_UPLOADS,
          S3_GET_OBJECT,
      };

  /**
   * Actions needed to write data to an S3A Path.
   * This includes the appropriate read operations.
   */
  public static final String[] S3_PATH_RW_OPERATIONS =
      new String[]{
          S3_ALL_GET,
          S3_PUT_OBJECT,
          S3_DELETE_OBJECT,
          S3_ABORT_MULTIPART_UPLOAD,
          S3_LIST_MULTIPART_UPLOAD_PARTS,
      };

  /**
   * Actions needed to write data to an S3A Path.
   * This is purely the extra operations needed for writing atop
   * of the read operation set.
   * Deny these and a path is still readable, but not writeable.
   */
  public static final String[] S3_PATH_WRITE_OPERATIONS =
      new String[]{
          S3_PUT_OBJECT,
          S3_DELETE_OBJECT,
          S3_ABORT_MULTIPART_UPLOAD
      };

  /**
   * Actions needed for R/W IO from the root of a bucket.
   */
  public static final String[] S3_ROOT_RW_OPERATIONS =
      new String[]{
          S3_LIST_BUCKET,
          S3_ALL_GET,
          S3_PUT_OBJECT,
          S3_DELETE_OBJECT,
          S3_ABORT_MULTIPART_UPLOAD,
          S3_LIST_MULTIPART_UPLOAD_PARTS,
          S3_ALL_LIST_BUCKET,
      };

  /**
   * All DynamoDB operations: {@value}.
   */
  public static final String DDB_ALL_OPERATIONS = "dynamodb:*";

  public static final String DDB_ADMIN = "dynamodb:*";


  public static final String DDB_BATCH_WRITE = "dynamodb:BatchWriteItem";

  /**
   * All DynamoDB tables: {@value}.
   */
  public static final String ALL_DDB_TABLES = "arn:aws:dynamodb:::*";



  public static final String WILDCARD = "*";

  /**
   * Allow all S3 Operations.
   */
  public static final Statement STATEMENT_ALL_S3 = statement(true,
      S3_ALL_BUCKETS,
      S3_ALL_OPERATIONS);

  /**
   * Statement to allow all DDB access.
   */
  public static final Statement STATEMENT_ALL_DDB = statement(true,
      ALL_DDB_TABLES, DDB_ALL_OPERATIONS);

  /**
   * Allow all S3 and S3Guard operations.
   */
  public static final Policy ALLOW_S3_AND_SGUARD = policy(
      STATEMENT_ALL_S3,
      STATEMENT_ALL_DDB
  );

}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy