Bagikan melalui

Mulai cepat menginstal Pratinjau Azure Data Manager for Agriculture

  • Artikel

Gunakan dokumen ini untuk memulai langkah-langkah menginstal Data Manager for Agriculture. Pastikan ID langganan Azure Anda ada dalam daftar izin kami. Microsoft Azure Data Manager for Agriculture memerlukan pendaftaran dan hanya tersedia untuk pelanggan dan mitra yang disetujui selama periode pratinjau. Untuk meminta akses ke Azure Data Manager for Agriculture selama periode pratinjau, gunakan formulir ini.

Catatan

Microsoft Azure Data Manager for Agriculture saat ini dalam pratinjau. Untuk persyaratan hukum yang berlaku untuk fitur yang beta, dalam pratinjau, atau belum dirilis ke ketersediaan umum, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

Microsoft Azure Data Manager for Agriculture memerlukan pendaftaran dan hanya tersedia untuk pelanggan dan mitra yang disetujui selama periode pratinjau. Untuk meminta akses ke Microsoft Data Manager for Agriculture selama periode pratinjau, gunakan formulir ini.

1: Mendaftarkan penyedia sumber daya

Ikuti langkah 1-5 dalam dokumentasi Penyedia Sumber Daya.

Pada langkah 5 dalam dokumentasi di atas, cari Microsoft.AgFoodPlatform dan daftarkan yang sama.

2: Cari di marketplace

Penting

Akses Portal Microsoft Azure menggunakan tautan ini . Tautan ini memungkinkan visibilitas kartu penginstalan Azure Data Manager for Agriculture di Marketplace untuk pelanggan pratinjau kami.

Masukkan Manajer data untuk pertanian di bilah pencarian marketplace. Kemudian pilih 'buat' pada petak daftar seperti yang ditunjukkan di bawah ini.

Cuplikan layar memperlihatkan daftar manajer data di marketplace.

3: Membuat Data Manager untuk instans Pertanian

Berikan detail yang diperlukan untuk membuat instans Azure Data Manager for Agriculture dan grup sumber daya di wilayah yang dipilih. Sediakan rincian berikut:

  • ID Langganan : Pilih ID langganan yang diizinkan untuk penyewa Anda
  • Grup Sumber Daya: Pilih grup sumber daya yang sudah ada atau buat yang baru
  • Nama Instans: Beri nama instans Data Manager for Agriculture
  • Wilayah: Pilih wilayah tempat Anda ingin instans disebarkan
  • Tag: Pilih untuk mengategorikan sumber daya dengan tag

Setelah memberikan detail dan menerima syarat dan ketentuan, pilih "tinjau + buat" diikuti dengan tombol buat. Ini memulai proses penyebaran sumber daya Azure Data Manager for Agriculture.

Cuplikan layar memperlihatkan manajer data untuk alur pembuatan sumber daya pertanian pada portal Azure.

4: Pendaftaran aplikasi Azure

Anda dapat mengakses sumber daya Data Manager for Agriculture melalui aplikasi yang terdaftar di MICROSOFT Entra ID. Gunakan portal Azure untuk Pendaftaran aplikasi, ini memungkinkan platform identitas Microsoft menyediakan layanan autentikasi dan otorisasi untuk aplikasi Anda yang mengakses Data Manager for Agriculture.

Ikuti langkah-langkah yang disediakan dalam PendaftaranAplikasi hingga langkah 8 untuk menghasilkan informasi berikut:

  • ID aplikasi (klien)
  • ID direktori (tenant)
  • Nama Aplikasi

Tuliskan ketiga nilai ini, Anda akan membutuhkannya di langkah berikutnya.

ID Aplikasi (klien) yang dibuat seperti ID Pengguna aplikasi, dan sekarang Anda perlu membuat kata sandi Aplikasi (rahasia klien) yang sesuai agar aplikasi mengidentifikasi dirinya sendiri.

Ikuti langkah-langkah yang disediakan di Menambahkan rahasia klien untuk menghasilkan Rahasia Klien dan salin rahasia klien yang dihasilkan.

5: Penetapan peran

Setelah pendaftaran Aplikasi selesai, langkah selanjutnya adalah menetapkan peran dalam portal Azure untuk memberikan Otorisasi ke aplikasi yang baru dibuat. Manajer Data untuk Pertanian menggunakan Azure RBAC untuk mengelola permintaan Otorisasi.

Masuk ke portal Azure dan navigasikan ke sumber daya yang baru dibuat (<Name>-resource-name dibuat di langkah 5) di bawah grup sumber daya (resource-group-name).

Catatan

Di dalam tab grup sumber daya, jika Anda tidak menemukan sumber daya Data Manager for Agriculture yang dibuat, Anda perlu mengaktifkan kotak centang tampilkan jenis tersembunyi untuk melihat sumber daya Data Manager for Agriculture yang Anda buat.

Pilih tab sumber daya Azure Data Manager for Agriculture, Anda dapat menemukan opsi menu IAM di sisi kiri panel opsi seperti yang ditunjukkan pada gambar:

Cuplikan layar memperlihatkan penetapan peran di Manajer data.

Pilih Tambahkan > penetapan peran, dan ini membuka panel di sisi kanan portal, pilih salah satu dari tiga peran dari menu dropdown:

  • Admin Layanan Platform AgFood - memiliki semua hak istimewa dalam operasi CRUD (Buat, Baca, Perbarui, dan Hapus).
  • Kontributor Layanan Platform AgFood - memiliki hak istimewa terbatas dalam operasi CRUD (Tidak dapat menghapus).
  • Pembaca Layanan Platform AgFood - hanya memiliki akses ke operasi baca.

Untuk menyelesaikan penetapan peran, lakukan langkah-langkah berikut:

  1. Pilih peran dari tiga peran yang disebutkan di atas.

  2. Pilih Pengguna, grup, atau perwakilan layanan di bagian Tetapkan akses ke.

  3. Tempelkan Nama Aplikasi yang baru dibuat di bagian Pilih (seperti yang ditunjukkan pada gambar di bawah).

  4. Pilih Simpan untuk menetapkan peran.

Cuplikan layar memperlihatkan pilihan aplikasi untuk otorisasi.

Ini memastikan bahwa Aplikasi (terdaftar di langkah sebelumnya) telah diberikan akses (berdasarkan peran yang ditetapkan) ke Azure Data Manager untuk Sumber Daya Pertanian.

Catatan

Anda perlu membuat tiga Aplikasi (Pendaftaran aplikasi) yang berbeda untuk dapat menetapkan ketiga peran (Admin, Kontributor, dan Pembaca).

6: Membuat token akses

Langkah selanjutnya adalah menghasilkan token akses, yang berisi kredensial keamanan yang diperlukan untuk mengidentifikasi aplikasi terhadap penetapan Peran Azure yang dilakukan pada langkah sebelumnya.

Untuk mengakses REST API Azure Data Manager for Agriculture dengan perwakilan layanan, Anda perlu mendapatkan token akses Microsoft Entra untuk perwakilan layanan.

Ganti parameter berikut dalam permintaan:

Parameter Deskripsi
ID Penyewa ID Penyewa di ID Microsoft Entra yang dihasilkan dalam pendaftaran aplikasi (langkah 1)
ID klien ID aplikasi (perwakilan layanan) aplikasi yang Anda daftarkan
Rahasia Klien Rahasia yang dihasilkan untuk aplikasi.

Parameter resource adalah pengidentifikasi untuk aplikasi login Azure Data Manager for Agriculture. Pengidentifikasi ini adalah nilai konstanta yang diatur ke https://farmbeats.azure.net.

Untuk Bash:

curl -X POST -H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials&client_id=<client-id>&resource=https://farmbeats.azure.net&client_secret=<application-secret>' \
https://login.microsoftonline.com/<tenant-id>/oauth2/token

Untuk PowerShell:

$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("Content-Type", "application/x-www-form-urlencoded")
$body = "grant_type=client_credentials&client_id=<client-id>&client_secret=<application-secret>&resource=https%3A%2F%2Ffarmbeats.azure.net"
$response = Invoke-RestMethod 'https://login.microsoftonline.com/<tenant-id>/oauth2/token' -Method 'POST' -Headers $headers -Body $body
$response | ConvertTo-Json

Respons akan terlihat seperti ini:

{
  "token_type": "Bearer",
  "expires_in": "3599",
  "ext_expires_in": "3599",
  "expires_on": "1622530779",
  "not_before": "1622526879",
  "resource": "https://farmbeats.azure.net",
  "access_token": "eyJ0eXAiOiJKV1QiLC......tpZCI6InZhcF9"
}

Dengan titik akhir API yang berfungsi (instanceUri) dan access_token, Anda sekarang dapat mulai membuat permintaan ke API layanan kami. Jika ada kueri dalam menyiapkan lingkungan, ajukan permintaan dukungan untuk mendapatkan bantuan yang diperlukan.

Langkah berikutnya