解决发送电子邮件时 Microsoft Graph API 的 OrganizationFromTenantGuidNotFound 错误

处理 Microsoft Graph API 中的 OrganizationFromTenantGuidNotFound 错误

使用 GenericProvider 和 Microsoft Graph API 的 PHP 脚本

$provider = new GenericProvider([
    'clientId' => $config['microsoft']['clientId'],
    'clientSecret' => $config['microsoft']['clientSecret'],
    'redirectUri' => $redirectUrl,
    'urlAuthorize' => $config['microsoft']['loginBaseUrl'] . "/" . $config['microsoft']['tenantId'] . "/oauth2/v2.0/authorize",
    'urlAccessToken' => $config['microsoft']['loginBaseUrl'] . "/" . $config['microsoft']['tenantId'] . "/oauth2/v2.0/token",
    'urlResourceOwnerDetails' => "https://graph.microsoft.com/v1.0/me",
]);

$scope = 'openid email profile https://graph.microsoft.com/.default offline_access';
$authUrl = $provider->getAuthorizationUrl([
    'scope' => $scope,
    'state' => base64_encode(json_encode($state))
]);

使用 cURL 进行直接 API 请求的替代解决方案

基于 cURL 的发送 Microsoft Graph API 请求的解决方案

$tenantId = $config['microsoft']['tenantId'];
$clientId = $config['microsoft']['clientId'];
$clientSecret = $config['microsoft']['clientSecret'];

$url = "https://login.microsoftonline.com/{$tenantId}/oauth2/v2.0/token";
$headers = ['Content-Type: application/x-www-form-urlencoded'];
$body = http_build_query([
    'client_id' => $clientId,
    'client_secret' => $clientSecret,
    'scope' => "https://graph.microsoft.com/.default",
    'grant_type' => "client_credentials"
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

使用单元测试测试和验证脚本

用于验证 Microsoft Graph API 集成的 PHPUnit 测试

use PHPUnit\Framework\TestCase;
class MicrosoftGraphAPITest extends TestCase {
    public function testAuthorizationUrl() {
        global $provider, $scope, $state;
        $authUrl = $provider->getAuthorizationUrl(['scope' => $scope, 'state' => $state]);
        $this->assertStringContainsString("https://login.microsoftonline.com", $authUrl);
    }

    public function testCurlResponse() {
        global $ch;
        $response = curl_exec($ch);
        $this->assertNotFalse($response);
    }
}

有关 Microsoft Graph API 租户错误的常见问题

1. OrganizationFromTenantGuidNotFound 错误是什么意思？
2. 此错误意味着 Microsoft Graph API 无法在 Azure Active Directory 中找到指定的租户。这可能是由于租户 GUID 无效或缺失造成的。
3. 如何在 Azure AD 中验证我的租户 GUID？
4. 您可以通过登录 Azure 门户、导航到 Azure Active Directory 并检查租户属性以获得正确的 GUID 来验证租户 GUID。
5. 不正确的权限会导致 OrganizationFromTenantGuidNotFound 错误吗？
6. 是的，权限不足可能会阻止对租户的访问。确保正确设置和授予 API 权限，并且角色与 Microsoft Graph API 所需的访问级别相匹配。
7. 为什么我需要 base64_encode 我的脚本中的命令？
8. 这 base64_encode 命令有助于对 OAuth 请求中的状态数据进行安全编码，从而针对跨站点请求伪造 (CSRF) 攻击添加额外的保护层。
9. 尽管拥有正确的租户 GUID，但如果出现错误，我应该检查什么？
10. 除了 GUID 之外，请确认 Azure AD 中的应用程序注册和权限符合 Microsoft Graph API 请求的要求。
11. 我可以在不指定租户 GUID 的情况下使用 Microsoft Graph API 吗？
12. 在单租户应用程序中，租户 GUID 直接在配置中指定。如果权限和配置设置正确，多租户应用程序可能不需要它。
13. 怎么样 GenericProvider 在 Microsoft Graph API 身份验证方面有帮助吗？
14. 这 GenericProvider 通过抽象 URL 管理并支持 Microsoft OAuth 端点的快速设置，简化了 OAuth2 实施。
15. 有没有办法在不使用 GenericProvider 的情况下手动获取访问令牌？
16. 是的，使用 cURL 命令允许您通过将客户端凭据发布到 Microsoft 的令牌端点来手动检索访问令牌。
17. Microsoft Graph API 的常见身份验证范围有哪些？
18. 常见范围包括 openid、email、profile、offline_access 和 https://graph.microsoft.com/.default，它们提供对各种数据点和权限的访问。
19. 如果 cURL 请求失败，如何排除故障？
20. 检查所有参数的格式是否正确，并验证标头，尤其是 Content-Type，以确保 API 以正确的格式接收请求。

关于解决 Microsoft Graph API 中租户错误的最终想法

处理诸如 OrganizationFromTenantGuidNotFound 之类的身份验证错误时，请确认正确的租户 ID 配置 Azure 活动目录 是必不可少的。这通常可以快速解决连接问题。正确的身份验证设置可以产生重大影响。

使用经过测试的方法，例如 通用提供者 或 cURL，帮助开发人员确保 API 请求顺利进行，同时利用正确的权限和设置进行多租户访问。通过执行这些步骤，大多数用户可以快速解决问题并继续与 Microsoft Graph 集成。