Mengonfigurasi ketentuan layanan dan pernyataan privasi untuk aplikasi

Pengembang yang membangun dan mengelola aplikasi multi-penyewa yang terintegrasi dengan ID Microsoft Entra dan akun Microsoft harus menyertakan tautan ke ketentuan layanan dan pernyataan privasi aplikasi. Ketentuan layanan dan pernyataan privasi dimunculkan kepada pengguna melalui pengalaman persetujuan pengguna. Mereka membantu pengguna Anda mengetahui bahwa mereka dapat mempercayai aplikasi Anda. Ketentuan layanan dan pernyataan privasi sangat penting untuk aplikasi yang berorientasi pengguna dan multi-tenant—aplikasi yang digunakan oleh beberapa direktori atau tersedia untuk semua akun Microsoft.

Anda bertanggung jawab untuk membuat dokumen ketentuan layanan dan pernyataan privasi untuk aplikasi Anda, dan untuk menyediakan URL ke dokumen-dokumen ini. Untuk aplikasi multi-penyewa yang gagal menyediakan tautan ini, pengalaman persetujuan pengguna untuk aplikasi Anda akan menampilkan pemberitahuan, yang dapat mencegah pengguna menyetujui aplikasi Anda.

Nota

  • Ketentuan layanan dan tautan pernyataan privasi tidak berlaku untuk aplikasi penyewa tunggal
  • Jika salah satu atau kedua tautan hilang, aplikasi Anda akan menampilkan pemberitahuan.

Contoh berikut menunjukkan pengalaman persetujuan pengguna untuk aplikasi multi-penyewa ketika ketentuan layanan dan pernyataan privasi sudah dikonfigurasi atau ketika tautan tersebut tidak dikonfigurasi.

Cuplikan layar dengan dan tanpa pernyataan privasi dan ketentuan layanan yang disediakan

Sebelum Anda menambahkan tautan ke dokumen ketentuan layanan dan pernyataan privasi aplikasi Anda, pastikan URL mengikuti panduan ini.

Pedoman Deskripsi
Rancangan Valid URL
Skema yang valid HTTP dan HTTPS
Kami merekomendasikan HTTPS
Panjang maksimum 2048 karakter

Contoh: https://myapp.com/terms-of-service dan https://myapp.com/privacy-statement

Ketika ketentuan layanan dan pernyataan privasi siap, Anda dapat menambahkan tautan ke dokumen-dokumen ini di aplikasi Anda menggunakan salah satu metode berikut:

Menggunakan pusat admin Microsoft Entra

Ikuti langkah-langkah ini untuk menambahkan tautan:

  1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.
  2. Telusuri ke Entra ID>Custom Branding.
  3. Pilih Memulai, lalu pilih Edit untuk pengalaman default masuk.
  4. Pilih Footer dan isi URL untuk Ketentuan Penggunaan dan Privasi & Cookie.
  5. Pilih Tinjau + simpan.

Menggunakan objek aplikasi JSON

Jika Anda lebih suka memodifikasi objek aplikasi JSON secara langsung, Anda dapat menggunakan editor manifes untuk menyertakan tautan ke ketentuan layanan dan pernyataan privasi aplikasi Anda.

  1. Buka bagian Pendaftaran Aplikasi dan pilih aplikasi Anda.
  2. Buka jendela Manifes.
  3. Ctrl+F, Cari "informationalUrls". Isi informasi.
  4. Simpan perubahan Anda dengan mengunduh manifes aplikasi, memodifikasinya, dan mengunggahnya.
    "informationalUrls": { 
        "termsOfService": "<your_terms_of_service_url>", 
        "privacy": "<your_privacy_statement_url>" 
    }

Menggunakan Microsoft Graph API

Untuk memperbarui aplikasi secara terprogram, Anda dapat menggunakan Microsoft Graph API untuk memperbarui semua aplikasi anda untuk menyertakan tautan ke dokumen ketentuan layanan dan pernyataan privasi.

PATCH https://graph.microsoft.com/v1.0/applications/{applicationObjectId}
{ 
    "appId": "{your application object id}", 
    "info": { 
        "termsOfServiceUrl": "<your_terms_of_service_url>", 
        "supportUrl": null, 
        "privacyStatementUrl": "<your_privacy_statement_url>", 
        "marketingUrl": null, 
        "logoUrl": null 
    }
}

Nota

  • Berhati-hatilah untuk tidak memperbarui nilai yang telah ada yang telah Anda tetapkan ke salah satu bidang ini: supportUrl, marketingUrl, dan logoUrl
  • Microsoft Graph API hanya berfungsi saat Anda masuk dengan akun Microsoft Entra. Akun Microsoft pribadi tidak didukung.
  • Last updated on