Help

Woodgrove Groceries is a live demo web application created by Microsoft to demonstrate several Microsoft Entra External ID features. Woodgrove simulates an online grocery store that sells groceries to both individual consumers and business customers. It allows you to sign-up and sign-in by using Microsoft Entra External ID and to explore its capabilities in scenarios that pertain to external identity management.
 

Select a use case

From the right corner of the page, select the Select a use case button.

Select a use case

The use cases come with some instructions (1) and button (2) to start the demo and a link (3) to learn how we configured the Woodgrove tenant. Read the instructions and start the use case.

Online retail demo

The online retail use case is an end-to-end demonstration that illustrates several of the most common authentication experiences that can be configured for your customer-facing apps. To run the use case, follow these steps:
1. User experience
On the sign-up or sign-in page notice the following:
  1. The sign-in page is fully customized with the Woodgrove brand.
  2. The domain name that appears in the web address bar is an extension of the Woodgrove domain name (will be available soon).
  3. The sign-in text appears with some guidance for the customers.
  4. Uses can sign-in with their email and password, or social accounts.
  5. Users can also create a new account.
  6. The footer contains links to the term of use and privacy policies.
2. Verify your email
  1. On the sign-in page, select the No account? Create one link.
  2. Enter your email address, which will be verified and becomes your login ID. At this time, Microsoft Entra exteral ID will send you a verification code to the email you entered.
  3. Open your mailbox and copy the verification code sent to you. Then, on the sign-in page enter the verification code and select next.
3. Create a Woodgrove account
  1. Before you start filling out the sign-up form. Notice that the county is preselected (Spain) and also a promo code was auto generated for you. This is done by using the custom authentication extension feature.
  2. Enter a password, re-enter the password, and enter a display name.
  3. For the city enter an incorrect one. For example, Berlin. You will see soon how this is handled.
  4. For the special diet, enter eggs, so Woodgrove will warn you about products that contain eggs. The special diet and the promo code are custom user attributes added to the sign-up flow.
  5. Finally, select next to create a Woodgrove online identity.
  6. At this point you should get an error message that Woodgrove doesn’t operate in this city. This input validation is done using a custom authentication extension we configured, that validates the city name, against a list of cities and countries we compiled.
  7. Correct the city (enter Madrid), and try to complete the registration again.
  8. Select next to complete the registration.
4. Start using the Woodgrove app
  1. After you successfully sign-in, your name appears in the header.
  2. Now you have the option to add items to the shopping cart.
  3. Since you specified the eggs allergy, a warning appears next to the eggs. For the warning, the app reads a claim from the security token.
5. Investigate your security token
  1. Select your name from the header.
  2. The token page shows the security token that was returned to the application by Microsoft Entra external ID. It shows the user object ID, the name and more information.
  3. Take a look on the loyalty number, loyalty since, and loyalty tier claims. These claims were generated by a custom authentication extension we implemented.
  4. It also shows the value of the special diet claim that was added to the security token.
6. Edit your profile
  1. From the header, select the profile icon.
  2. The profile editing page lets you manage you profile attributes, like display name, surname, given name, city, and others. After you update your profile, sign-out and sign-in again.
  3. You can also delete your account.
  4. Grant yourself permissions Sign-in activity, or add yourself to Woodgrove Commercial Accounts security group.
  5. Finally, check the sign-in activity.

Community Help and Support

If you find a bug, notice something but are not sure how to solve it, or want to provide product feedback, please raise an issue on GitHub Issues.
 
App version: 1.0.0.22