Dela via

Felsöka problem med API för inkommande etablering

  • Artikel

Introduktion

Det här dokumentet beskriver vanliga fel och problem med API för inkommande etablering och hur du felsöker dem.

Felsökningsscenarier

Ogiltigt dataformat

Problembeskrivning

  • Du får felmeddelandet Invalid Data Format med HTTP 400-svarskoden (felaktig begäran).

Sannolika orsaker

  1. Du skickar en giltig massbegäran enligt api-specifikationerna för etablering /bulkUpload , men du har inte angett http-begärandehuvudet "Content-Type" till application/scim+json.
  2. Du skickar en massbegäran som inte uppfyller api-specifikationerna för etablering /bulkUpload .

Lösning:

  1. Kontrollera att HTTP-begäran har Content-Type huvudet inställt på värdet application/scim+json.
  2. Se till att nyttolasten för massbegäran uppfyller API-specifikationerna för etablering /bulkUpload .

Det finns inget i etableringsloggarna

Problembeskrivning

  • Du skickade en begäran till slutpunkten för etablering/bulkUpload API och du fick HTTP 202-svarskod, men det finns inga data i etableringsloggarna som motsvarar din begäran.

Sannolika orsaker

  1. Din API-drivna etableringsapp har pausats.
  2. Etableringstjänsten har ännu inte uppdaterat etableringsloggarna med information om bearbetning av massbegäranden.
  3. Statusen för din lokala etableringsagent är inaktiv (om du kör den /API-drivna inkommande användaretablering till lokal Active Directory).

Lösning:

  1. Kontrollera att etableringsappen körs. Om den inte körs väljer du menyalternativet Starta etablering för att bearbeta data.
  2. Aktivera statusen för den lokala etableringsagenten genom att starta om den lokala agenten.
  3. Förvänta dig en fördröjning på 5 till 10 minuter mellan bearbetningen av begäran och skrivning till etableringsloggarna. Om API-klienten skickar data till api-slutpunkten provisioning/bulkUpload introducerar du en tidsfördröjning mellan frågan om begärandeanrop och etableringsloggar.

Förbjuden 403-svarskod

Problembeskrivning

  • Du skickade en begäran till api-slutpunkten för etablering/bulkUpload och du fick HTTP 403-svarskod (förbjuden).

Sannolika orsaker

  • Graph-behörigheten SynchronizationData-User.Upload har inte tilldelats till API-klienten.

Lösning:

  • Tilldela API-klienten Graph-behörigheten SynchronizationData-User.Upload och försök igen.

För många begäranden 429-svarskod

BulkUpload API-slutpunkten tillämpar följande begränsningsgränser och returnerar en 429-svarskod om dessa gränser överskrids.

  • 40 API-anrop per 5 sekunder – om antalet anrop överskrider den här gränsen inom ett intervall på 5 sekunder får klienten ett svar på 429. Ett sätt att undvika detta är genom att skicka begäranden med fördröjningar i logiken för att skicka klientbegäranden. 

  • 6000 API-anrop under en 24-timmarsperiod – om antalet anrop överskrider den här gränsen får klienten ett svar på 429. Ett sätt att förhindra detta är att se till att scim-massnyttolasten är optimerad för att använda max 50 poster per API-anrop. Med den här metoden kan du skicka 300 000 poster var 24:e timme.

Otillåten 401-svarskod

Problembeskrivning

  • Du skickade en begäran till api-slutpunkten för etablering/bulkUpload och du fick HTTP 401-svarskod (obehörig). Felkoden visar "InvalidAuthenticationToken" med ett meddelande om att åtkomsttoken har upphört att gälla eller inte är giltig ännu.

Sannolika orsaker

  • Din åtkomsttoken har upphört att gälla.

Lösning:

  • Generera en ny åtkomsttoken för API-klienten.

Jobbet anger karantäntillstånd

Problembeskrivning

  • Du har precis startat etableringsappen och den är i karantäntillstånd.

Sannolika orsaker

  • Du har inte angett e-postmeddelandet innan du startar jobbet.

Lösning: Gå till menyalternativet Redigera etablering . Under Inställningar finns en kryssruta bredvid Skicka ett e-postmeddelande när ett fel inträffar och ett fält för att ange din e-postavisering. Markera kryssrutan, ange ett e-postmeddelande och spara ändringen. Klicka på Starta om etablering för att få jobbet ur karantän.

Skapa användare – Ogiltigt UPN

Problembeskrivning Det finns ett användaretableringsfel. Etableringsloggarna visar felkoden: AzureActiveDirectoryInvalidUserPrincipalName.

Lösning:

  1. Kom till sidan Redigera attributmappningar .
  2. Välj mappningen UserPrincipalName och uppdatera den för att använda RandomString funktionen.
  3. Kopiera och klistra in det här uttrycket i uttrycksrutan: Join("", Replace([userName], , "(?<Suffix>@(.)*)", "Suffix", "", , ), RandomString(3, 3, 0, 0, 0, ), "@", DefaultDomain())

Det här uttrycket åtgärdar problemet genom att lägga till ett slumpmässigt tal till DET UPN-värde som godkänts av Microsoft Entra-ID.

Det gick inte att skapa användare – ogiltig domän

Problembeskrivning Det finns ett användaretableringsfel. Etableringsloggarna visar ett felmeddelande som anger domain does not exist.

Lösning:

  1. Gå till sidan Redigera attributmappningar .
  2. Välj mappning UserPrincipalName och kopiera och klistra in det här uttrycket i indatarutan för uttrycket: Join("", Replace([userName], , "(?<Suffix>@(.)*)", "Suffix", "", , ), RandomString(3, 3, 0, 0, 0, ), "@", DefaultDomain())

Det här uttrycket åtgärdar problemet genom att lägga till en standarddomän till UPN-värdet som godkänts av Microsoft Entra-ID.

Nästa steg