Konfigurowanie warunków użytkowania usługi i zasad zachowania poufności informacji dla aplikacji

Deweloperzy, którzy tworzą aplikacje wielodostępne, które integrują się z identyfikatorem Microsoft Entra ID i kontami Microsoft, powinni dołączać linki do warunków użytkowania aplikacji i zasad zachowania poufności informacji. Warunki korzystania z usług i zasad zachowania poufności informacji są udostępniane użytkownikom za pośrednictwem środowiska wyrażania zgody przez użytkownika. Pomagają oni użytkownikom wiedzieć, że mogą ufać Twojej aplikacji. Warunki korzystania z usług i zasad zachowania poufności informacji są szczególnie krytyczne dla aplikacji wielodostępnych dla użytkowników — aplikacji używanych przez wiele katalogów lub dostępnych dla dowolnego konta Microsoft.

Użytkownik jest odpowiedzialny za tworzenie dokumentów dotyczących warunków użytkowania usługi i zasad zachowania poufności informacji dla aplikacji oraz udostępnianie adresów URL tym dokumentom. W przypadku aplikacji wielodostępnych, które nie udostępniają tych linków, środowisko wyrażania zgody użytkownika dla aplikacji wyświetli alert, który może zniechęcać użytkowników do wyrażania zgody na aplikację.

Uwaga

• Linki do warunków korzystania z usług i zasad zachowania poufności informacji nie mają zastosowania do aplikacji z jedną dzierżawą
• Jeśli brakuje jednego lub obu linków, aplikacja wyświetli alert.

Środowisko zgody użytkownika

W poniższym przykładzie przedstawiono środowisko wyrażania zgody użytkownika dla aplikacji z wieloma dzierżawami, gdy warunki użytkowania usługi i zasady zachowania poufności informacji są skonfigurowane i gdy te linki nie są skonfigurowane.

Formatowanie linków do dokumentów dotyczących warunków użytkowania usługi i zasad zachowania poufności informacji

Przed dodaniem linków do dokumentów dotyczących warunków użytkowania usługi i zasad zachowania poufności informacji w aplikacji upewnij się, że adresy URL są zgodne z tymi wytycznymi.

Wytyczna	opis
Formatuj	Prawidłowy numer URL
Prawidłowe schematy	HTTP i HTTPS Zalecamy protokół HTTPS
Maksymalna długość	2048 znaków

Przykłady: https://myapp.com/terms-of-service i https://myapp.com/privacy-statement

Dodawanie linków do warunków użytkowania usługi i zasad zachowania poufności informacji

Gdy warunki użytkowania usługi i zasady zachowania poufności informacji są gotowe, możesz dodać linki do tych dokumentów w aplikacji przy użyciu jednej z następujących metod:

• Za pośrednictwem centrum administracyjnego firmy Microsoft Entra
• Korzystanie z pliku JSON obiektu aplikacji
• Korzystanie z interfejsu API programu Microsoft Graph

Korzystanie z centrum administracyjnego Microsoft Entra

Napiwek

Kroki opisane w tym artykule mogą się nieznacznie różnić w zależności od portalu, od którego zaczynasz.

Wykonaj następujące kroki, aby dodać linki:

1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra co najmniej jako deweloper aplikacji.
2. Przejdź do strony Identity>User experiences>Company branding (Obsługa znakowania firmowego w środowisku użytkownika tożsamości).
3. Wybierz pozycję Wprowadzenie, a następnie wybierz pozycję Edytuj dla środowiska logowania domyślnego.
4. Wybierz stopkę i wypełnij adres URL warunków użytkowania i prywatności i plików cookie.
5. Wybierz pozycję Przejrzyj i zapisz.

Korzystanie z pliku JSON obiektu aplikacji

Jeśli wolisz bezpośrednio zmodyfikować kod JSON obiektu aplikacji, możesz użyć edytora manifestu, aby dołączyć linki do warunków użytkowania usługi i zasad zachowania poufności informacji w aplikacji.

1. Przejdź do sekcji Rejestracje aplikacji i wybierz aplikację.
2. Otwórz okienko Manifest.
3. Ctrl+F, wyszukaj ciąg "informationalUrls". Wypełnij informacje.
4. Zapisz zmiany, pobierając manifest aplikacji, modyfikując go i przekazując.

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

Korzystanie z interfejsu API programu Microsoft Graph

Aby programowo zaktualizować aplikację, możesz użyć interfejsu API programu Microsoft Graph, aby zaktualizować wszystkie aplikacje w celu uwzględnienia linków do dokumentów dotyczących warunków usług i zasad zachowania poufności informacji.

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

Uwaga

• Należy zachować ostrożność, aby nie zastępować żadnych wstępnie istniejących wartości przypisanych do dowolnego z tych pól: supportUrl, marketingUrli logoUrl
• Interfejs API programu Microsoft Graph działa tylko po zalogowaniu się przy użyciu konta Microsoft Entra. Osobiste konta Microsoft nie są obsługiwane.