deploy: 7d5068a

feed.xml

@@ -5,7 +5,7 @@
         <title>Quarkus</title>
         <link>https://quarkus.io</link>
         <description>Quarkus: Supersonic Subatomic Java</description>
-        <lastBuildDate>Thu, 31 Oct 2024 11:57:04 +0000</lastBuildDate>
+        <lastBuildDate>Fri, 01 Nov 2024 03:15:29 +0000</lastBuildDate>
 
 
         <item>

version/main/guides/all-config.html

@@ -65977,7 +65977,7 @@ <h3 class="mb-0"></h3>
 <p><i class="fa fa-chevron-down"></i><span>Show more</span></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"><div class="content"><div class="paragraph">
-<p><code>apple</code>, <code>discord</code>, <code>facebook</code>, <code>github</code>, <code>google</code>, <code>linkedin</code>, <code>mastodon</code>, <code>microsoft</code>, <code>spotify</code>, <code>strava</code>, <code>twitch</code>, <code>twitter</code>, <code>x</code></p>
+<p><code>apple</code>, <code>discord</code>, <code>facebook</code>, <code>github</code>, <code>google</code>, <code>linkedin</code>, <code>mastodon</code>, <code>microsoft</code>, <code>slack</code>, <code>spotify</code>, <code>strava</code>, <code>twitch</code>, <code>twitter</code>, <code>x</code></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"></td>
 </tr>
@@ -68968,7 +68968,7 @@ <h3 class="mb-0"></h3>
 <p><i class="fa fa-chevron-down"></i><span>Show more</span></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"><div class="content"><div class="paragraph">
-<p><code>apple</code>, <code>discord</code>, <code>facebook</code>, <code>github</code>, <code>google</code>, <code>linkedin</code>, <code>mastodon</code>, <code>microsoft</code>, <code>spotify</code>, <code>strava</code>, <code>twitch</code>, <code>twitter</code>, <code>x</code></p>
+<p><code>apple</code>, <code>discord</code>, <code>facebook</code>, <code>github</code>, <code>google</code>, <code>linkedin</code>, <code>mastodon</code>, <code>microsoft</code>, <code>slack</code>, <code>spotify</code>, <code>strava</code>, <code>twitch</code>, <code>twitter</code>, <code>x</code></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"></td>
 </tr>

version/main/guides/doc-reference.html

@@ -1214,7 +1214,7 @@ <h3 id="document-variables"><a class="anchor" href="#document-variables"></a>Qua
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>{quarkus-images-url}</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="https://github.com/quarkusio/quarkus-images/tree" class="bare">https://github.com/quarkusio/quarkus-images/tree</a></code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="https://github.com/quarkusio/quarkus-images" class="bare">https://github.com/quarkusio/quarkus-images</a></code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">Quarkus URL to set of container images delivered for Quarkus.</p></td>
 </tr>
 <tr>

version/main/guides/getting-started-reactive.html

@@ -526,6 +526,10 @@ <h2 id="reactive-resource"><a class="anchor" href="#reactive-resource"></a>React
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package org.acme.hibernate.orm.panache;
 
+import java.util.List;
+
+import io.quarkus.panache.common.Sort;
+import io.smallrye.mutiny.Uni;
 import jakarta.enterprise.context.ApplicationScoped;
 import jakarta.ws.rs.Path;
 

version/main/guides/security-oidc-configuration-properties-reference.html

@@ -3247,7 +3247,7 @@ <h2 id="oidc-configuration"><a class="anchor" href="#oidc-configuration"></a>OID
 <p><i class="fa fa-chevron-down"></i><span>Show more</span></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"><div class="content"><div class="paragraph">
-<p><code>apple</code>, <code>discord</code>, <code>facebook</code>, <code>github</code>, <code>google</code>, <code>linkedin</code>, <code>mastodon</code>, <code>microsoft</code>, <code>spotify</code>, <code>strava</code>, <code>twitch</code>, <code>twitter</code>, <code>x</code></p>
+<p><code>apple</code>, <code>discord</code>, <code>facebook</code>, <code>github</code>, <code>google</code>, <code>linkedin</code>, <code>mastodon</code>, <code>microsoft</code>, <code>slack</code>, <code>spotify</code>, <code>strava</code>, <code>twitch</code>, <code>twitter</code>, <code>x</code></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"></td>
 </tr>
@@ -6238,7 +6238,7 @@ <h2 id="oidc-configuration"><a class="anchor" href="#oidc-configuration"></a>OID
 <p><i class="fa fa-chevron-down"></i><span>Show more</span></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"><div class="content"><div class="paragraph">
-<p><code>apple</code>, <code>discord</code>, <code>facebook</code>, <code>github</code>, <code>google</code>, <code>linkedin</code>, <code>mastodon</code>, <code>microsoft</code>, <code>spotify</code>, <code>strava</code>, <code>twitch</code>, <code>twitter</code>, <code>x</code></p>
+<p><code>apple</code>, <code>discord</code>, <code>facebook</code>, <code>github</code>, <code>google</code>, <code>linkedin</code>, <code>mastodon</code>, <code>microsoft</code>, <code>slack</code>, <code>spotify</code>, <code>strava</code>, <code>twitch</code>, <code>twitter</code>, <code>x</code></p>
 </div></div></td>
 <td class="tableblock halign-left valign-middle"></td>
 </tr>

version/main/guides/security-openid-connect-client-reference.html

@@ -1702,7 +1702,7 @@ <h2 id="token-propagation-rest"><a class="anchor" href="#token-propagation-rest"
 <p>Additionally, <code>AccessTokenRequestReactiveFilter</code> can support a complex application that needs to exchange the tokens before propagating them.</p>
 </div>
 <div class="paragraph">
-<p>If you work with <a href="https://www.keycloak.org/docs/latest/securing_apps/#_token-exchange">Keycloak</a> or another OIDC provider that supports a <a href="https://tools.ietf.org/html/rfc8693">Token Exchange</a> token grant, then you can configure <code>AccessTokenRequestReactiveFilter</code> to exchange the token like this:</p>
+<p>If you work with <a href="https://www.keycloak.org/securing-apps/token-exchange">Keycloak</a> or another OIDC provider that supports a <a href="https://tools.ietf.org/html/rfc8693">Token Exchange</a> token grant, then you can configure <code>AccessTokenRequestReactiveFilter</code> to exchange the token like this:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -1828,7 +1828,7 @@ <h3 id="restclient-accesstokenrequestfilter"><a class="anchor" href="#restclient
 <div class="sect3">
 <h4 id="exchange-token-before-propagation"><a class="anchor" href="#exchange-token-before-propagation"></a>Exchange token before propagation</h4>
 <div class="paragraph">
-<p>If the current access token needs to be exchanged before propagation and you work with <a href="https://www.keycloak.org/docs/latest/securing_apps/#_token-exchange">Keycloak</a> or other OpenID Connect Provider which supports a <a href="https://tools.ietf.org/html/rfc8693">Token Exchange</a> token grant, then you can configure <code>AccessTokenRequestFilter</code> like this:</p>
+<p>If the current access token needs to be exchanged before propagation and you work with <a href="https://www.keycloak.org/securing-apps/token-exchange">Keycloak</a> or other OpenID Connect Provider which supports a <a href="https://tools.ietf.org/html/rfc8693">Token Exchange</a> token grant, then you can configure <code>AccessTokenRequestFilter</code> like this:</p>
 </div>
 <div class="listingblock">
 <div class="content">

version/main/guides/security-openid-connect-providers.html

@@ -487,15 +487,15 @@ <h3 id="facebook"><a class="anchor" href="#facebook"></a>Facebook</h3>
 you may want to use a service such as <a href="https://ngrok.com" class="bare">https://ngrok.com</a>.</p>
 </div>
 <div class="paragraph">
-<p>In order to set up OIDC for Facebook start by <a href="https://developers.facebook.com/apps/create/">Creating an application</a>, select <code>None</code> as an app type, and press <code>Next</code>:</p>
+<p>In order to set up OIDC for Facebook start by <a href="https://developers.facebook.com/apps/create/">Creating an application</a>, select <code>Other</code> as an app type, and click <code>Next</code>.</p>
 </div>
 <div class="imageblock thumb">
 <div class="content">
 <img src="./images/oidc-facebook-1.png" alt="oidc facebook 1">
 </div>
 </div>
 <div class="paragraph">
-<p>Now enter an application name, and contact email, and press <code>Create app</code>:</p>
+<p>Now choose your application type. For this guide choose <code>Consumer</code> and click <code>Next</code> until you reach the screen below. Now enter an application name, and contact email, and press <code>Create app</code>:</p>
 </div>
 <div class="imageblock thumb">
 <div class="content">
@@ -511,15 +511,16 @@ <h3 id="facebook"><a class="anchor" href="#facebook"></a>Facebook</h3>
 </div>
 </div>
 <div class="paragraph">
-<p>Quick the <code>Quickstarts</code> page and click on <code>Facebook login &gt; Settings</code> on the left menu:</p>
+<p>On the <code>Quickstart</code> page click on <code>Facebook login &gt; Settings</code> on the left menu:</p>
 </div>
 <div class="imageblock thumb">
 <div class="content">
 <img src="./images/oidc-facebook-4.png" alt="oidc facebook 4">
 </div>
 </div>
 <div class="paragraph">
-<p>Enter your <code>Redirect URIs</code> (set to <code>&lt;host&gt;/_renarde/security/oidc-success</code>) and press <code>Save changes</code>:</p>
+<p>First click on <code>Get Advanced Access</code> to switch <code>public_profile</code> to advanced access.
+Then enter your <code>Redirect URIs</code> (set to <code>&lt;host&gt;/facebook</code>) and press <code>Save changes</code>:</p>
 </div>
 <div class="imageblock thumb">
 <div class="content">
@@ -901,6 +902,70 @@ <h3 id="microsoft"><a class="anchor" href="#microsoft"></a>Microsoft</h3>
 </div>
 </div>
 <div class="sect2">
+<h3 id="slack"><a class="anchor" href="#slack"></a>Slack</h3>
+<div class="paragraph">
+<p>Create a <a href="https://api.slack.com/authentication/sign-in-with-slack#setup">Slack application</a>:</p>
+</div>
+<div class="imageblock thumb">
+<div class="content">
+<img src="./images/oidc-slack-1.png" alt="oidc slack 1">
+</div>
+</div>
+<div class="paragraph">
+<p>Select application name, workspace, and remember it, you will need it later:</p>
+</div>
+<div class="imageblock thumb">
+<div class="content">
+<img src="./images/oidc-slack-2.png" alt="oidc slack 2">
+</div>
+</div>
+<div class="paragraph">
+<p>Please save client id and secret displayed on the next page, you will need them later:</p>
+</div>
+<div class="imageblock thumb">
+<div class="content">
+<img src="./images/oidc-slack-3.png" alt="oidc slack 3">
+</div>
+</div>
+<div class="paragraph">
+<p>Configure redirect URLs.
+Slack provider requires HTTPS protocol, for development purposes, you can use ngrok:</p>
+</div>
+<div class="imageblock thumb">
+<div class="content">
+<img src="./images/oidc-slack-4.png" alt="oidc slack 4">
+</div>
+</div>
+<div class="paragraph">
+<p>You can now configure your <code>application.properties</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">quarkus.oidc.provider=slack
+quarkus.oidc.client-id=&lt;Client ID&gt;
+quarkus.oidc.credentials.secret=&lt;Client Secret&gt;
+quarkus.oidc.authentication.extra-params.team=quarkus-slack <i class="conum" data-value="1"></i><b>(1)</b></code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>Use the <code>team</code> parameter to refer to the workspace you chose during the Slack OIDC application registration.</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Open your browser and navigate to your application <code><a href="https://&lt;your" class="bare">https://&lt;your</a> ngrok instance&gt;.ngrok-free.app/</code>.
+Quarkus will redirect you to Slack provider on the first request where you can grant required permissions:</p>
+</div>
+<div class="imageblock thumb">
+<div class="content">
+<img src="./images/oidc-slack-5.png" alt="oidc slack 5">
+</div>
+</div>
+</div>
+<div class="sect2">
 <h3 id="spotify"><a class="anchor" href="#spotify"></a>Spotify</h3>
 <div class="paragraph">
 <p>Create a <a href="https://developer.spotify.com/documentation/general/guides/authorization/app-settings/">Spotify application</a>:</p>
@@ -1421,6 +1486,7 @@ <h2 id="references"><a class="anchor" href="#references"></a>References</h2>
 <li><a href="#linkedin">LinkedIn</a></li>
 <li><a href="#mastodon">Mastodon</a></li>
 <li><a href="#microsoft">Microsoft</a></li>
+<li><a href="#slack">Slack</a></li>
 <li><a href="#spotify">Spotify</a></li>
 <li><a href="#strava">Strava</a></li>
 <li><a href="#twitch">Twitch</a></li>