BizDoc.Authentication.Okta
7.4.3
See the version list below for details.
dotnet add package BizDoc.Authentication.Okta --version 7.4.3
NuGet\Install-Package BizDoc.Authentication.Okta -Version 7.4.3
<PackageReference Include="BizDoc.Authentication.Okta" Version="7.4.3" />
paket add BizDoc.Authentication.Okta --version 7.4.3
#r "nuget: BizDoc.Authentication.Okta, 7.4.3"
// Install BizDoc.Authentication.Okta as a Cake Addin #addin nuget:?package=BizDoc.Authentication.Okta&version=7.4.3 // Install BizDoc.Authentication.Okta as a Cake Tool #tool nuget:?package=BizDoc.Authentication.Okta&version=7.4.3
Okta for BizDoc
BizDoc supports Okta for both authentication and authorization, in one of two configurations: server flow or client flow.
Server flow redirects unauthorized users to Okta sign-in page on Okta domain, and handles the redirect. Client flow prompts unauthorized users for credentials in an hosted widget, and negotiate with Okta on the background.
- For both modes, install BizDoc Nuget package:
dotnet add package BizDoc.Core.Okta
- Add Okta application. If using server mode, choose Web Application. If using client mode, choose ODIC - OpenID Connect, and select SPA.
Okta sign-in redirect url should match "/authorization-code/callback" on server mode, and no path for client mode.
Create an API Token to allow BizDoc to retrieve users information.
- In startup.cs, add Okta service.
For server flow, use AddOktaRedirect:
AddBizDoc(o=> {
o.ApplicationUri = "https://app-domain";
})
.AddOktaServer(o=> {
o.ApiToken = "api-token";
o.Domain = "domain-name";
o.ClientId = "client-id";
o.ClientSecret = "client-secret";
});
...
UseBizDoc().
.UseOktaServer();
For client mode, use AddOkta:
AddBizDoc(...)
.AddOkta(o=> {
o.ApiToken = "api-token";
o.Domain = "domain-name";
}).
UseIdentityProvider();
The UseIdentityProvider() method registers an identity provider which retrieve user information from Okta. To use a different provider, while still authenticating via Okta, see Implementing Identity Provider.
- Client mode only, install Angular package:
npm i @bizdoc/okta
Add Okta configuration in Angular app.module:
OktaModule.forRoot({
domain: 'domain-name',
clientId: 'client-id'
})
Roles
In order to map user groups to BizDoc roles for authorization purposes, add a new claim to Okta Authorization Server with the following specifications.
Property | Value |
---|---|
Name | bizdoc.roles |
Include in token type | ID Token |
Value type | Groups |
Filter | Matches regex, .* |
Include in | Any scope |
System
Add an attribute to either application profile or all profiles and set its type to boolean. Add a claim in API server that map to the profile attribute you created.
Property | Value |
---|---|
Name | bizdoc.admin |
Include in token type | ID Token |
Value type | Expression |
Value | user.{attr-name-here} |
Widgets
Staff Performance, current user is manager.
Staff Pending, current user is manager.
Groups Performance, selected groups, or current user groups.
Attributes
Implicit user attributes for analysis axes.
Name | Usage |
---|---|
CostCenter | |
Department | |
Division | |
Organization | |
Owner Additional Property | PropertyName required. |
A type must be set for attributes in Architecture tool to enable the analysis to map to an axis.
Rules
User attribues available within rule expression.
Name | Usage |
---|---|
CostCenter | |
Department | |
Division | |
Organization | |
User Additional Property | PropertyName required. |
Owner Additional Property | PropertyName required. |
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. 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. |
-
net7.0
- Microsoft.AspNetCore.Authentication.JwtBearer (>= 7.0.8)
- Microsoft.AspNetCore.Authentication.OpenIdConnect (>= 7.0.8)
- Okta.Sdk (>= 7.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
8.8.1 | 78 | 9/17/2024 |
8.8.0 | 74 | 8/28/2024 |
8.7.0 | 48 | 7/29/2024 |
8.6.0 | 77 | 7/10/2024 |
8.5.15 | 91 | 5/28/2024 |
8.5.14 | 70 | 5/14/2024 |
8.5.13 | 92 | 4/23/2024 |
8.4.13 | 98 | 2/22/2024 |
8.4.12 | 91 | 2/20/2024 |
8.4.11 | 99 | 2/7/2024 |
8.4.10 | 95 | 2/2/2024 |
8.4.9 | 104 | 1/18/2024 |
8.4.8 | 104 | 1/12/2024 |
7.4.8 | 120 | 1/1/2024 |
7.4.7 | 115 | 1/1/2024 |
7.4.6 | 112 | 1/1/2024 |
7.4.5 | 123 | 12/31/2023 |
7.4.4 | 158 | 11/26/2023 |
7.4.3 | 120 | 11/22/2023 |
7.4.2 | 115 | 11/22/2023 |
7.3.2 | 131 | 8/14/2023 |
7.2.2 | 164 | 6/24/2023 |
7.1.2 | 144 | 6/2/2023 |
7.1.1 | 138 | 5/11/2023 |
7.1.0 | 138 | 5/4/2023 |
7.0.2 | 183 | 4/11/2023 |
7.0.1 | 205 | 3/30/2023 |
7.0.0 | 295 | 11/28/2022 |
6.8.11 | 317 | 11/8/2022 |
6.8.10 | 327 | 11/6/2022 |
6.8.8 | 340 | 10/31/2022 |
6.8.7 | 340 | 10/28/2022 |
6.8.6 | 350 | 10/27/2022 |
6.8.5 | 346 | 10/27/2022 |
6.8.4 | 379 | 10/24/2022 |
6.8.3 | 412 | 10/20/2022 |
6.8.2 | 394 | 10/20/2022 |