Skip to content

Commit

Permalink
prepare v16
Browse files Browse the repository at this point in the history
  • Loading branch information
manfredsteyer committed Dec 16, 2023
1 parent f5d940c commit f1d3c38
Show file tree
Hide file tree
Showing 100 changed files with 3,279 additions and 1,709 deletions.
11 changes: 10 additions & 1 deletion .vscode/settings.json
Original file line number Diff line number Diff line change
Expand Up @@ -32,5 +32,14 @@
"latex",
"plaintext",
"markdown"
]
],
"files.exclude": {
"**/.git": true,
"**/.svn": true,
"**/.hg": true,
"**/CVS": true,
"**/.DS_Store": true,
"**/Thumbs.db": true
},
"hide-files.files": []
}
10 changes: 0 additions & 10 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,7 @@
# Changelog

All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.

## [16.1.0](https://github.com/manfredsteyer/angular-oauth2-oidc/compare/v10.0.3...v16.1.0) (2023-12-16)


### Features

* introduce DateTimeProvider ([0c0a4a7](https://github.com/manfredsteyer/angular-oauth2-oidc/commit/0c0a4a7a2574c8c134fa839f7ccdee06273a0676))
* **logout:** postLogoutRedirectUri should not default to redirectUri ([ff7d1d9](https://github.com/manfredsteyer/angular-oauth2-oidc/commit/ff7d1d915aa19f87bcb1c2d18ac3eb280db78d3b))
* provide standalone api ([e38c99c](https://github.com/manfredsteyer/angular-oauth2-oidc/commit/e38c99c5f70f23fad892328e2a6f01f1e813af4c))
* support JWT response on userinfo endpoint ([da16494](https://github.com/manfredsteyer/angular-oauth2-oidc/commit/da1649499376863b0ebf884748176f3b38d91899))
* update for angular 13 ([d95d7da](https://github.com/manfredsteyer/angular-oauth2-oidc/commit/d95d7da788e2c1390346c66de62dc31f10d2b852))
* update project to Angular 16 ([b999024](https://github.com/manfredsteyer/angular-oauth2-oidc/commit/b999024b1bb7fdb40f07810a75add60f47fe5f08))


Expand Down
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,9 @@ For using this library with **Azure Active Directory** (**Azure AD**), we recomm

Also, the Okta community created some guidelines on how to use this lib with Okta. See the links at the end of this page for more information.

**Angular 15 & 16**: Use 15.x versions of this library (**should also work with older Angular versions!**).
**Angular 16**: Use 16.x versions of this library (**should also work with older Angular versions!**).

**Angular 15**: Use 15.x versions of this library (**should also work with older Angular versions!**).

**Angular 14**: Use 14.x versions of this library (**should also work with older Angular versions!**).

Expand Down
27 changes: 19 additions & 8 deletions docs/additional-documentation/adapt-id_token-validation.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@

<link rel="icon" type="image/x-icon" href="../images/favicon.ico">
<link rel="stylesheet" href="../styles/style.css">
<link rel="stylesheet" href="../styles/dark.css" media="(prefers-color-scheme: dark)">
<link rel="stylesheet" href="../styles/dark.css">
</head>
<body>

<div class="navbar navbar-default navbar-fixed-top visible-xs">
<div class="navbar navbar-default navbar-fixed-top d-block d-sm-none">
<a href="../" class="navbar-brand">angular-oauth2-oidc</a>
<button type="button" class="btn btn-default btn-menu ion-ios-menu" id="btn-menu"></button>
</div>
Expand Down Expand Up @@ -44,12 +44,14 @@








<h1 id="configure-adapt-id_token-validation">Configure/ Adapt id_token Validation</h1>



<h1>Configure/ Adapt id_token Validation</h1>
<p>You can hook in an implementation of the interface <code>TokenValidator</code> to validate the signature of the received id_token and its at_hash property. This packages provides two implementations:</p>
<ul>
<li>JwksValidationHandler</li>
Expand All @@ -61,7 +63,7 @@ <h1 id="configure-adapt-id_token-validation">Configure/ Adapt id_token Validatio
[...]

this.oauthService.tokenValidationHandler = new JwksValidationHandler();</code></pre></div><p>In cases where no ValidationHandler is defined, you receive a warning on the console. This means that the library wants you to explicitly decide on this.</p>
<h2 id="dependency-injection">Dependency Injection</h2>
<h2>Dependency Injection</h2>
<p>You can also setup a ValidationHandler by leveraging dependency injection:</p>
<div><pre class="line-numbers"><code class="language-TypeScript">[...]
providers: [
Expand All @@ -70,7 +72,7 @@ <h2 id="dependency-injection">Dependency Injection</h2>
[...]</code></pre></div>
</div><div class="search-results">
<div class="has-results">
<h1 class="search-results-title"><span class='search-results-count'></span> result-matching "<span class='search-query'></span>"</h1>
<h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
<ul class="search-results-list"></ul>
</div>
<div class="no-results">
Expand All @@ -82,6 +84,15 @@ <h1 class="search-results-title">No results matching "<span class='search-query'
</div>
</div>

<label class="dark-mode-switch">
<input type="checkbox">
<span class="slider">
<svg class="slider-icon" viewBox="0 0 24 24" fill="none" height="20" stroke="#000" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" width="20" xmlns="http://www.w3.org/2000/svg">
<path d="M21 12.79A9 9 0 1111.21 3 7 7 0 0021 12.79z"></path>
</svg>
</span>
</label>

<script>
var COMPODOC_CURRENT_PAGE_DEPTH = 1;
var COMPODOC_CURRENT_PAGE_CONTEXT = 'additional-page';
Expand All @@ -91,8 +102,8 @@ <h1 class="search-results-title">No results matching "<span class='search-query'

<script src="../js/libs/custom-elements.min.js"></script>
<script src="../js/libs/lit-html.js"></script>
<script type="module" src="../js/menu-wc.js" defer></script>

<script src="../js/menu-wc.js" defer></script>
<script nomodule src="../js/menu-wc_es5.js" defer></script>

<script src="../js/libs/bootstrap-native.js"></script>
Expand Down
25 changes: 18 additions & 7 deletions docs/additional-documentation/authorization-servers.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@

<link rel="icon" type="image/x-icon" href="../images/favicon.ico">
<link rel="stylesheet" href="../styles/style.css">
<link rel="stylesheet" href="../styles/dark.css" media="(prefers-color-scheme: dark)">
<link rel="stylesheet" href="../styles/dark.css">
</head>
<body>

<div class="navbar navbar-default navbar-fixed-top visible-xs">
<div class="navbar navbar-default navbar-fixed-top d-block d-sm-none">
<a href="../" class="navbar-brand">angular-oauth2-oidc</a>
<button type="button" class="btn btn-default btn-menu ion-ios-menu" id="btn-menu"></button>
</div>
Expand Down Expand Up @@ -44,18 +44,20 @@








<h1 id="support-for-auth-servers">Support for Auth Servers</h1>



<h1>Support for Auth Servers</h1>
<p>As this lib follows the OAuth2 and OpenId Connect specs, it should work with all compliant authorizations servers.</p>
<p>However, experience shows that some authorizations servers come with some special behavior or settings. Hence, we must respect this when using this lib.</p>

</div><div class="search-results">
<div class="has-results">
<h1 class="search-results-title"><span class='search-results-count'></span> result-matching "<span class='search-query'></span>"</h1>
<h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
<ul class="search-results-list"></ul>
</div>
<div class="no-results">
Expand All @@ -67,6 +69,15 @@ <h1 class="search-results-title">No results matching "<span class='search-query'
</div>
</div>

<label class="dark-mode-switch">
<input type="checkbox">
<span class="slider">
<svg class="slider-icon" viewBox="0 0 24 24" fill="none" height="20" stroke="#000" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" width="20" xmlns="http://www.w3.org/2000/svg">
<path d="M21 12.79A9 9 0 1111.21 3 7 7 0 0021 12.79z"></path>
</svg>
</span>
</label>

<script>
var COMPODOC_CURRENT_PAGE_DEPTH = 1;
var COMPODOC_CURRENT_PAGE_CONTEXT = 'additional-page';
Expand All @@ -76,8 +87,8 @@ <h1 class="search-results-title">No results matching "<span class='search-query'

<script src="../js/libs/custom-elements.min.js"></script>
<script src="../js/libs/lit-html.js"></script>
<script type="module" src="../js/menu-wc.js" defer></script>

<script src="../js/menu-wc.js" defer></script>
<script nomodule src="../js/menu-wc_es5.js" defer></script>

<script src="../js/libs/bootstrap-native.js"></script>
Expand Down
33 changes: 22 additions & 11 deletions docs/additional-documentation/authorization-servers/auth0.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@

<link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
<link rel="stylesheet" href="../../styles/style.css">
<link rel="stylesheet" href="../../styles/dark.css" media="(prefers-color-scheme: dark)">
<link rel="stylesheet" href="../../styles/dark.css">
</head>
<body>

<div class="navbar navbar-default navbar-fixed-top visible-xs">
<div class="navbar navbar-default navbar-fixed-top d-block d-sm-none">
<a href="../../" class="navbar-brand">angular-oauth2-oidc</a>
<button type="button" class="btn btn-default btn-menu ion-ios-menu" id="btn-menu"></button>
</div>
Expand Down Expand Up @@ -44,19 +44,21 @@








<h1 id="using-auth0">Using Auth0</h1>



<h1>Using Auth0</h1>
<p>To use this lib with Auth0, open your Auth0 account and configure:</p>
<ul>
<li>An app </li>
<li>An API</li>
</ul>
<p>Configure the app to use <code>refresh token rotation</code> and the grant types <code>authorization code</code> and <code>refresh token</code>. For grant types, see the advanced settings at the end of the settings page.</p>
<h2 id="configuration">Configuration</h2>
<h2>Configuration</h2>
<p>Provide a configuration like this:</p>
<div><pre class="line-numbers"><code class="language-typescript">import { AuthConfig } from &#39;angular-oauth2-oidc&#39;;

Expand All @@ -78,20 +80,20 @@ <h2 id="configuration">Configuration</h2>
// Your API&#39;s name
audience: &#39;http://www.angular.at/api&#39;
},
};</code></pre></div><h2 id="getting-using-and-refreshing-a-token">Getting, Using, and Refreshing a Token</h2>
};</code></pre></div><h2>Getting, Using, and Refreshing a Token</h2>
<p>This should work as shown in the other examples in this documentation and in the readme file.</p>
<h2 id="logging-out">Logging out</h2>
<h2>Logging out</h2>
<p>Auth0&#39;s logout endpoint expects the parameters <code>client_id</code> and <code>returnTo</code>:</p>
<div><pre class="line-numbers"><code class="language-typescript">this.oauthService.revokeTokenAndLogout({
client_id: this.oauthService.clientId,
returnTo: this.oauthService.redirectUri
}, true);</code></pre></div><p>The optional 2nd parameter set to <code>true</code> ignores CORS issues with the logout endpoint.</p>
<h2 id="example">Example</h2>
<h2>Example</h2>
<p>Please find a <a href="https://github.com/manfredsteyer/auth0-demo">demo</a> for using Auth0 with angular-oauth2-oidc <a href="https://github.com/manfredsteyer/auth0-demo">here</a>.</p>

</div><div class="search-results">
<div class="has-results">
<h1 class="search-results-title"><span class='search-results-count'></span> result-matching "<span class='search-query'></span>"</h1>
<h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
<ul class="search-results-list"></ul>
</div>
<div class="no-results">
Expand All @@ -103,6 +105,15 @@ <h1 class="search-results-title">No results matching "<span class='search-query'
</div>
</div>

<label class="dark-mode-switch">
<input type="checkbox">
<span class="slider">
<svg class="slider-icon" viewBox="0 0 24 24" fill="none" height="20" stroke="#000" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" width="20" xmlns="http://www.w3.org/2000/svg">
<path d="M21 12.79A9 9 0 1111.21 3 7 7 0 0021 12.79z"></path>
</svg>
</span>
</label>

<script>
var COMPODOC_CURRENT_PAGE_DEPTH = 2;
var COMPODOC_CURRENT_PAGE_CONTEXT = 'additional-page';
Expand All @@ -112,8 +123,8 @@ <h1 class="search-results-title">No results matching "<span class='search-query'

<script src="../../js/libs/custom-elements.min.js"></script>
<script src="../../js/libs/lit-html.js"></script>
<script type="module" src="../../js/menu-wc.js" defer></script>

<script src="../../js/menu-wc.js" defer></script>
<script nomodule src="../../js/menu-wc_es5.js" defer></script>

<script src="../../js/libs/bootstrap-native.js"></script>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@

<link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
<link rel="stylesheet" href="../../styles/style.css">
<link rel="stylesheet" href="../../styles/dark.css" media="(prefers-color-scheme: dark)">
<link rel="stylesheet" href="../../styles/dark.css">
</head>
<body>

<div class="navbar navbar-default navbar-fixed-top visible-xs">
<div class="navbar navbar-default navbar-fixed-top d-block d-sm-none">
<a href="../../" class="navbar-brand">angular-oauth2-oidc</a>
<button type="button" class="btn btn-default btn-menu ion-ios-menu" id="btn-menu"></button>
</div>
Expand Down Expand Up @@ -44,17 +44,19 @@








<h1 id="using-with-azure-ad">Using with Azure AD</h1>



<h1>Using with Azure AD</h1>
<p>For using this library with <strong>Azure Active Directory</strong> (<strong>Azure AD</strong>), we recommend an additional look to this <a href="https://dev.to/yuriburger/azure-active-directory-b2c-with-pkce-for-your-angular-app-1dcg">blog post</a> and the example linked at the end of this blog post.</p>

</div><div class="search-results">
<div class="has-results">
<h1 class="search-results-title"><span class='search-results-count'></span> result-matching "<span class='search-query'></span>"</h1>
<h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
<ul class="search-results-list"></ul>
</div>
<div class="no-results">
Expand All @@ -66,6 +68,15 @@ <h1 class="search-results-title">No results matching "<span class='search-query'
</div>
</div>

<label class="dark-mode-switch">
<input type="checkbox">
<span class="slider">
<svg class="slider-icon" viewBox="0 0 24 24" fill="none" height="20" stroke="#000" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" width="20" xmlns="http://www.w3.org/2000/svg">
<path d="M21 12.79A9 9 0 1111.21 3 7 7 0 0021 12.79z"></path>
</svg>
</span>
</label>

<script>
var COMPODOC_CURRENT_PAGE_DEPTH = 2;
var COMPODOC_CURRENT_PAGE_CONTEXT = 'additional-page';
Expand All @@ -75,8 +86,8 @@ <h1 class="search-results-title">No results matching "<span class='search-query'

<script src="../../js/libs/custom-elements.min.js"></script>
<script src="../../js/libs/lit-html.js"></script>
<script type="module" src="../../js/menu-wc.js" defer></script>

<script src="../../js/menu-wc.js" defer></script>
<script nomodule src="../../js/menu-wc_es5.js" defer></script>

<script src="../../js/libs/bootstrap-native.js"></script>
Expand Down
Loading

0 comments on commit f1d3c38

Please sign in to comment.