ای میل بھیجتے وقت مائیکروسافٹ گراف API کی تنظیم سے TenantGuidNotFound کی خرابی کو حل کرنا

مائیکروسافٹ گراف API ای میل بھیجنے کی خرابیوں کا ازالہ کرنا

کا سامنا کرنا OrganizationFromTenantGuidNotFound خرابی۔ کے ساتھ ای میل بھیجنے کی کوشش کرتے وقت مائیکروسافٹ گراف API مایوس کن ہو سکتا ہے، خاص طور پر جب یہ اہم کام کے بہاؤ کو روکتا ہے۔ اس خرابی کا عام طور پر مطلب یہ ہے کہ API فراہم کردہ کرایہ دار GUID کی بنیاد پر ایک درست کرایہ دار کا پتہ نہیں لگا سکا۔

یہ مسئلہ پیچیدہ معلوم ہوسکتا ہے، لیکن یہ عام طور پر کنفیگریشن کی ترتیبات سے متعلق ہوتا ہے، خاص طور پر آپ کے ارد گرد Azure AD کرایہ دار سیٹ اپ یا تصدیق کی تفصیلات۔ یہ سمجھنا کہ اس خرابی کو کیا متحرک کرتا ہے اسے مؤثر طریقے سے حل کرنے کی کلید ہے۔

اس گائیڈ میں، ہم OrganizationFromTenantGuidNotFound کی خرابی کے عام اسباب اور ان کا تدارک کرنے کا طریقہ دیکھیں گے۔ ہم آپ کی تصدیق کرنے کا طریقہ دریافت کریں گے۔ کرایہ دار کی شناخت، توثیق کے پیرامیٹرز کو چیک کریں، اور اجازتوں کی توثیق کریں۔

درست ٹربل شوٹنگ کے اقدامات کے ساتھ، آپ اپنی API کالز کو ٹریک پر واپس لا سکتے ہیں اور ہموار ای میل بھیجنے کی فعالیت کو یقینی بنا سکتے ہیں۔ آئیے اس بات پر غور کریں کہ اس خرابی کی وجہ کیا ہے اور اسے حل کرنے کے اقدامات۔

مائیکروسافٹ گراف API کی توثیق میں کرایہ دار کی غلطیوں کو حل کرنا

کا استعمال کرتے وقت فراہم کردہ اسکرپٹ ایک عام مسئلہ کو حل کرتے ہیں۔ مائیکروسافٹ گراف API ای میلز بھیجنے کے لیے: OrganizationFromTenantGuidNotFound ایرر۔ یہ خرابی اس وقت ہوتی ہے جب API دیئے گئے کرایہ دار ID سے وابستہ کرایہ دار کو تلاش کرنے میں ناکام ہو جاتا ہے۔ اس کو حل کرنے کے لیے، ہم پی ایچ پی کا استعمال کرتے ہیں۔ عام فراہم کنندہ توثیق کے بہاؤ کو سنبھالنے کے لیے OAuth2 کلائنٹ پیکج سے کلاس۔ GenericProvider ضروری ہے کیونکہ یہ Microsoft کے OAuth2 اینڈ پوائنٹس سے جڑنے کی پیچیدگی کو ختم کرتا ہے، جس سے ڈویلپرز کو کلائنٹ کی اسناد، کرایہ دار ID، اور ٹوکنز تک رسائی کے لیے ضروری یو آر ایل کی وضاحت کرنے دیتا ہے۔ ترتیب کلائنٹ ID، کلائنٹ سیکرٹ، ری ڈائریکٹ URI، اور مائیکروسافٹ کی شناختی سروس کے مطابق بنائے گئے اختتامی نکات کا استعمال کرتی ہے، سیٹ اپ کے عمل کو آسان بناتی ہے۔

پہلی مثال میں، ہم اجازت دینے والے URL کو بنانے پر توجہ مرکوز کرتے ہیں، جس میں صارفین کو لاگ ان کرنے اور ای میل بھیجنے کے دائرہ کار کی اجازت دینے کی ضرورت ہوتی ہے۔ getAuthorizationUrl فنکشن اس URL کو مخصوص اسکوپس جیسے 'openid'، 'email'، اور 'offline_access' کے ساتھ تخلیق کرتا ہے۔ URL میں 'state' پیرامیٹر، base64_encode اور json_encode کا استعمال کرتے ہوئے تیار کیا گیا، سیشن کے لیے مخصوص معلومات کو انکوڈنگ کر کے ایک اضافی حفاظتی پرت کا اضافہ کرتا ہے۔ یہ OAuth بہاؤ کی سالمیت کو یقینی بناتے ہوئے کراس سائٹ ریکوئسٹ فورجی (CSRF) حملوں سے بچاتا ہے۔ نتیجے میں آنے والا اجازت نامہ یو آر ایل صارفین کو مائیکروسافٹ کے لاگ ان صفحہ پر بھیجے گا، اور انہیں مخصوص اجازتوں کی اجازت دینے کا اشارہ دے گا۔ کامیاب لاگ ان ہونے پر، مائیکروسافٹ صارفین کو اجازت کے کوڈ کے ساتھ ری ڈائریکٹ URI پر بھیجتا ہے، جسے ایپلیکیشن ایک رسائی ٹوکن کے بدلے کر سکتی ہے۔

ایسے معاملات کے لیے جن میں براہ راست درخواست کی ضرورت ہوتی ہے، دوسرا اسکرپٹ استعمال کرتا ہے۔ cURL API تعامل کے لیے۔ ٹوکن کی درخواست کو دستی طور پر بنا کر، ہم لائبریریوں کی ضرورت کو نظرانداز کرتے ہیں، اسے ہلکے وزن یا جانچ کے منظرناموں کے لیے مثالی بناتے ہیں۔ اسکرپٹ پیرامیٹرز جیسے client_id، client_secret، اور grant_type کو POST ڈیٹا کے طور پر http_build_query فنکشن کا استعمال کرتے ہوئے سیٹ کرتا ہے، جو ڈیٹا کو URL کے محفوظ فارمیٹ میں انکوڈ کرتا ہے۔ ٹوکن کی درخواست کو پھر curl_init اور curl_setopt کا استعمال کرتے ہوئے مناسب OAuth2 اینڈ پوائنٹ پر بھیجا جاتا ہے، ہیڈرز، HTTP طریقوں اور ڈیٹا فیلڈز کو ہینڈل کرنے کے لیے ترتیب دیا گیا ہے۔ curl_exec پر عمل درآمد درخواست بھیجتا ہے، اور اس کے نتیجے میں آنے والا جواب (ایکسیس ٹوکن یا غلطی کی تفصیلات پر مشتمل) کو Microsoft Graph API میں مزید درخواستوں کے لیے استعمال کیا جا سکتا ہے۔

مزید برآں، ہم نے ہر اسکرپٹ کی توثیق کرنے کے لیے یونٹ ٹیسٹ شامل کیے ہیں۔ پہلا یونٹ ٹیسٹ چیک کرتا ہے کہ آیا تیار کردہ اجازت نامہ URL میں Microsoft کا لاگ ان ڈومین شامل ہے، URL فارمیٹ کی تصدیق کرتا ہے۔ ایک اور ٹیسٹ اس بات کو یقینی بناتا ہے کہ cURL کی درخواستیں ناکام نہیں ہوتی ہیں، تصدیق کے اختتامی نقطہ سے کامیاب کنکشن کی تصدیق کرتی ہے۔ یہ ٹیسٹ اس بات کا اعتماد فراہم کرتے ہیں کہ کنفیگریشنز درست طریقے سے سیٹ کی گئی ہیں اور API کی درخواستیں فعال ہیں، جو کہ پیداواری ماحول میں اہم ہے۔ لائبریری پر مبنی اور دستی دونوں درخواستوں کو سنبھال کر، یہ اسکرپٹ اور ٹیسٹ Microsoft کے گراف API کے ساتھ تصدیق کرنے کے لیے مضبوط اختیارات پیش کرتے ہیں، جس سے لچک، خرابی سے نمٹنے، اور ماڈیولر ڈیزائن کی اجازت ملتی ہے جو مختلف پروجیکٹ کی ضروریات کے مطابق ہو سکتے ہیں۔

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

مائیکروسافٹ گراف API توثیق میں کرایہ دار GUID کے مسائل کو سمجھنا

دی OrganizationFromTenantGuidNotFound مائیکروسافٹ گراف API میں خرابی عام طور پر اس بات کی نشاندہی کرتی ہے کہ API کی درخواست کے دوران بیان کردہ کرایہ دار GUID Azure AD ڈائرکٹری میں واقع نہیں ہوسکتا ہے۔ یہ اکثر غلط کنفیگر شدہ کرایہ دار IDs یا Microsoft Graph API انضمام کے غلط سیٹ اپ کے نتیجے میں ہوتا ہے۔ Microsoft Azure میں ہر کرایہ دار کے پاس ایک منفرد شناخت کنندہ ہوتا ہے جسے کرایہ دار GUID کہا جاتا ہے، جو اس بات کو یقینی بناتا ہے کہ درخواستیں درست تنظیمی سیاق و سباق کی طرف بھیجی جائیں۔ اگر کرایہ دار GUID غلط ہے یا غائب ہے، تو Microsoft Graph API تنظیم کا پتہ نہیں لگا سکتا، جس کے نتیجے میں تصدیق ناکام ہو جاتی ہے۔ API کی درخواستوں میں کرایہ دار GUID کے کردار کو سمجھنا ایسے مسائل کو جلد حل کرنے کی کلید ہے۔

درست سیٹ اپ کو یقینی بنانے میں تصدیق کرنا شامل ہے۔ کرایہ دار کی شناخت Azure Active Directory میں اور اس بات کی تصدیق کرنا کہ یہ آپ کی ایپلیکیشن کی تصدیق کی ترتیبات میں ترتیب سے میل کھاتا ہے۔ بعض اوقات، ڈویلپرز غلطی سے کرایہ دار GUID کے بجائے ڈائریکٹری ID یا ایپلیکیشن ID استعمال کرتے ہیں، جس سے یہ مسئلہ پیدا ہوتا ہے۔ مزید برآں، مائیکروسافٹ گراف API میں ملٹی کرایہ دار سیٹ اپ کا استعمال کرنے کے لیے دوسرے کرایہ داروں کے ڈیٹا تک رسائی کے لیے اجازتوں کی وضاحت کی ضرورت ہوتی ہے۔ اجازتوں کو درست طریقے سے ترتیب دینے یا صحیح GUID کی وضاحت کرنے میں ناکامی API کے ذریعے ڈیٹا تک رسائی یا بھیجنے کی کوشش کرتے وقت خرابیوں کا باعث بن سکتی ہے۔

Azure AD کے اندر رسائی کنٹرول کی پالیسیوں کا جائزہ لینا بھی مفید ہے، کیونکہ منتظمین صارف کے کردار یا حفاظتی پالیسیوں کی بنیاد پر مخصوص وسائل تک رسائی کو محدود کر سکتے ہیں۔ مثال کے طور پر، کچھ صارفین کے پاس مخصوص کارروائیاں کرنے کی اجازت کی کمی ہو سکتی ہے اگر ان کا اکاؤنٹ محدود رسائی والے گروپ کا حصہ ہے۔ لہذا، Azure AD کے اندر GUID کی ترتیبات اور کردار کی اجازت دونوں کی تصدیق ضروری ہے۔ اگر مسائل برقرار رہتے ہیں تو، کرایہ داروں کی تشکیلات پر مائیکروسافٹ کی دستاویزات کی جانچ کرنا کثیر کرایہ دار ایپلی کیشنز کے تقاضوں پر اضافی وضاحت فراہم کر سکتا ہے، جس سے ڈویلپرز کو ان غلطیوں سے بچنے میں مدد مل سکتی ہے جو ان کے ورک فلو میں خلل ڈالتی ہیں۔