通过REST API获取租户的所有域

时间:2014-11-06 08:48:18

标签: sharepoint ms-office office365 azure-active-directory onedrive

我想知道是否有办法通过REST API为Sharepoint / Office365检索租户的注册域名。

考虑这种情况;

我有一个名为 abc.pqr 的租户和"我的"网站(OneDrive) abc-my.sharepoint.com

现在,当我为此租户创建用户时,UI面板提供了为此帐户选择域的选项。可用选项是;

1) @abc.pqr
2) @abc.onmicrosoft.com

现在,问题是,如果我有这种用户>>> testUser@abc.onmicrosoft.com ,如何找到此租户的注册域名?在我的情况下, abc.pqr

有没有办法通过REST API找到它?

1 个答案:

答案 0 :(得分:3)

您希望了解的是Azure Active Directory租户中已验证域的列表。 (Azure AD是Office 365和其他Microsoft在线服务背后的目录服务。)

Azure AD Graph API - AAD的REST API - 可以为您提供此功能。在您的情况下,您想要的GET请求是:

https://graph.windows.net/abc.onmicrosoft.com/tenantDetails

注意:您可以使用租户ID或租户的任何已验证域,而不是abc.onmicrosoft.com。租户ID可以从访问令牌中的tid声明中获取。

JSON响应将包含以下内容:

  "verifiedDomains": [
    {
      "capabilities": "None",
      "default": true,
      "id": "0007ABE0983098",
      "initial": false,
      "name": "abc.pqr",
      "type": "Managed"
    },
    {
      "capabilities": "Email, OfficeCommunicationsOnline",
      "default": false,
      "id": "0007ABE0983098",
      "initial": true,
      "name": "abc.onmicrosoft.com",
      "type": "Managed"
    }
  ]

(这是一个有用的Quickstart for the Azure AD Graph API,展示了如何开始使用AAD Graph API和GraphExplorer。)

如果您正在使用.NET,则会在https://github.com/AzureADSamples/WebApp-GraphAPI-DotNet处提供完整示例。 (https://github.com/AzureADSamples的其他语言和平台的更多示例。)