All Products
Search
Document Center

E-MapReduce:Gunakan penyedia kredensial OSS JindoFS

Last Updated:Mar 26, 2026

Penyedia kredensial OSS JindoFS menyimpan kredensial AccessKey yang telah dienkripsi dalam file konfigurasi sehingga mencegahnya terekspos dalam bentuk teks biasa. Mulai dari SmartData 3.4.0, Anda dapat mengonfigurasi satu atau beberapa penyedia secara global (untuk semua bucket) atau per bucket OSS.

Persyaratan versi

ProviderVersi SmartData minimum
TemporaryAliyunCredentialsProvider3.4.0
SimpleAliyunCredentialsProvider3.4.0
EnvironmentVariableCredentialsProvider3.4.0
JindoCommonCredentialsProvider3.4.0
EcsStsCredentialsProvider3.4.0
JindoRangerCredentialsProvider3.8.0
AssumeRoleStsCredentialsProvider3.8.0

Pilih penyedia kredensial

Pilih penyedia yang sesuai dengan metode autentikasi Anda:

ProviderKapan digunakan
TemporaryAliyunCredentialsProviderPasangan AccessKey berumur pendek ditambah token keamanan
SimpleAliyunCredentialsProviderPasangan AccessKey berumur panjang
EnvironmentVariableCredentialsProviderKredensial yang disimpan sebagai variabel lingkungan
JindoCommonCredentialsProviderKredensial bersama yang digunakan oleh JindoOSS dan JindoFS
EcsStsCredentialsProviderAkses tanpa password dari instance ECS (tidak memerlukan AccessKey)
JindoRangerCredentialsProviderAkses ke OSS yang dikontrol oleh Apache Ranger (SmartData 3.8.0+)
AssumeRoleStsCredentialsProviderKredensial temporary melalui Security Token Service (STS) dengan mengasumsikan peran Resource Access Management (RAM) (SmartData 3.8.0+)

Anda dapat menentukan beberapa penyedia sebagai daftar yang dipisahkan koma. Sistem akan mencoba setiap penyedia secara berurutan dan menggunakan penyedia pertama yang mengembalikan kredensial valid. Contohnya:

com.aliyun.emr.fs.auth.TemporaryAliyunCredentialsProvider,com.aliyun.emr.fs.auth.SimpleAliyunCredentialsProvider,com.aliyun.emr.fs.auth.EnvironmentVariableCredentialsProvider

Konfigurasi penyedia kredensial

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

  • Kluster EMR yang menjalankan SmartData 3.4.0 atau versi lebih baru

  • Akses ke Konsol Alibaba Cloud EMR

Langkah 1: Buka tab Konfigurasi SmartData

  1. Masuk ke Konsol Alibaba Cloud EMR.

  2. Pada bilah navigasi atas, pilih wilayah tempat kluster Anda berada dan pilih kelompok sumber daya.

  3. Klik tab Cluster Management.

  4. Temukan kluster Anda dan klik Details pada kolom Actions.

  5. Pada panel navigasi kiri, pilih Cluster Service > SmartData.

  6. Klik tab Configure.

Langkah 2: Tambahkan konfigurasi penyedia

Pilih cakupan konfigurasi:

  • Global (seluruh bucket): Pada bagian Configuration Filter di tab smartdata-site, temukan parameter fs.jfs.cache.oss.credentials.provider dan tambahkan nama kelas provider ke dalam nilainya.

  • Tingkat bucket: Di pojok kanan atas tab smartdata-site, klik Custom Configuration. Pada kotak dialog Add Configuration Item, atur Key menjadi fs.jfs.cache.oss.bucket.<bucket-name>.credentials.provider dan Value menjadi nama kelas penyedia.

    Catatan

    Ganti <bucket-name> dengan nama bucket OSS.

    Penting

    Jika Anda menggunakan JindoRangerCredentialsProvider, tambahkan konfigurasi pada tab namespace alih-alih tab smartdata-site.

Kemudian tambahkan parameter yang diperlukan untuk penyedia tersebut. Lihat Referensi penyedia untuk daftar lengkap parameternya.

Langkah 3: Simpan konfigurasi

  1. Di pojok kanan atas bagian Service Configuration, klik Save.

  2. Pada kotak dialog Confirm Changes, masukkan deskripsi dan aktifkan Auto-update Configuration.

  3. Klik OK.

Referensi penyedia

TemporaryAliyunCredentialsProvider

Gunakan untuk pasangan AccessKey berumur pendek dan token keamanan.

Nama kelas: com.aliyun.emr.fs.auth.TemporaryAliyunCredentialsProvider

Tambahkan parameter berikut pada tab smartdata-site:

Konfigurasi global

ParameterDeskripsi
fs.jfs.cache.oss.accessKeyIdID AccessKey
fs.jfs.cache.oss.accessKeySecretRahasia AccessKey
fs.jfs.cache.oss.securityTokenToken keamanan temporary

Konfigurasi tingkat bucket

ParameterDeskripsi
fs.jfs.cache.oss.bucket.<bucket-name>.accessKeyIdID AccessKey
fs.jfs.cache.oss.bucket.<bucket-name>.accessKeySecretRahasia AccessKey
fs.jfs.cache.oss.bucket.<bucket-name>.securityTokenToken keamanan temporary

SimpleAliyunCredentialsProvider

Gunakan untuk pasangan AccessKey berumur panjang.

Nama kelas: com.aliyun.emr.fs.auth.SimpleAliyunCredentialsProvider

Tambahkan parameter berikut pada tab smartdata-site:

Konfigurasi global

ParameterDeskripsi
fs.jfs.cache.oss.accessKeyIdID AccessKey
fs.jfs.cache.oss.accessKeySecretRahasia AccessKey

Konfigurasi tingkat bucket

ParameterDeskripsi
fs.jfs.cache.oss.bucket.<bucket-name>.accessKeyIdID AccessKey
fs.jfs.cache.oss.bucket.<bucket-name>.accessKeySecretRahasia AccessKey

EnvironmentVariableCredentialsProvider

Gunakan ketika kredensial disimpan sebagai variabel lingkungan pada node kluster.

Nama kelas: com.aliyun.emr.fs.auth.EnvironmentVariableCredentialsProvider

Atur variabel lingkungan berikut:

VariabelDeskripsi
ALIYUN_ACCESS_KEY_IDID AccessKey
ALIYUN_ACCESS_KEY_SECRETRahasia AccessKey
ALIYUN_SECURITY_TOKENToken keamanan temporary. Diperlukan hanya jika token memiliki periode validitas.

JindoCommonCredentialsProvider

Penyedia serbaguna yang berfungsi di JindoOSS dan JindoFS.

Nama kelas: com.aliyun.emr.fs.auth.JindoCommonCredentialsProvider

Tambahkan parameter berikut pada tab smartdata-site. Parameter ini berlaku untuk cakupan konfigurasi global maupun tingkat bucket.

ParameterDeskripsi
jindo.common.accessKeyIdID AccessKey
jindo.common.accessKeySecretRahasia AccessKey
jindo.common.securityTokenToken keamanan temporary

EcsStsCredentialsProvider

Gunakan untuk akses tanpa password dari instance ECS. Tidak diperlukan pasangan AccessKey.

Nama kelas: com.aliyun.emr.fs.auth.EcsStsCredentialsProvider

Tidak diperlukan parameter tambahan.

JindoRangerCredentialsProvider

Gunakan ketika Apache Ranger mengontrol akses ke OSS. Memerlukan SmartData 3.8.0 atau versi lebih baru.

Nama kelas: com.aliyun.emr.fs.auth.JindoRangerCredentialsProvider

Pada tab namespace, tambahkan parameter kustom berikut:

ParameterNilai
namespace.oss.permission.methodranger

Setelah menambahkan parameter, restart Jindo Namespace Service. Lihat Restart Jindo Namespace Service.

AssumeRoleStsCredentialsProvider

Gunakan untuk mengakses OSS dengan kredensial temporary yang diperoleh dengan mengasumsikan peran RAM melalui STS. Memerlukan SmartData 3.8.0 atau versi lebih baru.

Nama kelas: com.aliyun.emr.fs.auth.AssumeRoleStsCredentialsProvider

Tambahkan parameter berikut pada tab smartdata-site:

ParameterDeskripsi
assume.role.sts.accessKeyIdID AccessKey yang diperoleh dari STS
assume.role.sts.accessKeySecretRahasia AccessKey yang diperoleh dari STS
assume.role.sts.endpointTitik akhir STS. Lihat Endpoints.
assume.role.roleArnNama Sumber Daya Alibaba Cloud (ARN) dari peran RAM, dalam format acs:ram::<accountID>:role/<roleName>. Untuk melihat ARN, lihat Bagaimana cara melihat ARN peran RAM?
assume.role.roleSessionNameNama sesi peran. Atur ke identifikasi apa pun, seperti username.

Restart Jindo Namespace Service

Jika Anda menggunakan JindoRangerCredentialsProvider, restart Jindo Namespace Service setelah menambahkan konfigurasi.

  1. Pada tab Configure halaman layanan SmartData, klik Actions di pojok kanan atas dan pilih Restart Jindo Namespace Service.

  2. Pada kotak dialog Cluster Activities, masukkan deskripsi dan klik OK.

  3. Pada pesan konfirmasi, klik OK.