Repository files navigation

These are 4 different samples using AspNetCore C# to quick start Azure AD authentication to Azure Maps. Each sample uses different authentication protocols depending on application need which are supported by Azure AD and Azure Role Based Access Control (RBAC).

Outline the file contents of the repository. It helps users navigate the codebase, build configuration and any related assets.

Prior to downloading these samples

• Visual Studio 2019 or Visual Studio Code withASP.NET and web development workload.
• You will need an Azure Subscription, sign up for afree account if necessary.
• afree SKU forAzure Active Directory associated with the Azure Subscription.

• This application registration will represent the web application(s).
• Each specific sample will describe the steps necessary for the different authentication protocols.
• For the sake of this sample repository, thesame application registration can be used.
• For production we recommend a distinct application registration for each web application. Additionally, we highly recommend usingAzure Managed Identity for any non-interactive autentication to Azure Maps. This will save credential management costs.
• For display name, we can name it "WebApp" and leave the redirect uri empty for now and follow the individuals samplesREADME.md.

• Search for "Azure Maps" on create new resource and follow the portal to create a new account.
• Once the account is created, retrieve the Azure Maps Client ID and keep on hand for the specific sample you wish torun.
• This value should be used in the x-ms-client-id with all HTTP requests.
• If using any SDK add it to the authenication options (JS).

• Running the Web Applicaton samples are based on theAspNetCore MVC v2.2 documentation
• Once all the individual sample README.md have been configured, Debug (F5 key) should build and start the application.
• Make sure to run the web application with HTTPS configured.
• If prompted for development HTTPS certificate via IIS or AspNetCore, accept the prompt to trust the certificate.

• Using Azure Maps Web SDK supports 2 approaches for Azure AD access tokens.
• If a server component like AspNetCore MVC is available for your application, we recommendOpenID Connect.
• In the case of no server component, you must use implicit grant for an user interactive sign in experience. However,in the case for no interactive sign in, some server component must exist to retrieve an access token and provide itto the Azure Maps Web SDK.
• UsingAzure Service Authentication Library will help reduce the complexity and cost of credential management and allow forAzure Managed Identities to be used on the hosted platform such as Azure Virtual Machines or Azure App Service.

This project welcomes contributions and suggestions. Most contributions require you to agree to aContributor License Agreement (CLA) declaring that you have the right to, and actually do, grant usthe rights to use your contribution. For details, visithttps://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to providea CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructionsprovided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted theMicrosoft Open Source Code of Conduct.For more information see theCode of Conduct FAQ orcontactopencode@microsoft.com with any additional questions or comments.