[BC Break] Auth provider adjustments

UPGRADE.md

@@ -821,6 +821,35 @@ const App = () => {
 }
 ```
 
+## Auth Provider
+
+Some of the hooks allowing to call the `authProvider` methods are asynchronous: they return their result only when the `authProvider` promise resolves, and set the `loading` property to `true` until then.
+
+In react-admin v4, this `loading` field is now renamed to `isLoading`. The `loaded` field has been removed.
+
+```diff
+import { useAuthState, Loading } from 'react-admin';
+
+const MyPage = () => {
+-   const { loading, authenticated } = useAuthState();
++   const { isLoading, authenticated } = useAuthState();
+-   if (loading) {
++   if (isLoading) {
+        return <Loading />;
+    }
+    if (authenticated) {
+        return <AuthenticatedContent />;
+    } 
+    return <AnonymousContent />;
+};
+```
+
+To upgrade, check every instance of your code of the following hooks:
+
+- `useAuthState`
+- `useGetIdentity`
+- `usePermissions`
+
 ## Admin Child Function Result Has Changed
 
 In order to define the resources and their views according to users permissions, we used to support a function as a child of `<Admin>`. Just like the `customRoutes`, this function had to return an array of elements.

docs/AuthProviderList.md

@@ -0,0 +1,22 @@
+---
+layout: default
+title: "Supported Auth Provider Backends"
+---
+
+# Supported Auth Provider Backends
+
+It's very common that your auth logic is so specific that you'll need to write your own `authProvider`. However, the community has built a few open-source Auth Providers that may fit your need:
+
+- **[AWS Amplify](https://docs.amplify.aws)**: [MrHertal/react-admin-amplify](https://github.com/MrHertal/react-admin-amplify)
+- **[AWS Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/setting-up-the-javascript-sdk.html)**: [thedistance/ra-cognito](https://github.com/thedistance/ra-cognito)
+- **[Firebase Auth (Google, Facebook, GitHub, etc.)](https://firebase.google.com/docs/auth/web/firebaseui)**: [benwinding/react-admin-firebase](https://github.com/benwinding/react-admin-firebase#auth-provider)
+- **[Supabase](https://supabase.io/)**: [marmelab/ra-supabase](https://github.com/marmelab/ra-supabase).
+
+Beyond ready-to-use providers, you may find help in these third-party tutorials about integrating more authentication backends:
+
+* **[Auth0](https://auth0.com/docs/libraries/auth0-single-page-app-sdk)**: [spintech-software/react-admin-auth0-example](https://github.com/spintech-software/react-admin-auth0-example)
+* **[Azure Active Directory](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-browser)**: [victorp13/react-admin-msal](https://github.com/victorp13/react-admin-msal)
+* **[Loopback](https://loopback.io/doc/en/lb4/Authentication-overview.html)**: [appsmith dev.to tutorial](https://dev.to/appsmith/building-an-admin-dashboard-with-react-admin-86i#adding-authentication-to-reactadmin)
+* **[OpenID Connect (OIDC)](https://openid.net/connect/)**: [marmelab/ra-example-oauth](https://github.com/marmelab/ra-example-oauth)
+
+If you have released a reusable `authProvider`, or a tutorial for another auth backend, please open a PR to add it to this list!