設定公用憑證的自動輪換原則

如果您希望安排您的公開 SSL / TLS 憑證自動更新，您可以在訂購憑證時啟用憑證自動輪換功能。 您也可以透過編輯現有憑證的詳細資料來啟用自動旋轉。 在憑證的下一個輪換週期中，Secrets Manager 在憑證到期日前 31 天開始嘗試重新訂購該憑證。 服務會繼續每日嘗試更新憑證，直到成功為止。

1. 如果您 訂購公用憑證，請啟用輪替選項。

   1. 若要自動輪換憑證，請將輪換切換切換至 開啟。 您的憑證會在其到期日之前 31 天自動重新訂購。
   2. 若要在每次輪換證書時要求新的私密金鑰，請將重新鑰匙切換開啟。

2. 如果您正在編輯現有的公用憑證，請透過更新其詳細資料來排程自動輪換。

   1. 在 密鑰 表格中，檢視現有「公用」憑證的清單。
   2. 在您要編輯之憑證的列中，按一下 動作 功能表 > 編輯詳細資料。
   3. 使用 自動旋轉 選項來新增或移除密鑰的旋轉原則。

設定 IAM 認證的自動輪換原則

如果您偏好將 API 金鑰排定為定期自動輪替，則可以在建立 IAM 認證時啟用自動輪替。 您也可以透過編輯現有密鑰的詳細資料來啟用自動旋轉。 請選擇 30、60 或 90 天旋轉間隔。

如果您需要更多地控制秘訣的旋轉頻率，您可以使用 day 或 month 作為時間單位，使用 Secrets Manager API 設定自訂間隔。 如需相關資訊，請參閱 API 參考資料。

1. 如果您是 新增密鑰，請透過選取 30、60 或 90 天旋轉間隔來啟用旋轉選項。
2. 如果您正在編輯現有密鑰，請透過更新其詳細資料來啟用自動輪換。
   1. 在 密鑰 表格中，檢視現有密鑰的清單。
   2. 在您要編輯之密鑰的列中，按一下 動作 功能表 > 編輯詳細資料。
   3. 使用 自動旋轉 選項來啟用或停用密鑰的自動旋轉。

循環僅適用於重複使用金鑰設為 true 的 IAM 認證。 定義的旋轉間隔不能高於定義的存活時間 (TTL)。 您可以使用 minute 時間單位來設定密鑰的 TTL，但這些密鑰無法使用循環。

設定服務認證的自動輪換原則

如果您希望將服務憑證秘密排定為定期自動輪替，您可以在建立服務憑證時將其自動輪替啟用。 您也可以透過編輯現有密鑰的詳細資料來啟用自動旋轉。 請選擇 30、60 或 90 天旋轉間隔。

如果您需要更多地控制秘訣的旋轉頻率，您可以使用 day 或 month 作為時間單位，使用 Secrets Manager API 設定自訂間隔。 如需相關資訊，請參閱 API 參考資料。

1. 如果您是 新增密鑰，請透過選取 30、60 或 90 天旋轉間隔來啟用旋轉選項。
2. 如果您正在編輯現有密鑰，請透過更新其詳細資料來啟用自動輪換。
   1. 在 密鑰 表格中，檢視現有密鑰的清單。
   2. 在您要編輯之密鑰的列中，按一下 動作 功能表 > 編輯詳細資料。
   3. 使用 自動旋轉 選項來啟用或停用密鑰的自動旋轉。

為「自訂憑證」設定自動輪換政策

如果您偏好排定 custom_credentials secret 定時自動輪替，您可以在建立 custom_credentials secret 時啟用自動輪替。 您也可以透過編輯現有密鑰的詳細資料來啟用自動旋轉。 請選擇 30、60 或 90 天旋轉間隔。

如果您需要更多地控制秘訣的旋轉頻率，您可以使用 day 或 month 作為時間單位，使用 Secrets Manager API 設定自訂間隔。 如需相關資訊，請參閱 API 參考資料。

1. 如果您是 新增密鑰，請透過選取 30、60 或 90 天旋轉間隔來啟用旋轉選項。
2. 如果您正在編輯現有密鑰，請透過更新其詳細資料來啟用自動輪換。
   1. 在 密鑰 表格中，檢視現有密鑰的清單。
   2. 在您要編輯之密鑰的列中，按一下 動作 功能表 > 編輯詳細資料。
   3. 使用 自動旋轉 選項來啟用或停用密鑰的自動旋轉。

設定使用者認證的自動輪換原則

使用 ibmcloud secrets-manager secret-metadata-update 來排定使用者認證的自動輪換。

ibmcloud secrets-manager secret-metadata-update \
    --id=SECRET_ID \
    --rotation='{"auto_rotate": true,"interval": 30,"unit": "day"}'

若要移除原則，請將資源區塊保留空白。

設定公用憑證的自動輪換原則

使用 ibmcloud secrets-manager secret-metadata-update 來排定公用憑證的自動輪換。

ibmcloud secrets-manager secret-metadata-update \
    --id=SECRET_ID \
    --rotation='{"auto_rotate": true, "rotate_keys": true}'

設定專用憑證的自動輪替原則

使用 ibmcloud secrets-manager secret-metadata-update 來排定專用憑證的自動輪換。

ibmcloud secrets-manager secret-metadata-update \
    --id=SECRET_ID \
    --rotation='{"auto_rotate": true,"interval": 30,"unit": "day"}'

設定 IAM 認證的自動輪換原則

使用 ibmcloud secrets-manager secret-metadata-update 來排定 IAM 認證的自動輪換。

ibmcloud secrets-manager secret-metadata-update \
    --id=SECRET_ID \
    --rotation='{"auto_rotate": true,"interval": 30,"unit": "day"}'

若要移除原則，請將資源區塊保留空白。

設定服務認證的自動輪換原則

使用 ibmcloud secrets-manager secret-metadata-update 來排定服務認證的自動輪換。

ibmcloud secrets-manager secret-metadata-update \
    --id=SECRET_ID \
    --rotation='{"auto_rotate": true,"interval": 30,"unit": "day"}'

若要移除原則，請將資源區塊保留空白。

為「自訂憑證」設定自動輪換政策

透過使用 ibmcloud secrets-manager secret-metadata-update.

ibmcloud secrets-manager secret-metadata-update \
    --id=SECRET_ID \
    --rotation='{"auto_rotate": true,"interval": 30,"unit": "day"}'

若要移除原則，請將資源區塊保留空白。

設定使用者認證的自動輪換原則

下列範例要求會為使用者認證 (username_password) 密鑰建立自動輪換原則。 當您呼叫 API 時，請將 ID 變數及 IAM 記號取代為 Secrets Manager 實例特定的值。

curl -X PATCH
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H 'Content-Type: application/merge-patch+json' \
   -d '{
            "rotation": {
               "auto_rotate": true,
               "interval": 1,
               "unit": "month"
            }
         }' \
      "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/metadata"

若回應成功，系統將回傳該密鑰的 ID 值，以及其他元資料。 如需必要及選用要求參數的相關資訊，請參閱 API 參考資料。

若要移除原則，請將資源區塊保留空白。

設定公用憑證的自動輪換原則

如果您偏好將憑證排定為自動更新，則可以在訂購憑證時啟用憑證自動輪替，或透過編輯現有憑證的詳細資料來啟用憑證自動輪替。 在憑證的下一個循環週期中，Secrets Manager 會在憑證到期日之前 31 天重新訂購憑證。

curl -X POST
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
         "custom_metadata": {
            "metadata_custom_key": "metadata_custom_value"
         },
         "rotation": {
            "auto_rotate": true,
            "rotate_keys": true
         },
         "version_custom_metadata": {
            "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets"

設定 IAM 認證的自動輪換原則

下列範例要求會針對 IAM 認證 (iam_credentials) 密鑰建立自動輪換原則。 當您呼叫 API 時，請將 ID 變數及 IAM 記號取代為 Secrets Manager 實例特定的值。

curl -X PATCH
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H 'Content-Type: application/merge-patch+json' \
   -d '{
          "rotation": {
            "auto_rotate": true,
            "interval": 30,
            "unit": "day"
          }
         }' \
      "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/metadata"

若要移除原則，請將資源區塊保留空白。

若回應成功，系統將回傳該密鑰的 ID 值，以及其他元資料。 如需必要及選用要求參數的相關資訊，請參閱 API 參考資料。

定義的旋轉間隔不能高於定義的存活時間。 循環僅適用於「重複使用金鑰」設為 true 的 IAM 認證。 您可以使用 minute 時間單位來設定密鑰的 TTL，但這些密鑰無法使用循環。

設定服務認證的自動輪換原則

下列範例要求會建立服務認證 (service_credentials) 密鑰的自動輪換原則。 當您呼叫 API 時，請將 ID 變數及 IAM 記號取代為 Secrets Manager 實例特定的值。

curl -X PATCH
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H 'Content-Type: application/merge-patch+json' \
   -d '{
          "rotation": {
            "auto_rotate": true,
            "interval": 30,
            "unit": "day"
          }
         }' \
      "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/metadata"

若要移除原則，請將資源區塊保留空白。

若回應成功，系統將回傳該密鑰的 ID 值，以及其他元資料。 如需必要及選用要求參數的相關資訊，請參閱 API 參考資料。

定義的旋轉間隔不能高於定義的存活時間。

為「自訂憑證」設定自動輪換政策

以下範例請求為 custom_credentials secret 建立自動輪替政策。 當您呼叫 API 時，請將 ID 變數及 IAM 記號取代為 Secrets Manager 實例特定的值。

curl -X PATCH
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H 'Content-Type: application/merge-patch+json' \
   -d '{
          "rotation": {
            "auto_rotate": true,
            "interval": 30,
            "unit": "day"
          }
         }' \
      "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/metadata"

若要移除原則，請將資源區塊保留空白。

若回應成功，系統將回傳該密鑰的 ID 值，以及其他元資料。 如需必要及選用要求參數的相關資訊，請參閱 API 參考資料。

定義的旋轉間隔不能高於定義的存活時間。