Mengonfigurasi sumber Microsoft Dataverse untuk CDC

Datastream memungkinkan Anda melakukan streaming data perubahan dari lingkungan Microsoft Dataverse ke tujuan yang didukung, seperti BigQuery atau Cloud Storage. Untuk menyiapkan sumber, Anda mendaftarkan klien OAuth 2.0 di Microsoft Entra ID, mengonfigurasi pengguna aplikasi Dataverse, dan mengizinkan alamat IP publik Datastream jika diperlukan.

Sebelum memulai

Sebelum mulai mengonfigurasi Dataverse untuk digunakan dengan Datastream, Anda harus:

  • Memiliki akses ke langganan Microsoft Azure aktif dengan izin untuk mengelola Azure Active Directory (AAD) dan Dataverse.
  • Memiliki lingkungan Dataverse aktif.
  • Memiliki pengetahuan tentang cara membuka dan mengubah setelan di Microsoft Azure Portal, Dataverse, dan Dynamics 365.
  • Memiliki izin untuk mendaftarkan aplikasi di AAD dan membuat atau menetapkan peran di Dataverse.

Mengonfigurasi lingkungan Microsoft Dataverse untuk digunakan dengan Datastream

Untuk membuat koneksi antara lingkungan Dataverse dan Datastream, Anda harus melakukan autentikasi menggunakan alur kredensial klien OAuth 2.0. Hal ini mengharuskan Anda mendaftarkan aplikasi di AAD dan mengonfigurasi pengguna aplikasi dalam Dataverse.

Mendaftarkan aplikasi di Azure Active Directory

Dataverse menggunakan AAD untuk autentikasi. Untuk mendaftarkan aplikasi, ikuti langkah-langkah berikut:

  1. Login ke Azure Portal dengan akun administrator.
  2. Di portal, buka Azure Active Directory > App registrations > New registration.

  3. Daftarkan aplikasi:

    1. Di bagian Application name, berikan nama untuk aplikasi Anda, misalnya, DatastreamDataverseConnector.
    2. Pilih jenis akun, biasanya, Accounts in this organizational directory only.
    3. Klik Register.

  4. Setelah pendaftaran, salin Application (client) ID dan Directory (tenant) ID dari halaman Overview ke lokasi yang aman untuk digunakan nanti. ID ini diperlukan untuk profil koneksi Datastream.

  5. Buat rahasia klien:

    1. Di setelan aplikasi terdaftar, buka Certificates & secrets > New client secret.
    2. Berikan deskripsi dan tetapkan tanggal habis masa berlaku untuk rahasia Anda.
    3. Klik Add.

  6. Salin nilai rahasia yang dibuat, karena hanya ditampilkan sekali. Anda memerlukan rahasia ini saat membuat profil koneksi Datastream.

  7. Tetapkan izin API:

    1. Buka API permissions > Add a permission.
    2. Pilih Microsoft APIs > Dynamics CRM.
    3. Pilih Application permissions.
    4. Klik Grant admin consent for your directory.

Mengonfigurasi pengguna aplikasi Dataverse

Buat pengguna aplikasi di Dataverse untuk mewakili aplikasi AAD.

  1. Login ke lingkungan Microsoft Dataverse Anda dengan hak istimewa administrator.
  2. Buka Settings > Security > Users.
  3. Ubah tampilan dari Enabled users menjadi Application users.
  4. Klik New untuk membuat pengguna aplikasi baru.
  5. Tempelkan Application (client) ID yang disalin dari AAD ke kolom ID aplikasi. Detail lainnya, seperti nama pengguna , akan otomatis diisi.
  6. Simpan data tersebut.

  7. Tetapkan peran keamanan:

    1. Buka data pengguna aplikasi yang baru dibuat.
    2. Klik Manage roles.
    3. Tetapkan peran keamanan yang sesuai yang memberikan izin baca yang diperlukan untuk tabel yang ingin Anda replikasi oleh Datastream. Sebaiknya gunakan peran kustom dengan izin baca minimum yang diperlukan pada tabel tertentu, bukan peran luas, seperti administrator sistem. Pastikan peran tersebut memiliki akses untuk membaca metadata tabel.

Pembatasan IP

Jika lingkungan atau jaringan Dataverse Anda memiliki batasan alamat IP, pastikan bahwa alamat IP publik Datastream diizinkan untuk terhubung ke URL lingkungan Dataverse Anda (misalnya, ORGANIZATION_NAME.crm.dynamics.com).

Langkah berikutnya