Løse Microsoft Graph APIs OrganizationFromTenantGuidNotFound-feil ved sending av e-post

Feilsøking av Microsoft Graph API-e-postsendingsfeil

Møter på OrganisationFromTenantGuidNotFound feil når du prøver å sende en e-post med Microsoft Graph API kan være frustrerende, spesielt når det stopper kritiske arbeidsflyter. Denne feilen betyr vanligvis at API-en ikke kunne finne en gyldig leietaker basert på den oppgitte leietaker-GUIDen.

Dette problemet kan virke komplekst, men det er vanligvis relatert til konfigurasjonsinnstillinger, spesielt rundt din Azure AD leietakeroppsett eller autentiseringsdetaljer. Å forstå hva som utløser denne feilen er nøkkelen til å løse den effektivt.

I denne veiledningen går vi gjennom vanlige årsaker til OrganisationFromTenantGuidNotFound-feilen og hvordan de kan løses. Vi vil undersøke hvordan du kan bekrefte din leietaker-ID, sjekk autentiseringsparametere og valider tillatelser.

Med de riktige feilsøkingstrinnene kan du få API-anropene dine tilbake på sporet og sikre jevn e-postsendingsfunksjonalitet. La oss dykke ned i hva som forårsaker denne feilen og trinnene for å løse den.

Løse leietaker ikke funnet-feil i Microsoft Graph API-autentisering

De medfølgende skriptene løser et vanlig problem ved bruk av Microsoft Graph API for sending av e-post: OrganisationFromTenantGuidNotFound-feilen. Denne feilen oppstår når API-en ikke klarer å finne leietakeren knyttet til den gitte leietaker-ID-en. For å løse dette bruker vi PHP GenericProvider klasse fra OAuth2-klientpakken for å håndtere autentiseringsflyten. GenericProvider er viktig ettersom den abstraherer kompleksiteten ved å koble til Microsofts OAuth2-endepunkter, og lar utviklere spesifisere klientlegitimasjon, leietaker-ID og viktige URL-er for godkjenning og tilgang til tokens. Konfigurasjonen bruker klient-ID, klienthemmelighet, omdirigerings-URI og endepunkter som er skreddersydd for Microsofts identitetstjeneste, noe som forenkler oppsettprosessen.

I det første eksemplet fokuserer vi på å generere autorisasjons-URLen, som brukere trenger for å logge på og gi tillatelse til e-postsendingsomfang. GetAuthorizationUrl-funksjonen oppretter denne URL-en med spesifikke omfang som 'openid', 'email' og 'offline_access'. 'State'-parameteren i URL-en, generert ved hjelp av base64_encode og json_encode, legger til et ekstra sikkerhetslag ved å kode sesjonsspesifikk informasjon. Dette beskytter mot CSRF-angrep (cross-site request forgery), og sikrer integriteten til OAuth-flyten. Den resulterende autorisasjons-URLen vil lede brukerne til Microsofts påloggingsside, og ber dem om å tillate de angitte tillatelsene. Ved vellykket pålogging omdirigerer Microsoft brukere til omdirigerings-URIen med en autorisasjonskode, som applikasjonen kan bytte mot et tilgangstoken.

For tilfeller som krever en mer direkte forespørsel, bruker det andre skriptet curL for API-interaksjon. Ved å opprette tokenforespørselen manuelt, omgår vi behovet for biblioteker, noe som gjør den ideell for lette scenarier eller testscenarier. Skriptet setter opp parametere som client_id, client_secret og grant_type som POST-data ved å bruke http_build_query-funksjonen, som koder dataene til et URL-sikkert format. Tokenforespørselen sendes deretter til det aktuelle OAuth2-endepunktet ved hjelp av curl_init og curl_setopt, konfigurert til å håndtere overskrifter, HTTP-metoder og datafelt. Utførelse av curl_exec sender forespørselen, og det resulterende svaret (som inneholder tilgangstoken eller feildetaljer) kan brukes til ytterligere forespørsler i Microsoft Graph API.

I tillegg har vi inkludert enhetstester for å validere hvert skript. Den første enhetstesten sjekker om den genererte autorisasjons-URLen inkluderer Microsofts påloggingsdomene, og bekrefter URL-formatet. En annen test sikrer at cURL-forespørsler ikke mislykkes, og bekrefter en vellykket tilkobling til autentiseringsendepunktet. Disse testene gir sikkerhet for at konfigurasjonene er riktig satt og API-forespørslene er funksjonelle, noe som er kritisk i produksjonsmiljøer. Ved å håndtere både bibliotekbaserte og manuelle forespørsler, tilbyr disse skriptene og testene robuste alternativer for autentisering med Microsofts Graph API, noe som gir fleksibilitet, feilhåndtering og modulær design som kan tilpasses ulike prosjektbehov.

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

Forstå Tenant GUID-problemer i Microsoft Graph API-autentisering

De OrganisationFromTenantGuidNotFound feil i Microsoft Graph API indikerer vanligvis at leietaker-GUID angitt under API-forespørselen ikke kan finnes i Azure AD-katalogen. Dette skyldes ofte feilkonfigurerte leietaker-ID-er eller feil oppsett av Microsoft Graph API-integrasjonen. Hver leietaker i Microsoft Azure har en unik identifikator kjent som leietaker-GUID, som sikrer at forespørsler sendes til riktig organisasjonskontekst. Hvis leietaker-GUIDen er ugyldig eller mangler, kan ikke Microsoft Graph API finne organisasjonen, noe som resulterer i en autentiseringsfeil. Å forstå rollen til leietaker-GUID i API-forespørsler er nøkkelen til å løse slike problemer raskt.

Å sikre riktig oppsett innebærer å verifisere leietaker-ID i Azure Active Directory og bekrefter at den samsvarer med konfigurasjonen i applikasjonens autentiseringsinnstillinger. Noen ganger bruker utviklere feilaktig katalog-ID eller program-ID i stedet for leietaker-GUID, noe som fører til dette problemet. I tillegg krever bruk av et multi-tenant-oppsett i Microsoft Graph API spesifisering av tillatelser for å få tilgang til andre leietakers data. Unnlatelse av å konfigurere rettigheter eller spesifisere riktig GUID kan føre til feil når du prøver å få tilgang til eller sende data via API.

Det er også nyttig å gjennomgå tilgangskontrollpolicyer i Azure AD, siden administratorer kan begrense tilgangen til visse ressurser basert på brukerroller eller sikkerhetspolicyer. For eksempel kan noen brukere mangle tillatelser til å utføre spesifikke handlinger hvis kontoen deres er en del av en begrenset tilgangsgruppe. Derfor er det viktig å bekrefte både GUID-innstillinger og rolletillatelser i Azure AD. Hvis problemene vedvarer, kan sjekking av Microsofts dokumentasjon om leietakerkonfigurasjoner gi ytterligere klarhet om kravene til multi-tenant-applikasjoner, og hjelpe utviklere med å unngå feil som forstyrrer arbeidsflytene deres.