ईमेल भेजते समय Microsoft Graph API की OrganisationFromTenantGuidNotFound त्रुटि का समाधान करना

Microsoft ग्राफ़ एपीआई ईमेल भेजने में त्रुटि का निवारण

का सामना करना पड़ रहा है OrganizationFromTenantGuidNotFound त्रुटि के साथ एक ईमेल भेजने का प्रयास करते समय माइक्रोसॉफ्ट ग्राफ़ एपीआई निराशा हो सकती है, खासकर जब यह महत्वपूर्ण वर्कफ़्लो को रोक देता है। इस त्रुटि का आम तौर पर मतलब है कि एपीआई प्रदान किए गए किरायेदार GUID के आधार पर एक वैध किरायेदार का पता नहीं लगा सका।

यह समस्या जटिल लग सकती है, लेकिन यह आमतौर पर कॉन्फ़िगरेशन सेटिंग्स से संबंधित है, विशेष रूप से आपके आस-पास Azure AD टैनेंट सेटअप या प्रमाणीकरण विवरण। यह समझना कि इस त्रुटि का कारण क्या है, इसे कुशलतापूर्वक हल करने की कुंजी है।

इस गाइड में, हम OrganisationFromTenantGuidNotFound त्रुटि के सामान्य कारणों और उनसे निपटने के तरीके के बारे में जानेंगे। हम यह पता लगाएंगे कि आपका सत्यापन कैसे किया जाए किरायेदार आईडी, प्रमाणीकरण मापदंडों की जांच करें, और अनुमतियों को मान्य करें।

सही समस्या निवारण चरणों के साथ, आप अपने एपीआई कॉल को वापस ट्रैक पर ला सकते हैं और सुचारू ईमेल भेजने की कार्यक्षमता सुनिश्चित कर सकते हैं। आइए जानें कि इस त्रुटि का कारण क्या है और इसे हल करने के चरण क्या हैं।

Microsoft ग्राफ़ API प्रमाणीकरण में किरायेदार को नहीं मिली त्रुटियों का समाधान करना

उपयोग करते समय प्रदान की गई स्क्रिप्ट एक सामान्य समस्या का समाधान करती है माइक्रोसॉफ्ट ग्राफ़ एपीआई ईमेल भेजने के लिए:OrganizationFromTenantGuidNotFound त्रुटि। यह त्रुटि तब होती है जब एपीआई दिए गए किरायेदार आईडी से जुड़े किरायेदार का पता लगाने में विफल रहता है। इसे हल करने के लिए हम PHP का उपयोग करते हैं जेनेरिकप्रदाता प्रमाणीकरण प्रवाह को संभालने के लिए OAuth2 क्लाइंट पैकेज से क्लास। जेनेरिकप्रोवाइडर आवश्यक है क्योंकि यह माइक्रोसॉफ्ट के OAuth2 एंडपॉइंट से जुड़ने की जटिलता को दूर करता है, जिससे डेवलपर्स को क्लाइंट क्रेडेंशियल्स, टेनेंट आईडी और टोकन को अधिकृत करने और एक्सेस करने के लिए आवश्यक यूआरएल निर्दिष्ट करने की सुविधा मिलती है। कॉन्फ़िगरेशन क्लाइंट आईडी, क्लाइंट सीक्रेट, रीडायरेक्ट यूआरआई और माइक्रोसॉफ्ट की पहचान सेवा के अनुरूप एंडपॉइंट का उपयोग करता है, जो सेटअप प्रक्रिया को सरल बनाता है।

पहले उदाहरण में, हम प्राधिकरण यूआरएल उत्पन्न करने पर ध्यान केंद्रित करते हैं, जिसमें उपयोगकर्ताओं को लॉग इन करने और ईमेल भेजने के दायरे के लिए अनुमति देने की आवश्यकता होती है। GetAuthorizationUrl फ़ंक्शन इस URL को 'ओपनआईडी', 'ईमेल' और 'ऑफ़लाइन_एक्सेस' जैसे विशिष्ट क्षेत्रों के साथ बनाता है। बेस64_एनकोड और json_encode का उपयोग करके उत्पन्न यूआरएल में 'स्टेट' पैरामीटर, सत्र-विशिष्ट जानकारी को एन्कोड करके एक अतिरिक्त सुरक्षा परत जोड़ता है। यह OAuth प्रवाह की अखंडता को सुनिश्चित करते हुए, क्रॉस-साइट अनुरोध जालसाजी (CSRF) हमलों से बचाता है। परिणामी प्राधिकरण URL उपयोगकर्ताओं को Microsoft के लॉगिन पृष्ठ पर निर्देशित करेगा, और उन्हें निर्दिष्ट अनुमतियों की अनुमति देने के लिए प्रेरित करेगा। सफल लॉगिन पर, माइक्रोसॉफ्ट उपयोगकर्ताओं को एक प्राधिकरण कोड के साथ रीडायरेक्ट यूआरआई पर रीडायरेक्ट करता है, जिसे एप्लिकेशन एक्सेस टोकन के लिए एक्सचेंज कर सकता है।

अधिक प्रत्यक्ष अनुरोध की आवश्यकता वाले मामलों के लिए, दूसरी स्क्रिप्ट का उपयोग किया जाता है कर्ल एपीआई इंटरैक्शन के लिए. मैन्युअल रूप से टोकन अनुरोध बनाकर, हम पुस्तकालयों की आवश्यकता को दरकिनार कर देते हैं, जिससे यह हल्के या परीक्षण परिदृश्यों के लिए आदर्श बन जाता है। स्क्रिप्ट http_build_query फ़ंक्शन का उपयोग करके POST डेटा के रूप में क्लाइंट_आईडी, क्लाइंट_सीक्रेट और ग्रांट_टाइप जैसे पैरामीटर सेट करती है, जो डेटा को यूआरएल-सुरक्षित प्रारूप में एन्कोड करता है। फिर टोकन अनुरोध को हेडर, HTTP विधियों और डेटा फ़ील्ड को संभालने के लिए कॉन्फ़िगर किए गए कर्ल_इनिट और कर्ल_सेटॉप का उपयोग करके उचित OAuth2 एंडपॉइंट पर भेजा जाता है। कर्ल_एक्सईसी को निष्पादित करने से अनुरोध भेजा जाता है, और परिणामी प्रतिक्रिया (एक्सेस टोकन या त्रुटि विवरण युक्त) का उपयोग माइक्रोसॉफ्ट ग्राफ़ एपीआई में आगे के अनुरोधों के लिए किया जा सकता है।

इसके अतिरिक्त, हमने प्रत्येक स्क्रिप्ट को मान्य करने के लिए यूनिट परीक्षण शामिल किए हैं। प्रथम इकाई परीक्षण यह जांचता है कि जेनरेट किए गए प्राधिकरण यूआरएल में माइक्रोसॉफ्ट का लॉगिन डोमेन शामिल है या नहीं, यूआरएल प्रारूप की पुष्टि करता है। एक अन्य परीक्षण यह सुनिश्चित करता है कि प्रमाणीकरण समापन बिंदु पर एक सफल कनेक्शन की पुष्टि करते हुए, कर्ल अनुरोध विफल नहीं होते हैं। ये परीक्षण विश्वास प्रदान करते हैं कि कॉन्फ़िगरेशन सही ढंग से सेट हैं और एपीआई अनुरोध कार्यात्मक हैं, जो उत्पादन वातावरण में महत्वपूर्ण है। लाइब्रेरी-आधारित और मैन्युअल दोनों अनुरोधों को संभालकर, ये स्क्रिप्ट और परीक्षण माइक्रोसॉफ्ट के ग्राफ़ एपीआई के साथ प्रमाणीकरण के लिए मजबूत विकल्प प्रदान करते हैं, लचीलेपन, त्रुटि प्रबंधन और मॉड्यूलर डिज़ाइन की अनुमति देते हैं जो विभिन्न परियोजना आवश्यकताओं के अनुकूल हो सकते हैं।

$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))
]);

$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);

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 ग्राफ़ एपीआई प्रमाणीकरण में किरायेदार GUID मुद्दों को समझना

संगठनFromTenantGuidNotFound Microsoft ग्राफ़ एपीआई में त्रुटि आमतौर पर इंगित करती है कि एपीआई अनुरोध के दौरान निर्दिष्ट किरायेदार GUID Azure AD निर्देशिका में स्थित नहीं हो सकता है। यह अक्सर गलत कॉन्फ़िगर की गई टैनेंट आईडी या Microsoft ग्राफ़ एपीआई एकीकरण के अनुचित सेटअप के परिणामस्वरूप होता है। Microsoft Azure में प्रत्येक किरायेदार के पास एक अद्वितीय पहचानकर्ता होता है जिसे किरायेदार GUID के रूप में जाना जाता है, जो यह सुनिश्चित करता है कि अनुरोध सही संगठनात्मक संदर्भ में निर्देशित हैं। यदि किरायेदार GUID अमान्य या अनुपलब्ध है, तो Microsoft ग्राफ़ API संगठन का पता नहीं लगा सकता है, जिसके परिणामस्वरूप प्रमाणीकरण विफलता हो सकती है। एपीआई अनुरोधों में किरायेदार GUID की भूमिका को समझना ऐसे मुद्दों को शीघ्रता से हल करने की कुंजी है।

सही सेटअप सुनिश्चित करने में सत्यापन करना शामिल है किरायेदार आईडी Azure सक्रिय निर्देशिका में और यह पुष्टि करना कि यह आपके एप्लिकेशन की प्रमाणीकरण सेटिंग्स में कॉन्फ़िगरेशन से मेल खाता है। कभी-कभी, डेवलपर गलती से टैनेंट GUID के बजाय निर्देशिका आईडी या एप्लिकेशन आईडी का उपयोग कर लेते हैं, जिससे यह समस्या उत्पन्न होती है। इसके अतिरिक्त, Microsoft ग्राफ़ एपीआई में मल्टी-टेनेंट सेटअप का उपयोग करने के लिए अन्य किरायेदारों के डेटा तक पहुंचने के लिए अनुमति निर्दिष्ट करने की आवश्यकता होती है। अनुमतियों को सही ढंग से कॉन्फ़िगर करने या सही GUID निर्दिष्ट करने में विफलता से एपीआई के माध्यम से डेटा तक पहुंचने या भेजने का प्रयास करते समय त्रुटियां हो सकती हैं।

Azure AD के भीतर पहुंच नियंत्रण नीतियों की समीक्षा करना भी उपयोगी है, क्योंकि प्रशासक उपयोगकर्ता भूमिकाओं या सुरक्षा नीतियों के आधार पर कुछ संसाधनों तक पहुंच को प्रतिबंधित कर सकते हैं। उदाहरण के लिए, यदि कुछ उपयोगकर्ताओं का खाता प्रतिबंधित पहुंच समूह का हिस्सा है, तो उनके पास विशिष्ट कार्य करने की अनुमति की कमी हो सकती है। इसलिए, Azure AD के भीतर GUID सेटिंग्स और भूमिका अनुमतियाँ दोनों को सत्यापित करना आवश्यक है। यदि समस्याएँ बनी रहती हैं, तो किरायेदार कॉन्फ़िगरेशन पर Microsoft के दस्तावेज़ की जाँच करने से बहु-किरायेदार अनुप्रयोगों के लिए आवश्यकताओं पर अतिरिक्त स्पष्टता मिल सकती है, जिससे डेवलपर्स को उन त्रुटियों से बचने में मदद मिलेगी जो उनके वर्कफ़्लो को बाधित करती हैं।