Servicevoorwaarden en privacyverklaring voor een app configureren

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 gebruikers weergegeven via de gebruikerstoestemmingservaring. Ze helpen uw gebruikers te weten dat ze uw app kunnen vertrouwen. De servicevoorwaarden en privacyverklaring zijn met name essentieel voor 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 het verstrekken van de URL's aan deze documenten. Voor apps met meerdere tenants die deze koppelingen niet kunnen verstrekken, wordt in de gebruikerstoestemmingservaring voor uw app een waarschuwing weergegeven, waardoor gebruikers mogelijk geen toestemming kunnen geven voor uw app.

Notitie

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

Gebruikerstoestemmingservaring

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

Links naar de documenten voor de servicevoorwaarden en privacyverklaring

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

Richtlijn	Beschrijving
Formaat	Geldige URL
Geldige schema's	HTTP en HTTPS HTTPS wordt aangeraden
Maximale lengte	2048 tekens

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

Koppelingen toevoegen aan de servicevoorwaarden en privacyverklaring

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

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

Het Microsoft Entra-beheercentrum gebruiken

Volg deze stappen om koppelingen toe te voegen:

1. Meld u aan bij het Microsoft Entra-beheercentrum als minimaal een Applicatieontwikkelaar.
2. Blader naar Identiteit>Gebruikerservaringen>Bedrijfsbranding.
3. Selecteer Aan de slagen selecteer Bewerken voor de Standaard aanmeldingservaring.
4. Selecteer voettekst en vul de URL in voor gebruiksvoorwaarden en Privacy & Cookies.
5. Selecteer Controleren enopslaan.

De 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. Ga naar de sectie App-registraties en selecteer uw app.
2. Open het Manifest deelvenster.
3. Ctrl+F, zoek 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 ervoor dat u geen vooraf bestaande waarden overschrijft die u hebt toegewezen aan een van deze velden: supportUrl, marketingUrlen logoUrl
• De Microsoft Graph API werkt alleen wanneer u zich aanmeldt met een Microsoft Entra-account. Persoonlijke Microsoft-accounts worden niet ondersteund.