Skip to content

Commit cc4d99c

Browse files
github-automation-metabaseMetabase Docs bot
andauthored
[auto] adding content to ah-docs-saml->master (#453)
Co-authored-by: Metabase Docs bot <[email protected]>
1 parent 8a73e67 commit cc4d99c

15 files changed

+60
-17
lines changed

_docs/master/developers-guide/driver-changelog.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,14 @@ layout: new-docs
1111

1212
# Driver Interface Changelog
1313

14+
## Metabase 0.57.0
15+
16+
- `driver/field-reference-mlv2` is now deprecated, and is no longer used. Please remove your implementations.
17+
18+
- The key `metabase.driver-api.core/qp.add.nfc-path` is now more consistently populated; other `qp.add.*` keys no
19+
longer include parent column names for drivers like MongoDB -- use `qp.add.nfc-path` instead to qualify the
20+
`qp.add.source-column-alias` with parent column names as needed.
21+
1422
## Metabase 0.56.0
1523

1624
- Add the testing multi-method `tx/track-dataset` for shared cloud dbs to track loaded datasets for more efficient sharing.

_docs/master/embedding/embedded-analytics-js.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -164,7 +164,7 @@ For example, this will define the font, color, and size for text, color for back
164164
</script>
165165
```
166166
167-
For the full list of theme settings, see [Appearance](./sdk/appearance).
167+
For the full list of theme settings, see [Appearance](../sdk/appearance).
168168
169169
## Authentication
170170
@@ -193,7 +193,7 @@ Note that this will not work in some browsers, or in incognito mode. We recommen
193193
194194
To use an API key to test your embeds:
195195
196-
1. Create an [API key](../people-and-groups/api-keys)
196+
1. Create an [API key](../../people-and-groups/api-keys)
197197
2. Add `apiKey: "YOUR_API_KEY"` to `defineMetabaseConfig()`:
198198
199199
```html

_docs/master/embedding/securing-embeds.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@ Interactive embedding integrates with SSO ([JWT](/docs/latest/people-and-groups/
173173

174174
- [Tables](../permissions/data)
175175
- [Rows](../permissions/row-and-column-security#row-level-security-filter-by-a-column-in-the-table)
176-
- [Columns](../permissions/row-and-column-security#custom-row-and-column-security-use-a-sql-question-to-create-a-custom-view-of-a-table)
176+
- [Columns](../permissions/row-and-column-security#custom-row-and-column-security-use-a-saved-question-to-create-a-custom-view-of-a-table)
177177
- [Other data permissions](../permissions/data), such as data download permissions or SQL access.
178178

179179
### Interactive embedding with SSO

_docs/master/people-and-groups/authenticating-with-jwt.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ You can configure JWT group assignments through Metabase's Admin interface, or b
7373

7474
You can use the following environment variables to configure JTW group mappings instead of configuring them in Metabase's Admin settings:
7575

76-
- [`MB_JWT_ATTRIBUTE_GROUPS`](../configuring-metabase/environment-variables#mb_jwt_attribute_groups) to specify the key to retrieve the JWT user's groups;
76+
- [`MB_JWT_ATTRIBUTE_GROUPS`](../configuring-metabase/environment-variables#mb_jwt_attribute_groups) to specify the key to retrieve the JWT users groups;
7777

7878
- [`MB_JWT_GROUP_SYNC`](../configuring-metabase/environment-variables#mb_jwt_group_sync) to turn group sync on or off (sync is off by default).
7979

_docs/master/people-and-groups/authenticating-with-saml.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -167,6 +167,16 @@ So if your Metabase is served at `metabase.example.com` the logout service POST
167167
https://metabase.example.com/auth/sso/handle_slo
168168
```
169169

170+
### Enable SAML SLO
171+
172+
SLO isn’t configurable from the Metabase interface. To enable it, you’ll need to set the following options using environment variables or your Metabase configuration file:
173+
174+
- [`MB_SAML_SLO_ENABLED`](../configuring-metabase/environment-variables#mb_saml_slo_enabled) to `true`;
175+
- [`MB_SAML_IDENTITY_PROVIDER_URI`](../configuring-metabase/environment-variables#mb_saml_identity_provider_uri) to your IdP’s SLO endpoint;
176+
- [`MB_SESSION_COOKIE_SAMESITE`](../configuring-metabase/environment-variables#mb_session_cookie_samesite) to `none`.
177+
178+
For the `MB_SESSION_COOKIE_SAMESITE` setting to work with `none`, Metabase must be served over HTTPS. Browsers like Chrome will block cookies in cross-site requests if SSL is not enabled. Without HTTPS, logout requests from your IdP (such as Okta) won’t include the session cookie, which means Metabase won’t be able to end the session properly.
179+
170180
## Synchronizing group membership with your IdP
171181

172182
This setting allows you to assign users to Metabase groups based on an attribute of your users in your IdP. This setting may not correlate to group functionality provided by your IdP; you may need to create a separate user attribute to set people's Metabase groups, like `metabaseGroups`.

_docs/master/permissions/embedding.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ To keep A and C from viewing the `Insights` column, you can add [column-level se
7777
```
7878

7979
5. Save the SQL question as "Customer Metrics".
80-
6. [Add row and column security](./row-and-column-security#custom-row-and-column-security-use-a-sql-question-to-create-a-custom-view-of-a-table) using the "Metrics-Only Tenants" group and "Customer Metrics" SQL question.
80+
6. [Add row and column security](./row-and-column-security#custom-row-and-column-security-use-a-saved-question-to-create-a-custom-view-of-a-table) using the "Metrics-Only Tenants" group and "Customer Metrics" SQL question.
8181

8282
When, for example, Tenant A logs in, they'll only see the `Tenant_ID` and `Metrics` columns, and only the rows where `Tenant_ID = A`.
8383

_docs/master/permissions/row-and-column-security-examples.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ redirect_from:
1818
[Row and column security](./row-and-column-security) let you:
1919

2020
- [Restrict **rows**](./row-and-column-security#row-level-security-filter-by-a-column-in-the-table).
21-
- [Restrict **columns** (and rows)](./row-and-column-security#custom-row-and-column-security-use-a-sql-question-to-create-a-custom-view-of-a-table).
21+
- [Restrict **columns** (and rows)](./row-and-column-security#custom-row-and-column-security-use-a-saved-question-to-create-a-custom-view-of-a-table).
2222

2323
## Setup for all examples below
2424

_docs/master/permissions/row-and-column-security.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ You can define up to one row and column security policy for each table/group com
4040
Row and column security show specific data to each person based on their [user attributes](../people-and-groups/managing#adding-a-user-attribute). You can:
4141

4242
- [Restrict **rows**](#row-level-security-filter-by-a-column-in-the-table)
43-
- [Restrict **columns** and rows](#custom-row-and-column-security-use-a-sql-question-to-create-a-custom-view-of-a-table) for specific people.
43+
- [Restrict **columns** and rows](#custom-row-and-column-security-use-a-saved-question-to-create-a-custom-view-of-a-table) for specific people.
4444

4545
| Goal | Row (filter by a column in the table) | Custom (use a saved SQL question) |
4646
| ---------------------------------------------- | ------------------------------------- | --------------------------------- |
@@ -202,7 +202,7 @@ Learn more about [SQL parameters](../questions/native-editor/sql-parameters)
202202

203203
Some Metabase permissions can conflict with row and column security to give more permissive or more restrictive data access than you intended.
204204

205-
Say you've set up [column security](#custom-row-and-column-security-use-a-sql-question-to-create-a-custom-view-of-a-table) that hides the Email column from the Accounts table (for a particular group).
205+
Say you've set up [column security](#custom-row-and-column-security-use-a-saved-question-to-create-a-custom-view-of-a-table) that hides the Email column from the Accounts table (for a particular group).
206206

207207
The Email column may get exposed to someone if:
208208

_site/docs/master/developers-guide/driver-changelog.html

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@
4949
<meta name="twitter:site" content="@metabase">
5050

5151
<meta name="twitter:title" content="Driver interface changelog | Metabase Documentation">
52-
<meta name="twitter:description" content="Driver Interface Changelog Metabase 0.56.0 Add the testing multi-method tx/track-dataset for shared cloud dbs to track loaded datasets for more efficient sharing. Join alias escaping has been reworked; when compiling MBQL for a join...">
52+
<meta name="twitter:description" content="Driver Interface Changelog Metabase 0.57.0 driver/field-reference-mlv2 is now deprecated, and is no longer used. Please remove your implementations. The key metabase.driver-api.core/qp.add.nfc-path is now more consistently populated; other qp.add.* keys no...">
5353
<meta name="twitter:card" content="summary_large_image">
5454
<meta name="twitter:image" content="https://www.metabase.com/images/docs/docs-og.png">
5555
<!-- end of Twitter cards -->
@@ -59,7 +59,7 @@
5959
<meta property="og:type" content="article">
6060
<meta property="og:url" content="https://www.metabase.com/docs/master/developers-guide/driver-changelog">
6161
<meta name="title" property="og:title" content="Driver interface changelog | Metabase Documentation">
62-
<meta name="description" property="og:description" content="Driver Interface Changelog Metabase 0.56.0 Add the testing multi-method tx/track-dataset for shared cloud dbs to track loaded datasets for more efficient sharing. Join alias escaping has been reworked; when compiling MBQL for a join...">
62+
<meta name="description" property="og:description" content="Driver Interface Changelog Metabase 0.57.0 driver/field-reference-mlv2 is now deprecated, and is no longer used. Please remove your implementations. The key metabase.driver-api.core/qp.add.nfc-path is now more consistently populated; other qp.add.* keys no...">
6363
<meta name="image" property="og:image" content="https://www.metabase.com/images/docs/docs-og.png">
6464
<!-- end of Open Graph metadata -->
6565

@@ -4863,6 +4863,19 @@ <h5>Other resources</h5>
48634863

48644864
<h1 id="driver-interface-changelog">Driver Interface Changelog</h1>
48654865

4866+
<h2 id="metabase-0570">Metabase 0.57.0</h2>
4867+
4868+
<ul>
4869+
<li>
4870+
<p><code class="language-plaintext highlighter-rouge">driver/field-reference-mlv2</code> is now deprecated, and is no longer used. Please remove your implementations.</p>
4871+
</li>
4872+
<li>
4873+
<p>The key <code class="language-plaintext highlighter-rouge">metabase.driver-api.core/qp.add.nfc-path</code> is now more consistently populated; other <code class="language-plaintext highlighter-rouge">qp.add.*</code> keys no
4874+
longer include parent column names for drivers like MongoDB – use <code class="language-plaintext highlighter-rouge">qp.add.nfc-path</code> instead to qualify the
4875+
<code class="language-plaintext highlighter-rouge">qp.add.source-column-alias</code> with parent column names as needed.</p>
4876+
</li>
4877+
</ul>
4878+
48664879
<h2 id="metabase-0560">Metabase 0.56.0</h2>
48674880

48684881
<ul>

_site/docs/master/embedding/embedded-analytics-js.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5041,7 +5041,7 @@ <h3 id="theming">Theming</h3>
50415041
<span class="nt">&lt;/script&gt;</span>
50425042
</code></pre></div></div>
50435043

5044-
<p>For the full list of theme settings, see <a href="./sdk/appearance">Appearance</a>.</p>
5044+
<p>For the full list of theme settings, see <a href="../sdk/appearance">Appearance</a>.</p>
50455045

50465046
<h2 id="authentication">Authentication</h2>
50475047

@@ -5074,7 +5074,7 @@ <h3 id="use-api-keys-to-test-embeds">Use API keys to test embeds</h3>
50745074
<p>To use an API key to test your embeds:</p>
50755075

50765076
<ol>
5077-
<li>Create an <a href="../people-and-groups/api-keys">API key</a></li>
5077+
<li>Create an <a href="../../people-and-groups/api-keys">API key</a></li>
50785078
<li>Add <code class="language-plaintext highlighter-rouge">apiKey: "YOUR_API_KEY"</code> to <code class="language-plaintext highlighter-rouge">defineMetabaseConfig()</code>:</li>
50795079
</ol>
50805080

0 commit comments

Comments
 (0)