全部產品
Search
文件中心

Object Storage Service:RAM Policy

更新時間:Oct 13, 2026

RAM Policy是附加在RAM身份(使用者、使用者組、角色)上的授權策略。當需要管理RAM使用者或角色對OSS資源的存取權限時,可通過RAM Policy定義該身份可以執行的操作和可以訪問的資源範圍。

工作原理

RAM Policy採用基於身份的授權模式,策略附加在RAM使用者、使用者組或RAM角色上,定義該身份在滿足哪些條件(Condition)時,可對哪些資源(Resource)執行哪些操作(Action)。

RAM身份發起訪問請求時,OSS會綜合評估所有相關策略(包括RAM Policy和Bucket Policy),許可權判定遵循顯式拒絕優先原則:

  1. 顯式拒絕優先 :任何策略中存在匹配請求的Deny規則,請求立即被拒絕 。

  2. 尋找顯式允許 :不存在Deny規則時,若存在匹配的Allow規則,請求被允許 。

  3. 預設拒絕 :既無Deny也無Allow,請求預設被拒絕 。

OSS支援兩種RAM Policy類型:系統策略由阿里雲預置,使用者只能使用不能修改;自訂策略由使用者自行建立和維護,提供更靈活的許可權配置。

授權系統權限原則

系統權限原則由阿里雲建立,可在RAM控制台直接為使用者身份授權。以下以RAM使用者為例示範授權步驟。

  1. 前往RAM使用者列表,單擊目標使用者操作列的添加权限。

  2. 在新增授權面板中,資源範圍預設選中帳號層級。如需授權到指定資源群組,選擇資源群組層級。

  3. 在搜尋方塊中輸入系統策略名稱稱,勾選目標系統策略。OSS支援以下兩種系統策略:

  4. 單擊確認新增授權,完成使用權限設定。

授權自訂權限原則

自訂策略由使用者自主建立和維護,授權自訂權限原則時,需先建立自訂權限原則,再為對應的使用者身份進行授權。

步驟一:建立自訂權限原則

  1. 前往權限原則列表,單擊创建权限策略。

  2. 選擇指令碼編輯,在編輯框內輸入JSON格式的授權策略。可使用RAM Policy Editor快速產生授權策略。

    樣本授權策略:允許對example-bucket及該Bucket內所有資源的全部操作。

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": "oss:*",
          "Resource": [
            "acs:oss:*:*:example-bucket",
            "acs:oss:*:*:example-bucket/*"
          ]
        }
      ]
    }

    完整的授權策略包含Version(版本號碼)和Statement(授權語句)。

    • Version:權限原則版本,固定為1,不允許修改。

    • Statement:策略語句的主體,包含一條或多條具體的授權/拒絕規則。每條授權語句包含Effect(授權效力)、Action(授權操作)、Resource(授權資源)和Condition(授權條件)。

      策略元素

      說明

      Effect

      策略的效力,可選值為Allow(允許)或Deny(拒絕)。

      Action

      對資源執行的具體操作,支援使用萬用字元*。

      Resource

      策略作用的資源範圍。

      Condition

      策略生效的條件。

      當配置多個條件時,所有條件必須同時滿足(AND關係),策略才會生效。

      完整的授權元素列表請參見授權文法與元素。

  3. 單擊确定,輸入策略名称,然後單擊确定,完成自訂策略建立。

步驟二:為使用者身份進行授權

建立自訂權限原則後,需要將自訂策略授權給目標使用者身份。以下以RAM使用者為例示範授權步驟。

  1. 前往RAM使用者列表,單擊目標使用者操作列的添加权限。

  2. 在搜尋方塊中輸入自訂策略名稱稱,勾選目標策略。

  3. 單擊確認新增授權,完成使用權限設定。

常見授權情境

以下情境展示了RAM Policy在實際業務中的典型應用,涵蓋許可權授予、訪問限制和安全控制等多種需求。每個情境提供完整的策略配置樣本,可根據實際需求修改其中的Bucket名稱、目錄路徑等參數後直接使用。

情境1:授予RAM使用者對某個Bucket的完全控制許可權

以下樣本為授予RAM使用者對名為mybucket的Bucket擁有完全控制的許可權。

重要

對於行動裝置 App來說,授予使用者對Bucket的完全控制許可權存在極高風險,應盡量避免。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "oss:*",
      "Resource": [
        "acs:oss:*:*:mybucket",
        "acs:oss:*:*:mybucket/*"
      ]
    }
  ]
}

情境2:禁止RAM使用者刪除某個Bucket下匹配特定模式檔案的許可權

以下樣本為禁止RAM使用者刪除名為mybucket的Bucket下首碼為abc且格式為.txt的所有檔案。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Deny",
      "Action": [
        "oss:DeleteObject"
      ],
      "Resource": [
        "acs:oss:*:*:mybucket/abc*.txt"
      ]
    }
  ]
}

情境3:授予RAM使用者列舉並讀取某個Bucket下所有資源的許可權

  • 以下樣本為授予RAM使用者通過OSS SDK或OSS命令列工具列舉並讀取名為mybucket的Bucket下所有資源的許可權。

    說明

    ListObjects操作(Action)必須以整個Bucket作為Resource。

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": "oss:ListObjects",
          "Resource": "acs:oss:*:*:mybucket"
        },
        {
          "Effect": "Allow",
          "Action": "oss:GetObject",
          "Resource": "acs:oss:*:*:mybucket/*"
        }
      ]
    }
  • 以下樣本為授予RAM使用者通過OSS控制台列舉並讀取名為mybucket的Bucket下所有資源的許可權。

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "oss:ListBuckets",
            "oss:GetBucketStat",
            "oss:GetBucketInfo",
            "oss:GetBucketTagging",
            "oss:GetBucketLifecycle",
            "oss:GetBucketWorm",                      
            "oss:GetBucketVersioning", 
            "oss:GetBucketAcl" 
          ],    
          "Resource": "acs:oss:*:*:*"
        },
        {
          "Effect": "Allow",
          "Action": [
            "oss:ListObjects",
            "oss:GetBucketAcl"
          ],
          "Resource": "acs:oss:*:*:mybucket"
        },
        {
          "Effect": "Allow",
          "Action": [
            "oss:GetObject",
            "oss:GetObjectAcl"
          ],
          "Resource": "acs:oss:*:*:mybucket/*"
        }
      ]
    }

情境4:禁止RAM使用者刪除某個Bucket的許可權

以下樣本用于禁止RAM使用者刪除名為mybucket的Bucket的許可權。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "oss:*",
      "Resource": [
        "acs:oss:*:*:mybucket",
        "acs:oss:*:*:mybucket/*"
      ]
    },
    {
      "Effect": "Deny",
      "Action": [
        "oss:DeleteBucket"
      ],
      "Resource": [
        "acs:oss:*:*:mybucket"
      ]
    }
  ]
}

情境5:授予RAM使用者僅上傳和刪除檔案但不允許刪除Bucket的許可權

以下樣本用於授予RAM使用者對名為mybucket的Bucket僅擁有上傳和刪除檔案(包括刪除對象版本)的許可權,但禁止刪除該Bucket本身。與情境4使用oss:*寬泛授權不同,本情境精確指定允許的操作,符合最小許可權原則。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "oss:PutObject",
        "oss:DeleteObject",
        "oss:DeleteObjectVersion"
      ],
      "Resource": [
        "acs:oss:*:*:mybucket/*"
      ]
    },
    {
      "Effect": "Deny",
      "Action": [
        "oss:DeleteBucket"
      ],
      "Resource": [
        "acs:oss:*:*:mybucket"
      ]
    }
  ]
}
說明

同一策略中Deny語句優先於Allow生效,因此RAM使用者在擁有oss:PutObject、oss:DeleteObject、oss:DeleteObjectVersion許可權的同時,oss:DeleteBucket操作會被明確拒絕。

情境6:授予RAM使用者訪問某個Bucket下多個目錄的許可權

假設用於存放照片的Bucket為mybucket,該Bucket下有一些目錄,代表照片的拍攝地,每個拍攝地目錄下還包含年份子目錄。

mybucket[Bucket]
  ├── beijing
  │   ├── 2014
  │   └── 2015
  └── hangzhou
      ├── 2014
      └── 2015 

需要授予RAM使用者訪問mybucket/hangzhou/2014/和mybucket/hangzhou/2015/目錄的唯讀許可權。目錄層級的授權屬於授權的進階功能,根據使用情境不同,授權策略的複雜程度也不同,以下幾種情境可供參考。

  • 授予RAM使用者僅擁有讀取目錄mybucket/hangzhou/2014/和mybucket/hangzhou/2015/中檔案內容的許可權。

    由於RAM使用者知道檔案的完整路徑,建議直接使用完整的檔案路徑來讀取目錄下的檔案內容。

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "oss:GetObject"
          ],
          "Resource": [
            "acs:oss:*:*:mybucket/hangzhou/2014/*",
            "acs:oss:*:*:mybucket/hangzhou/2015/*"
          ]
        }
      ]
    }
  • 授予RAM使用者使用OSS命令列工具訪問目錄mybucket/hangzhou/2014/和mybucket/hangzhou/2015/並列舉目錄中檔案的許可權。

    RAM使用者不清楚目錄中有哪些檔案,可使用OSS命令列工具或API直接擷取目錄資訊,此情境下需要添加ListObjects許可權。

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "oss:GetObject"
          ],
          "Resource": [
            "acs:oss:*:*:mybucket/hangzhou/2014/*",
            "acs:oss:*:*:mybucket/hangzhou/2015/*"
          ]
        },
        {
          "Effect": "Allow",
          "Action": [
            "oss:ListObjects"
          ],
          "Resource": [
            "acs:oss:*:*:mybucket"
          ],
          "Condition":{
            "StringLike":{
              "oss:Prefix": [
                "hangzhou/2014/*",
                "hangzhou/2015/*"
              ]
            }
          }
        }
      ]
    }
  • 授予RAM使用者使用OSS控制台訪問目錄的許可權。

    使用OSS控制台訪問目錄mybucket/hangzhou/2014/和mybucket/hangzhou/2015/時,RAM使用者可從根目錄開始,逐層進入要訪問的目錄。

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "oss:ListBuckets",
            "oss:GetBucketStat",
            "oss:GetBucketInfo",
            "oss:GetBucketTagging",
            "oss:GetBucketLifecycle",
            "oss:GetBucketWorm",                      
            "oss:GetBucketVersioning", 
            "oss:GetBucketAcl" 
          ], 
          "Resource": [
            "acs:oss:*:*:*"
          ]
        },
        {
          "Effect": "Allow",
          "Action": [
            "oss:GetObject",
            "oss:GetObjectAcl"
          ],
          "Resource": [
            "acs:oss:*:*:mybucket/hangzhou/2014/*",
            "acs:oss:*:*:mybucket/hangzhou/2015/*"
          ]
        },
        {
          "Effect": "Allow",
          "Action": [
            "oss:ListObjects"
          ],
          "Resource": [
            "acs:oss:*:*:mybucket"
          ],
          "Condition": {
            "StringLike": {
              "oss:Delimiter": "/",
              "oss:Prefix": [
                "",
                "hangzhou/",
                "hangzhou/2014/*",
                "hangzhou/2015/*"
              ]
            }
          }
        }
      ]
    }

情境7:禁止RAM使用者刪除某個Bucket下任意檔案的許可權

以下樣本用于禁止RAM使用者刪除名為mybucket的儲存空間下任意檔案的許可權。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Deny",
      "Action": [
        "oss:DeleteObject"
      ],
      "Resource": [
        "acs:oss:*:*:mybucket/*"
      ]
    }
  ]
}

情境8:禁止RAM使用者訪問指定標籤Object的許可權

以下為添加Deny策略,用于禁止RAM使用者訪問儲存空間examplebucket下對象標籤為status:ok以及key1:value1的Object的許可權。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Deny",
      "Action": [
        "oss:GetObject"
      ],
      "Resource": [
        "acs:oss:*:174649585760xxxx:examplebucket/*"
      ],
      "Condition": {
        "StringEquals": {
          "oss:ExistingObjectTag/status":"ok",
          "oss:ExistingObjectTag/key1":"value1"
        }
      }
    }
  ]
}

情境9:授予RAM使用者通過特定的IP地址訪問OSS的許可權

  • 在Allow授權中增加IP地址限制。

    以下樣本為在Allow授權中增加IP地址限制,授予RAM使用者僅允許通過192.168.0.0/16和198.51.100.0/24兩個IP位址區段讀取名為mybucket的Bucket下所有資源的許可權。

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "oss:ListBuckets",
            "oss:GetBucketStat",
            "oss:GetBucketInfo",
            "oss:GetBucketTagging",
            "oss:GetBucketAcl" 
          ], 
          "Resource": [
            "acs:oss:*:*:*"
          ]
        },
        {
          "Effect": "Allow",
          "Action": [
            "oss:ListObjects",
            "oss:GetObject"
          ],
          "Resource": [
            "acs:oss:*:*:mybucket",
            "acs:oss:*:*:mybucket/*"
          ],
          "Condition":{
            "IpAddress": {
              "acs:SourceIp": ["192.168.0.0/16", "198.51.100.0/24"]
            },
            "StringNotLike": {
              "acs:SourceVpc": [
                "vpc-*"
              ]
            }
          }
        }
      ]
    }
  • 在Deny授權中增加IP地址限制。

    以下樣本為在Deny授權中增加IP地址限制,禁止源IP地址不在192.168.0.0/16範圍內的RAM使用者對OSS執行任何操作。

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "oss:ListBuckets",
            "oss:GetBucketStat",
            "oss:GetBucketInfo",
            "oss:GetBucketTagging",
            "oss:GetBucketAcl" 
          ], 
          "Resource": [
            "acs:oss:*:*:*"
          ]
        },
        {
          "Effect": "Allow",
          "Action": [
            "oss:ListObjects",
            "oss:GetObject"
          ],
          "Resource": [
            "acs:oss:*:*:mybucket",
            "acs:oss:*:*:mybucket/*"
          ]
        },
        {
          "Effect": "Deny",
          "Action": "oss:*",
          "Resource": [
            "acs:oss:*:*:*"
          ],
          "Condition":{
            "NotIpAddress": {
              "acs:SourceIp": ["192.168.0.0/16"]
            },
            "StringLike": {
              "acs:SourceVpc": [
                "*"
              ]
            }
          }
        }
      ]
    }
    說明

    由於權限原則的鑒權規則是Deny優先,所以訪問者從192.168.0.0/16以外的IP地址訪問mybucket中的內容時,OSS會提示沒有許可權。

情境10:通過RAM或STS服務向其他使用者授權

通過RAM或STS服務授予IP地址為192.168.0.1的使用者使用Java SDK用戶端執行以下操作。

  • 列舉mybucket中以foo為首碼的對象。

  • 允許向mybucket中上傳、下載和刪除以file開頭的對象。

{
  "Version": "1",
  "Statement": [{
    "Action": [
      "oss:GetBucketAcl",
      "oss:ListObjects"
    ],
    "Resource": [
      "acs:oss:*:177530505652xxxx:mybucket"
    ],
    "Effect": "Allow",
    "Condition": {
      "StringLike": {
        "acs:UserAgent": "*java-sdk*",
        "oss:Prefix": "foo"
      },
      "IpAddress": {
        "acs:SourceIp": "192.168.0.1"
      },
      "StringNotLike": {
        "acs:SourceVpc": [
          "vpc-*"
        ]
      }
    }
  },
    {
      "Action": [
        "oss:PutObject",
        "oss:GetObject",
        "oss:DeleteObject"
      ],
      "Resource": [
        "acs:oss:*:177530505652xxxx:mybucket/file*"
      ],
      "Effect": "Allow",
      "Condition": {
        "StringEquals": {
          "acs:UserAgent": "java-sdk"
        },
        "IpAddress": {
          "acs:SourceIp": "192.168.0.1"
        },
        "StringNotLike": {
          "acs:SourceVpc": [
            "vpc-*"
          ]
        }
      }
    }
  ]
}

情境11:禁止將 Bucket 和 Object 的 ACL 設定為公用訪問

以下樣本用于禁止將Bucket和Object的ACL設定為公用訪問,保障OSS資料安全。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Deny",
      "Action": [
        "oss:PutBucket",
        "oss:PutBucketAcl"
      ],
      "Resource": "*",
      "Condition": {
        "StringNotEquals": {
          "oss:x-oss-acl": "private"
        }
      }
    },
    {
      "Effect": "Deny",
      "Action": [
        "oss:PutObject",
        "oss:PutObjectAcl"
      ],
      "Resource": "*",
      "Condition": {
        "StringNotEquals": {
          "oss:x-oss-object-acl": [
            "private",
            "default"
          ]
        }
      }
    }
  ]
}

情境12:授予RAM使用者使用IMM相關功能的許可權

以下RAM Policy用於授予RAM使用者使用IMM文檔處理的許可權。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "oss:GetObject",
        "oss:PutObject",
        "oss:PostProcessTask",
        "oss:ProcessImm"
      ],
      "Resource": "*"
    },
    {
      "Action": [
        "imm:CreateOfficeConversionTask",
        "imm:GetWebofficeURL"
      ],
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Effect": "Allow",
      "Action": "ram:PassRole",
      "Resource": "acs:ram:*:*:role/aliyunimmdefaultrole"
    }
  ]
}

情境13:授予RAM使用者轉換儲存冗餘類型的許可權

  • 授予RAM使用者轉換某個Bucket儲存冗餘類型的許可權。

    以下樣本為RAM使用者授予轉換mybucket的儲存冗餘類型的許可權。

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "oss:CreateBucketDataRedundancyTransition",
            "oss:GetBucketDataRedundancyTransition",
            "oss:ListBucketDataRedundancyTransition",
            "oss:DeleteBucketDataRedundancyTransition"
          ],
          "Resource": "acs:oss:*:*:mybucket"
        }
      ]
    }
  • 授予RAM使用者轉換所有Bucket儲存冗餘類型的許可權。

    重要

    以下樣本會授予RAM使用者轉換阿里雲帳號下所有Bucket的儲存冗餘類型的許可權,請謹慎操作。

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "oss:CreateBucketDataRedundancyTransition",
            "oss:GetBucketDataRedundancyTransition",
            "oss:ListBucketDataRedundancyTransition",
            "oss:DeleteBucketDataRedundancyTransition"
          ],
          "Resource": "acs:oss:*:*:*"
        }
      ]
    }

情境14:授予RAM使用者建立OSS資源套件訂單的許可權

以下RAM Policy用於授予RAM使用者建立OSS資源套件訂單的許可權。

重要

RAM使用者建立OSS資源套件訂單後,可聯絡雲帳號擁有者完成訂單支付。如果要使RAM使用者能夠完成OSS資源套件訂單支付,雲帳號擁有者需要授予RAM使用者支付訂單的許可權bss:PayOrder。bss:PayOrder屬於高危許可權,涉及資金操作,非必要請勿授予。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "oss:CreateOrder",
      "Resource": "acs:oss:*:*:*"
    }
  ]
}

情境15:授予RAM使用者開通OSS的許可權

以下RAM Policy用於授予RAM使用者開通OSS的許可權。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "oss:ActivateProduct",
      "Resource": "acs:oss:*:*:*"
    }
  ]
}

情境16:授予RAM使用者讀寫指定標籤Bucket資料的許可權

以下RAM Policy用於授予RAM使用者讀寫指定標籤Bucket資料的許可權,標籤鍵為key1,標籤值為value1。

{
  "Version": "1",
  "Statement": [
    {
      "Action": [
        "oss:ListBuckets",
        "oss:GetBucketStat",
        "oss:GetBucketInfo",
        "oss:GetBucketAcl",
        "oss:ListObjects",
        "oss:PutObject",
        "oss:GetObject"
      ],
      "Resource": [
        "acs:oss:*:*:*"
      ],
      "Effect": "Allow",
      "Condition": {
        "StringEquals": {
          "oss:BucketTag/key1": "value1"
        }
      }
    }
  ]
}
說明

策略生效後,RAM使用者僅能對帶有標籤key1=value1的OSS Bucket執行指定操作。不同訪問方式的行為特性如下:

  • 通過OSS SDK或ossutil發起ListBuckets請求時,需添加標籤過濾參數(如tag-key=key1,tag-value=value1)。策略配置正確時,返回結果僅包含符合指定標籤條件的Bucket。

  • 通過OSS控制台發起ListBuckets請求時,由於控制台無法附加標籤參數,請求將因不滿足策略條件限制(oss:BucketTag/key1=value1)而被拒絕,系統提示許可權不足。

  • 其他動作(如PutObject、GetObject等)同樣受標籤條件限制,操作的目標Bucket必須滿足key1=value1的標籤要求。

情境 17:授予 RAM 使用者僅寫入權限(oss:PutObject)

以下 RAM Policy 用於授予 RAM 使用者向 OSS 上傳檔案,但不允許讀取或列舉 Bucket 及 Object 的許可權。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "oss:PutObject",
      "Resource": "acs:oss:*:*:*"
    }
  ]
}

將該策略授予 RAM 使用者後,RAM 使用者可通過 ossutil 或 SDK 上傳檔案,但無法使用 ls 列舉 Bucket 或 cp 下載檔案,這兩類請求會返回 403 AccessDenied,屬於策略生效的預期表現。如果只需授予對指定 Bucket 的僅寫入權限,可將 Resource 收緊為 acs:oss:*:*:{bucket-name}/*;請勿使用 acs:oss:*:*:/*,該寫法不是有效 Resource 格式,無法通過授權校正。

該策略可單獨授予 RAM 使用者,也可單獨授予 RAM 角色,不需要同時對兩者授權。如果通過 STS 臨時憑證訪問 OSS,RAM 使用者最終獲得的許可權是 RAM 角色許可權與 STS 工作階段策略的交集,此時可以直接為 RAM 角色授予該僅寫入權限策略。

應用於生產環境

在配置RAM Policy和管理RAM身份時,遵循以下安全最佳實務,可有效降低資料泄露風險並確保許可權管控的精確性:

  • 遵循最小許可權原則:始終只授予執行任務所必需的最小許可權集。避免使用oss:*這樣寬泛的授權,除非絕對必要。通過最小許可權原則可減少潛在的攻擊面,降低許可權濫用和誤操作風險。

  • 使用RAM角色和STS臨時憑證:對於應用程式,尤其是部署在ECS或容器中的應用,建議使用RAM角色並擷取STS臨時憑證來訪問OSS。相比長期AccessKey,臨時憑證具備自動到期機制,避免將長期AccessKey寫入程式碼在代碼或設定檔中,顯著降低了AK泄露的風險。

  • 人員使用者與程式使用者分離:為不同的人員和應用程式建立獨立的RAM使用者,實現身份管理的專業化和許可權的精細控制。

    • 人員使用者:設定控制台訪問,使用帳號和密碼訪問雲產品控制台,推薦開啟MFA多因素認證。

    • 程式使用者:設定使用永久AccessKey訪問,通過存取金鑰調用API訪問雲資源。

  • AccessKey安全管理:

    • 不要把RAM使用者的AccessKey ID和AccessKey Secret儲存在工程代碼中,否則可能導致AK泄露。

    • 建議使用STS或環境變數等方式擷取訪問授權。

    • 定期輪換AccessKey。

  • RAM角色安全建議:

    • 建立RAM角色後,請勿隨意變更RAM角色的可信實體,避免影響業務或帶來過度授權風險。

    • 設定合理的STS Token有效期間,避免有效期間過長帶來安全風險。

  • 定期審計許可權:定期檢查並清理不再需要的RAM使用者和權限原則,確保許可權與當前業務需求保持一致。

  • 利用Condition加強安全:在策略中添加Condition,例如限制源IP或VPC,通過多維度條件約束為資料訪問增加額外的安全防線。

    重要

    配置RAM Policy時,請結合自身的網路接入架構進行配置。建議同時配置acs:SourceIp和acs:SourceVpc條件,實現雙重存取控制。單一條件可能存在安全盲區,例如僅限制公網IP時,VPC可通過公網私用方式以匹配的出口IP訪問,造成越權。

策略未生效排查

配置 RAM 自訂策略後,如果 OSS 訪問請求仍然失敗,可參考以下常見原因逐步排查。

顯式 Deny 規則覆蓋 Allow

癥狀:RAM Policy 中已配置 Allow 語句,但請求仍返回 AccessDenied 錯誤。

排查步驟:

  1. 前往RAM 使用者列表,單擊目標使用者,在許可權標籤頁查看該身份已綁定的所有策略(含系統策略和自訂策略)。

  2. 逐一檢查各策略,尋找 Effect: Deny 的語句,重點關注 Action 包含萬用字元(如 oss:*)或覆蓋目標操作的規則。

  3. 如帳號層面啟用了服務控制策略(SCP),同時檢查 SCP 中是否有 Deny 規則命中該請求。

解決方案:刪除不必要的 Deny 語句,或縮小 Deny 規則的 Resource 和 Condition 範圍,避免誤攔截已 Allow 的合法請求。RAM Policy 遵循顯式拒絕優先原則:任意一條 Deny 規則命中請求,訪問即被拒絕,與同策略或其他策略中的 Allow 規則無關。

Resource ARN 格式不正確

癥狀:GetObject、PutObject 等對象級操作返回許可權不足;或 ListObjects 等 Bucket 級操作失敗;兩類操作需分別配置 Resource。

排查步驟:

  1. 檢查策略中的 Resource 欄位,確認 Bucket 級資源(acs:oss:*:*:bucketname)和 Object 級資源(acs:oss:*:*:bucketname/*)是否均已包含。

  2. 確認帳號 ID 填寫正確。如果使用了 * 匹配所有帳號,確認這符合預期授權範圍。

  3. 對於目錄級授權,確認使用了正確的首碼萬用字元(如 acs:oss:*:*:mybucket/dir/*),而非將目錄路徑寫入 Resource 但遺漏了 ListObjects 所需的 Bucket 級資源。

解決方案:需要同時授權 Bucket 級和 Object 級操作時,在同一策略中分別配置兩類 Resource:

{
  "Effect": "Allow",
  "Action": ["oss:ListObjects", "oss:GetBucketInfo"],
  "Resource": "acs:oss:*:*:mybucket"
},
{
  "Effect": "Allow",
  "Action": ["oss:GetObject", "oss:PutObject"],
  "Resource": "acs:oss:*:*:mybucket/*"
}

策略未附加到正確 RAM 身份

癥狀:建立或修改策略後許可權未生效,RAM 使用者或角色的實際訪問行為未發生變化。

排查步驟:

  1. 前往權限原則列表,找到目標策略,單擊綁定使用者查看當前已綁定的身份列表,確認目標使用者或角色在列表中。

  2. 如果通過使用者組授權,前往RAM 使用者組列表確認:該 RAM 使用者已加入對應使用者組,且使用者組已繫結目標策略。

  3. 如果使用 RAM 角色,確認應用程式或使用者扮演的是已繫結目標策略的正確角色,而非其他角色。

解決方案:在目標使用者的許可權標籤頁單擊新增授權,將目標策略附加給該 RAM 身份後重新測試。

Condition 條件不匹配

癥狀:策略中包含 Condition(如 IP 限制、VPC 限制、時間視窗限制),部分來源或時間段的請求意外被拒絕。

排查步驟:

  1. 查看策略中的 Condition 配置,核對使用的條件鍵(如 acs:SourceIp、acs:SourceVpc、oss:Prefix)及對應的匹配值。

  2. 確認發起請求的用戶端實際 IP、VPC ID 或其他屬性是否滿足 Condition 要求。

  3. 注意 acs:SourceIp 和 acs:SourceVpc 通常需要同時配置才能避免安全盲區:僅限制公網 IP 時,VPC 內的請求可能通過公網出口以匹配的 IP 繞過限制;詳見應用於生產環境中的安全建議。

解決方案:根據實際網路接入架構調整 Condition 欄位。如需定位問題,可臨時移除 Condition 以驗證策略基礎 Allow 是否正常,再逐步添加條件約束並驗證。

Action 名稱拼字錯誤或不完整

癥狀:已配置對應操作的 Allow,但請求仍返回 AccessDenied;或通過 OSS 控制台可以正常訪問,但 SDK 或 API 呼叫失敗(或反之)。

排查步驟:

  1. 核對策略中每條 Action 的名稱,注意大小寫(OSS Action 區分大小寫,正確格式如 oss:GetObject,而非 oss:getobject)。

  2. 通過 OSS 控制台操作通常需要同時授權多個 Action(如 oss:ListBuckets、oss:GetBucketStat、oss:GetBucketInfo、oss:GetBucketAcl 等),檢查是否有遺漏。

  3. 參考OSS 支援的 RAM 授權元素確認所需操作的完整名稱及適用情境。

解決方案:修正拼字錯誤的 Action 名稱,並按實際使用情境(控制台、SDK 或 API)補充所需的完整 Action 集合。

Bucket Policy 與 RAM Policy 交叉影響

癥狀:RAM Policy 已授權目標操作,但訪問特定 Bucket 時仍被拒絕;或移除 RAM Policy 後訪問行為未改變。

排查步驟:

  1. 前往 OSS 控制台,進入目標 Bucket,選擇許可權控制 > Bucket Policy,查看是否存在覆蓋當前身份的 Deny 規則。

  2. 根據顯式拒絕優先原則,Bucket Policy 中的 Deny 規則與 RAM Policy 中的 Allow 之間同樣遵循 Deny 優先——即使 RAM Policy 已授權該操作,只要 Bucket Policy 中有匹配的 Deny 規則,請求仍會被拒絕。

  3. 檢查 Bucket 的存取控制清單(ACL)設定。對於 private ACL 的 Bucket,所有訪問均需通過 RAM Policy 或 Bucket Policy 明確授權;Bucket 級 ACL 為 public-read 或 public-read-write 時,匿名使用者也可訪問,需注意資料安全風險。

解決方案:綜合梳理 RAM Policy 和 Bucket Policy,確認兩者不衝突。如需 RAM Policy 的 Allow 生效,調整或刪除 Bucket Policy 中對應的 Deny 規則,或將相關授權統一收歸 RAM Policy 管理。

相關文檔