Merge pull request #14281 from jamieklassen/patch-3

[microsite] mention connectivity to graph.microsoft.com
2022-10-24 16:56:33 -04:00
parent 66a993f0c2 2f6f81acbd
commit 99e65be542
1 changed files with 6 additions and 0 deletions
@@ -46,6 +46,12 @@ The Microsoft provider is a structure with three configuration keys:
 - `clientSecret`: Secret, found on App Registration > Certificates & secrets
 - `tenantId`: Directory (tenant) ID, found on App Registration > Overview

+In order to finish signing a user in from Azure, the Backstage backend must
+fetch their information from graph.microsoft.com (as seen in [this source
+code](https://github.com/seanfisher/passport-microsoft/blob/0456aa9bce05579c18e77f51330176eb26373658/lib/strategy.js#L93-L95)),
+so ensure that your Backstage backend has connectivity to this host.
+Otherwise users may see an `Authentication failed, failed to fetch user profile` error when they attempt to log in.
+
 ## Adding the provider to the Backstage frontend

 To add the provider to the frontend, add the `microsoftAuthApiRef` reference and