Servicevoorwaarden en privacyverklaring configureren voor een app

Ontwikkelaars die apps met meerdere tenants bouwen en beheren die kunnen worden geïntegreerd met Microsoft Entra ID en Microsoft-accounts, moeten koppelingen naar de servicevoorwaarden en privacyverklaring van de app bevatten. De servicevoorwaarden en privacyverklaring worden aan de gebruikers weergegeven via de gebruikerstoestemming. Ze laten uw gebruikers weten dat ze uw app kunnen vertrouwen. De servicevoorwaarden en privacyverklaring zijn met name essentieel voor de gebruikersgerichte apps met meerdere tenants, apps die worden gebruikt door meerdere mappen of die beschikbaar zijn voor elk Microsoft-account.

U bent verantwoordelijk voor het maken van de servicevoorwaarden en privacyverklaringsdocumenten voor uw app en voor verstrekken van de URL's aan deze documenten. Voor apps met meerdere tenants die deze koppelingen niet bieden, wordt in de gebruikerstoestemmingservaring voor uw app een waarschuwing weergegeven, waardoor de gebruikers geen toestemming kunnen geven voor uw app.

Notitie

• De koppelingen naar de servicevoorwaarden en privacyverklaring zijn niet van toepassing op apps met één tenant
• Als een of beide koppelingen ontbreken, dan wordt in uw app een waarschuwing weergegeven.

De gebruikerstoestemmingservaring

In het volgende voorbeeld ziet u de gebruikerstoestemmingservaring voor een app met meerdere tenants wanneer de servicevoorwaarden en privacyverklaring zijn geconfigureerd en als deze koppelingen niet zijn geconfigureerd.

De opmaak van koppelingen naar de documenten van de servicevoorwaarden en privacyverklaring

Voordat u de koppelingen toevoegt naar de servicevoorwaarden en privacyverklaring van uw app, moet u zorgen dat de URL's aan deze richtlijnen voldoen.

Richtlijn	Beschrijving
Notatie	Geldig URL
De geldige schema's	HTTP en HTTPS Wij raden HTTPS aan
Maximumlengte	2048 tekens

De voorbeelden: https://myapp.com/terms-of-service en https://myapp.com/privacy-statement

De koppelingen toevoegen aan de servicevoorwaarden en privacyverklaring

Wanneer de servicevoorwaarden en privacyverklaring gereed zijn, kunt u de koppelingen naar deze documenten in uw app toevoegen met behulp van een van deze methoden:

• Via het Microsoft Entra-beheercentrum
• JSON van het app-object gebruiken
• De Microsoft Graph API gebruiken

Het Microsoft Entra-beheercentrum gebruiken

Tip

Stappen in dit artikel kunnen enigszins variëren op basis van de portal waaruit u begint.

Volg deze stappen om koppelingen toe te voegen:

1. Meld u als toepassingsontwikkelaar aan bij het Microsoft Entra-beheercentrum.
2. Blader naar de huisstijl van het bedrijf voor identiteitsgebruikerservaringen>>.
3. Selecteer Aan de slag en selecteer Vervolgens Bewerken voor de standaard aanmeldingservaring.
4. Selecteer Voettekst en vul de URL in voor gebruiksvoorwaarden en privacy & cookies.
5. Selecteer Beoordelen en opslaan.

JSON van het app-object gebruiken

Als u de JSON van het app-object liever rechtstreeks wijzigt, kunt u de manifesteditor gebruiken om koppelingen naar de servicevoorwaarden en privacyverklaring van uw app op te nemen.

1. Navigeer naar de sectie App-registraties en selecteer uw app.
2. Open het venster Manifest.
3. Ctrl+F, zoek dan naar 'informationalUrls'. Vul de gegevens in.
4. Sla uw wijzigingen op door het app-manifest te downloaden, te wijzigen en te uploaden.

    "informationalUrls": { 
        "termsOfService": "<your_terms_of_service_url>", 
        "privacy": "<your_privacy_statement_url>" 
    }

De Microsoft Graph API gebruiken

Als u uw app programmatisch wilt bijwerken, kunt u de Microsoft Graph API gebruiken om al uw apps bij te werken om koppelingen naar de servicevoorwaarden en privacyverklaringsdocumenten op te nemen.

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

Notitie

• Zorg dat u geen vooraf bestaande waarden overschrijft die u hebt toegewezen aan een van deze velden: supportUrl, marketingUrl en logoUrl
• De Microsoft Graph API werkt alleen wanneer u zich aanmeldt met een Microsoft Entra-account. Persoonlijke Microsoft-accounts worden nooit ondersteund.