Arc4u.Standard.OAuth2.AspNetCore 8.3.1

Prefix Reserved
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Arc4u.Standard.OAuth2.AspNetCore --version 8.3.1
                    
NuGet\Install-Package Arc4u.Standard.OAuth2.AspNetCore -Version 8.3.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Arc4u.Standard.OAuth2.AspNetCore" Version="8.3.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Arc4u.Standard.OAuth2.AspNetCore" Version="8.3.1" />
                    
Directory.Packages.props
<PackageReference Include="Arc4u.Standard.OAuth2.AspNetCore" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Arc4u.Standard.OAuth2.AspNetCore --version 8.3.1
                    
#r "nuget: Arc4u.Standard.OAuth2.AspNetCore, 8.3.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#addin nuget:?package=Arc4u.Standard.OAuth2.AspNetCore&version=8.3.1
                    
Install as a Cake Addin
#tool nuget:?package=Arc4u.Standard.OAuth2.AspNetCore&version=8.3.1
                    
Install as a Cake Tool

Arc4u.Standard.OAuth2.AspNetCore

Core framework to integrate OAuth2 and creation of the principal in asp net core.

As it is a AspNetCore library, it is based on the Microsoft.AspNetCore.Authentication and Microsoft.AspNetCore.Authentication.OAuth libraries.

Do not use this package in other contexts than AspNetCore.

ProblemDetails extension

When working with the Results feature in Arc4u, the Rest Api controller will return a ProblemDetails object when an error occurs.

The idea is from a controller endpoint to call the business layer and return the result to the client. The business layer will return a Result object that can be converted to an ActionResult object.

    return await bl.DoSomethingAsync()
                   .ToActionOkResultAsync();

Different situations, different HttpStatusCodes can be returned.

Success path:

When the call to the business layer is a success, depending on the result, different codes will be returned.

Result:

The return code is 204 NoContent.

Result<T>

The return code is 200 Ok or 201 Created.

200 Ok HTTP GET

What to return when the value is null?
On internet, it is not clear what to return when the value is null. Some say to return a 204 NoContent, others say to return a 200 OK with a null value.
I find personaly than returning a 204 NoContent is more appropriate. The client knows that the call was successful but there is no content to return.

If you are using proxy code generator like NSwagStudio, this situation is not managed like I would expect. If you return a 200 Ok when you have a value and a 204 NoContent when the value is null, the proxy code generator will return the value when there is a value but will manage the 204 NoContent as an error! To avoid this today, I return a 200 Ok with a null value. The client will have to manage the null value.

It is possible to override the default behavior by informing the extension method to return another code when the value is null.

    return await bl.DoSomethingAsync(id)
                   .ToActionResultAsync(() => StatusCode(StatusCodes.Status204NoContent));

Mapping to a Dto is also possible. The mapper is a function and can be AutoMapper or any other mapper.

    return await bl.DoSomethingAsync(id)
                   .ToActionResultAsync(mapper.Map<ContractDto>);
201 Created HTTP POST

When the result is a 201 Created, the location header is set to the location of the created resource.

To handle this specific situation, the extension method ToActionCreatedResultAsync is available. The method expect a Uri to set the location correctly.
The need to split the call in two steps is to allow the business layer to return the result and the controller to set the location header.
If you do this in one step, the location is captured when the fluent Api is built and the location will never be updated when the ToActionCreatedResultAction is called!


        Uri? location = null;

        var result = await bl.DoSomethingAsync(dto, cancellation)
                                         .OnSuccess((contract) => location = new Uri(Url.ActionLink("GetById", "Contract", new { id = contract.Id })!))
                                         .ConfigureAwait(false);

        return await result.ToActionCreatedResultAsync(location, mapper.Map<ContractDto>)
                           .ConfigureAwait(false);

Error path:

When an error occurs, the business layer will return a Result object with the error information.

Different cases could happen:

  • An exception was thrown.
  • A validation error occured.
  • A Problem occured.
Exception

When an exception is thrown, a 500 InternalServerError is returned with a ProblemDetails message explaining that the exception is log with an activyId. There is no more explanation about the exception to avoid leaking information.

Validation error

When some parameters or Dto is given to a controller, code will validate the inputs.
If the validation fails, a 422 UnprocessableEntity is returned with a ValidationProblemDetails message explaining the validation errors.
The code of the validation error is used to categorrized the errors (they are grouped by code).

Problem

When a problemDetailError is returned, a 500 InternalServerError is returned with a ProblemDetails message explaining the error when no specific StatusCode is given.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Arc4u.Standard.OAuth2.AspNetCore:

Package Downloads
Arc4u.Standard.OAuth2.AspNetCore.Msal

Core Framework used in AspNetCore to authenticate user based on Msal.

Arc4u.Standard.OAuth2.AspNetCore.Authentication

Package Description

Arc4u.Standard.OAuth2.AspNetCore.Adal

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
8.3.2-preview08 286 6/11/2025
8.3.2-preview07 282 6/10/2025
8.3.2-preview06 135 6/3/2025
8.3.2-preview05 71 5/31/2025
8.3.2-preview04 102 5/25/2025
8.3.2-preview03 233 5/13/2025
8.3.2-preview02 138 5/10/2025
8.3.2-preview01 163 5/7/2025
8.3.1 172 5/5/2025
8.3.0 157 5/4/2025
8.3.0-preview04 91 5/3/2025
8.3.0-preview03 101 2/15/2025
8.3.0-preview02 107 11/14/2024
8.3.0-preview01 169 8/30/2024
8.2.1 723 11/10/2024
8.2.1-preview01 143 11/9/2024
8.2.0 1,408 8/16/2024
8.2.0-preview31 168 8/16/2024
8.2.0-preview30 191 8/1/2024
8.2.0-preview29 103 7/25/2024
8.2.0-preview28 103 7/25/2024
8.2.0-preview27 170 6/28/2024
8.2.0-preview26 174 6/27/2024
8.2.0-preview25 163 6/26/2024
8.2.0-preview24 164 6/9/2024
8.2.0-preview23 252 5/29/2024
8.2.0-preview22 186 5/26/2024
8.2.0-preview21 162 5/22/2024
8.2.0-preview20 179 5/19/2024
8.2.0-preview19 131 5/18/2024
8.2.0-preview18 124 5/12/2024
8.2.0-preview17 114 5/12/2024
8.2.0-preview16 113 5/12/2024
8.2.0-preview15 120 5/11/2024
8.2.0-preview14 124 5/10/2024
8.2.0-preview13 114 5/9/2024
8.2.0-preview12 159 5/8/2024
8.2.0-preview11 172 5/7/2024
8.2.0-preview10 154 5/5/2024
8.2.0-preview09 159 5/4/2024
8.2.0-preview08 138 4/25/2024
8.2.0-preview07 171 4/23/2024
8.2.0-preview06 154 4/23/2024
8.2.0-preview05 149 4/21/2024
8.2.0-preview04 140 4/20/2024
8.2.0-preview03 130 4/17/2024
8.2.0-preview02 163 4/12/2024
8.2.0-preview01 172 4/11/2024
8.1.0 2,258 2/7/2024
8.1.0-preview10 151 2/6/2024
8.1.0-preview09 149 1/29/2024
8.1.0-preview08 198 1/9/2024
8.1.0-preview07 197 12/31/2023
8.1.0-preview06 159 12/30/2023
8.1.0-preview05 168 12/24/2023
8.1.0-preview04 155 12/23/2023
8.1.0-preview03 157 12/20/2023
8.1.0-preview02 169 12/20/2023
8.1.0-preview01 172 12/19/2023
8.0.0 260 12/15/2023
8.0.0-preview01 174 12/14/2023
6.1.22.1-preview06 206 11/25/2023
6.1.22.1-preview05 150 11/24/2023
6.1.22.1-preview04 179 11/20/2023
6.1.22.1-preview03 180 11/17/2023
6.1.22.1-preview02 140 11/17/2023
6.1.22.1-preview01 129 11/16/2023
6.1.21.1-preview04 144 10/10/2023
6.1.21.1-preview03 112 10/10/2023
6.1.21.1-preview02 111 10/5/2023
6.1.21.1-preview01 111 9/21/2023
6.1.20.1-preview03 127 8/31/2023
6.1.20.1-preview02 210 8/14/2023
6.1.20.1-preview01 180 8/13/2023
6.1.18.1 845 8/18/2023
6.0.14.3-preview56 184 8/7/2023
6.0.14.3-preview55 162 8/4/2023
6.0.14.3-preview54 197 8/3/2023
6.0.14.3-preview53 198 8/1/2023
6.0.14.3-preview52 198 7/26/2023
6.0.14.3-preview51 211 7/26/2023
6.0.14.3-preview50 206 7/19/2023
6.0.14.3-preview49 182 7/19/2023
6.0.14.3-preview48 212 7/12/2023
6.0.14.3-preview47 195 7/6/2023
6.0.14.3-preview46 194 7/3/2023
6.0.14.3-preview45 186 6/24/2023
6.0.14.3-preview44 205 6/18/2023
6.0.14.3-preview43 178 6/18/2023
6.0.14.3-preview42 185 6/14/2023
6.0.14.3-preview41 197 6/12/2023
6.0.14.3-preview40 190 6/9/2023
6.0.14.3-preview39 187 6/8/2023
6.0.14.3-preview38 189 5/30/2023
6.0.14.3-preview37 212 5/29/2023
6.0.14.3-preview36 210 5/26/2023
6.0.14.3-preview35 206 5/23/2023
6.0.14.3-preview34 186 5/22/2023
6.0.14.3-preview33 212 5/19/2023
6.0.14.3-preview32 208 5/19/2023
6.0.14.3-preview31 197 5/18/2023
6.0.14.3-preview30 197 5/12/2023
6.0.14.3-preview29 198 5/12/2023
6.0.14.3-preview28 195 5/10/2023
6.0.14.3-preview27 214 5/8/2023
6.0.14.3-preview26 218 5/7/2023
6.0.14.3-preview25 210 5/3/2023
6.0.14.3-preview24 213 4/29/2023
6.0.14.3-preview23 219 4/28/2023
6.0.14.3-preview22 191 4/27/2023
6.0.14.3-preview21 202 4/26/2023
6.0.14.3-preview20 208 4/24/2023
6.0.14.3-preview19 213 4/18/2023
6.0.14.3-preview18 208 4/17/2023
6.0.14.3-preview17 234 4/16/2023
6.0.14.3-preview16 178 4/14/2023
6.0.14.3-preview15 220 4/14/2023
6.0.14.3-preview14 201 4/11/2023
6.0.14.3-preview13 251 4/3/2023
6.0.14.3-preview12 203 4/1/2023
6.0.14.3-preview11 215 4/1/2023
6.0.14.3-preview10 211 3/30/2023
6.0.14.3-preview09 198 3/29/2023
6.0.14.3-preview08 237 3/25/2023
6.0.14.3-preview07 218 3/24/2023
6.0.14.3-preview06 219 3/19/2023
6.0.14.3-preview05 212 3/17/2023
6.0.14.3-preview04 196 3/15/2023
6.0.14.3-preview03 176 3/15/2023
6.0.14.3-preview02 214 3/14/2023
6.0.14.3-preview01 189 3/11/2023
6.0.14.2 1,560 3/8/2023
6.0.14.2-preview02 204 3/4/2023
6.0.14.2-preview01 192 3/3/2023
6.0.14.1 447 2/17/2023
6.0.14.1-preview02 216 2/16/2023
6.0.14.1-preview01 212 2/15/2023
6.0.13.1 431 2/15/2023
6.0.12.1 453 2/15/2023
6.0.11.2 443 2/15/2023
6.0.11.2-preview03 194 2/14/2023
6.0.11.2-preview02 206 2/13/2023
6.0.11.2-preview01 205 2/12/2023
6.0.11.1 3,194 1/11/2023
6.0.11.1-preview11 210 1/10/2023
6.0.11.1-preview10 203 1/10/2023
6.0.11.1-preview09 250 1/8/2023
6.0.11.1-preview08 232 1/4/2023
6.0.11.1-preview07 223 1/3/2023
6.0.11.1-preview06 207 1/3/2023
6.0.11.1-preview05 218 1/2/2023
6.0.11.1-preview04 198 1/2/2023
6.0.11.1-preview03 179 12/10/2022
6.0.11.1-preview02 185 11/15/2022
6.0.11.1-preview01 316 11/11/2022
6.0.9.3 3,139 11/8/2022
6.0.9.2 758 9/27/2022
6.0.9.1 4,281 9/17/2022
6.0.8.4 660 11/8/2022
6.0.8.3 804 9/27/2022
6.0.8.2 650 9/16/2022
6.0.8.1 637 9/7/2022
6.0.8.1-preview02 192 9/5/2022
6.0.8.1-preview01 220 8/18/2022
6.0.6.1-preview03 254 6/25/2022
6.0.6.1-preview02 236 6/15/2022
6.0.6.1-preview01 198 6/15/2022
6.0.5.1-preview01 474 5/10/2022
6.0.4.1-preview04 240 5/7/2022
6.0.4.1-preview03 251 4/27/2022
6.0.4.1-preview02 222 4/27/2022
6.0.4.1-preview01 220 4/24/2022
5.0.17.3 737 9/19/2022
5.0.17.3-preview01 261 9/16/2022
5.0.17.2 688 9/1/2022
5.0.17.2-preview07 211 8/29/2022
5.0.17.2-preview06 213 8/24/2022
5.0.17.2-preview05 209 8/24/2022
5.0.17.2-preview04 181 8/23/2022
5.0.17.2-preview03 209 8/22/2022
5.0.17.2-preview02 197 8/22/2022
5.0.17.2-preview01 208 8/17/2022
5.0.17.1 732 5/30/2022
5.0.16.1 738 5/7/2022
5.0.16.1-preview02 252 4/17/2022
5.0.16.1-preview01 230 4/14/2022
5.0.15.1-preview07 250 4/2/2022
5.0.15.1-preview06 221 4/1/2022
5.0.15.1-preview05 216 3/30/2022
5.0.15.1-preview04 247 3/27/2022
5.0.15.1-preview03 223 3/18/2022
5.0.15.1-preview02 242 3/13/2022
5.0.15.1-preview01 236 3/13/2022
5.0.14.1-preview9 223 3/1/2022
5.0.14.1-preview7 223 2/23/2022
5.0.14.1-preview6 242 2/20/2022
5.0.14.1-preview5 229 2/20/2022
5.0.14.1-preview4 226 2/19/2022
5.0.14.1-preview3 243 2/19/2022
5.0.14.1-preview2 239 2/10/2022
5.0.14.1-preview13 207 3/11/2022
5.0.14.1-preview12 244 3/9/2022
5.0.14.1-preview11 249 3/7/2022
5.0.14.1-preview10 243 3/2/2022
5.0.14.1-preview1 234 2/9/2022
5.0.13.1-preview4 256 1/30/2022
5.0.13.1-preview3 243 1/29/2022
5.0.13.1-preview2 251 1/29/2022
5.0.13.1-preview1 241 1/29/2022
5.0.11.2 2,220 10/20/2021
5.0.11.2-preview1 321 10/19/2021
5.0.11.1 544 10/19/2021
5.0.11.1-preview4 284 10/19/2021
5.0.11.1-preview3 342 10/18/2021
5.0.11.1-preview2 342 10/17/2021
5.0.11.1-preview1 321 10/16/2021
5.0.10.3 576 9/30/2021
5.0.10.2 626 9/30/2021
5.0.10.1 570 9/28/2021
5.0.9.1-preview1 291 9/1/2021
5.0.8.2 408 8/19/2021
5.0.8.1 431 8/11/2021
5.0.6.4 469 7/13/2021
5.0.6.3 962 7/10/2021
5.0.6.2 418 7/7/2021
5.0.6.1 883 6/29/2021
5.0.6.1-rc16 323 6/21/2021
5.0.6.1-rc15 319 6/20/2021
5.0.6 2,101 5/21/2021
5.0.5 477 5/21/2021
1.0.0 183 5/18/2024