All Products
Search

This Product

    MaxCompute:Gunakan keysets

    Document Center

    MaxCompute:Gunakan keysets

    Last Updated:Jul 18, 2026

    Keyset di MaxCompute mengelola satu atau beberapa kunci kriptografi. Anda dapat menambahkan kunci ke keyset untuk rotasi kunci dan memeriksa bahan kunci aslinya.

    Catatan

    Anda harus menyimpan keyset dan parameter dekripsi secara aman. Jika hilang, data yang dienkripsi dengan keyset tersebut tidak dapat dipulihkan secara permanen.

    Siapkan data

    Buat tabel bernama mf_test_data dan tambahkan data sampel ke dalamnya.

    -- Buat tabel.
create table mf_test_data(id string,name string,tel string);
-- Masukkan data.
insert into mf_test_data values(1,'kyle','13900001234'),(2,'tom','13900001111');
-- Kueri data.
select * from mf_test_data;
-- Hasil berikut dikembalikan:
+----+------+-----+
| id | name | tel |
+----+------+-----+
| 1  | kyle | 13900001234 |
| 2  | tom  | 13900001111 |
+----+------+-----+

    Gunakan keyset standar

    • Contoh 1: Buat keyset baru.

      select NEW_KEYSET('AES-GCM-256', 'my first keyset');

      Hasilnya sebagai berikut.

      +------+
| _c0  |
+------+
| =0A=10260nZQEAMAsSF7mB=12\=0A3=0A=0BAES-GCM-256=12=20=C4t=13+=8E=DD=9D=E8=A0=AA=B4=ED~1`=B7=C6=D0K=D3=FC=D4n=DF=DF=D4=C3)=E8=96=0E=17=18=01=20=02=10=01=1A=10260nZQEAMAsSF7mB=20=02*=0Fmy=20first=20keyset |
+------+

    • Contoh 2: Lihat representasi JSON teks biasa dari keyset.

      select KEYSET_TO_JSON(NEW_KEYSET('AES-GCM-256', 'my first keyset'));

      Hasilnya sebagai berikut.

      +-----+
| _c0 |
+-----+
| {
    "key": [{
            "description": "my first keyset",
            "key_id": "Ra4nZQEAoBuiGbmB",
            "key_meta_data": {
                "key_material_origin": "Origin_ALIYUN_MAXCOMPUTE",
                "key_material_type": "SYMMETRIC",
                "type": "AES-GCM-256",
                "value": "/LFKWhw18hz+OBO490YKmjQQDNVWJLOueaUAKKiem/k="},
            "output_prefix_type": "PREFIX_ALIYUN_MAXCOMPUTE",
            "status": "ENABLED"}],
    "primary_key_id": "Ra4nZQEAoBuiGbmB"} |

    • Contoh 3: Tambahkan kunci baru ke keyset dan tetapkan sebagai kunci primary.

      • Tambahkan kunci AES-SIV-CMAC-128 ke keyset yang sudah ada yang berisi kunci AES-GCM-256.

        select  KEYSET_TO_JSON(
  					ADD_KEY_TO_KEYSET(
              NEW_KEYSET('AES-GCM-256', 'my first keyset'), 
              'AES-SIV-CMAC-128', 
              unhex('b75585cf321cdcad42451690cdb7bfc49c26092f60f854e72d43244c55620a3d'),
              ''
            )
				);

        Hasilnya sebagai berikut.

        +-----+
| _c0 |
+-----+
| {
    "key": [{
            "description": "my first keyset",
            "key_id": "+q8nZQEAgAMtJLmB",
            "key_meta_data": {
                "key_material_origin": "Origin_ALIYUN_MAXCOMPUTE",
                "key_material_type": "SYMMETRIC",
                "type": "AES-GCM-256",
                "value": "Hj//ZKxLE/t0Uq7XRJQoe2OYNwlauDdGmkaQbMfnZ80="},
            "output_prefix_type": "PREFIX_ALIYUN_MAXCOMPUTE",
            "status": "ENABLED"},
        {
            "description": "",
            "key_id": "+q8nZQEAML2VArmB",
            "key_meta_data": {
                "key_material_origin": "Origin_RAW",
                "key_material_type": "SYMMETRIC",
                "type": "AES-SIV-CMAC-128",
                "value": "t1WFzzIc3K1CRRaQzbe/xJwmCS9g+FTnLUMkTFViCj0="},
            "output_prefix_type": "PREFIX_ALIYUN_MAXCOMPUTE",
            "status": "ENABLED"}],
    "primary_key_id": "+q8nZQEAML2VArmB"} |
+-----+

      • Fungsi ini secara otomatis menghasilkan kunci baru dan menetapkannya sebagai kunci primary.

        select  KEYSET_TO_JSON(
  				ROTATE_KEYSET(
  					NEW_KEYSET('AES-GCM-256', 'my first keyset'),
  			 		'AES-GCM-256')
  			);

        Hasilnya sebagai berikut.

        +-----+
| _c0 |
+-----+
| {
    "key": [{
            "description": "my first keyset",
            "key_id": "TbEnZQEAUIEJC7mB",
            "key_meta_data": {
                "key_material_origin": "Origin_ALIYUN_MAXCOMPUTE",
                "key_material_type": "SYMMETRIC",
                "type": "AES-GCM-256",
                "value": "TLAKX8y0/aUbMAtElI+oicEw1fWSTJhZs1D2i3AAf40="},
            "output_prefix_type": "PREFIX_ALIYUN_MAXCOMPUTE",
            "status": "ENABLED"},
        {
            "key_id": "TbEnZQEAAIy0IrmB",
            "key_meta_data": {
                "key_material_origin": "Origin_ALIYUN_MAXCOMPUTE",
                "key_material_type": "SYMMETRIC",
                "type": "AES-GCM-256",
                "value": "jPewQsmbsajzM/gLNX9QFtENs2n9uvhgrgcrcGgl0A0="},
            "output_prefix_type": "PREFIX_ALIYUN_MAXCOMPUTE",
            "status": "ENABLED"}],
    "primary_key_id": "TbEnZQEAAIy0IrmB"} |
+-----+

    • Contoh 4: Enkripsi dan dekripsi data.

      1. Buat tabel bernama mf_keyset dan tulis keyset ke dalamnya.

          -- Buat tabel.
create table mf_keyset (id string,ks binary);
-- Buat keyset dan masukkan ke tabel mf_keyset.
insert into mf_keyset select '1',NEW_KEYSET('AES-GCM-256', 'my first keyset');

      2. Enkripsi dan dekripsi kolom tel di tabel mf_test_data.

        • Enkripsi kolom tel di tabel mf_test_data.

          select id,
       name,
       ENHANCED_SYM_ENCRYPT(ks,tel) as tel 
  from (SELECT id,name,tel FROM mf_test_data) JOIN 
       (SELECT ks FROM mf_keyset WHERE  id = '1') a ;

          Hasilnya sebagai berikut.

          +----+------+------+
| id | name | tel  |
+----+------+------+
| 1  | kyle | =0B=88=A5=0Ak=AD=E0=9A=B4=EC=CC=1F=F9=DEk\=16=0F=BD=F1=03=8B=95=F0@=88s=EE=1E=8A=D2=05=83=B5'e=01=00=A0=C5=0BXu=A5Z&<=01=F8=C5Q=89=A9=A6=80=E2=0F=1A)=02fa=CF=07'=1B'=EB=FD=CF=E9 |
| 2  | tom  | =0B=88=A5=0Ak=AD=E0=9A=B4=EC=CC=1F=F9=DEk\=16=0F=BD=F1=03=8B=95=F0@=88s=EE=1E=8A=D2=05=83=B5'e=01=00=10=FC=0BXu=A5+3=D5=1Fb=C0=88=AC=90=AA=FE!C=F0=99y&=9C=89=0E=9B=8FD=16=E0=96, |
+----+------+------+

        • Dekripsi kolom tel di tabel mf_test_data.

          select id,
       name,
       ENHANCED_SYM_DECRYPT(ks,
                            ENHANCED_SYM_ENCRYPT(ks,tel),
                            '')as tel 
  from (SELECT id,name,tel FROM mf_test_data) JOIN 
       (SELECT ks FROM mf_keyset WHERE  id = '1') a ;

          Hasilnya sebagai berikut.

          +----+------+------+
| id | name | tel  |
+----+------+------+
| 1  | kyle | 13900001234 |
| 2  | tom  | 13900001111 |
+----+------+------+

    Gunakan keyset dengan KMS

    MaxCompute terintegrasi dengan Key Management Service (KMS) untuk meningkatkan enkripsi data. Keyset standar pertama kali dihasilkan untuk mengenkripsi dan mendekripsi data, lalu dienkripsi oleh kunci KMS untuk membuat wrapped keyset yang harus Anda simpan. Saat Anda mengenkripsi atau mendekripsi data, Anda memberikan wrapped keyset tersebut, dan MaxCompute menggunakan kunci KMS untuk membukanya (unwrap) serta sementara memulihkan keyset aslinya untuk operasi tersebut.

    Diagram berikut menggambarkan alur kerja ini.

    keyset.jpg

    Aktifkan KMS dan konfigurasikan izin

    1. Aktifkan KMS dan beli instans manajemen kunci perangkat lunak. Untuk informasi selengkapnya, lihat Beli dan aktifkan instans KMS.

    2. Buat kunci dan dapatkan ARN-nya dari halaman Detail Kunci. Untuk informasi selengkapnya, lihat Memulai Key Management.

      Pada contoh ini, ARN kunci yang dibuat adalah acs:kms:cn-beijing:189273228874****:key/key-bjj6527b6c6465hsf****.

    3. Berikan izin KMS yang diperlukan kepada MaxCompute untuk enkripsi dan dekripsi.

      Catatan

      Setelah membungkus keyset MaxCompute dengan KMS, Anda harus memberikan izin KMS yang diperlukan kepada MaxCompute. Jika tidak, perintah enkripsi dan dekripsi selanjutnya akan gagal.

      Ikuti langkah-langkah berikut:

      1. Buat RAM role. Tetapkan trusted entity type ke Alibaba Cloud Service dan Trusted Service ke MaxCompute. Untuk informasi selengkapnya, lihat Buat RAM role untuk layanan Alibaba Cloud tepercaya.

      2. Sambungkan kebijakan sistem AliyunKMSCryptoUserAccess ke role yang telah Anda buat untuk memberikan izin enkripsi dan dekripsi yang diperlukan kepada MaxCompute. Untuk informasi selengkapnya, lihat Berikan izin ke RAM role.

        • Jika Akun Alibaba Cloud bernama USER_A melakukan langkah-langkah ini, maka akun tersebut dapat mengenkripsi keyset.

        • Pada contoh ini, RAM role bernama mf-secr, dan ARN-nya adalah acs:ram::189273228874****:role/mf-secr.

    4. (Opsional) Untuk mengizinkan RAM user dari akun yang sama (USER_A) atau akun lain (USER_B) melakukan enkripsi dan dekripsi, Anda harus memberikan izin berikut.

      Menggunakan RAM user USER_A

      Untuk mengizinkan RAM user menggunakan role mf-secr, buat kebijakan yang memberikan izin ram:PassRole pada role mf-secr dan sambungkan ke RAM user tersebut. Untuk informasi selengkapnya, lihat Berikan izin ke RAM user. Contoh kode berikut menunjukkan contoh kebijakan.

      {
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "ram:PassRole",
            "Resource": "acs:ram:*:*:role/mf-secr"
        }
    ],
    "Version": "1"
}

      Menggunakan USER_B dan RAM usernya

      Penting

      Untuk enkripsi dan dekripsi cross-account, Anda harus menentukan parameter role_chain dalam fungsi terkait. Berdasarkan role pada contoh berikut, parameternya adalah 'acs:ram::188538605451****:role/b-secr,acs:ram::189273228874****:role/mf-secr2b'.

      Ikuti langkah-langkah berikut:

      1. Di Akun Alibaba Cloud USER_A, buat RAM role baru (misalnya, mf-secr2b). Tetapkan trusted entity type ke Alibaba Cloud Account dan tentukan USER_B sebagai akun tepercaya. Untuk informasi selengkapnya, lihat Buat RAM role untuk akun Alibaba Cloud tepercaya.

      2. Berikan izin ram:PassRole pada peran mf-secr kepada peran mf-secr2b. Untuk contoh kebijakan, lihat Gunakan Pengguna RAM USER_A untuk melakukan enkripsi dan dekripsi.

      3. Di Akun Alibaba Cloud USER_B, buat RAM role baru (misalnya, b-secr). Tetapkan trusted entity type ke Alibaba Cloud Service dan Trusted Service ke MaxCompute. Untuk informasi selengkapnya, lihat Buat RAM role untuk layanan Alibaba Cloud tepercaya.

      4. Berikan izin b-secr untuk melakukan sts:AssumeRole pada role mf-secr2b. Contoh kode berikut menunjukkan contoh kebijakan.

        {
    "Version": "1",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "sts:AssumeRole",
            "Resource": "acs:ram:*:189273228874****:role/mf-secr2b"
        }
    ]
}

      5. (Opsional) Jika RAM user USER_B perlu melakukan enkripsi dan dekripsi, Anda juga harus memberikan izin ram:PassRole pada role b-secr kepada user tersebut. Contoh kode berikut menunjukkan contoh kebijakan.

        {
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "ram:PassRole",
            "Resource": "acs:ram:*:*:role/b-secr"
        }
    ],
    "Version": "1"

    Enkripsi dan dekripsi data dengan KMS

    • Contoh 1: Buat wrapped keyset baru.

      select hex(NEW_WRAPPED_KEYSET('acs:kms:cn-beijing:189273228874****:key/key-bjj6527b6c6465hsf****', 
                              'acs:ram::189273228874****:role/mf-secr', 'AES-GCM-256', 'hello'));

      Hasilnya sebagai berikut.

      +-----+
| _c0 |
+-----+
| 613256354C574A71616A59314D6A64694E6D4D324E44593161484E6D65576732595331315A586435646D4678596A6C36555437693738632B647070524B46334E5263497567384A6B36716C4E54354133734F6E4776376258453132524E6C4B6E5163703859787132536C6D794F6E4A6975797541745448374F6B5132412B4B6947502F4A7530756477694B736B503033576643726E45646D666F6F324D61774F7A452F4F55314A51643268397941384F6B425644665A59746D3968775576536E543744684276723773464A714A47394D7770765064484B6A457A6F4A3533716E57766F4339634639413348556E433641434A6438444170583275326B2B4177776941487668575279304941445031373461794A2F50773D3D |
+-----+

    • Contoh 2: Enkripsi ulang wrapped keyset.

      select REWRAP_KEYSET('acs:kms:cn-beijing:189273228874****:key/key-bjj6527b6c6465hsf****', 
                'acs:ram::189273228874****:role/mf-secr',  
                     unhex('613256354C574A71616A59314D6A64694E6D4D324E44593161484E6D65576732595331315A586435646D4678596A6C36555437693738632B647070524B46334E5263497567384A6B36716C4E54354133734F6E4776376258453132524E6C4B6E5163703859787132536C6D794F6E4A6975797541745448374F6B5132412B4B6947502F4A7530756477694B736B503033576643726E45646D666F6F324D61774F7A452F4F55314A51643268397941384F6B425644665A59746D3968775576536E543744684276723773464A714A47394D7770765064484B6A457A6F4A3533716E57766F4339634639413348556E433641434A6438444170583275326B2B4177776941487668575279304941445031373461794A2F50773D3D'));

      Hasilnya sebagai berikut.

      +------+
| _c0  |
+------+
| a2V5LWJqajY1MjdiNmM2NDY1aHNmeWg2YS11ZXd5dmFxYjl60Kftgx5o1sQH4kkwRboFSYUmcVKjF1GKF+JU5gKSp3xOF1xjKdb6fGZyNuD4YSAzqNTD7x7j5fzTLW2+9a+8BmS1z3ZP1RjNL6Lp93FAC4NWg/jtggh6WOTXrVoG67/CfzdWro65YDTPZpe52K416gpfW18GXSOzu9q4swMti0UrScl/fTg6eOIMYgoPCfBh9qvXhNSR72J+qXU1vHcyYNQL6UewsBE2suVRFQ=3D=3D |

    • Contoh 3: Lakukan rotasi kunci.

      select  ROTATE_WRAPPED_KEYSET('acs:kms:cn-beijing:189273228874****:key/key-bjj6527b6c6465hsf****', 
                'acs:ram::189273228874****:role/mf-secr',  
                     unhex('613256354C574A71616A59314D6A64694E6D4D324E44593161484E6D65576732595331315A586435646D4678596A6C36555437693738632B647070524B46334E5263497567384A6B36716C4E54354133734F6E4776376258453132524E6C4B6E5163703859787132536C6D794F6E4A6975797541745448374F6B5132412B4B6947502F4A7530756477694B736B503033576643726E45646D666F6F324D61774F7A452F4F55314A51643268397941384F6B425644665A59746D3968775576536E543744684276723773464A714A47394D7770765064484B6A457A6F4A3533716E57766F4339634639413348556E433641434A6438444170583275326B2B4177776941487668575279304941445031373461794A2F50773D3D'), 
                              'AES-GCM-256', 
                              'descrption');

      Hasilnya sebagai berikut.

      +------+
| _c0  |
+------+
| a2V5LWJqajY1MjdiNmM2NDY1aHNmeWg2YS11ZXd5dmFxYjl67ZxGgfbQhsOududp3FuxLFW1qWt7fF2fT2mAqFekH3D/SoooVf1Jgj0dS/3kxHLQImthef+fCca5vRbVYbOeSsjhGI841WhJvYE1KzRuTpV04SpzVimCovlPPiYCm1649Vhkua1/zUu2W0ioCPnXzHIANhoOIXM2mAV+EfuRCjLUtcJhMdCnu+whHwkGXMYugtXmLxZIBHaJNvO9I3tntplTzxElVmj/LpDrAkg0mKahLJa7FhcJ8cn/JHjp9sk0MhHQc/5X14vHBJuulkYkukcF/kZ+AFVfWes5pZOMs8Og3pYEjCESMiiMONy/CpIrYepapgsKqRAmCGxRv/7aDOZyaAV5Jdz31NotMCBi/hrYBwyU0QdAq5pvsOEdXVIJyazViQ=3D=3D |
+------+

    • Contoh 4: Enkripsi dan dekripsi data.

      1. Buat tabel bernama mf_keyset_kms dan tulis wrapped keyset ke dalamnya.

        -- Buat tabel.
create table mf_keyset_kms (id string,ks binary);
-- Hasilkan wrapped keyset dan tulis ke tabel.
insert into mf_keyset_kms 
      select '1',
             NEW_WRAPPED_KEYSET(
                'acs:kms:cn-beijing:189273228874****:key/key-bjj6527b6c6465hsf****', 
                'acs:ram::189273228874****:role/mf-secr', 
                'AES-GCM-256', 
               'description');

        Verifikasi bahwa keyset telah ditulis.

        -- Kueri tabel.
select id,hex(ks) from mf_keyset_kms;
-- Hasil berikut dikembalikan:
+----+------+
| id | ks   |
+----+------+
| 1  | 613256354C574A71616A59314D6A64694E6D4D324E44593161484E6D65576732595331315A586435646D4678596A6C36555437693738632B647070524B46334E5263497567384A6B36716C4E54354133734F6E4776376258453132524E6C4B6E5163703859787132536C6D794F6E4A6975797541745448374F6B5132412B4B6947502F4A7530756477694B736B503033576643726E45646D666F6F324D61774F7A452F4F55314A51643268397941384F6B425644665A59746D3968775576536E543744684276723773464A714A47394D7770765064484B6A457A6F4A3533716E57766F4339634639413348556E433641434A6438444170583275326B2B4177776941487668575279304941445031373461794A2F50773D3D |

      2. Enkripsi dan dekripsi kolom tel di tabel mf_test_data.

        • Enkripsi kolom tel di tabel mf_test_data.

          -- Enkripsi kolom tel. Keyset harus disediakan sebagai konstanta.
select id,
       name,
       ENHANCED_SYM_ENCRYPT(
           USE_WRAPPED_KEYSET('acs:kms:cn-beijing:189273228874****:key/key-bjj6527b6c6465hsf****', 
                              'acs:ram::189273228874****:role/mf-secr', 
                              unhex('613256354C574A71616A59314D6A64694E6D4D324E44593161484E6D65576732595331315A586435646D4678596A6C36555437693738632B647070524B46334E5263497567384A6B36716C4E54354133734F6E4776376258453132524E6C4B6E5163703859787132536C6D794F6E4A6975797541745448374F6B5132412B4B6947502F4A7530756477694B736B503033576643726E45646D666F6F324D61774F7A452F4F55314A51643268397941384F6B425644665A59746D3968775576536E543744684276723773464A714A47394D7770765064484B6A457A6F4A3533716E57766F4339634639413348556E433641434A6438444170583275326B2B4177776941487668575279304941445031373461794A2F50773D3D')
                             ),
           tel
       ) as tel 
 FROM mf_test_data;

          Hasilnya sebagai berikut.

          +----+------+------+
| id | name | tel  |
+----+------+------+
| 1  | kyle | =1A=B88=F7=C5A=DF=DC=91=A6R=F8{=EB=A5_x=AD=AF=FF=9A=14=D81<=8BO=EB=F5=D3Jn=E8=0ESe=01=00=A0=AC=0D=C8=0De=B9=E4=84=AB=F0f=AE~Dt=C5W=FAx=A5=11=01t=95=DF=FA/-=BC7=C5G |
| 2  | tom  | =1A=B88=F7=C5A=DF=DC=91=A6R=F8{=EB=A5_x=AD=AF=FF=9A=14=D81<=8BO=EB=F5=D3Jn=E8=0ESe=01=00=B0=BF=0D=C8=0DejL{;.w0=80,=E6=86V@b=F3=AB=DEY=A6=02=07=001=E0[=E7V |
+----+------+------+

        • Dekripsi kolom tel di tabel mf_test_data.

          select id,
       name,
       ENHANCED_SYM_DECRYPT(
         USE_WRAPPED_KEYSET('acs:kms:cn-beijing:189273228874****:key/key-bjj6527b6c6465hsf****', 
                              'acs:ram::189273228874****:role/mf-secr', 
                              unhex('613256354C574A71616A59314D6A64694E6D4D324E44593161484E6D65576732595331315A586435646D4678596A6C36555437693738632B647070524B46334E5263497567384A6B36716C4E54354133734F6E4776376258453132524E6C4B6E5163703859787132536C6D794F6E4A6975797541745448374F6B5132412B4B6947502F4A7530756477694B736B503033576643726E45646D666F6F324D61774F7A452F4F55314A51643268397941384F6B425644665A59746D3968775576536E543744684276723773464A714A47394D7770765064484B6A457A6F4A3533716E57766F4339634639413348556E433641434A6438444170583275326B2B4177776941487668575279304941445031373461794A2F50773D3D')
                             ),
       	 ENHANCED_SYM_ENCRYPT(
           USE_WRAPPED_KEYSET('acs:kms:cn-beijing:189273228874****:key/key-bjj6527b6c6465hsf****', 
                              'acs:ram::189273228874****:role/mf-secr', 
                              unhex('613256354C574A71616A59314D6A64694E6D4D324E44593161484E6D65576732595331315A586435646D4678596A6C36555437693738632B647070524B46334E5263497567384A6B36716C4E54354133734F6E4776376258453132524E6C4B6E5163703859787132536C6D794F6E4A6975797541745448374F6B5132412B4B6947502F4A7530756477694B736B503033576643726E45646D666F6F324D61774F7A452F4F55314A51643268397941384F6B425644665A59746D3968775576536E543744684276723773464A714A47394D7770765064484B6A457A6F4A3533716E57766F4339634639413348556E433641434A6438444170583275326B2B4177776941487668575279304941445031373461794A2F50773D3D')
                             ),
           tel
       ),
       ''
      )
       as tel 
 FROM mf_test_data;

          Hasilnya sebagai berikut.

          +----+------+------+
| id | name | tel  |
+----+------+------+
| 1  | kyle | 13900001234 |
| 2  | tom  | 13900001111 |
+----+------+------+