Skip to content

Commit b34b899

Browse files
authored
V3 upgrade guide- MSAL related updates (#489)
* 3.0.0-preview-3 release * msal updates
1 parent 0ca5b49 commit b34b899

File tree

1 file changed

+11
-6
lines changed

1 file changed

+11
-6
lines changed

changelogs/v3-upgrade-guide.md

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,12 @@
1111
- Microsoft Graph JS SDK requires Node.js 12 LTS or higher. The active Long Term Service (LTS) version of Node.js is used for on-going testing of existing and upcoming product features.
1212
- Updated to TypeScript 4.x.
1313

14+
### Removing `ImplicitMSALAuthenticationProvider` and `MSALAuthenticationProviderOptions` class.
15+
16+
- Use of `ImplicitMSALAuthenticationProvider`, that is,using the implicit authorization flow is not recommended any more. [OAuth 2.0 Implicit Grant](https://oauth.net/2/grant-types/implicit/).
17+
- The 3.0.0 version introduces `AuthCodeMSALBrowserAuthenticationProvider` which supports the [MSAL Browser](https://www.npmjs.com/package/@azure/msal-browser) and enables authorization using the Authentication Code Flow with PKCE. Learn more about the [AuthCodeMSALBrowserAuthenticationProvider](https://github.com/microsoftgraph/msgraph-sdk-javascript/blob/dev/docs/AuthCodeMSALBrowserAuthenticationProvider.md).
18+
- Alternatively, you can implement a `CustomAuthenticationProvider` with an auth library of your choice. Learn more using the [samples](https://github.com/microsoftgraph/msgraph-sdk-javascript#samples-and-tutorials).
19+
1420
### LargeFileUploadTask
1521

1622
- Modified the `FileObject` interface which now contains the `sliceFile` function. Learn more [LargeFileUploadTask](../docs/tasks/LargeFileUploadTask.md).
@@ -47,11 +53,15 @@
4753

4854
## Enhancements
4955

56+
### Introducing support for `@azure/msal-browser`
57+
- The 3.0.0 version introduces `AuthCodeMSALBrowserAuthenticationProvider` which supports authentication using the [MSAL Browser](https://www.npmjs.com/package/@azure/msal-browser)
58+
- `AuthCodeMSALBrowserAuthenticationProvider` enables authorization using the Authentication Code Flow with PKCE. Learn more about the [AuthCodeMSALBrowserAuthenticationProvider](https://github.com/microsoftgraph/msgraph-sdk-javascript/blob/dev/docs/AuthCodeMSALBrowserAuthenticationProvider.md).
59+
5060
### Introducing support for `@azure/identity TokenCredentials`
5161

5262
- Added a `TokenCredentialAuthenticationProvider` enabling the use of `@azure/identity` `credential classes` for authentication purposes.
5363
- The `TokenCredentialAuthenticationProvider` enables server-side authentication using `credential classes` such as `ClientSecretCredential` or `ClientCertificateCredential`.
54-
- Find the samples on how to use `TokenCredentialAuthenticationProvider` here - [TokenCredentialAuthenticationProvider samples](../samples/tokenCredentialSamples)
64+
- Find the samples on how to use `TokenCredentialAuthenticationProvider` here - [TokenCredentialAuthenticationProvider samples](../samples/javascript/clientInitialization/tokenCredentialAuthenticationProvider)
5565

5666
### LargeFileUploadTask
5767

@@ -81,11 +91,6 @@ const client = Client.initWithMiddleware({ middleware, customHosts });
8191

8292
## Deprecation
8393

84-
### Deprecating `ImplicitMSALAuthenticationProvider`
85-
86-
- Use of `ImplicitMSALAuthenticationProvider`, that is,using the implicit authorization flow is not recommended any more. [OAuth 2.0 Implicit Grant](https://oauth.net/2/grant-types/implicit/).
87-
- Alternatively, you can implement a `CustomAuthenticationProvider` with an auth library of your choice. Learn more using the [samples](https://github.com/microsoftgraph/msgraph-sdk-javascript#samples-and-tutorials).
88-
8994
### Deprecating the `sliceFile` function of the `LargeFileUploadTask` class.
9095

9196
- The `sliceFile` function has been moved to the `FileObject` interface.

0 commit comments

Comments
 (0)