<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Using Polaris on Apache Polaris</title><link>https://polaris.apache.org/releases/1.9.0/getting-started/using-polaris/</link><description>Recent content in Using Polaris on Apache Polaris</description><generator>Hugo</generator><language>en-us</language><copyright>&lt;a href="https://www.apache.org/"&gt;Copyright © 2026 The Apache Software Foundation&lt;/a&gt;.&lt;br&gt;Licensed under the &lt;a href="https://www.apache.org/licenses/LICENSE-2.0"&gt;Apache License, Version 2.0&lt;/a&gt;.</copyright><atom:link href="https://polaris.apache.org/releases/1.9.0/getting-started/using-polaris/index.xml" rel="self" type="application/rss+xml"/><item><title>Getting Started with Apache Polaris, External Authentication and Keycloak</title><link>https://polaris.apache.org/releases/1.9.0/getting-started/using-polaris/keycloak-idp/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://polaris.apache.org/releases/1.9.0/getting-started/using-polaris/keycloak-idp/</guid><description>&lt;h2 id="overview" id="overview"&gt;Overview&lt;a class="heading-anchor" href="#overview" aria-label="Anchor"&gt;🔗&lt;/a&gt;
&lt;/h2&gt;
&lt;p&gt;This example uses Keycloak as an &lt;strong&gt;external&lt;/strong&gt; identity provider for Polaris, while keeping Polaris&amp;rsquo;s &lt;strong&gt;built-in&lt;/strong&gt;
(internal) authorizer, which authorizes requests using grants recorded in the Polaris metastore. The &amp;ldquo;iceberg&amp;rdquo; realm
is automatically created and configured from the &lt;code&gt;iceberg-realm.json&lt;/code&gt; file.&lt;/p&gt;
&lt;p&gt;This Keycloak realm contains 1 client definition, &lt;code&gt;client1:s3cr3t&lt;/code&gt;, and 1 real user, &lt;code&gt;keycloak-admin:s3cr3t&lt;/code&gt;, who is
granted the &lt;code&gt;service_admin&lt;/code&gt; role on &lt;code&gt;client1&lt;/code&gt;. Unlike the claims used in some other Polaris examples, nothing here is
hardcoded: the token&amp;rsquo;s claims come naturally from this real user and the role granted to it in Keycloak.&lt;/p&gt;</description></item><item><title>Getting Started with Apache Polaris, Prometheus and Jaeger</title><link>https://polaris.apache.org/releases/1.9.0/getting-started/using-polaris/telemetry-tools/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://polaris.apache.org/releases/1.9.0/getting-started/using-polaris/telemetry-tools/</guid><description>&lt;p&gt;This example requires &lt;code&gt;jq&lt;/code&gt; to be installed on your machine.&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;Build the Polaris image if it&amp;rsquo;s not already present locally:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-shell" data-lang="shell"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;./gradlew &lt;span style="color:#4e9a06"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; :polaris-server:assemble &lt;span style="color:#4e9a06"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; :polaris-server:quarkusAppPartsBuild --rerun &lt;span style="color:#4e9a06"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; -Dquarkus.container-image.build&lt;span style="color:#ce5c00;font-weight:bold"&gt;=&lt;/span&gt;&lt;span style="color:#204a87"&gt;true&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Start the docker compose group by running the following command from the root of the repository:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-shell" data-lang="shell"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;docker compose -f getting-started/telemetry/docker-compose.yml up
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;To access Polaris from the host machine, first request an access token:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-shell" data-lang="shell"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#204a87"&gt;export&lt;/span&gt; &lt;span style="color:#000"&gt;POLARIS_TOKEN&lt;/span&gt;&lt;span style="color:#ce5c00;font-weight:bold"&gt;=&lt;/span&gt;&lt;span style="color:#204a87;font-weight:bold"&gt;$(&lt;/span&gt;curl -s http://localhost:8181/api/catalog/v1/oauth/tokens &lt;span style="color:#4e9a06"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; --user root:s3cr3t &lt;span style="color:#4e9a06"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; -d &lt;span style="color:#4e9a06"&gt;&amp;#39;grant_type=client_credentials&amp;#39;&lt;/span&gt; &lt;span style="color:#4e9a06"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; -d &lt;span style="color:#4e9a06"&gt;&amp;#39;scope=PRINCIPAL_ROLE:ALL&amp;#39;&lt;/span&gt; &lt;span style="color:#000;font-weight:bold"&gt;|&lt;/span&gt; jq -r .access_token&lt;span style="color:#204a87;font-weight:bold"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Then, use the access token in the Authorization header when accessing Polaris; you can also test
the &lt;code&gt;X-Request-ID&lt;/code&gt; header; you should see it in all logs and traces:&lt;/p&gt;</description></item><item><title>Getting Started with Apache Polaris, Fully External Principals, Keycloak and OPA</title><link>https://polaris.apache.org/releases/1.9.0/getting-started/using-polaris/keycloak-opa-idp/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://polaris.apache.org/releases/1.9.0/getting-started/using-polaris/keycloak-opa-idp/</guid><description>&lt;h2 id="overview" id="overview"&gt;Overview&lt;a class="heading-anchor" href="#overview" aria-label="Anchor"&gt;🔗&lt;/a&gt;
&lt;/h2&gt;
&lt;p&gt;This example uses Keycloak as an &lt;strong&gt;external&lt;/strong&gt; identity provider for Polaris. Unlike the &lt;a href="https://polaris.apache.org/releases/1.9.0/getting-started/using-polaris/keycloak-idp/"&gt;Keycloak
IDP example&lt;/a&gt;, it demonstrates &lt;strong&gt;fully external principals&lt;/strong&gt;: a
principal authenticated by Keycloak that never needs to exist in the Polaris metastore at all.&lt;/p&gt;
&lt;p&gt;Enabling fully external principals is done by setting the option
&lt;code&gt;polaris.authentication.credential-mode=external&lt;/code&gt;; it has two hard requirements, both enforced by
Polaris at startup:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;The authentication type must not be the default (&lt;code&gt;internal&lt;/code&gt;) one.&lt;/li&gt;
&lt;li&gt;The authorizer must not be the default (&lt;code&gt;internal&lt;/code&gt;) one, since it authorizes requests using metastore-backed
grants, which external principals don&amp;rsquo;t have.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;This example satisfies both requirements: the default (and only) realm delegates authentication to Keycloak
exclusively (&lt;code&gt;polaris.authentication.type=external&lt;/code&gt;), and the whole deployment is authorized by
&lt;a href="https://www.openpolicyagent.org/"&gt;Open Policy Agent (OPA)&lt;/a&gt; instead of Polaris&amp;rsquo;s built-in authorizer.&lt;/p&gt;</description></item></channel></rss>