Konfigurasikan persyaratan layanan dan pernyataan privasi untuk aplikasi

Artikel
12/15/2023

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 multi-penyewa yang dihadapi pengguna - aplikasi yang digunakan oleh beberapa direktori atau tersedia untuk akun Microsoft apa pun.

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

Catatan

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

Contoh berikut menunjukkan pengalaman izin pengguna untuk aplikasi multi-tenant saat ketentuan layanan dan pernyataan privasi dikonfigurasi dan saat tautan ini tidak dikonfigurasi.

Screenshots with and without a privacy statement and terms of service provided

Memformat link ke persyaratan layanan dan dokumen pernyataan privasi

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

Pedoman	Deskripsi
Format	URL yang Sahih
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

Menambahkan link ke persyaratan layanan dan pernyataan privasi

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

Melalui pusat admin Microsoft Entra
Menggunakan objek aplikasi JSON
Menggunakan Microsoft Graph API

Menggunakan pusat admin Microsoft Entra

Tip

Langkah-langkah dalam artikel ini mungkin sedikit berbeda berdasarkan portal tempat Anda memulai.

Ikuti langkah-langkah ini untuk menambahkan tautan:

Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.
Telusuri pengalaman >Pengguna Identitas>Branding perusahaan.
Pilih Memulai, lalu pilih Edit untuk pengalaman masuk Default.
Pilih Footer dan isi URL untuk Ketentuan Penggunaan dan Privasi & Cookie.
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.

Buka bagian Pendaftaran Aplikasi dan pilih aplikasi Anda.
Buka panel Manifes.
Ctrl+F, Cari "informationalUrls". Isi informasinya.
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 
    }
}