新增自訂 Java 呼叫安全性政策

本頁適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

什麼是自訂 Java 呼叫安全性政策？

Java 說明文字可讓您使用 Java 程式碼自訂 API 行為。當您實作 Java 呼叫時，Apigee 會使用 Java 權限政策為 API 設定預設權限。在 Apigee hybrid 中，您可以建立自訂 Java 呼叫安全性政策，藉此變更預設權限。

您可以使用資源建立自訂 Java 呼叫安全性政策，該資源是在 securityPolicy 類型的資源檔案中定義。資源是在環境層級設定。資源檔案可以使用任何名稱，但您必須在自訂 Java 政策檔案名稱中加上 .policy 後置字串。例如：strict-security.policy。

下列指令會新增名為 strict-security.policy 的資源檔案。

curl -X POST "https://apigee.googleapis.com/v1/organizations/my-organization/environments/test/resourcefiles?name=CustomJavaSecurityPolicy&type=securityPolicy"
-H "Authorization: Bearer $TOKEN" \
-H "Content-type: multipart/form-data" \
-F file=@/Users/home/strict-security.policy
 安全性政策檔案支援的語法與標準 Java 安全性政策相同，請參閱「 預設政策實作和政策檔案語法」。

建立定義自訂 Java 呼叫政策的安全性政策檔案後，Apigee 執行階段就能偵測政策，並使用政策定義的自訂權限。如果沒有自訂 Java 呼叫政策，Apigee 會為自訂 Java 或 Python 程式碼使用預設安全性政策。

安全性政策檔案

以下範例顯示安全性政策檔案的內容範例。

下列程式碼行會指定自訂 Java 資訊窗口的程式碼位置，並授予目錄所有權限。

Relaxed security policy file for testing
// javacallout code has just read permission in the installed dir and everything below it
  grant codeBase "file:${javacallout.dir}/-"  {
    permission java.security.AllPermission;
}

這些行會指定自訂 Jython/Python 呼叫出顯示區塊的程式碼位置，並授予目錄讀取權限。

// Jython/Python secure
grant codeBase "file:${jython-secure-jar}" {
    // No logging permissions for secure jar. Hence value of the AllExcept target parameter set to 0
    permission com.apigee.securitypolicy.AllExcept "0", "java.io.FilePermission";
    permission java.io.FilePermission "{T}conf_security-policy_install.dir{/T}/lib/-" , "read";
    // Add JRE read permissions to jython. Existing permissions have two formats to java home. Keep the same.
    permission java.io.FilePermission "${java.home}/-", "read,readLink";
    permission java.io.FilePermission "${JAVA_HOME}/-", "read,readLink";
}

範例

以下範例說明如何執行與自訂 Java 呼叫安全性政策相關的特定工作。

建立自訂 Java 呼叫安全性政策

以下指令會建立自訂 Java 呼叫安全性政策，該政策是在名為 strict-security.policy 的資源檔案中定義。

curl -X POST "https://apigee.googleapis.com/v1/organizations/my-organization/environments/test/resourcefiles?name=CustomJavaSecurityPolicy&type=securityPolicy"
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: multipart/form-data" \
  -F file=@/Users/home/strict-security.policy

查看所有安全性政策

您可以使用下列指令，查看 API 中所有現有的自訂 Java 呼叫安全性政策。

curl -X GET "https://apigee.googleapis.com/v1/organizations/my-organization/environments/test/resourcefiles/securityPolicy" \
  -H "Authorization: Bearer $TOKEN"

查看安全性政策檔案的內容

下列指令可取得個別安全性政策檔案的內容，方便您查看。

curl -X GET "https://apigee.googleapis.com/v1/organizations/my-organization/environments/test/resourcefiles/securityPolicy/CustomJavaSecurityPolicy" \
  -H "Authorization: Bearer $TOKEN"

更新範圍限定為環境的政策

下列指令會更新環境範圍的安全性政策。

curl -X PUT "https://apigee.googleapis.com/v1/organizations/my-organization/environments/test/resourcefiles/securityPolicy/CustomJavaSecurityPolicy"
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: multipart/form-data" \
  -F file=@/Users/home/strict-security-revised.policy

刪除特定環境範圍的安全性政策

下列指令會刪除環境範圍的安全政策。

curl -X DELETE https://apigee.googleapis.com/v1/organizations/my-organization/environments/test/resourcefiles/securityPolicy/CustomJavaSecurityPolicy \
  -H "Authorization: Bearer $TOKEN"