Anpassa MFA-e-postmeddelanden i Azure B2C: En guide

Lösning av anpassade e-postproblem i MFA

Azure B2C erbjuder omfattande anpassningsalternativ för användarautentiseringsflöden, inklusive möjligheten att skicka anpassade e-postmeddelanden för olika scenarier. Medan du ställer in anpassade policyer för att möjliggöra inloggning för lokala konton och glömda lösenordsflöden, kan allt fungera sömlöst, från hantering av användarvillkor till att anpassa e-postmeddelanden via SendGrid.

Ett vanligt problem uppstår dock när MFA-processen (Multi-Factor Authentication) under inloggning misslyckas med att skicka den anpassade e-posten för verifieringskoden, istället för att återgå till Microsoft-hyresgästens standard-e-post. Den här artikeln utforskar det här problemet och ger vägledning om hur du löser det effektivt.

Kommando	Beskrivning
<BasePolicy>	Definierar basprincipen att ärva från i Azure AD B2C anpassade policyer.
<ClaimsTransformations>	Innehåller transformationer för anspråk, som att generera anpassade e-postämnen.
ClaimsTransformation	Anger en individuell anspråksomvandling, inklusive in- och utanspråk.
SendGridClient	Initierar SendGrid-klienten för att skicka e-post.
SendGridMessage	Skapar ett meddelandeobjekt för att skicka ett e-postmeddelande via SendGrid.
AddTo	Lägger till en mottagare i e-postmeddelandet.
SendEmailAsync	Skickar e-postmeddelandet asynkront med SendGrid-klienten.

Förstå Custom MFA-e-postimplementering i Azure B2C

Skripten som tillhandahålls ovan är utformade för att möjliggöra sändning av anpassade MFA-verifieringsmail under inloggningsprocessen i Azure B2C. Det första skriptet innebär att konfigurera den anpassade policy-XMLen för Azure AD B2C. Inom denna XML, taggen används för att ärva från baspolicyn, vilket säkerställer att alla grundläggande konfigurationer ingår. De avsnittet innehåller omvandlingar för anspråk, som att skapa ett anpassat e-postämne med hjälp av element. Dessa transformationer möjliggör dynamisk anpassning av MFA-e-postinnehållet.

Det andra skriptet är en C# Azure-funktion som skickar det anpassade e-postmeddelandet med SendGrid. Denna funktion utlöses av en kö, specificerad av attribut. Den initierar SendGrid-klienten med och skapar ett e-postmeddelande med hjälp av . De AddTo metod lägger till mottagaren i e-postmeddelandet, och skickar e-postmeddelandet asynkront. Denna inställning säkerställer att MFA-e-postmeddelanden skickas med det anpassade innehållet definierat i SendGrid, vilket löser problemet med standardmeddelanden från Microsoft-hyresgäster som skickas under inloggningsflödet.

<TrustFrameworkPolicy xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06">
<BasePolicy>
<PolicyId>B2C_1A_TrustFrameworkBase</PolicyId>
</BasePolicy>
<BuildingBlocks>
<ClaimsTransformations>
<ClaimsTransformation Id="CreateMfaEmailSubject">
<InputClaims>
<InputClaim ClaimTypeReferenceId="email" TransformationClaimType="email"/>
</InputClaims>
<OutputClaims>
<OutputClaim ClaimTypeReferenceId="email" TransformationClaimType="email"/>
</OutputClaims>
</ClaimsTransformation>
</ClaimsTransformations>

using System.Threading.Tasks;
using Microsoft.Azure.WebJobs;
using Microsoft.Extensions.Logging;
using SendGrid;
using SendGrid.Helpers.Mail;
public static async Task Run([QueueTrigger("mfa-email-queue")] string email, ILogger log)
{
var client = new SendGridClient(Environment.GetEnvironmentVariable("SendGridApiKey"));
var msg = new SendGridMessage()
{
From = new EmailAddress("no-reply@yourdomain.com", "Your Company"),
Subject = "Your MFA Verification Code",
PlainTextContent = $"Your verification code is {email}",
HtmlContent = $"<strong>Your verification code is {email}</strong>"
};
msg.AddTo(new EmailAddress(email));
var response = await client.SendEmailAsync(msg);
}

Avancerade tekniker för att anpassa MFA-e-postmeddelanden i Azure B2C

En annan viktig aspekt att tänka på när du anpassar MFA-e-postmeddelanden i Azure B2C är att säkerställa korrekta orkestreringssteg inom din anpassade policy. Detta innebär att definiera och konfigurera ytterligare steg i användarresan för att hantera sändningen av MFA-e-postmeddelanden korrekt. En effektiv teknik är att lägga till ett nytt orkestreringssteg dedikerat till e-postverifiering inom inloggningspolicyn. Det här steget bör utnyttja anspråksomvandlingen och den tekniska profilen för att anropa e-postsändningsprocessen.

Dessutom är det viktigt att felsöka och övervaka användarresan för att säkerställa att rätt e-postmallar och API:er anropas. Att använda verktyg som Application Insights kan hjälpa till att spåra och diagnostisera problem inom den anpassade policyexekveringen. Detta möjliggör övervakning och felsökning i realtid, vilket säkerställer att anpassade e-postmeddelanden skickas som förväntat under MFA-processen.

1. Hur konfigurerar jag en anpassad e-postmall för MFA i Azure B2C?
2. Använda sig av eller en annan e-posttjänst för att skapa och hantera anpassade e-postmallar och sedan integrera den i dina B2C-anpassade policyer.
3. Vilka orkestreringssteg krävs för att skicka anpassade MFA-e-postmeddelanden?
4. Inkludera en dedikerad för e-postverifiering i inloggningspolicyn.
5. Hur kan jag säkerställa att den anpassade e-posten används under inloggningsflödet?
6. Uppdatera användarresan för att referera till den anpassade e-postmallen i lämpliga orkestreringssteg.
7. Varför skickas standardmeddelandet från Microsoft fortfarande under MFA?
8. Kontrollera om den anpassade policyn korrekt refererar till och mall.
9. Hur felsöker jag problem med anpassad e-postsändning i Azure B2C?
10. Använda sig av för att övervaka och diagnostisera användarresan och e-postsändningsprocessen.
11. Kan jag använda andra e-posttjänster än SendGrid?
12. Ja, Azure B2C stöder olika e-postleverantörer; du måste konfigurera dem på lämpligt sätt i den anpassade policyn.
13. Vilka anspråksomvandlingar krävs för anpassade MFA-e-postmeddelanden?
14. Definiera det nödvändiga för att generera och formatera e-postinnehållet dynamiskt.
15. Är det möjligt att anpassa avsändarens e-postadress?
16. Ja, ange avsändaradressen i konfigurationen av e-posttjänsten och referera till den i policyn.
17. Hur kan jag testa det anpassade e-postflödet för MFA?
18. Använd testkonton och aktivera inloggningsprocessen för att säkerställa att det anpassade e-postmeddelandet skickas korrekt.

Att konfigurera Azure B2C för att skicka anpassade e-postmeddelanden för MFA-verifiering innebär att förstå och korrekt ställa in olika element som orkestreringssteg, anspråkstransformationer och att integrera externa tjänster som SendGrid. Även om processen kan vara komplex, kan det att följa detaljerade riktlinjer och använda lämpliga felsökningsverktyg hjälpa till att säkerställa att anpassade e-postmeddelanden skickas på ett tillförlitligt sätt under inloggningsflödet. Detta ökar inte bara säkerheten utan förbättrar också användarupplevelsen genom att tillhandahålla en sömlös och varumärkesbaserad autentiseringsprocess.