„Microsoft Graph“ API organizacijos „FromTenantGuidNotFound“ klaidos siunčiant el. laišką sprendimas

„Microsoft Graph“ API el. pašto siuntimo klaidų trikčių šalinimas

Susidūrimas su OrganizationFromTenantGuidNotFound klaida bandant išsiųsti el. laišką su Microsoft Graph API gali būti varginantis, ypač kai sustabdo svarbias darbo eigas. Ši klaida paprastai reiškia, kad API negali rasti tinkamo nuomininko pagal pateiktą nuomininko GUID.

Ši problema gali atrodyti sudėtinga, tačiau dažniausiai ji susijusi su konfigūracijos nustatymais, ypač aplink jus Azure AD nuomininko sąranka arba autentifikavimo duomenis. Norint veiksmingai ją išspręsti, svarbu suprasti, kas sukelia šią klaidą.

Šiame vadove apžvelgsime įprastas OrganizationFromTenantGuidNotFound klaidos priežastis ir kaip jas pašalinti. Išnagrinėsime, kaip patvirtinti savo nuomininko ID, patikrinkite autentifikavimo parametrus ir patvirtinkite leidimus.

Atlikę tinkamus trikčių šalinimo veiksmus, galite sugrąžinti API skambučius ir užtikrinti sklandų el. laiškų siuntimo funkciją. Panagrinėkime, kas sukelia šią klaidą ir kaip ją išspręsti.

„Microsoft Graph“ API autentifikavimo klaidų nuomininkas nerastas sprendimas

Pateikti scenarijai sprendžia dažnai pasitaikančias problemas naudojant Microsoft Graph API el. laiškų siuntimui: OrganizationFromTenantGuidNotFound klaida. Ši klaida įvyksta, kai API nepavyksta rasti nuomininko, susieto su nurodytu nuomininko ID. Norėdami tai išspręsti, naudojame PHP GenericProvider klasė iš OAuth2 kliento paketo, kad tvarkytų autentifikavimo srautą. „GenericProvider“ yra būtinas, nes jis abstrahuoja prisijungimo prie „Microsoft“ OAuth2 galinių taškų sudėtingumą, leidžiant kūrėjams nurodyti kliento kredencialus, nuomininko ID ir esminius URL prieigos raktams suteikti ir pasiekti. Konfigūracija naudoja kliento ID, kliento paslaptį, peradresavimo URI ir galutinius taškus, pritaikytus „Microsoft“ tapatybės paslaugai, todėl sąrankos procesas supaprastinamas.

Pirmajame pavyzdyje mes sutelkiame dėmesį į prieigos URL generavimą, prie kurio vartotojai turi prisijungti ir suteikti el. laiškų siuntimo apimčių leidimą. Funkcija getAuthorizationUrl sukuria šį URL su konkrečiomis apimtimis, pvz., „openid“, „email“ ir „offline_access“. URL parametras „state“, sugeneruotas naudojant „base64_encode“ ir „json_encode“, prideda papildomą saugos sluoksnį, užkoduodamas seansui būdingą informaciją. Tai apsaugo nuo kryžminių svetainių užklausų klastojimo (CSRF) atakų ir užtikrina OAuth srauto vientisumą. Gautas autorizacijos URL nukreips vartotojus į „Microsoft“ prisijungimo puslapį, paragindamas juos leisti nurodytus leidimus. Sėkmingai prisijungus, „Microsoft“ nukreipia vartotojus į peradresavimo URI su autorizavimo kodu, kurį programa gali pakeisti prieigos prieigos raktu.

Tais atvejais, kai reikia tiesioginės užklausos, naudojamas antrasis scenarijus cURL API sąveikai. Neautomatiniu būdu kurdami prieigos rakto užklausą, apeiname bibliotekų poreikį, todėl jis idealiai tinka lengviems arba testavimo scenarijus. Scenarijus nustato tokius parametrus kaip client_id, client_secret ir grant_type kaip POST duomenis, naudodamas funkciją http_build_query, kuri koduoja duomenis į URL saugų formatą. Tada prieigos rakto užklausa siunčiama į atitinkamą OAuth2 galinį tašką naudojant curl_init ir curl_setopt, sukonfigūruotus tvarkyti antraštes, HTTP metodus ir duomenų laukus. Vykdant curl_exec siunčiama užklausa, o gautas atsakymas (su prieigos prieigos raktu arba klaidos informacija) gali būti naudojamas tolimesnėms užklausoms Microsoft Graph API.

Be to, įtraukėme vienetų testus, kad patvirtintume kiekvieną scenarijų. Pirmojo vieneto bandymo metu patikrinama, ar sugeneruotame prieigos teisės URL yra „Microsoft“ prisijungimo domenas, patikrinamas URL formatas. Kitas testas užtikrina, kad cURL užklausos nesuveiktų, patvirtinant sėkmingą ryšį su autentifikavimo galutiniu tašku. Šie testai suteikia pasitikėjimo, kad konfigūracijos yra teisingai nustatytos ir API užklausos veikia, o tai yra labai svarbu gamybos aplinkoje. Tvarkant ir bibliotekomis pagrįstus, ir rankinius užklausas, šie scenarijai ir testai siūlo patikimas autentifikavimo naudojant Microsoft Graph API parinktis, todėl lankstumas, klaidų apdorojimas ir modulinis dizainas gali būti pritaikytas prie įvairių projekto poreikių.

$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 Graph API“ autentifikavimo nuomininko GUID problemų supratimas

The OrganizationFromTenantGuidNotFound klaida Microsoft Graph API paprastai rodo, kad API užklausoje nurodyto nuomininko GUID negalima rasti Azure AD kataloge. Tai dažnai atsiranda dėl netinkamai sukonfigūruotų nuomininko ID arba netinkamos Microsoft Graph API integracijos sąrankos. Kiekvienas „Microsoft Azure“ nuomininkas turi unikalų identifikatorių, žinomą kaip nuomininko GUID, kuris užtikrina, kad užklausos būtų nukreiptos į tinkamą organizacinį kontekstą. Jei nuomininko GUID yra neteisingas arba jo nėra, Microsoft Graph API negali rasti organizacijos, todėl nepavyks autentifikuoti. Norint greitai išspręsti tokias problemas, labai svarbu suprasti nuomininko GUID vaidmenį API užklausose.

Norint užtikrinti teisingą sąranką, reikia patikrinti nuomininko ID „Azure Active Directory“ ir patvirtinkite, kad ji atitinka konfigūraciją jūsų programos autentifikavimo nustatymuose. Kartais kūrėjai klaidingai naudoja katalogo ID arba programos ID, o ne nuomininko GUID, todėl kyla ši problema. Be to, norint naudoti kelių nuomininkų sąranką Microsoft Graph API, reikia nurodyti leidimus pasiekti kitų nuomininkų duomenis. Jei nepavyks tinkamai sukonfigūruoti leidimų arba nenurodžius tinkamo GUID, gali atsirasti klaidų bandant pasiekti arba siųsti duomenis per API.

Taip pat naudinga peržiūrėti „Azure AD“ prieigos kontrolės strategijas, nes administratoriai gali apriboti prieigą prie tam tikrų išteklių, atsižvelgdami į vartotojo vaidmenis arba saugos politiką. Pavyzdžiui, kai kuriems vartotojams gali trūkti leidimų atlikti konkrečius veiksmus, jei jų paskyra priklauso ribotos prieigos grupei. Todėl „Azure AD“ būtina patikrinti GUID nustatymus ir vaidmens leidimus. Jei problemos išlieka, patikrinus „Microsoft“ dokumentaciją apie nuomininko konfigūraciją, galima gauti papildomo aiškumo dėl kelių nuomininkų taikomųjų programų reikalavimų ir padėti kūrėjams išvengti klaidų, kurios sutrikdo jų darbo eigą.