Muokkaa

Jaa

Configure terms of service and privacy statement for an app

  • Artikkeli

Developers who build and manage multi-tenant apps that integrate with Microsoft Entra ID and Microsoft accounts should include links to the app's terms of service and privacy statement. The terms of service and privacy statement are surfaced to users through the user consent experience. They help your users know that they can trust your app. The terms of service and privacy statement are especially critical for user-facing multi-tenant apps--apps that are used by multiple directories or are available to any Microsoft account.

You are responsible for creating the terms of service and privacy statement documents for your app, and for providing the URLs to these documents. For multi-tenant apps that fail to provide these links, the user consent experience for your app will show an alert, which may discourage users from consenting to your app.

Note

  • The terms of service and privacy statement links are not applicable to single-tenant apps
  • If one or both of the two links are missing, your app will show an alert.

The following example shows the user consent experience for a multi-tenant app when the terms of service and privacy statement are configured and when these links are not configured.

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

Before you add links to your app's terms of service and privacy statement documents, make sure the URLs follow these guidelines.

Guideline Description
Format Valid URL
Valid schemas HTTP and HTTPS
We recommend HTTPS
Max length 2048 characters

Examples: https://myapp.com/terms-of-service and https://myapp.com/privacy-statement

When the terms of service and privacy statement are ready, you can add links to these documents in your app using one of these methods:

Using the Microsoft Entra admin center

Tip

Steps in this article might vary slightly based on the portal you start from.

Follow these steps to add links:

  1. Sign in to the Microsoft Entra admin center as at least an Application Developer.
  2. Browse to Identity > User experiences > Company branding.
  3. Select Getting started, and then select Edit for the Default sign-in experience.
  4. Select Footer and fill out the URL for Terms of Use and Privacy & Cookies.
  5. Select Review + save.

Using the app object JSON

If you prefer to modify the app object JSON directly, you can use the manifest editor to include links to your app's terms of service and privacy statement.

  1. Navigate to the App Registrations section and select your app.
  2. Open the Manifest pane.
  3. Ctrl+F, Search for "informationalUrls". Fill in the information.
  4. Save your changes by downloading the app manifest, modifying it, and uploading it.
    "informationalUrls": { 
        "termsOfService": "<your_terms_of_service_url>", 
        "privacy": "<your_privacy_statement_url>" 
    }

Using the Microsoft Graph API

To programmatically update your app, you can use the Microsoft Graph API to update all your apps to include links to the terms of service and privacy statement documents.

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 
    }
}

Note

  • Be careful not to overwrite any pre-existing values you have assigned to any of these fields: supportUrl, marketingUrl, and logoUrl
  • The Microsoft Graph API only works when you sign in with a Microsoft Entra account. Personal Microsoft accounts are not supported.