Configurare le condizioni d’uso del servizio e l'informativa sulla privacy per un’app

Gli sviluppatori che creano e gestiscono app multi-tenant integrate con Microsoft Entra ID e account Microsoft devono includere collegamenti alle condizioni d’uso del servizio e all'informativa sulla privacy dell'app. Le condizioni per l'utilizzo del servizio e l'informativa sulla privacy vengono presentate agli utenti tramite l'esperienza di consenso dell'utente e consentono agli utenti di sapere che possono considerare attendibile l'app. Le condizioni per l'utilizzo del servizio e l'informativa sulla privacy sono particolarmente importanti per le app multi-tenant rivolte all'utente, ovvero le app che vengono usate da più directory o sono disponibili per qualsiasi account Microsoft.

L'autore dell'app è responsabile della creazione dei documenti delle condizioni per l'utilizzo del servizio e dell'informativa sulla privacy per la propria app e della specifica degli URL per questi documenti. Per le app multi-tenant che non forniscono questi collegamenti, l'esperienza di consenso dell'utente per l'app visualizzerà un avviso, che potrebbe demotivare gli utenti a fornire il consenso per l'uso dell'app.

Nota

• I collegamenti alle condizioni d’uso e l'informativa sulla privacy non sono applicabili alle app a tenant singolo
• Se mancano uno o entrambi i collegamenti, l'app visualizzerà un avviso.

Esperienza di autorizzazione utente

L’esempio seguente mostra l'esperienza di consenso dell'utente per un’app multi-tenant quando le condizioni d’uso e l'informativa sulla privacy sono configurate e quando questi collegamenti non sono configurati.

Formattazione dei collegamenti ai documenti delle condizioni per l'utilizzo del servizio e dell'informativa sulla privacy

Prima di aggiungere collegamenti ai documenti delle condizioni per l'utilizzo del servizio e dell'informativa sulla privacy, assicurarsi che gli URL rispettino queste linee guida.

Linee guida	Descrizione
Formatta	URL valido
Schemi validi	HTTP e HTTPS Si consiglia HTTPS
Lunghezza massima	2048 caratteri

Esempi: https://myapp.com/terms-of-service e https://myapp.com/privacy-statement

Aggiunta di collegamenti per le condizioni per l'utilizzo del servizio e l'informativa sulla privacy

Quando le condizioni per l'utilizzo del servizio e l'informativa sulla privacy sono pronte, è possibile aggiungere collegamenti a questi documenti nell'app con uno dei metodi seguenti:

• Tramite l'interfaccia di amministrazione di Microsoft Entra
• Con il codice JSON dell'oggetto app
• Uso dell'API Microsoft Graph

Uso dell'interfaccia di amministrazione di Microsoft Entra

Suggerimento

La procedura descritta in questo articolo può variare leggermente in base al portale di partenza.

Per aggiungere collegamenti, seguire questa procedura:

1. Accedere all'interfaccia di amministrazione di Microsoft Entra almeno come sviluppatore di applicazioni.
2. Passare a Identità>Esperienza utente>Personalizzazione della società.
3. Selezionare Introduzione e quindi selezionare Modifica per l'esperienza di accesso predefinita.
4. Selezionare Piè di pagina e compilare l'URL per Condizioni d’uso e Privacy & cookie.
5. Selezionare Rivedi e salva.

Con il codice JSON dell'oggetto app

Se si preferisce modificare direttamente il codice JSON dell'oggetto app, è possibile usare l'editor per includere i collegamenti alle condizioni d’uso del servizio e all'informativa sulla privacy.

1. Passare alla sezione Registrazioni per l'app e selezionare l'app.
2. Aprire il riquadro Manifesto.
3. CTRL+F, Cercare "informationalUrls". Specifica le informazioni.
4. Salvare le modifiche scaricando il manifesto dell'app, modificandolo e caricandolo.

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

Uso dell'API Microsoft Graph

Per aggiornare le app a livello di programmazione, è possibile usarel’API Microsoft Graph per aggiornare tutte le app per includere collegamenti ai documenti delle condizioni d’uso e dell'informativa sulla privacy.

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

• Prestare attenzione a non sovrascrivere eventuali valori pre-esistenti assegnati a uno di questi campi: supportUrl, marketingUrl e logoUrl
• L'API Microsoft Graph funziona solo quando si accede con un account Microsoft Entra. Gli account Microsoft personali non sono supportati.