配置应用的服务条款和隐私声明
构建和管理与 Microsoft Entra ID 和 Microsoft 帐户集成的多租户应用的开发人员应包含指向应用服务条款和隐私声明的链接。 服务条款和隐私声明通过用户同意体验展示给用户。 它们可以帮助用户认识到他们可以信任你的应用。 对于面向用户的多租户应用(由多个目录使用的应用或面向所有 Microsoft 帐户提供的应用)来说,服务条款和隐私声明至关重要。
你负责为你的应用创建服务条款和隐私声明文档,并提供指向这些文档的 URL。 对于未能提供这些链接的多租户应用,你的应用的用户同意体验将显示一条警报,可能阻碍用户同意使用你的应用。
注意
- 服务条款和隐私声明链接不适用于单租户应用
- 如果缺少一个或两个两个链接,应用将显示警报。
用户同意体验
下面的示例分别展示已配置服务条款和隐私声明以及未配置这些链接时的多租户应用的用户同意体验。
设置链接格式指向服务条款和隐私声明文档
添加指向应用的服务条款和隐私声明的文档之前,请确保 URL 遵循以下准则。
准则 | 说明 |
---|---|
格式 | 有效的 URL |
有效的架构 | HTTP 和 HTTPS 建议使用 HTTPS |
最大长度 | 2048 个字符 |
示例:https://myapp.com/terms-of-service
和 https://myapp.com/privacy-statement
添加指向服务条款和隐私声明的链接
服务条款和隐私声明准备就绪后,可以在应用中使用这些方法之一添加指向这些文档的链接:
使用 Microsoft Entra 管理中心
提示
本文中的步骤可能因开始使用的门户而略有不同。
按照以下步骤添加链接:
- 至少以应用程序开发人员的身份登录到 Microsoft Entra 管理中心。
- 浏览到“标识”>“用户体验”>“公司品牌”。
- 选择“入门”,然后选择“编辑”以获取默认登录体验。
- 选择“页脚”并填写“使用条款”和“隐私与 Cookie”的 URL。
- 选择“查看 + 保存”。
使用应用对象 JSON
如果想要直接修改应用对象 JSON,可以使用清单编辑器来包含指向应用的服务条款和隐私声明的链接。
- 导航到“应用注册”部分并选择应用 。
- 打开“清单”窗格。
- 按 Ctrl+F,搜索“informationalUrls”。 填写信息。
- 通过下载、修改和上传应用清单来保存更改。
"informationalUrls": {
"termsOfService": "<your_terms_of_service_url>",
"privacy": "<your_privacy_statement_url>"
}
使用 Microsoft Graph API
若要以编程方式更新应用,可以使用 Microsoft Graph API 更新所有应用,以包含指向服务条款和隐私声明文档的链接。
PATCH https://microsoftgraph.chinacloudapi.cn/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
}
}
注意
- 请注意不要覆盖已分配给以下任何字段的任何预先存在的值:
supportUrl
marketingUrl
和logoUrl
- 仅在使用 Microsoft Entra 帐户登录时,Microsoft Graph API 才会正常工作。 不支持 Microsoft 个人帐户。