IdAceCodeEditor - Tool which helps developers to setup the sample code interacting with Azure AD across multipe platforms

How to use the tool

• Go to the release tab and download the latest IdAceCodeEditor_DATE_PREFIX.zip file. Please refer the below screenshot

  

• Navigate to the downloaded folder to locate the zip file. You may want to make sure that, file is unblocked before unzipping it to a folder.Please refer below screenshot.

  

• Extract the zip file to a local folder. To avoid path length limitations on Windows, we recommend extracting it into a directory near the root of your drive. Please refer below screenshot.

  

• Navigate to the folder where the files are unzipped. Locate the IdAceCodeEditor.exe file and double click on it to execute it. Please refer the below screenshot.

  

• The window should popup with the below screen. The window should let you to choose the platform in which you want to test/create the POC(Example- .NET CORE, Angular,JAVA, etc.). For the sake of articualting the usage of the tool, I'll take an example of .NET core and simple sign-in flow. Please refer the below screenshot for reference

  

• After expanding the desired option(From the context of this article, it is sign-in flow in .NET core), you will see three sections (1)Description of the sample along with the relavent tags (2) configure button with Azure AD (3) Configure button with manual option . Please refer below screenshot

• ##Configure-Connect with Azure Ad flow:

• If you click on the configure- connect with Azure Ad button, app will popup a Azure AD authetication prompt as shown in the below screenshot. Please enter the credential of the tenant under which you want to create the app registration.

• If you are a normal user in the tenant, you may get the below consent prompt depending on the user consent settings in the azure portal. Please refer the link https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/configure-user-consent?tabs=azure-portal. You may have to wait until, your admin approves the request.

  

• If you have entered the admin credential, then you will see the below prompt

  

• Once you pass the above hurdle which is making sure that, app has the enough permission to list the app registrations, tool will display the lists of aps registered in the tenant. Please refer the below screenshot.

• Tool gives two options here. Either select the existing pp registration or create the new one. As name suggestes, if you click on the Create button then, it creates the app regsitration for you. Before that, it could ask Application.ReadWrite permission. Please refer below screenshot

• Another option is to select the existing app registration and skip the above step. This doesnt need Application.ReadWrite permission.

• Both the above steps should display the below prerequites window if it is succesfully downloaded the sample.

  

  • The section heiglighted in (1) will list the prerequites to run the sample code on your local machine.
  • The section heiglighted in (2) will provide the detailed instructions on how the sample would work.
  • The section heiglighted in (3) will open the local folder where the code is downloaded.

• ##Configure-Manual updation:

• This option doesnt need any permission from the tenant. You should see a below window where you are asked to update the required information to pre-populate the sample

  

• After successfull configuration you will see a prereuisites window.

• You are good to go now to test your sample/POC.