MaxCompute:NEW_WRAPPED_KEYSET

Arka plan bilgileri ve ön koşullar

MaxCompute ile KMS'i birlikte kullanarak anahtarları yönetebilirsiniz. Bir KMS anahtarı temel alarak bir anahtar kümesini şifreleyip sarılı bir anahtar kümesi oluşturabilirsiniz. Sarılı bir anahtar kümesi oluşturduktan sonra, sonraki KMS anahtarı tabanlı veri şifreleme ve şifre çözme işlemleri için bu sarılı anahtar kümesini manuel olarak kaydetmeniz ve saklamanız gerekir. Şifreleme veya şifre çözme sürecindeki tüm anahtarları sistem otomatik olarak üretir. Şifreleme ve şifre çözme işleminde kullanılan orijinal anahtarı görüntüleyemezsiniz. Bu sayede veriler daha güvenli bir şekilde şifrelenir veya şifresi çözülür. NEW_WRAPPED_KEYSET işlevi, KMS müşteri anahtarı (CMK) ARN'lerini kullanma iznine sahip bir rolün Alibaba Cloud Resource Name (ARN) bilgisini MaxCompute'e varsayar ve sarılı bir anahtar kümesi oluşturur. Rol ARN'si role_arn parametresiyle belirtilir. KMS CMK ARN'si ise kms_cmk_arn parametresiyle tanımlanır. Bu işlev ayrıca role_chain parametresi aracılığıyla diğer Alibaba Cloud hesaplarına sarılı anahtar kümelerini kullanma izni vermek için de kullanılır.

NEW_WRAPPED_KEYSET işlevini kullanmadan önce aşağıdaki ön koşulların karşılandığından emin olun:

• KMS etkinleştirilmiş ve bir KMS örneği oluşturulmuştur.

• Bir KMS anahtarı oluşturulmuş ve kms_cmk_arn parametresiyle belirtilen anahtar ARN'si elde edilmiştir.

• Bir RAM rolü oluşturulmuş ve MaxCompute'in KMS'e erişmesine izin verilmiştir. RAM rolünün ARN'si alınmıştır. Rol ARN'si role_arn parametresiyle belirtilir.

Daha fazla bilgi için bkz. KMS'i etkinleştirin ve izinleri yapılandırın konusundaki "KMS'i etkinleştirin ve KMS üzerinde izinler verin" bölümü.

Söz dizimi

binary NEW_WRAPPED_KEYSET(string <kms_cmk_arn> , string <role-arn>, string <key_type>
[, string <description>, [string <role_chain>]])

Parametreler

• kms_cmk_arn: zorunludur. Bu parametre, bir anahtar kümesini şifrelemek için kullanılan KMS CMK'sinin ARN'sini belirtir. Parametre değeri 'acs:kms:<RegionId>:<UserId>:key/<CmkId>' biçimindedir. RegionId bölge kimliğini, UserId kullanıcı kimliğini ve CmkId CMK kimliğini belirtir. ARN bilgisini KMS konsolu üzerindeki Anahtar Ayrıntıları sayfasından edinebilirsiniz.

• role_arn: zorunludur. Bu parametre, KMS üzerinde izne sahip olan RAM rolünün ARN'sini belirtir. Rolün MaxCompute tarafından üstlenilmesi gerekir. Parametre değeri 'acs:ram:${<userAID>}:role/${<roleName>}' biçimindedir. userAID kullanıcı kimliğini, roleName ise rol adını belirtir.

• key_type: zorunludur. Bu parametre, yeni oluşturulan anahtar kümesindeki anahtarın algoritma türünü belirtir. Geçerli değerler: AES-GCM-256, AES-SIV-CMAC-128 ve AES-SIV-CMAC-256.

• description: isteğe bağlıdır. Bu parametre, anahtar için bir açıklama sağlar.

• role_chain: isteğe bağlıdır. Bu parametre, kullanıcı yetkilendirmesi için rol zincirini belirtir. Parametre değeri 'acs:ram:<userAID>:role/<roleName2>,acs:ram:<userBID>:role/<roleName3>},...' biçimindedir. Rol zincirlerini kullanarak sarılı anahtar kümelerini Alibaba Cloud hesapları arasında çağırabilirsiniz.

Dönüş değeri

İşlem, BINARY türünde sarılı bir anahtar kümesi döndürür. İş ihtiyaçlarınıza göre BINARY türündeki sarılı anahtar kümesini STRING türünde bir anahtar kümesine dönüştürmek için HEX işlevini kullanabilirsiniz. HEX işlevi hakkında daha fazla bilgi için bkz. HEX.

Örnekler

• Sarılı bir anahtar kümesi oluşturun.

  select hex(NEW_WRAPPED_KEYSET('acs:kms:cn-hangzhou:1**************7:key/key-hzz****************1t','acs:ram::1**************7:role/kms', 'AES-GCM-256', 'hello'));

  Aşağıdaki sonuç döndürülür:

  +-----+
  | _c0 |
  +-----+
  | 613256354C576836656A59314D6D59344E7A6B7A624452754D6D3434627A49786443317A655859786358426F4E6A4D78434A373434582F54756C5A547A4E69337562786F4B3543412F616655573262786D345A41306B464C674A2F5758324F4E514E346746306F303236376D35335A6471797237366E57565A6836387A52687A4A673945784B6E677568794A376E6F4A68573677684B5A555A42786E4A383742536C4D46326A374F71474F4C414A6B665779694557394D58664876576E306C6D49777052746A77325643707A4259517277327944354343396C50586F31346A4351506253612F3044394C4C6E6E622F747A6B57316E4F564A6C5359354B35526130537565584F33507856773D |
  +-----+

• Sarılı bir anahtar kümesi oluşturun ve diğer rollerin bu sarılı anahtar kümesini çağırmasına izin verin.

  select hex(NEW_WRAPPED_KEYSET('acs:kms:cn-hangzhou:1**************7:key/key-hzz****************1t','acs:ram::1**************7:role/kms', 'AES-GCM-256', 'hello','acs:ram::1**************7:role/kms1'));

  Aşağıdaki sonuç döndürülür:

  +-----+
  | _c0 |
  +-----+
  | 613256354C576836656A59314D6D59344E7A6B7A624452754D6D3434627A49786443317A655859786358426F4E6A4D784D59716D4C767954716B3562444779574C7A387965774966432F516B4A59616F57623648364A546A62434F7A7A42634F517A687A6E526F36543866714E4E63555546566874696C4A3947713556667A2F7851757A55686467504C517A2B6C433337485A535449744B53714E396B6639587666487A4D7957643842334D3179392F67423774726835437A556F786A74614571612F5A3543447668524A7731426566525647796A77574974476243475A4E594550714E767963532B333432743347396B714777626C54336F57706939706E437A667A4E4D6F4C63714F453D |
  +-----+

İlgili konular