மைக்ரோசாஃப்ட் கிராஃப் ஏபிஐ அமைப்பிலிருந்து மின்னஞ்சலை அனுப்பும்போது கண்டறியப்படாத பிழையைத் தீர்க்கிறது

மைக்ரோசாஃப்ட் கிராஃப் ஏபிஐ மின்னஞ்சல் அனுப்பும் பிழைகளை சரிசெய்தல்

சந்திப்பது OrganizationFromTenantGuidNotFound பிழை உடன் மின்னஞ்சல் அனுப்ப முயற்சிக்கும்போது மைக்ரோசாஃப்ட் கிராஃப் ஏபிஐ குறிப்பாக முக்கியமான பணிப்பாய்வுகளை நிறுத்தும்போது, ​​வெறுப்பாக இருக்கலாம். இந்த பிழையானது பொதுவாக வழங்கப்பட்ட குத்தகைதாரர் GUID அடிப்படையில் சரியான குத்தகைதாரரை APIயால் கண்டறிய முடியவில்லை.

இந்தச் சிக்கல் சிக்கலானதாகத் தோன்றலாம், ஆனால் இது பொதுவாக உள்ளமைவு அமைப்புகளுடன் தொடர்புடையது, குறிப்பாக உங்களைச் சுற்றியுள்ளது Azure AD குத்தகைதாரர் அமைப்பு அல்லது அங்கீகார விவரங்கள். இந்தப் பிழையைத் தூண்டுவதைப் புரிந்துகொள்வது, அதைத் திறமையாகத் தீர்ப்பதற்கு முக்கியமாகும்.

இந்த வழிகாட்டியில், OrganisationFromTenantGuidNotFound பிழைக்கான பொதுவான காரணங்கள் மற்றும் அவற்றை எவ்வாறு நிவர்த்தி செய்வது என்பதை நாங்கள் காண்போம். உங்களுடையதை எவ்வாறு சரிபார்க்கலாம் என்பதை நாங்கள் ஆராய்வோம் குத்தகைதாரர் ஐடி, அங்கீகார அளவுருக்களை சரிபார்த்து, அனுமதிகளை சரிபார்க்கவும்.

சரியான சரிசெய்தல் படிகள் மூலம், உங்கள் API அழைப்புகளை மீண்டும் பாதையில் பெறலாம் மற்றும் மென்மையான மின்னஞ்சல் அனுப்பும் செயல்பாட்டை உறுதிசெய்யலாம். இந்த பிழைக்கான காரணம் என்ன மற்றும் அதைத் தீர்ப்பதற்கான படிகளைப் பார்ப்போம்.

மைக்ரோசாஃப்ட் கிராஃப் ஏபிஐ அங்கீகாரத்தில் குத்தகைதாரர் கண்டறியப்படாத பிழைகளைத் தீர்ப்பது

வழங்கப்பட்ட ஸ்கிரிப்டுகள் பயன்படுத்தும் போது ஒரு பொதுவான சிக்கலைக் குறிப்பிடுகின்றன மைக்ரோசாஃப்ட் கிராஃப் ஏபிஐ மின்னஞ்சல்களை அனுப்புவதற்கு: OrganizationFromTenantGuidNotFound பிழை. கொடுக்கப்பட்ட குத்தகைதாரர் ஐடியுடன் தொடர்புடைய குத்தகைதாரரை API கண்டறியத் தவறினால் இந்தப் பிழை ஏற்படுகிறது. இதைத் தீர்க்க, நாங்கள் PHPகளைப் பயன்படுத்துகிறோம் பொதுவான வழங்குநர் அங்கீகார ஓட்டத்தைக் கையாள OAuth2 கிளையன்ட் தொகுப்பிலிருந்து வகுப்பு. மைக்ரோசாப்டின் OAuth2 இறுதிப்புள்ளிகளுடன் இணைப்பதில் உள்ள சிக்கலை சுருக்கி, டோக்கன்களை அங்கீகரிப்பதற்கும் அணுகுவதற்கும் கிளையன்ட் நற்சான்றிதழ்கள், வாடகைதாரர் ஐடி மற்றும் அத்தியாவசிய URLகளை டெவலப்பர்கள் குறிப்பிட அனுமதிப்பதால் GenericProvider இன்றியமையாதது. உள்ளமைவு கிளையன்ட் ஐடி, கிளையன்ட் ரகசியம், திருப்பியனுப்புதல் URI மற்றும் மைக்ரோசாப்டின் அடையாள சேவைக்கு ஏற்றவாறு இறுதிப் புள்ளிகளைப் பயன்படுத்துகிறது, அமைவு செயல்முறையை எளிதாக்குகிறது.

முதல் எடுத்துக்காட்டில், பயனர்கள் உள்நுழைந்து மின்னஞ்சல் அனுப்பும் நோக்கங்களுக்கான அனுமதியை வழங்க வேண்டிய அங்கீகார URL ஐ உருவாக்குவதில் கவனம் செலுத்துகிறோம். getAuthorizationUrl செயல்பாடு இந்த URL ஐ 'openid', 'email' மற்றும் 'offline_access' போன்ற குறிப்பிட்ட நோக்கங்களுடன் உருவாக்குகிறது. URL இல் உள்ள 'state' அளவுரு, base64_encode மற்றும் json_encode ஐப் பயன்படுத்தி உருவாக்கப்படுகிறது, அமர்வு-குறிப்பிட்ட தகவலை குறியாக்கம் செய்வதன் மூலம் கூடுதல் பாதுகாப்பு அடுக்கைச் சேர்க்கிறது. OAuth ஓட்டத்தின் ஒருமைப்பாட்டை உறுதிசெய்து, குறுக்கு-தள கோரிக்கை மோசடி (CSRF) தாக்குதல்களுக்கு எதிராக இது பாதுகாக்கிறது. இதன் விளைவாக வரும் அங்கீகார URL, மைக்ரோசாப்டின் உள்நுழைவுப் பக்கத்திற்கு பயனர்களை வழிநடத்தும், குறிப்பிட்ட அனுமதிகளை அனுமதிக்கும்படி அவர்களைத் தூண்டும். வெற்றிகரமாக உள்நுழைந்தவுடன், மைக்ரோசாப்ட் பயனர்களை ஒரு அங்கீகாரக் குறியீட்டைக் கொண்டு URI ஐ வழிமாற்றுகிறது, இது பயன்பாடு அணுகல் டோக்கனுக்குப் பரிமாறிக்கொள்ளலாம்.

நேரடி கோரிக்கை தேவைப்படும் நிகழ்வுகளுக்கு, இரண்டாவது ஸ்கிரிப்ட் பயன்படுத்துகிறது சுருட்டு API தொடர்புக்கு. டோக்கன் கோரிக்கையை கைமுறையாக உருவாக்குவதன் மூலம், நூலகங்களின் தேவையைத் தவிர்த்து, எடை குறைந்த அல்லது சோதனைக் காட்சிகளுக்கு ஏற்றதாக ஆக்குகிறோம். ஸ்கிரிப்ட் http_build_query செயல்பாட்டைப் பயன்படுத்தி POST தரவாக கிளையன்ட்_ஐடி, கிளையன்ட்_சீக்ரெட் மற்றும் கிராண்ட்_டைப் போன்ற அளவுருக்களை அமைக்கிறது, இது தரவை URL-பாதுகாப்பான வடிவத்தில் குறியாக்குகிறது. டோக்கன் கோரிக்கையானது curl_init மற்றும் curl_setopt ஐப் பயன்படுத்தி பொருத்தமான OAuth2 இறுதிப் புள்ளிக்கு அனுப்பப்படும், தலைப்புகள், HTTP முறைகள் மற்றும் தரவுப் புலங்களைக் கையாளும் வகையில் கட்டமைக்கப்பட்டது. curl_exec ஐ இயக்குவது கோரிக்கையை அனுப்புகிறது, மேலும் இதன் விளைவாக வரும் பதில் (அணுகல் டோக்கன் அல்லது பிழை விவரங்கள் கொண்டது) Microsoft Graph API இல் மேலும் கோரிக்கைகளுக்குப் பயன்படுத்தப்படலாம்.

கூடுதலாக, ஒவ்வொரு ஸ்கிரிப்டையும் சரிபார்க்க யூனிட் சோதனைகளைச் சேர்த்துள்ளோம். உருவாக்கப்பட்ட அங்கீகார URL ஆனது Microsoft இன் உள்நுழைவு டொமைனை உள்ளடக்கியதா என்பதை முதல் அலகு சோதனை சரிபார்க்கிறது, URL வடிவமைப்பைச் சரிபார்க்கிறது. மற்றொரு சோதனை, கர்ல் கோரிக்கைகள் தோல்வியடையாமல் இருப்பதை உறுதிசெய்கிறது, இது அங்கீகார இறுதிப்புள்ளிக்கு வெற்றிகரமான இணைப்பை உறுதிப்படுத்துகிறது. இந்தச் சோதனைகள் கட்டமைப்புகள் சரியாக அமைக்கப்பட்டுள்ளன மற்றும் 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);
    }
}

மைக்ரோசாஃப்ட் கிராஃப் ஏபிஐ அங்கீகாரத்தில் குத்தகைதாரர் வழிகாட்டி சிக்கல்களைப் புரிந்துகொள்வது

தி நிறுவனத்தில் இருந்து குத்தகைதாரர் வழிகாட்டி காணப்படவில்லை மைக்ரோசாஃப்ட் கிராஃப் ஏபிஐயில் உள்ள பிழை பொதுவாக ஏபிஐ கோரிக்கையின் போது குறிப்பிடப்பட்ட குத்தகைதாரர் ஜியுஐடியை அஸூர் ஏடி கோப்பகத்தில் இருக்க முடியாது என்பதைக் குறிக்கிறது. இது பெரும்பாலும் தவறாக உள்ளமைக்கப்பட்ட குத்தகைதாரர் ஐடிகள் அல்லது மைக்ரோசாஃப்ட் கிராஃப் ஏபிஐ ஒருங்கிணைப்பின் முறையற்ற அமைப்பால் விளைகிறது. மைக்ரோசாஃப்ட் அஸூரில் உள்ள ஒவ்வொரு குத்தகைதாரரும் குத்தகைதாரர் GUID எனப்படும் தனித்துவமான அடையாளங்காட்டியைக் கொண்டுள்ளனர், இது கோரிக்கைகள் சரியான நிறுவன சூழலுக்கு அனுப்பப்படுவதை உறுதி செய்கிறது. குத்தகைதாரர் GUID தவறானது அல்லது காணவில்லை என்றால், Microsoft Graph API நிறுவனத்தைக் கண்டறிய முடியாது, இதன் விளைவாக அங்கீகாரம் தோல்வியடையும். API கோரிக்கைகளில் குத்தகைதாரர் GUID இன் பங்கைப் புரிந்துகொள்வது, இதுபோன்ற சிக்கல்களை விரைவாகத் தீர்ப்பதற்கு முக்கியமாகும்.

சரியான அமைப்பை உறுதிசெய்வது சரிபார்ப்பதை உள்ளடக்கியது குத்தகைதாரர் ஐடி அசூர் ஆக்டிவ் டைரக்டரியில் மற்றும் அது உங்கள் பயன்பாட்டின் அங்கீகார அமைப்புகளில் உள்ள உள்ளமைவுடன் பொருந்துகிறது என்பதை உறுதிப்படுத்துகிறது. சில நேரங்களில், டெவலப்பர்கள் குத்தகைதாரர் GUIDக்குப் பதிலாக அடைவு ஐடி அல்லது பயன்பாட்டு ஐடியைத் தவறாகப் பயன்படுத்துகிறார்கள், இது இந்தச் சிக்கலுக்கு வழிவகுக்கும். கூடுதலாக, மைக்ரோசாஃப்ட் கிராஃப் ஏபிஐயில் பல குத்தகைதாரர் அமைப்பைப் பயன்படுத்த, மற்ற குத்தகைதாரர்களின் தரவை அணுகுவதற்கான அனுமதிகளைக் குறிப்பிட வேண்டும். அனுமதிகளை சரியாக உள்ளமைக்கத் தவறினால் அல்லது சரியான GUID ஐக் குறிப்பிடத் தவறினால், API வழியாக தரவை அணுக அல்லது அனுப்ப முயற்சிக்கும்போது பிழைகள் ஏற்படலாம்.

பயனர் பாத்திரங்கள் அல்லது பாதுகாப்புக் கொள்கைகளின் அடிப்படையில் சில ஆதாரங்களுக்கான அணுகலை நிர்வாகிகள் கட்டுப்படுத்தலாம் என்பதால், Azure AD க்குள் அணுகல் கட்டுப்பாட்டுக் கொள்கைகளை மதிப்பாய்வு செய்வதும் பயனுள்ளதாக இருக்கும். உதாரணமாக, சில பயனர்கள் தங்கள் கணக்கு தடைசெய்யப்பட்ட அணுகல் குழுவின் பகுதியாக இருந்தால், குறிப்பிட்ட செயல்களைச் செய்வதற்கான அனுமதிகள் இல்லாமல் இருக்கலாம். எனவே, Azure AD க்குள் GUID அமைப்புகள் மற்றும் பங்கு அனுமதிகள் இரண்டையும் சரிபார்ப்பது அவசியம். சிக்கல்கள் தொடர்ந்தால், குத்தகைதாரர் உள்ளமைவுகளில் மைக்ரோசாஃப்ட் ஆவணங்களைச் சரிபார்ப்பது, பல குத்தகைதாரர் பயன்பாடுகளுக்கான தேவைகள் குறித்த கூடுதல் தெளிவை அளிக்கும், டெவலப்பர்கள் தங்கள் பணிப்பாய்வுகளுக்கு இடையூறு விளைவிக்கும் பிழைகளைத் தவிர்க்க உதவுகிறது.