Move all the Spring related samples to Azure Samples

Move all the Spring related samples to Azure Samples

Author: backwind1233

.gitignore

@@ -348,3 +348,35 @@ MigrationBackup/
 
 # Ionide (cross platform F# VS Code tools) working folder
 .ionide/
+### Java template
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
+/.idea/*
+.idea/*
+.idea
+target
+.classpath
+.project
+*.iml

CHANGELOG.md

@@ -0,0 +1,111 @@
+---
+page_type: sample
+languages:
+- java
+products:
+- azure-active-directory-b2c
+description: "Sample project for Azure AD B2C Spring Boot client library"
+urlFragment: "azure-spring-boot-sample-active-directory-b2c-oidc"
+---
+
+# Sample for Azure AD B2C Spring Boot client library for Java
+
+## Key concepts
+This sample illustrates how to use `azure-spring-boot-starter-active-directory-b2c` package to work with OAuth 2.0 and OpenID Connect protocols with Azure Active Diretory B2C.
+
+## Getting started
+
+
+
+### Create your Azure Active Directory B2C tenant
+
+Follow the guide of [AAD B2C tenant creation](https://docs.microsoft.com/azure/active-directory-b2c/tutorial-create-tenant).
+
+### Register your Azure Active Directory B2C application
+
+Follow the guide of [AAD B2C application registry](https://docs.microsoft.com/azure/active-directory-b2c/tutorial-register-applications).
+Please ensure that your b2c application's `Redirect URL` is configured to `http://localhost:8080/login/oauth2/code/`.
+
+### Create user flows
+
+Follow the guide of [AAD B2C user flows creation](https://docs.microsoft.com/azure/active-directory-b2c/tutorial-create-user-flows).
+
+## Examples
+### Configure the sample
+
+#### application.yml
+
+1. Fill in `${your-tenant-authorization-server-base-uri}` from **Azure AD B2C** portal `App registrations` blade, select **Endpoints**, copy the base endpoint uri(Global cloud format may looks like
+`https://{your-tenant-name}.b2clogin.com/{your-tenant-name}.onmicrosoft.com`, China Cloud looks like `https://{your-tenant-name}.b2clogin.cn/{your-tenant-name}.partner.onmschina.cn`). 
+
+    **NOTE**: The `azure.activedirectory.b2c.tenant` has been deprecated. Please use `azure.activedirectory.b2c.base-uri` instead.
+
+2. Select one registered instance under `Applications` from portal, and then:
+    1. Fill in `${your-client-id}` from `Application ID`.
+    2. Fill in `${your-client-secret}` from one of `Keys`.
+3. Add your user flows defined on the Azure Portal under the `user-flows` configuration, which is a map, you can give each user flow a key and the value will be the name of user flow defined in AAD B2C. 
+   By default, we use the key `sign-up-or-sign-in` for a **login** user flow and `password-reset` for the **Password reset** type user flow, you can choose to override them.
+4. Fill in `${your-login-user-flow-key}` with the key of your login user flow, we will use the value `sign-up-or-sign-in` to look up the user-flows map if this property is not provided.   
+5. Replace `${your-logout-success-url}` to `http://localhost:8080/login`.
+
+```yaml
+azure:
+  activedirectory:
+    b2c:
+      base-uri: ${your-tenant-authorization-server-base-uri}
+      client-id: ${your-client-id}
+      client-secret: ${your-client-secret}
+      login-flow: ${your-login-user-flow-key}               # default to sign-up-or-sign-in, will look up the user-flows map with provided key.
+      logout-success-url: ${your-logout-success-url}
+      user-flows:
+        password-reset: ${your-profile-edit-user-flow}
+        profile-edit: ${your-password-reset-user-flow}
+        sign-up-or-sign-in: ${your-sign-up-or-in-user-flow}
+      user-name-attribute-name: ${your-user-name-claim}
+```
+
+**NOTE**: If both `tenant` and `baseUri` are configured at the same time, only `baseUri` takes effect.
+
+### Run with Maven
+```
+cd azure-spring-boot-samples/aad/azure-spring-boot-sample-active-directory-b2c-oidc
+mvn spring-boot:run
+```
+
+### Validation
+
+1. Access `http://localhost:8080/` as index page.
+2. Sign up/in.
+3. Profile edit.
+4. Password reset.
+5. Log out.
+6. Sign in.
+
+## Troubleshooting
+- `Missing attribute 'name' in attributes `
+
+  ```
+  java.lang.IllegalArgumentException: Missing attribute 'name' in attributes
+  	at org.springframework.security.oauth2.core.user.DefaultOAuth2User.<init>(DefaultOAuth2User.java:67) ~[spring-security-oauth2-core-5.3.6.RELEASE.jar:5.3.6.RELEASE]
+  	at org.springframework.security.oauth2.core.oidc.user.DefaultOidcUser.<init>(DefaultOidcUser.java:89) ~[spring-security-oauth2-core-5.3.6.RELEASE.jar:5.3.6.RELEASE]
+  	at org.springframework.security.oauth2.client.oidc.userinfo.OidcUserService.loadUser(OidcUserService.java:144) ~[spring-security-oauth2-client-5.3.6.RELEASE.jar:5.3.6.RELEASE]
+  	at org.springframework.security.oauth2.client.oidc.userinfo.OidcUserService.loadUser(OidcUserService.java:63) ~[spring-security-oauth2-client-5.3.6.RELEASE.jar:5.3.6.RELEASE]
+  ```
+
+  While running sample, if error occurs with logs above:
+
+  - make sure that while creating user workflow by following this [guide](https://docs.microsoft.com/azure/active-directory-b2c/tutorial-create-user-flows), for **User attributes and claims** , attributes and claims for **Display Name** should be chosen.
+
+### FAQ
+
+#### Sign in with loops to B2C endpoint ?
+This issue almost due to polluted cookies of `localhost`. Clean up cookies of `localhost` and try it again.
+
+#### More identity providers from AAD B2C login ?
+Follow the guide of [Set up Google account with AAD B2C](https://docs.microsoft.com/azure/active-directory-b2c/active-directory-b2c-setup-goog-app).
+And also available for Amazon, Azure AD, FaceBook, Github, Linkedin and Twitter.
+
+## Next steps
+## Contributing
+<!-- LINKS -->
+

CONTRIBUTING.md

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+
+  <parent>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-parent</artifactId>
+    <version>2.5.0</version> <!-- {x-version-update;org.springframework.boot:spring-boot-starter-parent;external_dependency} -->
+  </parent>
+
+  <groupId>com.azure.spring</groupId>
+  <artifactId>azure-spring-boot-sample-active-directory-b2c-oidc</artifactId>
+  <version>1.0.0</version>
+  <packaging>jar</packaging>
+
+  <name>Azure Spring Boot Starter Sample - Azure AD B2C Spring Security 5 OAuth Integration</name>
+  <description>Azure AD B2C Spring Security 5 OAuth2 Integration Spring Boot Sample</description>
+  <url>https://github.com/Azure/azure-sdk-for-java</url>
+
+  <dependencyManagement>
+    <dependencies>
+      <dependency>
+        <groupId>com.azure</groupId>
+        <artifactId>azure-core</artifactId>
+        <version>1.18.0</version> <!-- {x-version-update;com.azure:azure-core;dependency} -->
+      </dependency>
+    </dependencies>
+  </dependencyManagement>
+
+  <dependencies>
+    <dependency>
+      <groupId>com.azure.spring</groupId>
+      <artifactId>azure-spring-boot-starter-active-directory-b2c</artifactId>
+      <version>3.6.0</version> <!-- {x-version-update;com.azure.spring:azure-spring-boot-starter-active-directory-b2c;dependency} -->
+    </dependency>
+
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-web</artifactId>
+    </dependency>
+
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-thymeleaf</artifactId>
+    </dependency>
+
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-security</artifactId>
+    </dependency>
+
+    <dependency>
+      <groupId>org.thymeleaf.extras</groupId>
+      <artifactId>thymeleaf-extras-springsecurity5</artifactId>
+    </dependency>
+  </dependencies>
+</project>

README.md

@@ -0,0 +1,16 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+package com.azure.spring.sample.aad.b2c;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class AzureADB2COIDCSampleApplication {
+
+    public static void main(String[] args) {
+        //
+        SpringApplication.run(AzureADB2COIDCSampleApplication.class, args);
+    }
+}